SharePlex 11.4 - リファレンス・ガイド

SharePlexコマンドのアルファベット順リファレンス

SharePlexコマンドのアルファベット順リファレンス

ここから、SharePlexコマンドの詳細なリファレンスドキュメントをアルファベット順に記載します。

abort config

abort configコマンドを使用すると、設定を即座に非アクティベーションし、関連するすべてのキューとレプリケーションプロセスを同時に削除できます。 このコマンドは、キュー内のデータがポストされたかどうかにかかわらず、ソースシステムとターゲットシステムで設定されたデータソースのすべてのレプリケーションアクティビティを停止します。これは強制的な非アクティベーションです。

abort configコマンドは、システム、設定、またはデータに問題が発生し、ターゲットシステムへのポストを防ぐ必要がある場合に有効です。パイプラインに残っているデータがすべて削除されるため、このコマンドが有効になると、ソースインスタンスとターゲットインスタンスは同期しなくなります。

abort configコマンドの実行前または実行中に、SharePlexレプリケーションプロセスが停止した場合、このコマンドも停止します。プロセスが再開されると、コマンドは動作を再開します。これにより、abort configはネットワークが一時的にダウンした場合でも機能し、接続が回復するまでキューに残ります。

同じソースシステム上に複数のアクティブな設定がある場合は、それぞれのレプリケーションストリームを分離する名前付きexportキューがある場合にのみ、abort configコマンドを使用してください。名前付きexportキューがない場合、SharePlexは、レプリケートされたすべてのデータを1つのexportキューを通して転送します。そして、1つの設定に対してabort configコマンドを実行すると、すべてのアクティブな設定のデータが削除されます。名前付きキューを作成するには、『SharePlex管理者ガイド』の第5章を参照してください。

用途

構文

構文の説明

リモートオプション

これらのオプションにより、リモートマシンにコマンドを発行したり、ログイン名、パスワード、ポート番号、またはそれらの組み合わせを含むコマンドをスクリプト化したりすることができます。

abort service

abort serviceコマンドを使用すると、SharePlexレプリケーションプロセス（サービス）を、そのプロセスがキューからの読み取り、またはキューへの書き込みを完了したかどうかにかかわらず、直ちに終了させることができます。このコマンドは、プロセスがグレースフルに停止するのを待てない場合、または、stopコマンドを発行してもプロセスがシャットダウンしない異常な状況で有効です。

このコマンドはレプリケートされたデータには影響しません。データは安全にキューに残り、プロセスが再開されると、SharePlexは通常の処理を再開します。

abort serviceコマンドで中断されたプロセスは、SharePlexをシャットダウンして再起動しても、停止したままになります。startコマンドを使用した場合のみ、プロセスを再開できます。

abort serviceコマンドには、他のルートのレプリケーションに影響を与えることなく、任意の（あるいはすべての）システムまたは名前付きキューのプロセスを中断できるオプションがあります。

用途

構文

構文の説明

リモートオプション

これらのオプションにより、リモートマシンにコマンドを発行したり、ログイン名、パスワード、ポート番号、またはそれらの組み合わせを含むコマンドをスクリプト化したりすることができます。

activate config

設定をアクティベーションするには、activate configコマンドを使用します。レプリケーションは、アクティベーションプロセスが完了すると直ちに開始されます。設定をアクティベーションすると何が起こるかの詳細については、『SharePlex管理ガイド』を参照してください。

アクティベーションプロセスは、設定ファイルを読み込み、そこからSharePlexが以下を実行するために必要なすべての情報を取得します。

• レプリケーション対象のオブジェクトを特定する
• レプリケートされた変更を適切なターゲットデータベースにルーティングする
• Postがターゲットに変更を適用するために使用するSQLを生成する
• レプリケーションに追加されたすべてのテーブルをアクティベーションする

sp_copが設定をアクティベーションするために呼び出すプロセスはsp_tconfです。

アクティベーションは、複数のテーブルを同時にアクティベーションするために、非同期の並列処理スレッドを作成します。各テーブルは、テーブルをアクティベーションするために最低限必要なだけの、非常に短い時間ロックされます。各テーブルのレプリケーションは、そのアクティベーションが完了するとすぐに開始されます。

