네임스페이스 만들기

네임스페이스 만들기 (Creating a namespace)

테이블 네임스페이스는 Amazon S3 테이블 버킷 안에서 테이블을 묶어 두는 논리적 구성이에요. 각 테이블은 하나의 네임스페이스에 속해요. 테이블 버킷에 테이블을 만들기 전에 테이블을 묶을 네임스페이스를 먼저 만들어야 해요. 네임스페이스는 Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK, 통합 쿼리 엔진으로 만들 수 있어요.

출처: 문서

본문

네임스페이스 이름 규칙

네임스페이스에는 다음 명명 규칙이 적용돼요.

  • 이름은 1~255자 사이여야 해요.
  • 이름은 소문자, 숫자, 밑줄(_)만 사용할 수 있어요. 밑줄은 네임스페이스 이름의 시작이나 끝에 쓸 수 없어요.
  • 이름은 문자나 숫자로 시작하고 끝나야 해요.
  • 이름에 하이픈(-)이나 마침표(.)를 포함할 수 없어요.
  • 네임스페이스는 테이블 버킷 안에서 고유해야 해요.
  • 네임스페이스 이름은 예약된 접두어 aws로 시작하면 안 돼요.

유효한 네임스페이스 이름에 대한 자세한 내용은 "Naming rules for tables and namespaces" 문서를 참고하세요.

Amazon S3 콘솔에서 네임스페이스를 만들려면 다음 절차는 Create table with Athena 워크플로우를 사용해요. 네임스페이스 안에서 Amazon Athena로 테이블을 만들지 않으려면 네임스페이스 생성 후 워크플로우를 취소하면 돼요.

  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/s3/ 에서 Amazon S3 콘솔을 열어요.
  2. 왼쪽 탐색 창에서 Table buckets를 선택해요.
  3. Table buckets 페이지에서 네임스페이스를 만들 버킷을 선택해요.
  4. 버킷 세부 정보 페이지에서 Create table with Athena를 선택해요.
  5. Create table with Athena 대화 상자에서 Create a namespace를 선택한 다음 Create namespace를 선택해요.
  6. Namespace name 필드에 이름을 입력해요. 네임스페이스 이름은 1~255자여야 하고 테이블 버킷 안에서 고유해야 해요. 유효한 문자는 a–z, 0–9, 밑줄(_)이에요. 밑줄은 네임스페이스 이름의 시작이나 끝에 쓸 수 없어요.
  7. Create namespace를 선택해요.
  8. 테이블도 만들려면 Create table with Athena를 선택해요. Athena로 테이블을 만드는 방법에 대한 자세한 내용은 "Using the S3 console and Amazon Athena" 문서를 참고하세요. 지금 테이블을 만들지 않으려면 Cancel을 선택해요.

AWS CLI로 테이블 네임스페이스를 만드는 예시는 다음과 같아요. 이 예시를 사용할 때는 사용자 입력 자리표시자를 자신의 정보로 바꾸세요.

aws s3tables create-namespace \
    --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1 \
    --namespace example_namespace

Amazon S3 테이블 버킷에 연결된 Apache Spark 세션에서 네임스페이스를 만들 수도 있어요.

S3 Tables와 통합된 쿼리 엔진에서 CREATE 문으로 테이블을 만드는 예시는 다음과 같아요. 이 예시를 사용할 때는 사용자 입력 자리표시자를 자신의 정보로 바꾸세요.

spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")

더 알아보기 (Learn more)

  • 네임스페이스 (Namespaces)
  • 네임스페이스 삭제하기 (Delete a namespace)