Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

亚马逊Keyspaces 中的 DDL 语句（数据定义语言）

数据定义语言(DDL) 是一组卡桑德拉查询语言 (CQL) 语句，用于管理亚马逊Keyspaces（适用于 Apache Cassandra）中的数据结构，例如密钥空间和表。可以使用 DDL 创建这些数据结构，在创建数据结构后对其进行修改，以及在不再使用数据结构时将其删除。亚马逊Keyspaces 异步执行 DDL 操作。请参阅异步创建和删除键空间和表.

支持以下 DDL 语句：

Keyspaces

键空间 对与一个或多个应用程序相关的表进行分组。就关系数据库管理系统 (RDBMS) 而言，键空间与数据库、表空间或类似的结构大致相似。

有关 Amazon Keyspaces 密钥空间的配额限制和限制的信息，请参阅Amazon Keyspaces（针对 Apache Cassandra）的配额.

以下是键空间唯一可用的复制策略：

SingleRegionStrategy— 在其区域的三个可用区之间复制数据。

CREATE KEYSPACE

使用 CREATE KEYSPACE 语句可创建新的键空间。

语法

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

其中：

示例

创建键空间，如下所示。

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

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

表

表是亚马逊Keyspaces 中的主要数据结构。表中的数据按行和列进行组织。这些列的子集用于通过指定分区键来确定分区（以及最终的数据放置）。

可以将另一组列定义为聚类列，这意味着它们可以作为谓词参与查询执行。

默认情况下，将创建具有按需 吞吐容量的新表。您可以更改新表和现有表的容量模式。有关读/写容量吞吐量模式的更多信息，请参阅 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 [ 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
                              | WITH TAGS
                              | WITH default_time_to_live

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;

在使用聚类列的表中，可以在表定义中将非聚类列声明为静态列。请参阅亚马逊 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 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语句。本语句要求 point-in-time 要在表上启用恢复。有关更多信息，请参阅 Amazon Keyspaces (a) 时间点恢复（针对 Apache Cassandra）。

语法

restore_table_statement ::=  
    RESTORE TABLE table_name FROM TABLE 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;