쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

Amazon Keyspaces의 데이터 정의 언어 오류 문제 해결

포커스 모드

이 페이지에서

Amazon Keyspaces의 데이터 정의 언어 오류 문제 해결 - Amazon Keyspaces(Apache Cassandra용)

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

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

리소스 생성에 문제가 있으신가요? 다음에서는 몇 가지 일반적인 문제와 이에 대한 해결 방법에 대해 설명합니다.

데이터 정의 언어 오류

Amazon Keyspaces는 키스페이스 및 테이블 생성 및 삭제와 같이 데이터 정의 언어(DDL) 작업을 비동기적으로 수행합니다. 애플리케이션이 준비가 되기 전에 리소스를 사용하려고 하면 작업이 실패합니다.

에서 새 키스페이스 및 테이블의 생성 상태를 모니터링할 수 있습니다. AWS Management Console이는 키스페이스 또는 테이블이 보류 중이거나 활성 상태인 경우를 나타냅니다. 또한 시스템 스키마 테이블을 쿼리하여 프로그래밍 방식으로 새 키스페이스 또는 테이블의 생성 상태를 모니터링할 수 있습니다. 키스페이스 또는 테이블을 사용할 준비가 되면 시스템 스키마에 해당 키스페이스나 테이블이 표시됩니다.

참고

를 사용하여 키스페이스 생성을 최적화하려면이 유틸리티를 사용하여 CQL 스크립트를 CloudFormation 템플릿으로 변환 AWS CloudFormation할 수 있습니다. 도구는 GitHub 리포지토리에서 사용할 수 있습니다.

새 키스페이스를 생성했지만 해당 키스페이스를 보거나 액세스할 수 없음

새 키스페이스에 액세스하려는 애플리케이션에서 오류가 발생합니다.

아직 비동기적으로 생성 중인 새로 생성된 Amazon Keyspaces 키스페이스에 액세스하려고 하면 오류가 발생합니다. 다음은 오류의 예입니다.

InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured keyspace mykeyspace"

새 키스페이스를 사용할 준비가 되면 확인하는 권장 설계 패턴은 Amazon Keyspaces 시스템 스키마 테이블(system_schema_mcs.*)을 폴링하는 것입니다.

자세한 내용은 Amazon Keyspaces에서 키스페이스 생성 상태 확인 단원을 참조하십시오.

새 테이블을 생성했지만 해당 테이블을 보거나 액세스할 수 없음

새 테이블에 액세스하려는 애플리케이션에서 오류가 발생합니다.

아직 비동기적으로 생성 중인 새로 생성된 Amazon Keyspaces 테이블에 액세스하려고 하면 오류가 발생합니다. 예를 들어 아직 사용할 수 없는 테이블을 쿼리하려고 하면 unconfigured table 오류로 실패합니다.

InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured table mykeyspace.mytable"

sync_table()을 사용하여 테이블을 보려고 하면 KeyError로 실패합니다.

KeyError: 'mytable'

새 테이블을 사용할 준비가 되면 확인하는 권장 설계 패턴은 Amazon Keyspaces 시스템 스키마 테이블(system_schema_mcs.*)을 폴링하는 것입니다.

다음은 생성 중인 테이블의 예제 출력입니다.

user-at-123@cqlsh:system_schema_mcs> select table_name,status from system_schema_mcs.tables where keyspace_name='example_keyspace' and table_name='example_table'; table_name | status ------------+---------- example_table | CREATING (1 rows)

다음은 활성화된 테이블의 예제 출력입니다.

user-at-123@cqlsh:system_schema_mcs> select table_name,status from system_schema_mcs.tables where keyspace_name='example_keyspace' and table_name='example_table'; table_name | status ------------+---------- example_table | ACTIVE (1 rows)

자세한 내용은 Amazon Keyspaces에서 테이블 생성 상태 확인 단원을 참조하십시오.

Amazon Keyspaces 복구(PITR)를 사용하여 테이블을 point-in-time 복원하려고 하지만 복원이 실패합니다.

복구(PITR)를 사용하여 point-in-time Amazon Keyspaces 테이블을 복원하려고 하는데 복원 프로세스가 시작되었지만 성공적으로 완료되지 않은 경우이 특정 테이블에 대한 복원 프로세스에 필요한 모든 필수 권한을 구성하지 않았을 수 있습니다.

사용자 권한 외에도 Amazon Keyspaces는 보안 주체를 대신하여 복원 프로세스 중에 작업을 수행할 수 있는 권한을 요구할 수 있습니다. 테이블이 고객 관리형 키로 암호화되거나 수신 트래픽을 제한하는 IAM 정책을 사용하는 경우입니다.

