Amazon Keyspaces에서 기존 테이블에 대한 CDC 스트림 활성화 - Amazon Keyspaces(Apache Cassandra용)

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

Amazon Keyspaces에서 기존 테이블에 대한 CDC 스트림 활성화

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

테이블에서 변경된 각 행에 대해 Amazon Keyspaces는 선택한 view_type의에 따라 다음과 같은 변경 사항을 캡처cdc_specification할 수 있습니다.

  • 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. 완료하려면 변경 사항 저장을 선택합니다.