CREATE DATABASE - Amazon Athena

CREATE DATABASE

데이터베이스를 생성합니다. DATABASESCHEMA는 동일한 의미로 통용됩니다. 두 용어의 의미는 동일합니다.

참고

데이터베이스 생성, 테이블 생성 및 Athena의 테이블에서 SELECT 쿼리 실행에 대한 예제는 시작하기 항목을 참조하세요.

시놉시스

CREATE {DATABASE|SCHEMA} [IF NOT EXISTS] database_name [COMMENT 'database_comment'] [LOCATION 'S3_loc'] [WITH DBPROPERTIES ('property_name' = 'property_value') [, ...]]

파라미터

[IF NOT EXISTS]

database_name이라는 데이터베이스가 이미 있으면 오류가 억제되도록 합니다.

[COMMENT database_comment]

comment라는 내장 메타데이터 속성의 메타데이터 값과 database_comment에 입력하는 값을 설정합니다. AWS Glue에서 COMMENT 콘텐츠는 데이터베이스 속성의 Description 필드에 작성됩니다.

[LOCATION S3_loc]

데이터베이스 파일과 메타 스토어가 존재할 위치를 S3_loc로 지정합니다. 이 위치는 Amazon S3 위치여야 합니다.

[WITH DBPROPERTIES ('property_name' = 'property_value') [, ...] ]

데이터베이스 정의에 사용자 지정 메타데이터 속성을 지정할 수 있습니다.

예제

CREATE DATABASE clickstreams;
CREATE DATABASE IF NOT EXISTS clickstreams COMMENT 'Site Foo clickstream data aggregates' LOCATION 's3://DOC-EXAMPLE-BUCKET/clickstreams/' WITH DBPROPERTIES ('creator'='Jane D.', 'Dept.'='Marketing analytics');

데이터베이스 속성 보기

CREATE DATABASE를 사용해 AWSDataCatalog에 생성한 데이터베이스의 데이터베이스 속성을 보려면 다음 예시처럼 AWS CLI 명령 aws glue get-database를 사용합니다.

aws glue get-database --name <your-database-name>

JSON 출력에서 결과가 다음과 같이 보입니다.

{ "Database": { "Name": "<your-database-name>", "Description": "<your-database-comment>", "LocationUri": "s3://DOC-EXAMPLE-BUCKET", "Parameters": { "<your-database-property-name>": "<your-database-property-value>" }, "CreateTime": 1603383451.0, "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ] } }

AWS CLI에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하세요.