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

compare status

compare status

compare statusコマンドを使用して、最後に実行されたcompareまたはrepairジョブのステータスを表示します。compare statusコマンドを使用すると、compareジョブやrepairジョブ、またはcompareジョブやrepairジョブの一部に関する詳細なステータスを表示したり、SharePlexに履歴があるすべてのcompareジョブおよびrepairジョブのステータスを表示したりできます。

注意: compare statusコマンドの詳細および使用例については、job statusコマンドを参照してください。

用途

構文

構文の説明

リモートオプション

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

connection

connectionコマンドを使用すると、SharePlexをデータベースに接続するように設定できます。

connectionコマンドの使用方法

connectionコマンドを使用して、データベースに接続する際にSharePlexが使用する接続プロパティを設定します。このコマンドは、データベースで使用できるデータベース・セットアップ・ユーティリティがない場合にのみ使用します。データベースのセットアップユーティリティが存在するかどうかを確認するには、「データベース・セットアップ・ユーティリティ ページを参照してください。

connectionコマンドは以下のように使用します。

• setオプションを使用して接続属性を設定します。使用するオプションごとに、connectionコマンドを1つ発行します。このコマンドでは、1つのコマンドで複数のキーワード/値のペアを文字列化することができません。
• resetオプションを使用して接続設定をクリアします。
• showオプションを指定して現在の接続設定を表示します。

重要: このコマンドを使用した後は、必ずPostプロセスを停止してから再度開始してください。

用途

構文

構文の説明

キーワード

例

Oracleの例

connection o.myora12 set user=myuser

connection o.myora12 set password=mypassword

connection o.myora12 set tns_alias=myora12

Open Targetの例

DSNが存在する場合

connection r.mydb set user=myuser

connection r.mydb set password=mypassword

connection r.mydb set dsn=mydsn

DSNが存在しない場合

connection r.mydb set user=myuser

connection r.mydb set password=mypassword

connection r.mydb set port=1234

connection r.mydb set server=server1

connection r.mydb set driver=/database/ODBC/lib/databasedriver.so

DSNが存在しないため、接続文字列を使用

connection r.mydb set user=myuser

connection r.mydb set password=mypassword

connection r.mydb set connect_string=”driver=/database/ODBC/lib/databasedriver.so;server=server1;port=1234;uid=myuser;pwd=mypassword”

接続値の削除

connection r.mydb reset port

connection r.mydb reset

接続設定の表示

connection r.mydb show

connection show all

copy/append

copy / append

copy/appendコマンドは、Oracle Export/Importユーティリティを使用して、ユーザがレプリケーションをセットアップしたり、既にレプリケーション内にある個々のテーブルを（再）同期したりできるようにします。

ユーザは、個々のテーブルを単一のターゲットにコピー/追加したり、複数のターゲットを指定したり、レプリケーション設定内のすべてのターゲットを指定したりできます。

copyコマンド

データを同期する前にターゲットテーブルを切り捨てたい場合は、copyコマンドを使用して、あるホストから別のホストにテーブル（または複数のテーブル）を同期またはインスタンス化します。

appendコマンド

データを同期する前にターゲットテーブルを切り捨てたくない場合は、appendコマンドを使用して、あるホストから別のホストにテーブル（または複数のテーブル）を同期またはインスタンス化します。

copy/appendコマンドを使用するとき

copy/appendコマンドは以下のように使用します。

• データベースを移行するため。
• Compare/Repairプロセスでrepairできないテーブルを同期するため。
• テーブルをインスタンス化する際にレプリケーションに入れる。

copy/appendコマンドがサポートするもの

copy/appendコマンドは以下をサポートしています。

• copy/appendコマンドでサポートされるオブジェクトは、OracleのImport/Exportユーティリティでサポートされているオブジェクトです。
• 下位バージョンのOracleから上位バージョンのOracleへのコピー、または同じバージョンのOracle間でのコピー。
• Oracleワイルドカード指定の結果として含まれる同期ルーティングファイル内のオブジェクトのコピー/追加。
• コマンドライン構文でのOracleワイルドカード指定の使用。

copy/appendコマンドがサポートしていないもの

copy/appendコマンドは、以下をサポートしていません。

