View a markdown version of this page

ロールバック後にフェーズ 2 の KCL 3.5.x 以降にロールフォワードする - Amazon DynamoDB
ステップ 1: KCL 移行ツールを実行するステップ 2: フェーズ 2 の設定でコードをデプロイする

ロールバック後にフェーズ 2 の KCL 3.5.x 以降にロールフォワードする

このトピックでは、ロールバック後にコンシューマーアプリケーションを KCL 3.5.x 以降にロールフォワードする方法について説明します。ロールフォワードが必要な場合は、2 ステップのプロセスを完了する必要があります。

  1. GitHub ウェブサイトの KCL 移行ツールを実行します。

  2. フェーズ 2 のコードをデプロイします。

ステップ 1: KCL 移行ツールを実行する

次のコマンドを使用して KCL 移行ツールを実行し、KCL 3.5.x 以降にロールフォワードします。

python3 ./KclMigrationTool.py --region region --mode rollforward [--application_name applicationName] [--lease_table_name leaseTableName]

パラメータ

--region

リージョンをお客様の AWS リージョンに置き換えてください。

--application_name

このパラメータは、リーステーブルにデフォルト名を使用している場合に必要です。リーステーブルにカスタム名を指定している場合は、このパラメータを省略できます。applicationName を実際の KCL アプリケーションの名前に置き換えます。カスタム名が指定されていない場合、ツールはこの名前を使用してデフォルトのテーブル名を取得します。

--lease_table_name

このパラメータは、KCL 設定でリーステーブルのカスタム名を設定している場合に必要です。デフォルトのテーブル名を使用している場合は、このパラメータを省略できます。leaseTableName をリーステーブルに指定したカスタムテーブル名に置き換えます。

移行ツールをロールフォワードモードで実行すると、KCL は KCL 3.5.x 以降に必要な次の DynamoDB リソースを作成します。

  • リーステーブルのグローバルセカンダリインデックス

注記

KCL 3.5.x 以降では、移行中に個別のワーカーメトリクスやコーディネーター状態テーブルは作成されません。すべてのメタデータはリーステーブルに保存されます。

ステップ 2: フェーズ 2 の設定でコードをデプロイする

ロールフォワードの KCL 移行ツールを実行したら、KCL 3.5.x 以降のフェーズ 2 の設定 (CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X) を使用してコードをワーカーにデプロイします。移行を完了するには、「ステップ 8: 移行を完了する」を参照してください。