테이블 네임스페이스는 Amazon S3 Tables 버킷으로 테이블을 그룹화하는 논리적 구문입니다. 각 테이블은 단일 네임스페이스에 속합니다. 테이블 버킷에 테이블을 생성하기 전에 테이블을 그룹화할 네임스페이스를 생성해야 합니다. Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK 또는 통합 쿼리 엔진을 사용하여 네임스페이스를 생성할 수 있습니다.
네임스페이스 이름
네임스페이스에는 다음 이름 지정 규칙이 적용됩니다.
-
이름은 1~255자 이내여야 합니다.
-
이름은 소문자, 숫자 및 밑줄(
_)로만 구성될 수 있습니다. 네임스페이스 이름 시작에는 밑줄이 허용되지 않습니다. -
이름은 글자 또는 숫자로 시작하고 끝나야 합니다.
-
이름에 하이픈(
-) 또는 마침표(.)가 포함되어서는 안 됩니다.
유효한 네임스페이스 이름에 대한 자세한 내용은 테이블 및 네임스페이스의 이름 지정 규칙 섹션을 참조하세요.
다음 절차에서는 Athena로 테이블 생성 워크플로를 사용하여 Amazon S3 콘솔에서 네임스페이스를 생성합니다. Amazon Athena를 사용하여 네임스페이스에 테이블을 생성하지 않으려면 네임스페이스를 생성한 후 워크플로를 취소할 수 있습니다.
네임스페이스를 생성하려면
AWS Management Console에 로그인한 후 https://console.aws.amazon.com/s3/
에서 Amazon S3 콘솔을 엽니다. -
왼쪽 탐색 창에서 테이블 버킷을 선택합니다.
-
테이블 버킷 페이지에서 네임스페이스를 생성할 버킷을 선택합니다.
-
버킷 세부 정보 페이지에서 Athena로 테이블 생성을 선택합니다.
-
Athena로 테이블 생성 대화 상자에서 네임스페이스 생성을 선택한 다음 네임스페이스 생성을 선택합니다.
-
네임스페이스 이름 필드에 이름을 입력합니다. 네임스페이스 이름은 1~255자여야 하며 테이블 버킷 내에서 고유해야 합니다. 유효한 문자는 a-z, 0-9 및 밑줄(
_)입니다. 네임스페이스 이름 시작에는 밑줄이 허용되지 않습니다. -
Create namespace(네임스페이스 생성)를 선택합니다.
-
테이블도 생성하려면 Athena로 테이블 생성을 선택합니다. Athena를 사용하여 테이블을 생성하는 방법에 대한 자세한 내용은 S3 콘솔 및 Amazon Athena 사용 섹션을 참조하세요. 지금 테이블을 생성하지 않으려면 취소를 선택합니다.
이 예시에서는 AWS CLI를 사용하여 테이블 네임스페이스를 생성하는 방법을 보여줍니다. 이 예제를 사용하려면 user input placeholders
aws s3tables create-namespace \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1\ --namespaceexample_namespace
Amazon S3 테이블 버킷에 연결된 Apache Spark 세션에서 네임스페이스를 생성할 수 있습니다.
이 예시에서는 S3 Tables과 통합된 쿼리 엔진에서 CREATE 문을 사용하여 테이블을 생성하는 방법을 보여줍니다. 이 예시를 사용하려면 사용자 입력 자리 표시자를 실제 정보로 대체하세요.
spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")