• 上位バージョンのOracleから下位バージョンのOracleへのコピー
• テーブルからビューへのコピー
• UDTまたはVARRAY（UDTまたはVARRAYタイプがOracleのImport/ExportユーティリティまたはOracleのホットバックアップを使用してターゲットデータベースに作成されていない場合）。これはOracleのインポート/エクスポート機能の制限です
• 水平分割または垂直分割されたレプリケーション内のテーブル
• シーケンス
• トランスフォーメーションが使用されているテーブル（トランスフォーメーションがターゲットにも適用されている場合を除く）。
• ソースサーバとターゲットサーバ間のデータ受け渡しにパススルーサーバを使用するネットワーク構成
• 列のマッピング
• 列のサブセット
• テーブル内の行のサブセットの指定
• インデックス、制約、トリガ、およびグラントオプション
• 直接ロード
• 透過的データ暗号化（TDE）

• appendコマンドはOracleパーティションをサポートしていません（copyコマンドのみがOracleパーティションをサポートしています）。

• Oracle Database 23cでは、暗号化されたテーブルスペースではCopy/Appendコマンドはサポートされません。

ランチャープロセス

copy/appendコマンドを実行する前に、ターゲットシステムでランチャープロセスを実行しておく必要があります。ランチャープロセスを開始するには、各ターゲットシステムで以下のコマンドを実行する必要があります。

ランチャープロセスの実行中は、show launcherコマンドを使用してプロセスの詳細を表示できます。

ユーザが同期を完了したら、ターゲットシステムでランチャーを停止することができます。ランチャープロセスを停止するには、各ターゲットシステムで以下のコマンドを実行する必要があります。

コピー/追加プロセスの概要

copy/appendコマンドは、個々のホスト間で個々のテーブルを同期するプロセスを開始します。

以下は、単純な同期プロセスのアクティビティを示すイベントのシーケンスです。

1. ターゲットシステムにログオンし、sp_ctrlからstart launcherコマンドを発行します。
2. sp_ctrlセッションからcopy/appendコマンドが発行されると、sp_cncはソースシステム上にsp_sync_svrを生成します。
3. sp_sync_svrはターゲットシステムに接続し、ターゲットシステムでsp_sync_clntを起動します。
4. sp_sync_svrは、sp_syn_clntにテーブルリストを送信し、ターゲットテーブルの情報を確認します。a) オブジェクトがコピーされている場合（追加ではなく）、ターゲットテーブルは切り捨てられます。
5. コピー対象の各オブジェクトに対して、sp_sync_svrはOracleのexportプロセスを開始します。
6. コピー対象のオブジェクトがレプリケーションに含まれる場合、sp_sync_svrは、sp_sync_clntがPostプロセスの準備ができたことを示すまで待機する必要があります。
7. sp_sync_clntプロセスは、sp_sync_svrプロセスがOracleのexportプロセスを開いた各オブジェクトに対してOracleのimportプロセスを開始します。
8. sp_sync_svrプロセスは、コピーが完了するまで、データをsp_sync_clntプロセスに転送します。
9. コピー対象のオブジェクトがレプリケーションに含まれる場合、Postプロセスが再度開始され、そのポストアクティビティを再開します。
10. ターゲットシステムにログオンし、sp_ctrlからstop launcherコマンドを発行します。

コピープロセスの同時実行

一度に複数のcopy/appendコマンドを発行できます。ユーザは、コピープロセスの進行中にPostプロセスがすべてのレプリケーションを停止することに注意する必要があります。

同期プロセスの識別

同期プロセスは、sp_copプロセスによって開始されないため、sp_ctrlコンソールにリストされません。プロセスを識別するには、オペレーティングシステムを使用して実行可能ファイルを探します。

• sp_sync_svr

• sp_sync_clnt

• sp_sync_lstnr

• sp_sync_launcher

同期のチューニングパラメーター

以下は、copy/ appendコマンドを使用した同期に関連するパラメーターのリストです。これらのパラメーターはすべてライブであり、次にコマンドが発行されたときに有効になります。

