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

테이블 버킷을 만들 때 버킷 이름과 AWS 리전을 선택하는데, 그 이름은 선택한 리전의 계정에서 고유해야 해요. 테이블 버킷을 만든 후에는 버킷 이름이나 리전을 변경할 수 없어요. 테이블 버킷 이름은 특정 이름 지정 규칙을 따라야 해요. 테이블 버킷과 그 안의 테이블 및 네임스페이스의 이름 지정 규칙에 대한 자세한 내용은 다음 주제를 참고하세요.

테이블 버킷 이름 지정 규칙
테이블과 네임스페이스의 이름 지정 규칙

출처: Amazon S3 table bucket, table, and namespace naming rules

본문

테이블 버킷 이름 지정 규칙

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."

더 알아보기 (Learn more)

테이블 버킷 만들기
Amazon S3 테이블 버킷 세부 정보 보기