Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tabellen

Tabellen sind die primären Datenstrukturen in Amazon Keyspaces. Daten in einer Tabelle sind in Zeilen und Spalten organisiert. Eine Teilmenge dieser Spalten wird verwendet, um die Partitionierung (und letztlich die Datenplatzierung) durch die Angabe eines Partitionsschlüssels zu bestimmen.

Eine weitere Gruppe von Spalten kann in Clusterspalten definiert werden, was bedeutet, dass sie als Prädikate an der Abfrageausführung beteiligt sein können.

Standardmäßig werden neue Tabellen mit On-Demand-Durchsatzkapazität erstellt. Sie können den Kapazitätsmodus für neue und bestehende Tabellen ändern. Weitere Informationen zu den Modi für den read/write Kapazitätsdurchsatz finden Sie unterLese-/Schreibkapazitätsmodi in Amazon Keyspaces konfigurieren.

Für Tabellen im Bereitstellungsmodus können Sie optional AUTOSCALING_SETTINGS konfigurieren. Weitere Informationen zur auto Skalierung von Amazon Keyspaces und den verfügbaren Optionen finden Sie unterKonfigurieren Sie die automatische Skalierung für eine bestehende Tabelle.

Informationen zu Kontingentbeschränkungen und Einschränkungen für Amazon Keyspaces-Tabellen finden Sie unterKontingente für Amazon Keyspaces (für Apache Cassandra).

CREATE TABLE

Verwenden Sie die CREATE TABLE Anweisung, um eine neue Tabelle zu erstellen.

Syntax

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 ]
                              | cdc
                              | CUSTOM_PROPERTIES
                              | AUTOSCALING_SETTINGS
                              | default_time_to_live
                              | TAGS

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

Wobei Folgendes gilt:

Beispiel

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;

In einer Tabelle, die Clusterspalten verwendet, können Spalten, die keine Clusterbildung bilden, in der Tabellendefinition als statisch deklariert werden. Weitere Hinweise zu statischen Spalten finden Sie unter. Schätzen Sie den Kapazitätsverbrauch für statische Spalten in Amazon Keyspaces

Beispiel

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

Sie können eine Tabelle mit einer Spalte erstellen, die einen benutzerdefinierten Typ (UDT) verwendet. Die erste Anweisung in den Beispielen erstellt einen Typ, die zweite Anweisung erstellt eine Tabelle mit einer Spalte, die diesen Typ verwendet.

Beispiel

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

Verwenden Sie die ALTER TABLE Anweisung, um neue Spalten hinzuzufügen, Tags hinzuzufügen oder die benutzerdefinierten Eigenschaften der Tabelle zu ändern.

Syntax

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
                    
                

Wobei Folgendes gilt:

Beispiele

Die folgende Anweisung zeigt, wie einer vorhandenen Tabelle eine Spalte hinzugefügt wird.

ALTER TABLE mykeyspace.mytable ADD (ID int);

Diese Anweisung zeigt, wie zwei Sammlungsspalten zu einer vorhandenen Tabelle hinzugefügt werden:

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

Das folgende Beispiel zeigt, wie einer Tabelle eine Spalte hinzugefügt wird, die einen benutzerdefinierten Typ (UDT) verwendet.

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

Um den Kapazitätsmodus einer Tabelle zu ändern und Lese- und Schreibkapazitätseinheiten anzugeben, können Sie die folgende Anweisung verwenden.

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

Die folgende Anweisung gibt einen vom Kunden verwalteten KMS-Schlüssel für die Tabelle an.

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'     
                  } 
         };

Um die point-in-time Wiederherstellung für eine Tabelle zu aktivieren, können Sie die folgende Anweisung verwenden.

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

Um einen Standardwert für die Gültigkeitsdauer in Sekunden für eine Tabelle festzulegen, können Sie die folgende Anweisung verwenden.

ALTER TABLE my_table WITH default_time_to_live = 2592000;

Diese Anweisung ermöglicht benutzerdefinierte Time-to-Live-Einstellungen für eine Tabelle.

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

TABELLE WIEDERHERSTELLEN

Verwenden Sie die RESTORE TABLE Anweisung, um eine Tabelle auf einen bestimmten Zeitpunkt zurückzusetzen. Für diese Anweisung muss die point-in-time Wiederherstellung für eine Tabelle aktiviert sein. Weitere Informationen finden Sie unter Daten mit point-in-time Wiederherstellung für Amazon Keyspaces Backup und wiederherstellen.

Syntax

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

Wobei Folgendes gilt:

Beispiel

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

Verwenden Sie die DROP TABLE Anweisung, um eine Tabelle aus dem Schlüsselraum zu entfernen.

Syntax

drop_table_statement ::=  
    DROP TABLE [ IF EXISTS ] table_name

Wobei Folgendes gilt:

Beispiel

DROP TABLE my_keyspace.my_table;