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

DDLAmazon Keyspaces 中的語句（數據定義語言）

數據定義語言（DDL）是一組卡桑德拉查詢語言（CQL）語句，用於管理 Amazon Keyspaces 中的數據結構（對於 Apache 卡桑德拉），如密鑰空間和表。您可DDL以使用建立這些資料結構、在建立資料結構後修改它們，並在不再使用時將其移除。Amazon Keyspaces 以異步方式執行DDL操作。如需如何確認非同步作業是否已完成的詳細資訊，請參閱異步創建和刪除密鑰空間和表。

支援下列DDL陳述式：

Keyspaces

索引鍵空間會將與一或多個應用程式相關的相關資料表分組。就關係數據庫管理系統（RDBMS）而言，密鑰空間與數據庫，表空間或類似的構造大致相似。

如需 Amazon Keyspaces 的配額限制和限制的相關資訊，請參閱。配額 Amazon Keyspaces（阿帕奇卡桑德拉）

CREATE KEYSPACE

使用該CREATE KEYSPACE語句創建一個新的密鑰空間。

語法

create_keyspace_statement ::= 
    CREATE KEYSPACE [ IF NOT EXISTS ] keyspace_name
    WITH options

其中：

範例

創建一個密鑰空間，如下所示。

CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class': 'SingleRegionStrategy'} and TAGS ={'key1':'val1', 'key2':'val2'} ;

若要建立多區域金鑰空間，請指定NetworkTopologyStrategy並包含至少兩個和最多六個。 AWS 區域每個區域的複製因子是三個。

CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3'};

ALTER KEYSPACE

使用ALTER KEYSPACE從金鑰空間新增或移除標籤。

語法

alter_keyspace_statement ::= 
    ALTER KEYSPACE keyspace_name
    [[ADD | DROP] TAGS

其中：

範例

改變一個密鑰空間，如下所示。

ALTER KEYSPACE "myGSGKeyspace" ADD TAGS {'key1':'val1', 'key2':'val2'};

DROP KEYSPACE

使用DROP KEYSPACE陳述式移除金鑰空間，包括金鑰空間的所有內容，例如資料表。

語法

drop_keyspace_statement ::= 
    DROP KEYSPACE [ IF EXISTS ] keyspace_name

其中：

範例

DROP KEYSPACE "myGSGKeyspace";

資料表

表是 Amazon Keyspaces 中的主要數據結構。表中的數據被組織成行和列。這些資料行的子集是透過指定分割索引鍵來判斷資料分割 (最終資料放置)。

另一組資料行可以定義為叢集資料行，這表示它們可以在查詢執行中以述詞的形式參與。

依預設，會以隨需輸送量容量建立新表格。您可以變更新表格和現有資料表的容量模式。如需讀取/寫入容量輸送量模式的詳細資訊，請參閱 Amazon 密Keyspaces 間中的讀取/寫入容量模

對於佈建模式下的表格，您可以設定選用AUTOSCALING_SETTINGS。如需 Amazon Keyspaces auto 擴展和可用選項的詳細資訊，請參閱使用卡桑德拉查詢語言（CQL）管理 Amazon Keyspaces auto 擴展。

如需 Amazon Keyspaces 資料表的配額限制和限制的相關資訊，請參閱配額 Amazon Keyspaces（阿帕奇卡桑德拉）。

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));

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>>>);

若要變更資料表的容量模式並指定讀取和寫入容量單位，您可以使用下列陳述式。

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 TABLE

使用RESTORE TABLE陳述式將資料表還原到某個時間點。此陳述式需要在資料表上啟用 point-in-time 復原。如需詳細資訊，請參閱Amazon Keyspaces 的 Point-in-time 復原 (適用於 Apache Cassandra) 的 Peyspaces 的復原。

語法

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 "myGSGKeyspace".employees_tbl;