Amazon S3 테이블 버킷, 테이블 및 네임스페이스 이름 지정 규칙

테이블 버킷을 생성할 때 버킷 이름과 AWS 리전을 선택합니다. 이름은 선택한 리전의 계정에서 고유해야 합니다. 테이블 버킷을 생성한 후에는 버킷 이름 또는 리전을 변경할 수 없습니다. 테이블 버킷 이름은 특정 이름 지정 규칙을 따라야 합니다. 테이블 버킷과 그 안에 있는 테이블 및 네임스페이스의 이름 지정 규칙에 대한 자세한 내용은 다음 주제를 참조하세요.

테이블 버킷 이름 지정 규칙

Amazon S3 테이블 버킷을 생성할 때 테이블 버킷 이름을 지정합니다. 다른 버킷 유형과 마찬가지로 테이블 버킷의 이름을 바꿀 수 없습니다. 다른 버킷 유형과 달리 테이블 버킷은 글로벌 네임스페이스에 존재하지 않으므로 계정의 각 버킷 이름은 현재 AWS 리전에서만 고유하면 됩니다.

범용 버킷의 이름 지정 규칙은 범용 버킷 이름 지정 규칙 섹션을 참조하세요. 디렉터리 버킷 이름 지정 규칙은 디렉터리 버킷 이름 지정 규칙 섹션을 참조하세요.

테이블 버킷에는 다음 이름 지정 규칙이 적용됩니다.

• 버킷 이름은 3자에서 63자 사이여야 합니다.

• 버킷 이름은 소문자, 숫자 및 하이픈(-)으로만 구성될 수 있습니다.

• 버킷 이름은 문자 또는 숫자로 시작하고 끝나야 합니다.

• 버킷 이름에는 밑줄(_) 또는 마침표(.)가 포함되어서는 안 됩니다.

• 버킷 이름은 다음과 같은 예약된 접두사로 시작해서는 안됩니다.

  • xn--

  • sthree-

  • amzn-s3-demo-

  • aws

• 버킷 이름은 다음과 같은 예약된 접미사로 끝나서는 안됩니다.

  • -s3alias

  • --ol-s3

  • --x-s3

  • --table-s3

테이블 및 네임스페이스의 이름 지정 규칙

테이블 버킷 내의 테이블 및 네임스페이스에는 다음 이름 지정 규칙이 적용됩니다.

• 이름은 1~255자 이내여야 합니다.

• 이름은 소문자, 숫자 및 밑줄(_)로만 구성될 수 있습니다.

• 이름은 글자 또는 숫자로 시작하고 끝나야 합니다.

• 이름에 하이픈(-) 또는 마침표(.)가 포함되어서는 안 됩니다.

• 테이블 이름은 네임스페이스 내에서 고유해야 합니다.

• 네임스페이스는 테이블 버킷 내에서 고유해야 합니다.

• 네임스페이스 이름은 예약된 접두사 aws로 시작되어서는 안됩니다.

중요

테이블을 만들 때 테이블 이름 및 테이블 정의에 모두 소문자를 사용해야 합니다. 예를 들어 열 이름이 모두 소문자인지 확인합니다. 테이블 이름 또는 테이블 정의에 대문자가 포함된 경우 테이블은 AWS Lake Formation 또는 AWS Glue Data Catalog에서 지원되지 않습니다. 이 경우 테이블 버킷이 AWS 분석 서비스와 통합되어 있더라도 Amazon Athena와 같은 AWS 분석 서비스에는 테이블이 표시되지 않습니다.

테이블 정의에 대문자가 포함된 경우 Athena에서 SELECT 쿼리를 실행할 때 "GENERIC_INTERNAL_ERROR: Get table request failed: com.amazonaws.services.glue.model.ValidationException: Unsupported Federation Resource - Invalid table or column names."라는 오류 메시지가 표시됩니다.