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

# Amazon Keyspaces で既存のテーブルの CDC ストリームを有効にする
<a name="keyspaces-enable-cdc-alter-table"></a>

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

テーブル内の変更された行ごとに、Amazon Keyspaces は、`cdc_specification`選択した `view_type`の に基づいて次の変更をキャプチャできます。
+ `NEW_AND_OLD_IMAGES` – 変更前と変更後の両方のバージョンの行。これがデフォルトです。
+ `NEW_IMAGE` – 変更後の行のバージョン。
+ `OLD_IMAGE` – 変更前の行のバージョン。
+ `KEYS_ONLY` – 変更された行のパーティションキーとクラスタリングキー。

ストリームにタグを付ける方法については、「」を参照してください[ストリームに新しいタグを追加する](Tagging.Operations.existing.stream.md)。

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

------
#### [ Cassandra Query Language (CQL) ]

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

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

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

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

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

   ```
   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:us-east-1: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
   ```

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

   ```
   { "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable" }
   ```

------
#### [ Console ]

**Amazon Keyspaces コンソールで CDC ストリームを有効にする**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

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

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

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

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

1. ストリームの表示**タイプ**を選択します。以下のオプションが利用できます。作成後にストリームのビュータイプを変更することはできません。
   + **新しいイメージと古いイメージ** – Amazon Keyspaces は、変更前と変更後の両方のバージョンの行をキャプチャします。これがデフォルトです。
   + **新しいイメージ** – Amazon Keyspaces は、変更後の行のバージョンのみをキャプチャします。
   + **古いイメージ** – Amazon Keyspaces は、変更前の行のバージョンのみをキャプチャします。
   + **プライマリキーのみ** – Amazon Keyspaces は、変更された行のパーティションとクラスタリングキー列のみをキャプチャします。

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

------