S3 Metadata 문제 해결 - Amazon Simple Storage Service
AWS 관리형 테이블 버킷 및 메타데이터 테이블을 삭제할 수 없음AWS 관리형 메타데이터 테이블에 대한 암호화 설정을 지정하거나 변경할 수 없음메타데이터 테이블 구성을 다시 만들려고 하면 오류가 발생함구성에서 인벤토리 테이블을 활성화할 수 없음구성에서 저널 테이블 레코드 만료를 활성화할 수 없음메타데이터 테이블을 쿼리할 수 없음특정 S3 Metadata AWS CLI 명령 및 API 작업을 사용하려고 하면 405 오류가 발생함

S3 Metadata 문제 해결

다음 정보를 사용하여 Amazon S3 Metadata로 작업할 때 발생할 수 있는 일반적인 문제를 진단하고 수정할 수 있습니다.

AWS 관리형 테이블 버킷 및 메타데이터 테이블을 삭제할 수 없음

메타데이터 테이블을 삭제하려면 먼저 범용 버킷에서 연결된 메타데이터 테이블 구성을 삭제해야 합니다. 자세한 내용은 메타데이터 테이블 구성 삭제 섹션을 참조하세요.

AWS 관리형 테이블 버킷을 삭제하려면 먼저 이 버킷과 연결된 모든 메타데이터 테이블 구성과 버킷의 모든 메타데이터 테이블을 삭제해야 합니다. 자세한 내용은 메타데이터 테이블 구성 삭제 및 메타데이터 테이블 삭제(을)를 참조하세요.

AWS 관리형 메타데이터 테이블에 대한 암호화 설정을 지정하거나 변경할 수 없음

메타데이터 테이블 구성을 만들 때 AWS Key Management Service(AWS KMS) 키(SSE-KMS)를 사용한 서버 측 암호화로 AWS 관리형 메타데이터 테이블을 암호화하도록 선택할 수 있습니다. SSE-KMS를 사용하기로 선택한 경우 범용 버킷과 동일한 리전에 고객 관리형 KMS 키를 제공해야 합니다. 테이블을 만드는 중에만 테이블에 대한 암호화 유형을 설정할 수 있습니다. AWS 관리형 테이블이 만들어진 후에는 암호화 설정을 변경할 수 없습니다. 메타데이터 테이블에 SSE-KMS를 지정하려면 특정 권한이 있어야 합니다. 자세한 내용은 Permissions for SSE-KMS를 참조하세요.

메타데이터 테이블의 암호화 설정이 기본 버킷 수준 암호화 설정보다 우선합니다. 테이블에 암호화 설정을 지정하지 않으면 버킷의 기본 암호화 설정을 상속합니다.

기본적으로 AWS 관리형 테이블 버킷은 Amazon S3 관리형 암호화 키를 사용한 서버 측 암호화(SSE-S3)를 사용하여 암호화됩니다. 첫 번째 메타데이터 구성을 만든 후 AWS Key Management Service(AWS KMS) 키를 사용한 서버 측 암호화(SSE-KMS)를 사용하도록 AWS 관리형 테이블 버킷의 기본 암호화 설정을 지정할 수 있습니다. 자세한 내용은 Encryption for AWS managed table buckets 및 테이블 버킷에서 AWS KMS 키(SSE-KMS)를 사용한 서버 측 암호화 지정 섹션을 참조하세요.

메타데이터 테이블 구성을 다시 만들려고 하면 오류가 발생함

메타데이터 테이블 구성을 삭제하면 구성만 삭제됩니다. 메타데이터 테이블 구성을 삭제하더라도 AWS 관리형 테이블 버킷과 메타데이터 테이블은 여전히 존재합니다.

메타데이터 테이블 구성을 삭제하고 동일한 범용 버킷에 대한 구성을 다시 만들려면 먼저 AWS 관리형 테이블 버킷에서 이전 저널 및 인벤토리 테이블을 수동으로 삭제해야 합니다. 그러지 않으면 새 메타데이터 테이블 구성 만들기에 실패합니다. 해당 테이블이 이미 존재하기 때문입니다.

메타데이터 테이블을 삭제하려면 메타데이터 테이블 삭제 섹션을 참조하세요.

구성에서 인벤토리 테이블을 활성화할 수 없음

2025년 7월 15일 이전에 S3 Metadata 구성을 만든 경우 해당 구성에서 인벤토리 테이블을 활성화할 수 없습니다. 인벤토리 테이블을 만들고 저널 테이블 레코드를 만료시킬 수 있도록 구성을 삭제하고 다시 만드는 것이 좋습니다. 자세한 내용은 2025년 7월 15일 이전에 만들어진 메타데이터 구성에 대한 인벤토리 테이블 활성화 섹션을 참조하세요.

구성에서 저널 테이블 레코드 만료를 활성화할 수 없음