1つまたは複数のテーブルがアクティベーションに失敗した場合、SharePlexは他のテーブルのアクティベーションを続行します。レプリケーション設定でアプリケーションがテーブルのNOWAITロックを使用している場合、アクティベーションするオブジェクトのロックを取得しようとすると、失敗する可能性があります。

アクティベーションのガイドライン

• 設定をアクティベーションするには、レプリケートするオブジェクトを含むデータベースをマウントし、開いておく必要があります。アクティベーションにかかる時間は、設定されたオブジェクトのサイズ、数、構造によって異なります。
• 各システム上のデータソース（Oracleインスタンス）ごとに1つの設定をアクティベーションできます。例えば、インスタンスora10にConfigA、ConfigB、ConfigCがある場合、一度にアクティベーションできるのはそのうちの1つだけです。同じデータソースについて別の設定をアクティベーションすると、最初の設定は自動的に非アクティベーションされます。
• アクティベーション中は、DDL（TRUNCATEを含む）を実行しないでください。アクティベーション中に許可される変更はDMLの変更だけです。
• アクティベーションを実行するには、アプリケーションに再試行ロジックが必要です。レプリケーション設定でテーブルがNOWAITロックされている場合、アプリケーションがアクティベーションするオブジェクトのロックを取得しようとすると、失敗する可能性があります。
• アクティベーションプロセスでは、アクティベーションが完了するまでsp_ctrlインターフェイスの制御を保持します。同一システム上の異なるデータソースの複数の設定をアクティベーションするには、最初の設定をアクティベーションしてから、sp_ctrlの別のセッションを開き、2つ目の設定をアクティベーションします。アクティベーションする設定の数だけsp_ctrlのセッションを開きます。

• 設定をアクティベーションする前に、verify configコマンドを使用して、アクティベーションとレプリケーションを正常に実行するための基本要件が満たされていることを確認します。このコマンドは、アクティベーションの失敗を引き起こす可能性のある潜在的な問題を警告します。

アクティベーションのスレッド数の設定

アクティベーションのスレッド数はグローバルに（すべてのアクティベーションに対して）設定することができ、任意のアクティベーションに対してこの設定を上書きすることができます。

スレッド数をグローバルに設定するには:

1. sp_ctrlを実行します。

2. 次のコマンドを発行します。最大32スレッドまで使用できます。

   sp_ctrl> set param SP_OCF_THREAD_COUNT number_of_threads

現在のアクティベーションのスレッド数を設定するには:

[threads=n]オプションを指定してactivate configコマンドを発行します。

アクティベーションのステータスと結果の表示

SharePlexはオブジェクトを、設定ファイルの順番ではなく、オブジェクトIDに従ってアクティベーションするので、アクティベーションの順番を予測する方法はありません。

SharePlexは個々のテーブルのアクティベーションに失敗してもしなくてもアクティベーションを続行するため、テーブルのアクティベーションに失敗すると、 sp_ctrlプロンプトに次のエラーメッセージを表示して警告します。「WARNING, not all objects activated successfully. Check activation log.」（警告、一部のオブジェクトが正常にアクティベーションされませんでした。アクティベーションログを確認してください。）

アクティベーションの結果を表示するには:

show configコマンドを実行します。

アクティベーションに失敗した場合の対処法

テーブルや設定全体のアクティベーションに失敗する原因は多数あります。例えば、設定ファイルの1つ以上のコンポーネントが誤って入力された場合、影響を受けるオブジェクトのアクティベーションは失敗します。

アクティベーションの前にverify configコマンドを実行しなかった場合は、今すぐ実行し、検出された問題を修正してください。その後、もう一度アクティベーションを実行してください。トラブルシューティングの詳細については、『SharePlex管理ガイド』を参照してください。

用途

構文

構文の説明

リモートオプション

これらのオプションにより、リモートマシンにコマンドを発行したり、ログイン名、パスワード、ポート番号、またはそれらの組み合わせを含むコマンドをスクリプト化したりすることができます。