本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

資料表

資料表是 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'     
                  } 
         };

若要啟用資料表的point-in-time還原，您可以使用下列陳述式。

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

若要設定資料表的預設存留時間值，以秒為單位，您可以使用下列陳述式。

ALTER TABLE my_table WITH default_time_to_live = 2592000;

此陳述式會啟用資料表的自訂存留時間設定。

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

RESTORE 資料表

使用 RESTORE TABLE陳述式將資料表還原至某個時間點。此陳述式需要在資料表上啟用point-in-time復原。如需詳細資訊，請參閱使用 point-in-time復原來備份和還原資料。

語法

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;