• SP_OSY_COMPRESSION: このパラメーターは、データ圧縮をオフ（0）からフル（9）まで調整します。デフォルトの整数値は6に設定されています。
• SP_OSY_EXP_BUFFER_SIZE: このパラメーターは、ターゲットシステムに送信される前にバッファされるデータ量を調整します。デフォルトの整数値は1024キロバイトです。
• SP_OSY_IMP_BUFFER_SIZE: このパラメーターは、ターゲットシステムに適用される前にバッファされるデータ量を調整します。デフォルトの整数値は1024キロバイトです。
• SP_OSY_LOCK_TIMEOUT: このパラメーターは、同期プロセスがテーブルロックを取得するまで待機する時間を秒数で設定します。デフォルトの整数値は2秒です。
• SP_OSY_PORT: このパラメーターは、同期プロセスのポート番号を設定します。デフォルトの整数値は、ポート番号2501に設定されています。
• SP_OSY_POST_TIMEOUT: このパラメーターは、同期プロセスが、Postプロセスの準備が整い、同期が開始されるまで待機する時間を秒数で設定します。デフォルトの整数値は1800秒（30分）に設定されています。
• SP_OSY_TCP_TIMEOUT: このパラメーターはIPCタイムアウトの秒数を設定します。デフォルトの整数値は60秒に設定されています。
• SP_OSY_THREADS: このパラメーターは、同期処理のスレッド数を設定します。このスレッドパラメーターは、パーティション分割されたテーブルにのみ影響します。デフォルトの整数値は5スレッドに設定されています。最大値は32スレッドです。

コピーステータスの表示

1つまたは複数のcopy/appendコマンドのステータスを表示する最適な方法は、copy statusコマンドまたはappend statusコマンドを使用することです。基本コマンドは、システム上のすべてのcopy/appendプロセスの結果を表示します。

基本コマンドは、システム上で現在実行中のすべてのcopy/appendジョブのステータスと、最後に実行されたcopy/append（現在実行中のリストに含まれていない場合）のステータスを表示します。このリストは、指定したステータスのみを表示するようにフィルタリングすることができます。

1つ以上のcopy/appendコマンドの結果を表示する最適な方法は、sp_ctrlでcopyオプションを指定してreportコマンドを使用することです。

以下の例では、copy/appendコマンドがレプリケーションに含まれないテーブルに対して発行されています。その後のcopy statusは、テーブルに関する基本情報と手順のステータスを表示します。

このリストをフィルタリングして、ステータスがエラーであるテーブルだけを表示するには、以下のコマンドを実行します。

同期ルーティングファイルの使用

同期ルーティングファイルは、アクティベーションに使用される設定ファイルと非常によく似た構造をしており、ファイルの内容には同じフォーマット要件があります。この2つのファイルの違いは、設定ファイルのテーブルやオブジェクトの中には、同期プロセスでサポートされていないため、同期ルーティングファイルに含めるべきではないものがあることです。例えば、水平分割または垂直分割のテーブルは、同期プロセスでサポートされていないため、同期ルーティングファイルに含めるべきではありません。

同期ルーティングファイルでのOracleワイルドカードの使用はサポートされています。同期ルーティングファイルでのOracleワイルドカードの適用方法は、設定ファイルの場合と同じです。SharePlexがワイルドカードをどのようにサポートしているかについては、『SharePlex管理ガイド』を参照してください。

ルーティングファイルの例

異種ソーステーブルとターゲットテーブルのコピー

ソーステーブルとターゲットテーブルの構造は同一でなければなりませんが、例外として、ソーステーブルの列数はターゲットテーブルより少なくても構いません。

copy/appendコマンドは、ソーステーブルの列数が対応するターゲットテーブルより多い場合は使用しないでください。

分割レプリケーションでのコピーの使用

設定内のテーブルが分割レプリケーションを使用する場合:

• copy/appendコマンドは、個々のテーブルのコピーとパーティション化された個々のテーブルのコピーをサポートしますが、個々のパーティションのコピーはサポートしていません。
• 指定されたターゲットオブジェクトがパーティションであっても、データが個々のパーティションにコピーされることはありません。
• パーティションをターゲットとして指定することはサポートされていません。
• データの同期は、copyでもappendでも、常にベーステーブルで行われ、パーティションで行われることはありません。
• copy/appendコマンドは、現在レプリケーションに含まれている垂直または水平のパーティション分割されたテーブルをサポートしていません。
• [singlethread]オプションを使用すると、パーティション分割されたテーブルが1つのオブジェクトとしてコピーされます。デフォルトの動作は、パーティション分割されたテーブルの各パーティションを個別にコピーするので、コピーを並行して実行できます。

処理スレッド数の制御

複数のプロセッサを搭載したマシンを活用するために、SP_OSY_THREADSパラメーターを使用して、ソースシステム上のコピー/追加処理スレッド数を設定できます。このスレッドパラメーターは、パーティション分割されたテーブルにのみ影響します。このパラメーターのデフォルト値は5スレッドに設定されており、有効な値の範囲は1～32スレッドです。

