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. Die Daten in einer Tabelle sind in Zeilen und Spalten organisiert. Eine Teilmenge dieser Spalten wird verwendet, um die Partitionierung (und letztendlich die Datenplatzierung) durch die Angabe eines Partitionsschlüssels zu bestimmen.

Eine weitere Gruppe von Spalten kann als Cluster-Spalten definiert werden, was bedeutet, dass sie als Prädikate an der Abfrageausführung teilnehmen können.

Standardmäßig werden neue Tabellen mit bedarfsgesteuerter Durchsatzkapazität erstellt. Sie können den Kapazitätsmodus für neue und vorhandene Tabellen ändern. Weitere Hinweise zu den Modi für den read/write Kapazitätsdurchsatz finden Sie unterread/write Kapazitätsmodi in Amazon Keyspaces konfigurieren.

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

Informationen zu Kontingentbeschränkungen und Einschränkungen für Amazon Keyspaces-Tabellen finden Sie unter. Kontingente 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 gruppierte Spalten verwendet, können Spalten ohne Cluster-Bildung 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 den 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 einer vorhandenen Tabelle zwei Sammlungsspalten 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-Recovery 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;