Amazon Keyspaces で既存のテーブルの CDC ストリームを有効にする - Amazon Keyspaces (Apache Cassandra 向け)

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

Amazon Keyspaces で既存のテーブルの CDC ストリームを有効にする

既存のテーブルの CDC ストリームを有効にするには、CQL で ALTER TABLEステートメントを使用するか、 で update-table コマンドを使用するか AWS CLI、 コンソールを使用できます。

テーブル内の変更された行ごとに、Amazon Keyspaces はcdc_specification選択した view_typeの に基づいて次の変更をキャプチャできます。

  • NEW_AND_OLD_IMAGES – 変更前と変更後の両方のバージョンの行。これがデフォルトです。

  • NEW_IMAGE – 変更後の行のバージョン。

  • OLD_IMAGE – 変更前の行のバージョン。

  • KEYS_ONLY – 変更された行のパーティションキーとクラスタリングキー。

ストリームにタグを付ける方法については、「」を参照してくださいストリームに新しいタグを追加する。

注記

Amazon Keyspaces CDC には、ユーザーに代わって Amazon Keyspaces CDC ストリームから CloudWatch アカウントの "cloudwatch:namespace": "AWS/Cassandra" にメトリクスデータを発行するサービスにリンクされたロール (AWSServiceRoleForAmazonKeyspacesCDC) が必要です。このロールは自動的に作成されます。詳細については、「Amazon Keyspaces CDC ストリームのロールの使用」を参照してください。

Cassandra Query Language (CQL)
CQL でストリーム (CDC ストリーム) を有効にする

を使用してALTER TABLE、既存のテーブルのストリームを有効にできます。

  1. 次の例では、変更された行のパーティションキーとクラスタリングキーの変更のみをキャプチャするストリームを作成します。

    ALTER TABLE mykeyspace.mytable
WITH cdc = TRUE
WITH CUSTOM_PROPERTIES={'cdc_specification': {'view_type': 'KEYS_ONLY'}};

  2. ストリーム設定を確認するには、次のステートメントを使用できます。

    SELECT keyspace_name, table_name, cdc, custom_properties FROM system_schema_mcs.tables WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';

    ステートメントの出力は次のようになります。

     keyspace_name | table_name | cdc  | custom_properties
---------------+------------+------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
    mykeyspace |    mytable | True | {'capacity_mode': {'last_update_to_pay_per_request_timestamp': '1741385897045', 'throughput_mode': 'PAY_PER_REQUEST'}, 'cdc_specification': {'latest_stream_arn': 'arn:aws:cassandra:aws-region:111122223333:/keyspace/mykeyspace/table/mytable/stream/2025-03-07T22:20:10.454', 'status': 'ENABLED', 'view_type': 'KEYS_ONLY'}, 'encryption_specification': {'encryption_type': 'AWS_OWNED_KMS_KEY'}, 'point_in_time_recovery': {'status': 'disabled'}}
CLI
を使用して CDC ストリームを作成する AWS CLI

  1. 既存のテーブルのストリームを作成するには、次の構文を使用できます。

    aws keyspaces update-table \
--keyspace-name 'mykeyspace' \
--table-name 'mytable' \
--cdc-specification status=ENABLED,viewType=NEW_AND_OLD_IMAGES

  2. そのコマンドの出力は標準create-tableレスポンスを示し、この例のようになります。

    { "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/mykeyspace/table/mytable" }
Console
Amazon Keyspaces コンソールで CDC ストリームを有効にする

  1. にサインインし AWS Management Console、https://console.aws.amazon.com/keyspaces/home で Amazon Keyspaces コンソールを開きます。

  2. ナビゲーションペインで、テーブルを選択し、リストからテーブルを選択します。

  3. ストリームタブを選択します。

  4. 編集 を選択してストリームを有効にします。

  5. ストリームをオンにする を選択します。

  6. ストリームの表示タイプを選択します。以下のオプションが利用できます。作成後にストリームのビュータイプを変更することはできません。

    • 新しいイメージと古いイメージ – Amazon Keyspaces は、変更前と変更後の両方のバージョンの行をキャプチャします。これがデフォルトです。

    • 新しいイメージ – Amazon Keyspaces は、変更後の行のバージョンのみをキャプチャします。

    • 古いイメージ – Amazon Keyspaces は、変更前の行のバージョンのみをキャプチャします。

    • プライマリキーのみ – Amazon Keyspaces は、変更された行のパーティションとクラスタリングキー列のみをキャプチャします。

  7. 終了するには、変更の保存を選択します。