예를 들어 IAM 정책에서 조건 키를 사용하여 소스 트래픽을 특정 엔드포인트 또는 IP 범위로 제한하는 경우 복원 작업이 실패합니다. Amazon Keyspaces가 보안 주체를 대신하여 테이블 복원 작업을 수행하도록 허용하려면 IAM 정책에 aws:ViaAWSService 전역 조건 키를 추가해야 합니다.

테이블 복원 권한에 대한 자세한 내용은 Amazon Keyspaces PITR에 대한 복원 테이블 IAM 권한 구성 섹션을 참조하세요.

INSERT/UPDATE를 사용하여 사용자 지정 Time to Live(TTL) 설정을 편집하려고 하지만 작업이 실패합니다.

사용자 지정 TTL 값을 삽입하거나 업데이트하려는 경우 다음 오류와 함께 작업이 실패할 수 있습니다.

TTL is not yet supported.

INSERT 또는 UPDATE 작업을 사용하여 행 또는 열에 대한 사용자 지정 TTL 값을 지정하려면 먼저 테이블에 TTL 대해를 활성화해야 합니다. ttl 사용자 지정 속성을 사용하여 테이블에 TTL 대해를 활성화할 수 있습니다.

테이블에 대한 사용자 지정 TTL 설정 활성화에 대한 자세한 내용은 섹션을 참조하세요사용자 지정 TTL(Time to Live)로 테이블 업데이트.

Amazon Keyspaces 테이블에 데이터를 업로드하려고 하는데 열 수를 초과한다는 오류가 발생함

데이터를 업로드하고 있는데 동시에 업데이트할 수 있는 열 수를 초과했습니다.

이 오류는 테이블 스키마가 최대 크기인 350KB를 초과할 때 발생합니다. 자세한 내용은 Amazon Keyspaces(Apache Cassandra용)에 대한 할당량 단원을 참조하십시오.

Amazon Keyspaces 테이블에서 데이터를 삭제하려고 하는데 해당 범위에서 삭제가 실패함

파티션 키로 데이터를 삭제하려고 하는데 범위 삭제 오류가 발생했습니다.

이 오류는 한 번의 삭제 작업으로 1,000개 이상의 행을 삭제하려고 할 때 발생합니다.

Range delete requests are limited by the amount of items that can be deleted in a single range.

자세한 내용은 범위 삭제 단원을 참조하십시오.

단일 파티션 내에서 1,000개가 넘는 행을 삭제하려면 다음 옵션을 고려해 보세요.

  • 파티션별 삭제 - 파티션 대다수가 1,000행 미만인 경우 파티션별로 데이터를 삭제해 볼 수 있습니다. 파티션에 1,000개 이상의 행이 포함된 경우 대신 클러스터링 열을 기준으로 삭제를 시도합니다.

  • 클러스터링 열별 삭제 - 모델에 클러스터링 열이 여러 개 있는 경우 열 계층 구조를 사용하여 여러 행을 삭제할 수 있습니다. 클러스터링 열은 중첩 구조이므로 최상위 열에 대해 작업하여 많은 행을 삭제할 수 있습니다.

  • 개별 행별 삭제 - 행을 반복하고 전체 프라이머리 키(파티션 열 및 클러스터링 열)로 각 행을 삭제할 수 있습니다.

  • 행을 여러 파티션으로 분할하는 것이 가장 좋습니다. Amazon Keyspaces에서는 처리량을 테이블 파티션에 분산하는 것이 좋습니다. 이렇게 하면 물리적 리소스 전체에 데이터와 액세스가 균등하게 분산되므로 처리량이 가장 좋습니다. 자세한 내용은 데이터 모델링 모범 사례: 데이터 모델 설계를 위한 권장 사항 단원을 참조하십시오.

워크로드가 많은 삭제 작업을 계획할 때는 다음 권장 사항도 고려해 보세요.

  • Amazon Keyspaces를 사용하면 파티션에 사실상 무제한의 행이 포함될 수 있습니다. 이를 통해 기존 Cassandra 지침인 100MB보다 “더 넓게” 파티션을 확장할 수 있습니다. 시간이 지남에 따라 시계열 또는 원장의 데이터가 1기가바이트 이상 증가하는 것은 드문 일이 아닙니다.

  • Amazon Keyspaces를 사용하면 과중한 워크로드로 인해 삭제 작업을 수행해야 할 때 고려할 압축 전략이나 삭제 표시가 없습니다. 읽기 성능에 영향을 주지 않으면서 원하는 만큼 데이터를 삭제할 수 있습니다.

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.