テーブルがレプリケーションの対象である場合、同期プロセスはシングルスレッドであることに注意してください。マルチスレッド処理が有効になるのは、レプリケーション対象外のテーブルのみです。

コマンドライン構文でのOracleワイルドカードの使用

Oracleワイルドカードは、copy/appendコマンドの source_table部分を指定するときに使用できます。さらに、not表記を使用して、特定のオブジェクトを除外することもできます。

特定のスキーマ内の全テーブルを指定するには、以下を使用します。

上記の例では、オブジェクトが現在レプリケーションに含まれている場合、scottスキーマ以下のすべてのオブジェクトがコピーされます。

また、以下を使用して除外を設定することもできます。

上記の例では、オブジェクトが現在レプリケーションに含まれている場合、名前に「foo」が含まれるオブジェクトを除く、scottスキーマ以下のすべてのオブジェクトがコピーされます。

SharePlexがワイルドカードをどのようにサポートしているかの詳細については、『SharePlex管理ガイド』を参照してください。

copy/appendの使用に関するその他の考慮事項

• copy/appendコマンドを使用して同期されていないテーブルを同期する場合、またはcopy/append コマンドを使用してテーブルをインスタンス化する際にレプリケーションに入れる場合、テーブルのコピー中にPostプロセスが一時停止します。copy/appendコマンドが完了すると、Postプロセスは再開されます。これは、新しいルートを通じてレプリケーションに追加されるテーブルには適用されません。
• copy/appendコマンドは、テーブルが現在レプリケーションに含まれている場合、一度に1つのテーブルに対してのみ操作できます。
• 既知のレプリケーションルートにないテーブルにcopy/appendコマンドを使用する場合は、forceオプションを使用する必要があります。レプリケーション対象外のオブジェクトにcopy/appendを使用するには、forceオプションを使用する必要があります。
• レプリケーション対象のテーブルにcopy/appendコマンドを使用する場合、copy/appendコマンドの発行時に、すべてのSharePlexプロセス（Capture、Read、Export、Import、Post）が実行中でなければならず、プロセス中も実行中のままである必要があります。
• カスケードレプリケーション環境では、copy/appendコマンドを使用しないでください。
• 外部キーを持つテーブルは、それらのキーを一旦無効にしてから再度有効にする必要があります。
• テーブルインデックス、制約、トリガ、およびグラントオプションはサポートされていないため、同期完了後に（再度）有効にする必要があります。
• オブジェクトがレプリケーション対象の場合、copy/appendは、ソーステーブルとターゲットテーブル間のロックや同期は必要ありません。copy/appendコマンドが実行されている間、ソーステーブルとターゲットテーブルが変更されないことを前提としているからです。

• 複数のオブジェクトを含む設定ファイルが指定された場合、ソーススキーマ名とターゲットスキーマ名が異なることが許容されるのは、すべてのターゲットオブジェクトが同じスキーマ名を持つ場合のみです。

• copy/appendコマンドは、オブジェクトが異なるスキーマに存在する場合のみ、同じデータベース上の2つのオブジェクト間でデータをコピーまたは追加することができます。
• copy/appendプロセスの実行中に新しい設定をアクティベーションすると、同期プロセスが失敗する可能性があります。

注意: copyコマンドとappendコマンドの構文はまったく同じです。以下に示す例では、copyコマンドを使用していますが、copyをappendに置き換えるだけでappendコマンドを呼び出すことができます。

用途

構文

構文の説明

リモートオプション

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

copy cache

copy cacheコマンドを使用して、オブジェクトキャッシュをソースからターゲットにコピーします。

SharePlexイベントログに以下のメッセージがある場合は、copy cacheコマンドにPostプロセスのターゲットホストとターゲットSID、およびエラーメッセージにあるactid（アクティベーションID）を含めてください。これは、Postプロセスが現在ポストしているアクティベーションのアクティベーションIDです。

Poster [SP-OPO01009] cannot read object cache for actid <nnnn>

copy cacheコマンドをオプションなしで発行すると、SharePlexはソース上の現在のアクティベーションIDを識別し、そのアクティベーションIDのオブジェクトキャッシュをソースからすべてのターゲットにコピーします。

用途

構文

構文の説明

リモートオプション

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