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

표

테이블은 Amazon Keyspaces의 기본 데이터 구조입니다. 테이블의 데이터는 행과 열로 구성됩니다. 이러한 열의 하위 집합은 파티션 키 지정을 통해 파티셔닝(및 데이터 배치)을 결정하는 데 사용됩니다.

또 다른 열 집합을 클러스터링 열로 정의할 수 있습니다. 즉, 이러한 열 집합을 쿼리 실행 시 조건자로 사용할 수 있습니다.

기본적으로 온디맨드 처리량 용량을 갖춘 새 테이블이 생성됩니다. 새 테이블과 기존 테이블의 용량 모드를 변경할 수 있습니다. 읽기/쓰기 용량 처리량 모드에 대한 자세한 내용은 Amazon Keyspaces의 읽기/쓰기 용량 모드 구성를 참조하세요.

프로비저닝된 모드의 테이블의 경우 선택적 AUTOSCALING_SETTINGS를 구성할 수 있습니다. Amazon Keyspaces 오토 스케일링 및 사용 가능한 옵션에 대한 자세한 내용은 기존 테이블에서 오토 스케일링 구성 섹션을 참조하세요.

Amazon Keyspaces 테이블의 할당량 한도 및 제약 조건에 대한 자세한 내용은 Amazon Keyspaces(Apache Cassandra용)에 대한 할당량을 참조하세요.

CREATE TABLE

CREATE TABLE 문을 사용하여 새 테이블을 만듭니다.

구문

create_table_statement ::=  CREATE TABLE [ IF NOT EXISTS ] table_name
    '('
        column_definition 
        ( ',' column_definition )*
        [ ',' PRIMARY KEY '(' primary_key ')' ]
    ')' [ WITH table_options ]

column_definition      ::=  column_name cql_type [ FROZEN ][ STATIC ][ PRIMARY KEY]

primary_key            ::=  partition_key [ ',' clustering_columns ]

partition_key          ::=  column_name
                              | '(' column_name ( ',' column_name )* ')'

clustering_columns     ::=  column_name ( ',' column_name )*

table_options          ::=  [table_options]
                              | CLUSTERING ORDER BY '(' clustering_order ')' [ AND table_options ]
                              | options
                              | CUSTOM_PROPERTIES
                              | AUTOSCALING_SETTINGS
                              | default_time_to_live
                              | TAGS

clustering_order       ::=  column_name (ASC | DESC) ( ',' column_name (ASC | DESC) )*

위치:

예

CREATE TABLE IF NOT EXISTS my_keyspace.my_table (
                                            id text,
                                            name text,
                                            region text,
                                            division text,
                                            project text,
                                            role text,
                                            pay_scale int,
                                            vacation_hrs float,
                                            manager_id text,
                                            PRIMARY KEY (id,division))
                                            WITH CUSTOM_PROPERTIES={
                                                'capacity_mode':{
                                                        'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20
                                                    },
                                                'point_in_time_recovery':{'status': 'enabled'},
                                                'encryption_specification':{
                                                        'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                                                        'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'
                                                    }
                                            }
                                            AND CLUSTERING ORDER BY (division ASC) 
                                            AND TAGS={'key1':'val1', 'key2':'val2'}
                                            AND default_time_to_live = 3024000;

클러스터링 열을 사용하는 테이블의 경우 테이블 정의에서 클러스터링이 아닌 열을 고정으로 선언할 수 있습니다. 정적 열에 대한 자세한 내용은 Amazon Keyspaces의 정적 열에 대한 용량 소비 추정을 참조하세요.

예

CREATE TABLE my_keyspace.my_table (
                                            id int,
                                            name text,
                                            region text,
                                            division text,
                                            project text STATIC,
                                            PRIMARY KEY (id,division));

사용자 정의 유형(UDT)을 사용하는 열로 테이블을 생성할 수 있습니다. 예제의 첫 번째 문은 유형을 생성하고 두 번째 문은 유형을 사용하는 열이 있는 테이블을 생성합니다.

예

CREATE TYPE my_keyspace."udt""N@ME" (my_field int);
CREATE TABLE my_keyspace.my_table (my_col1 int pri key, my_col2 "udt""N@ME");

ALTER TABLE

ALTER TABLE 문을 사용하여 새 열을 추가하거나, 태그를 추가하거나, 테이블의 사용자 지정 속성을 변경합니다.

구문

alter_table_statement ::=  ALTER TABLE table_name    
 
        [ ADD ( column_definition | column_definition_list)  ] 
        [[ADD | DROP] TAGS {'key1':'val1', 'key2':'val2'}]            
        [ WITH table_options [ , ... ] ] ;
        
column_definition      ::=  column_name cql_type
                    
                

위치:

예제

다음 문은 기존 테이블에 열을 추가하는 방법을 보여줍니다.

ALTER TABLE mykeyspace.mytable ADD (ID int);

이 문은 기존 테이블에 두 개의 수집 열을 추가하는 방법을 보여줍니다.

ALTER TABLE my_Table ADD(col_frozen_list FROZEN<LIST<FROZEN<SET<TEXT>>>>, col_map MAP<INT, FROZEN<SET<INT>>>);

다음 예제에서는 사용자 정의 유형(UDT)을 사용하는 열을 테이블에 추가하는 방법을 보여줍니다.

ALTER TABLE my_keyspace.my_table ADD (my_column, my_udt;);

테이블의 용량 모드를 변경하고 읽기 및 쓰기 용량 단위를 지정하려면 다음 문을 사용할 수 있습니다.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}};

다음 문은 테이블의 고객 관리형 KMS 키를 지정합니다.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={     
              'encryption_specification':{ 
                      'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                      'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'     
                  } 
         };

테이블에 대해 시점 복원을 활성화하려면 다음 문을 사용할 수 있습니다.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'point_in_time_recovery': {'status': 'enabled'}};

테이블의 기본 Time to Live 값을 초 단위로 설정하려면 다음 문을 사용할 수 있습니다.

ALTER TABLE my_table WITH default_time_to_live = 2592000;

이 문을 사용하면 테이블의 Time to Live 설정을 사용자 지정할 수 있습니다.

ALTER TABLE mytable WITH CUSTOM_PROPERTIES={'ttl':{'status': 'enabled'}};

RESTORE TABLE

RESTORE TABLE 문을 사용하여 테이블을 특정 시점으로 복원합니다. 이 문을 사용하려면 테이블의 시점 복구가 활성화되어 있어야 합니다. 자세한 내용은 Amazon Keyspaces에 대한 시점 복구를 통한 데이터 백업 및 복원 단원을 참조하십시오.

구문

restore_table_statement ::=  
    RESTORE TABLE restored_table_name FROM TABLE source_table_name 
                    [ WITH table_options [ , ... ] ];

위치:

예

RESTORE TABLE mykeyspace.mytable_restored from table mykeyspace.my_table 
WITH restore_timestamp = '2020-06-30T04:05:00+0000'
AND custom_properties = {'point_in_time_recovery':{'status':'disabled'}, 'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}}
AND TAGS={'key1':'val1', 'key2':'val2'};

DROP TABLE

DROP TABLE 문을 사용하여 키스페이스에서 테이블을 제거합니다.

구문

drop_table_statement ::=  
    DROP TABLE [ IF EXISTS ] table_name

위치:

예

DROP TABLE my_keyspace.my_table;