View a markdown version of this page

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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

KCL 3.5.x からのロールバック後に KCL 3.5.x にロールフォワードする

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

  1. 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: を <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: 移行を完了する に従って移行を完了します。