View a markdown version of this page

ロールバック後に KCL 3.x にロールフォワードする - Amazon DynamoDB

ロールバック後に KCL 3.x にロールフォワードする

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

  1. KCL 移行ツールを実行します。

  2. KCL 3.x を使用してコードをデプロイします。

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

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

python3 ./KclMigrationTool.py --region region --mode rollforward [--application_name applicationName] [--coordinator_state_table_name coordinatorStateTableName]

パラメータ

--region

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

--application_name

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

--coordinator_state_table_name

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

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

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

  • ワーカーメトリクステーブル

ステップ 2: KCL 3.x を使用してコードをデプロイする

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