表のリストのレプリケーションの開始

表のリストのレプリケーションを開始できます。 表は、レプリケーション・セット名、整合性グループ名、およびサブスクリプション名によって識別されます。

始める前に

このタスクは、複製ソースのクラスター・ホストで実行する必要があります。 API 呼び出しを実行する前に、必ず以下の情報を収集してください。
  • クラスター・ホスト上のソースの基本許可トークン。1
  • 複製ソース・データベースのホスト名。
  • 複製ソース・データベースの外部ポート番号。2
  • レプリケーション・セット名 (rsName)。3
  • 整合性グループ名 (cgName)。
  • サブスクリプション名 (subName)。 4
必要な Replication REST API 呼び出しを実行するには、この情報が必要です。
1 cURL 要求を実行するには、基本許可トークンを作成する必要があります。 トークンを作成するには、次のコマンドを実行します。
echo <source_db_username>:<source_db_password>| base64
2 以下のコマンドを実行して、複製ソース・データベースの外部ポート番号を取得できます。
oc get svc | grep <db2_instance_id> | grep db2u-engn-svc | grep 50001 | sed 's/.*50001://' | sed 's/\/TCP.*//')
3 次のコマンドを実行すると、レプリケーション・セット名 (rsName) と整合性グループ名 (cgName) を見つけることができます。
curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' 
'https://<source_hostname>:<source_rest_port>/dr/v1/replicationset'
4 次のコマンドを実行すると、サブスクリプション名 (subName) を見つけることができます。
curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' 'https://<source_hostname>:<source_rest_port>/dr/v1/<replication_name>/<consistency_group_name>'

このタスクについて

この API 呼び出しは、表のリストのレプリケーションを開始するタスクをトリガーします。

手順

  1. 以下のコマンドを使用して、Q レプリケーション REST API を実行します。
    curl --insecure -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' -d '{ "tableSubList": ["<subscription_name>"] }' 'https://<source_hostname>:<source_rest_port>/dr/v1/replicationset/<replication_set_name>/<consistency_group_name>/start-tablesubs'

    この API 呼び出しは、ジョブ番号 (id) を返します。

    {
  "id": <job_number>,
  "url": "https://<source_hostname>:<source_rest_external_port>/dr/v1/target/progress/<job_number>"
}
  2. 以下のコマンドにジョブ番号を含めて、複製開始操作の進行状況を確認します。
    curl --insecure -X GET --header 'Accept: application/json' --header 'Authorization: Basic <your_authorization_token>' 
'https://<source_hostname>:<source_rest_port>/dr/v1/replicationset/progress/<job_number>'

結果

表のリストのレプリケーションの開始は、 "executionState": "COMPLETED"、"overallJobResult": "PASS" を含む応答メッセージが返されたときに完了します。 これらの値が戻されるまで、応答内のエラー・コード、メッセージ、および解決を調べてください。
以下の表は、テーブル一覧のレプリケーション開始APIコールで使用可能な HTTP ステータス・コードと応答メッセージの一覧です。 また、応答構文を示すサンプル・コードも含まれています。
HTTP状況コード 理由 応答モデル
202 表サブスクリプションを開始するために CAPSTART コマンドが挿入されました。 ユーザー・リクエストは、APIコールの開始時にジョブ （id ）と URL （サンプル値）を返す：
{
  "id": 15,
  "url": "https://dr-source1.ibm.com:31023/dr/v1/replicationset/progress/15"
}
ユーザー要求は、API 呼び出しの完了に対する正常な応答を返します (サンプル値)。
{
  "id": 15,
  "url": "https://dr-source1.ibm.com:31023/dr/v1/replicationset/progress/15",
  "executionState": "COMPLETED",
  "overallJobResult": "PASS",
  "jobStatusList": [
    {
      "jobKey": "startRepCg",
      "jobDescription": "Start replication for consistency group.",
      "execState": "COMPLETED",
      "jobResult": "PASS",
      "values": [],
      "errors": []
    }
  ]
}

}
4xx クライアント要求エラー 誤った形式の要求構文またはその他のクライアントの問題が原因で、ユーザー要求が満たされませんでした。
{
  "errorCode": "string",
  "errorMessage": "string",
  "errorResolution": "string"
}
5xx サーバー・エラー ユーザー要求は有効と思われましたが、サーバーの問題が原因で実行されませんでした:
{
  "errorCode": "string",
  "errorMessage": "string",
  "errorResolution": "string"
}

例

以下の例は、レプリケーション・セット RS_MPP_2のソース・データベースから表のリストのレプリケーションを開始するためのコマンド構文を示しています。 ステップ 1 を参照してください。
curl --insecure -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic ZHNhZG06aFRjT3dTTjR1RFo0N1Ew'  -d '{ "tableSubList": ["RSMPP20001_DSADM_T6C", "RSMPP20001_DSADM_T7C"]}' 'https://dr-source1.ibm.com:31023/dr/v1/replicationset/RS_MPP_2/RSMPP20001/start-tablesubs'

以下の例は、生成されたジョブ番号 15 を使用して、表のリストのレプリケーション開始の状況を検査するためのコマンド構文を示しています。 ステップ 2 を参照してください。


curl --insecure -X GET --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Basic ZHNhZG06aFRjT3dTTjR1RFo0N1Ew' 'https://dr-source1.ibm.com:31023/dr/v1/replicationset/progress/15'

次のタスク

テーブル一覧のレプリケーションを停止する