기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Keyspaces에서 기존 테이블에 대한 CDC 스트림 활성화
<a name="keyspaces-enable-cdc-alter-table"></a>

기존 테이블에 대해 CDC 스트림을 활성화하려면 CQL의 `ALTER TABLE` 문, `update-table` 명령을와 함께 사용하거나 콘솔을 사용할 AWS CLI수 있습니다.

테이블에서 변경된 각 행에 대해 Amazon Keyspaces는 선택한 `view_type`의에 따라 다음과 같은 변경 사항을 캡처`cdc_specification`할 수 있습니다.
+ `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 Management Console하고 [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. 완료하려면 **변경 사항 저장**을 선택합니다.

------