Amazon QLDB에서 CREATE TABLE - Amazon Quantum Ledger Database(QLDB)
구문파라미터반환 값테이블 생성 시 태그 지정예시드라이버를 사용하여 프로그래밍 방식으로 실행

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon QLDB에서 CREATE TABLE

Amazon QLDB에서는 CREATE TABLE 명령을 사용하여 새 테이블을 생성합니다.

테이블에는 네임스페이스가 없는 단순한 이름이 있습니다. QLDB는 개방형 콘텐츠를 지원하며 스키마를 적용하지 않으므로 테이블을 만들 때 속성이나 데이터 유형을 정의하지 않습니다.

참고

원장에서 이 PartiQL 명령을 실행하기 위한 액세스를 제어하는 방법을 알아보려면 Amazon QLDB에서 표준 권한 모드로 시작하기을 참조하세요.

구문

CREATE TABLE table_name [ WITH (aws_tags = `{'key': 'value'}`) ]

파라미터

table_name

생성할 테이블의 고유 이름입니다. 같은 이름의 활성 테이블이 이미 존재하지 않아야 합니다. 다음은 명명 제약 조건입니다.

  • 1~128자의 영숫자 또는 밑줄만 포함해야 합니다.

  • 첫 번째 글자에는 문자 또는 밑줄이 있어야 합니다.

  • 영숫자와 밑줄을 조합하여 나머지 문자에 사용할 수 있습니다.

  • 대소문자를 구분합니다.

  • QLDB PartiQL 예약어가 아니어야 합니다.

'key': 'value'

(선택 사항)생성 중에 테이블 리소스에 연결할 태그입니다. 각 태그는 키-값 쌍으로 정의되며, 키와 값은 각각 작은 따옴표로 표시됩니다. 각 키-값 쌍은 백틱으로 표시되는 Amazon Ion 구조 내에 정의됩니다.

테이블 생성 시 태그 지정은 현재 ‭STANDARD 권한 모드의 원장에만 지원됩니다.

반환 값

tableId – 생성한 테이블의 고유 ID입니다.

테이블 생성 시 태그 지정

참고

테이블 생성 시 태그 지정은 현재 ‭STANDARD 권한 모드의 원장에만 지원됩니다.

선택적으로 CREATE TABLE 문에 태그를 지정하여 테이블 리소스에 태그를 지정할 수 있습니다. 태그에 대한 자세한 내용은 Amazon QLDB 리소스 태그 지정 섹션을 참조하세요. 다음 예제에서는 ‭environment=production‬ 태그가 있는 ‭Vehicle‬이라는 테이블을 생성합니다.

CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'production'}`)

생성 시 테이블에 태그를 지정하려면 qldb:PartiQLCreateTable 및 qldb:TagResource 작업 모두에 액세스할 수 있어야 합니다. QLDB 리소스 권한에 대한 자세한 내용은 Amazon QLDB에서 IAM을 사용하는 방법 섹션을 참조하세요.

리소스를 생성하는 동안 태그를 지정하면 리소스 생성 후 사용자 지정 태그 지정 스크립트를 실행할 필요가 없습니다. 테이블에 태그가 지정된 후 해당 태그를 기반으로 테이블에 대한 액세스를 제어할 수 있습니다. 예를 들어 특정 태그가 있는 테이블에만 전체 액세스 권한을 부여할 수 있습니다. JSON 정책의 예는 테이블 태그를 기반으로 하는 모든 작업에 대한 전체 액세스 권한 섹션을 참조하세요.

예시

CREATE TABLE VehicleRegistration
CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'development'}`)
CREATE TABLE Vehicle WITH (aws_tags = `{'key1': 'value1', 'key2': 'value2'}`)

드라이버를 사용하여 프로그래밍 방식으로 실행

QLDB 드라이버를 사용하여 이 명령문을 프로그래밍 방식으로 실행하는 방법을 알아보려면 드라이버 시작하기에서 다음 자습서를 참조하세요.