2025년 7월 15일 이전에 S3 Metadata 구성을 만든 경우 해당 구성에서 저널 테이블 레코드 만료를 활성화할 수 없습니다. 저널 테이블 레코드를 만료시키고 인벤토리 테이블을 만들 수 있도록 구성을 삭제하고 다시 만드는 것이 좋습니다. 자세한 내용은 2025년 7월 15일 이전에 만들어진 메타데이터 구성에 대한 인벤토리 테이블 활성화 섹션을 참조하세요.

메타데이터 테이블을 쿼리할 수 없음

메타데이터 테이블을 쿼리할 수 없는 경우 다음을 확인하세요.

  • Amazon Athena 또는 Amazon Redshift를 사용하여 메타데이터 테이블을 쿼리하는 경우, 메타데이터 테이블 네임스페이스 이름을 따옴표(") 또는 백틱(`)으로 묶어야 합니다. 그러지 않으면 쿼리가 작동하지 않을 수 있습니다.

  • Amazon EMR 또는 기타 타사 엔진에서 Apache Spark를 사용하여 메타데이터 테이블을 쿼리하는 경우 Amazon S3 Tables Iceberg REST 엔드포인트를 사용하는 것이 좋습니다. 이 엔드포인트를 사용하지 않으면 쿼리가 성공적으로 실행되지 않을 수 있습니다. 자세한 내용은 Amazon S3 Tables Iceberg REST 엔드포인트를 사용하여 테이블에 액세스 섹션을 참조하세요.

  • 메타데이터 테이블을 쿼리할 수 있는 적절한 AWS Identity and Access Management(IAM) 권한이 있는지 확인합니다. 자세한 내용은 메타데이터 테이블 쿼리에 대한 권한 섹션을 참조하세요.

  • Amazon Athena를 사용하고 쿼리를 실행하려고 할 때 오류가 발생하는 경우 다음을 수행합니다.

    • Athena에서 쿼리를 실행하려고 할 때 “쿼리를 실행할 권한이 충분하지 않습니다. 위탁자는 지정된 리소스에 대한 권한이 없습니다." 오류가 표시되면 테이블에서 필요한 Lake Formation 권한이 부여되어야 합니다. 자세한 내용은 테이블 또는 데이터베이스에 대한 Lake Formation 권한 부여 섹션을 참조하세요.

    • 쿼리를 실행하려고 할 때 "Iceberg가 요청된 리소스에 액세스할 수 없음" 오류가 표시되면 AWS Lake Formation 콘솔로 이동하여 생성한 테이블 버킷 카탈로그 및 데이터베이스(네임스페이스)에 대한 권한을 자신에게 부여했는지 확인합니다. 이러한 권한을 부여할 때 테이블을 지정하지 마십시오. 자세한 내용은 테이블 또는 데이터베이스에 대한 Lake Formation 권한 부여 섹션을 참조하세요.

특정 S3 Metadata AWS CLI 명령 및 API 작업을 사용하려고 하면 405 오류가 발생함

V1 GetBucketMetadataTableConfiguration API 작업을 직접적으로 호출하거나 V2 메타데이터 테이블 구성을 기준으로 get-bucket-metadata-table-configuration AWS Command Line Interface(AWS CLI) 명령을 사용하면 HTTP 405 Method Not Allowed 오류가 발생합니다. 마찬가지로 V1 DeleteBucketMetadataTableConfiguration API 작업을 직접적으로 호출하거나 delete-bucket-metadata-table-configuration AWS CLI 명령을 사용해도 405 오류가 발생합니다.

V1 또는 V2 메타데이터 테이블 구성을 기준으로 V2 GetBucketMetadataConfiguration API 작업 또는 get-bucket-metadata-configuration AWS CLI 명령을 사용할 수 있습니다. 마찬가지로 V1 또는 V2 메타데이터 테이블 구성을 기준으로 V2 DeleteBucketMetadataConfiguration API 작업 또는 delete-bucket-metadata-configuration AWS CLI 명령을 사용할 수 있습니다.

V1 API 작업 대신 새 V2 API 작업(CreateBucketMetadataConfiguration, GetBucketMetadataConfiguraion 및 DeleteBucketMetadataConfiguration)을 사용하도록 프로세스를 업데이트하는 것이 좋습니다. S3 Metadata의 V1에서 V2로 마이그레이션하는 방법에 대한 자세한 내용은 2025년 7월 15일 이전에 만들어진 메타데이터 구성에 대한 인벤토리 테이블 활성화 섹션을 참조하세요.

구성이 V1인지 V2인지 확인하려면 GetBucketMetadataConfiguration API 응답의 다음 속성을 볼 수 있습니다. AWS 관리형 버킷 유형("aws")은 V2 구성을 나타내고 고객 관리형 버킷 유형("customer")은 V1 구성을 나타냅니다.

"MetadataTableConfigurationResult": {
            "TableBucketType": ["aws" | "customer"]

자세한 내용은 메타데이터 테이블 구성 보기 섹션을 참조하세요.