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 unter[read/write Kapazitätsmodi in Amazon Keyspaces konfigurieren](ReadWriteCapacityMode.md). 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 unter[Konfigurieren Sie die automatische Skalierung für eine bestehende Tabelle](autoscaling.configureTable.md). Informationen zu Kontingentbeschränkungen und Einschränkungen für Amazon Keyspaces-Tabellen finden Sie unter[Kontingente für Amazon Keyspaces (für Apache Cassandra)](quotas.md). **Topics** + [CREATE TABLE](#cql.ddl.table.create) + [ALTER TABLE](#cql.ddl.table.alter) + [TABELLE WIEDERHERSTELLEN](#cql.ddl.table.restore) + [DROP TABLE](#cql.ddl.table.drop) ## 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: + `table_name`ist der Name der Tabelle, die erstellt werden soll. Der vollqualifizierte Name beinhaltet das Schlüsselraumpräfix. Alternativ können Sie den aktuellen Schlüsselraum mit der `USE` Keyspace-Anweisung festlegen. + `column_definition`besteht aus den folgenden Komponenten: + *`column_name`*— Der Name der Spalte. + `cql_type`— Ein Amazon Keyspaces-Datentyp (siehe[Datentypen](cql.elements.md#cql.data-types)). + `FROZEN`— Kennzeichnet diese Spalte, die benutzerdefiniert ist oder deren Typ `collection` (z. B.,, oder`MAP`) ist `LIST``SET`, als eingefroren. Eine *eingefrorene* Sammlung wird in einen einzigen unveränderlichen Wert serialisiert und wie eine behandelt. `BLOB` Weitere Informationen finden Sie unter [Sammlungstypen](cql.elements.md#cql.data-types.collection). + `STATIC`— Kennzeichnet diese Spalte als statisch. Statische Spalten speichern Werte, die von allen Zeilen in derselben Partition gemeinsam genutzt werden. + `PRIMARY KEY`— Bezeichnet diese Spalte als Primärschlüssel der Tabelle. + `primary_key`besteht aus den folgenden Komponenten: + `partition_key` + `clustering_columns` + `partition_key`: + Der Partitionsschlüssel kann eine einzelne Spalte oder ein zusammengesetzter Wert sein, der aus zwei oder mehr Spalten besteht. Der Partitionsschlüsselteil des Primärschlüssels ist erforderlich und bestimmt, wie Amazon Keyspaces Ihre Daten speichert. + `clustering_columns`: + Der optionale Teil der Clustering-Spalte Ihres Primärschlüssels bestimmt, wie die Daten innerhalb der einzelnen Partitionen gruppiert und sortiert werden. + `table_options`bestehen aus den folgenden Komponenten: + *`CLUSTERING ORDER BY`*— Die standardmäßige CLUSTERING-REIHENFOLGE für eine Tabelle setzt sich aus Ihren Gruppierungsschlüsseln in `ASC` (aufsteigender) Sortierrichtung zusammen. Geben Sie es an, um das Standard-Sortierverhalten zu überschreiben. + *`cdc`*— Ein boolescher Wert, der angibt, ob Amazon Keyspaces einen CDC-Stream (Change Data Capture) für die Tabelle erstellt. Der Standardwert ist `false`. Um bei der Aktivierung eines `view type` Streams den anzugeben, legen Sie den Wert mit fest. `cdc_specification` `CUSTOM_PROPERTIES` + *`CUSTOM_PROPERTIES`*— Eine Karte mit Einstellungen, die für Amazon Keyspaces spezifisch sind. + `capacity_mode`: Gibt den Lese-/Schreibdurchsatzkapazitätsmodus für die Tabelle an. Die Optionen sind `throughput_mode:PAY_PER_REQUEST` und `throughput_mode:PROVISIONED`. Der bereitgestellte Kapazitätsmodus erfordert `read_capacity_units` und `write_capacity_units` als Eingaben. Der Standardwert ist `throughput_mode:PAY_PER_REQUEST`. + `cdc_specification`: Gibt den Wert `view_type` des CDC-Streams an. Die Optionen sind: + `NEW_AND_OLD_IMAGES`— beide Versionen der Zeile, vor und nach der Änderung. Dies ist die Standardeinstellung. + `NEW_IMAGE`— die Version der Zeile nach der Änderung. + `OLD_IMAGE`— die Version der Zeile vor der Änderung. + `KEYS_ONLY`— die Partitions- und Clusterschlüssel der Zeile, die geändert wurde. Weitere Hinweise zu CDC-Streams finden Sie unter. [Arbeiten mit Change Data Capture (CDC) -Streams in Amazon Keyspaces](cdc.md) Codebeispiele finden Sie unter [Aktivieren Sie einen CDC-Stream, wenn Sie eine neue Tabelle in Amazon Keyspaces erstellen](keyspaces-enable-cdc-new-table.md). + `client_side_timestamps`: Gibt an, ob clientseitige Zeitstempel für die Tabelle aktiviert oder deaktiviert sind. Die Optionen sind `{'status': 'enabled'}` und `{'status': 'disabled'}`. Wenn es nicht angegeben ist, ist die Standardeinstellung. `status:disabled` Nachdem clientseitige Zeitstempel für eine Tabelle aktiviert wurden, kann diese Einstellung nicht deaktiviert werden. + `encryption_specification`: Gibt die Verschlüsselungsoptionen für die Verschlüsselung im Ruhezustand an. Wenn es nicht angegeben ist, ist die Standardeinstellung`encryption_type:AWS_OWNED_KMS_KEY`. Die vom Kunden verwaltete Verschlüsselungsoption erfordert den AWS KMS Schlüssel im Format Amazon Resource Name (ARN) als Eingabe:`kms_key_identifier:ARN`:`kms_key_identifier:ARN`. + `point_in_time_recovery`: Gibt an, ob die point-in-time Wiederherstellung für die Tabelle aktiviert oder deaktiviert ist. Die Optionen sind `status:enabled` und `status:disabled`. Wenn es nicht angegeben ist, ist die Standardeinstellung`status:disabled`. + `replica_updates`: Gibt die Einstellungen einer Tabelle mit mehreren Regionen an, die spezifisch für eine AWS-Region sind. Bei einer Tabelle mit mehreren Regionen können Sie die Lesekapazität der Tabelle je nach Region unterschiedlich konfigurieren. AWS-Region Sie können dies tun, indem Sie die folgenden Parameter konfigurieren. Weitere Informationen und Beispiele finden Sie unter [Erstellen Sie eine Tabelle mit mehreren Regionen im Bereitstellungsmodus mit auto Skalierung in Amazon Keyspaces](tables-mrr-create-provisioned.md). + `region`— Das AWS-Region des Tabellenreplikats mit den folgenden Einstellungen: + `read_capacity_units` + `TTL`: Aktiviert benutzerdefinierte Time to Live-Einstellungen für die Tabelle. Verwenden Sie zum Aktivieren`status:enabled`. Der Standardwert ist `status:disabled`. Nach `TTL` der Aktivierung können Sie es für die Tabelle nicht mehr deaktivieren. + `AUTOSCALING_SETTINGS`beinhaltet die folgenden optionalen Einstellungen für Tabellen im Bereitstellungsmodus. Weitere Informationen und Beispiele finden Sie unter [Erstellen Sie eine neue Tabelle mit automatischer Skalierung](autoscaling.createTable.md). + `provisioned_write_capacity_autoscaling_update`: + `autoscaling_disabled`— Um die auto Skalierung für die Schreibkapazität zu aktivieren, setzen Sie den Wert auf`false`. Der Standardwert ist `true`. (Optional) + `minimum_units`— Der Mindestwert für den Schreibdurchsatz, den die Tabelle immer unterstützen sollte. Der Wert muss zwischen 1 und dem maximalen Kontingent für den Durchsatz pro Sekunde für Ihr Konto liegen (standardmäßig 40.000). + `maximum_units`— Der maximale Schreibdurchsatz, den die Tabelle immer unterstützen sollte. Der Wert muss zwischen 1 und dem maximalen Kontingent für den Durchsatz pro Sekunde für Ihr Konto liegen (standardmäßig 40.000). + `scaling_policy`— Amazon Keyspaces unterstützt die Zielverfolgungsrichtlinie. Das Auto Scaling-Ziel ist die bereitgestellte Schreibkapazität der Tabelle. + `target_tracking_scaling_policy_configuration`— Um die Zielverfolgungsrichtlinie zu definieren, müssen Sie den Zielwert definieren. Weitere Informationen zu Target Tracking und Cooldown-Perioden finden Sie unter [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) im *Application Auto Scaling User Guide*. + `target_value`— Die Zielauslastungsrate der Tabelle. Die auto Skalierung von Amazon Keyspaces stellt sicher, dass das Verhältnis von verbrauchter Kapazität zu bereitgestellter Kapazität auf oder nahe diesem Wert bleibt. Sie definieren `target_value` als Prozentsatz. Ein Doppelter zwischen 20 und 90. (Erforderlich) + `scale_in_cooldown`— Eine Abklingzeit in Sekunden zwischen den Skalierungsaktivitäten, sodass sich die Tabelle stabilisiert, bevor eine weitere Aktivitätsskala beginnt. Wenn kein Wert angegeben wird, ist der Standardwert 0. (Optional) + `scale_out_cooldown`— Eine Abklingzeit in Sekunden zwischen Skalierungsaktivitäten, durch die sich die Tabelle stabilisiert, bevor eine weitere Scale-Out-Aktivität beginnt. Wenn kein Wert angegeben wird, ist der Standardwert 0. (Optional) + `disable_scale_in`: A`boolean`, das angibt, ob `scale-in` es für die Tabelle deaktiviert oder aktiviert ist. Dieser Parameter ist standardmäßig deaktiviert. Stellen Sie zum `scale-in` Einschalten den `boolean` Wert auf ein`FALSE`. Das bedeutet, dass die Kapazität für eine Tabelle in Ihrem Namen automatisch herunterskaliert wird. (Optional) + `provisioned_read_capacity_autoscaling_update`: + `autoscaling_disabled`— Um die auto Skalierung für die Lesekapazität zu aktivieren, setzen Sie den Wert auf`false`. Der Standardwert ist `true`. (Optional) + `minimum_units`— Der Mindestdurchsatz, für den die Tabelle immer bereit sein sollte, ihn zu unterstützen. Der Wert muss zwischen 1 und dem maximalen Kontingent für den Durchsatz pro Sekunde für Ihr Konto liegen (standardmäßig 40.000). + `maximum_units`— Der maximale Durchsatz, den die Tabelle immer unterstützen sollte. Der Wert muss zwischen 1 und dem maximalen Kontingent für den Durchsatz pro Sekunde für Ihr Konto liegen (standardmäßig 40.000). + `scaling_policy`— Amazon Keyspaces unterstützt die Richtlinie zur Zielverfolgung. Das Auto Scaling-Ziel ist die bereitgestellte Lesekapazität der Tabelle. + `target_tracking_scaling_policy_configuration`— Um die Zielverfolgungsrichtlinie zu definieren, müssen Sie den Zielwert definieren. Weitere Informationen zu Target Tracking und Cooldown-Perioden finden Sie unter [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) im *Application Auto Scaling User Guide*. + `target_value`— Die Zielauslastungsrate der Tabelle. Die auto Skalierung von Amazon Keyspaces stellt sicher, dass das Verhältnis von verbrauchter Kapazität zu bereitgestellter Kapazität auf oder nahe diesem Wert bleibt. Sie definieren `target_value` als Prozentsatz. Ein Doppelter zwischen 20 und 90. (Erforderlich) + `scale_in_cooldown`— Eine Abklingzeit in Sekunden zwischen den Skalierungsaktivitäten, sodass sich die Tabelle stabilisiert, bevor eine weitere Aktivitätsskala beginnt. Wenn kein Wert angegeben wird, ist der Standardwert 0. (Optional) + `scale_out_cooldown`— Eine Abklingzeit in Sekunden zwischen Skalierungsaktivitäten, durch die sich die Tabelle stabilisiert, bevor eine weitere Scale-Out-Aktivität beginnt. Wenn kein Wert angegeben wird, ist der Standardwert 0. (Optional) + `disable_scale_in`: A`boolean`, das angibt, ob `scale-in` es für die Tabelle deaktiviert oder aktiviert ist. Dieser Parameter ist standardmäßig deaktiviert. Stellen Sie zum `scale-in` Einschalten den `boolean` Wert auf ein`FALSE`. Das bedeutet, dass die Kapazität für eine Tabelle in Ihrem Namen automatisch herunterskaliert wird. (Optional) + `replica_updates`: Gibt die AWS-Region spezifischen Auto-Scaling-Einstellungen einer Tabelle mit mehreren Regionen an. Bei einer Tabelle mit mehreren Regionen können Sie die Lesekapazität der Tabelle je nach Region unterschiedlich konfigurieren. AWS-Region Sie können dies tun, indem Sie die folgenden Parameter konfigurieren. Weitere Informationen und Beispiele finden Sie unter [Aktualisieren Sie die bereitgestellten Kapazitäten und Auto-Scaling-Einstellungen für eine Tabelle mit mehreren Regionen in Amazon Keyspaces](tables-mrr-autoscaling.md). + `region`— Das AWS-Region des Tabellenreplikats mit den folgenden Einstellungen: + `provisioned_read_capacity_autoscaling_update` + `autoscaling_disabled`— Um die auto Skalierung für die Lesekapazität der Tabelle zu aktivieren, setzen Sie den Wert auf`false`. Der Standardwert ist `true`. (Optional) **Anmerkung** Auto Scaling für eine Tabelle mit mehreren Regionen muss für alle Replikate der Tabelle entweder aktiviert oder deaktiviert sein. + `minimum_units`— Der Mindestwert an Lesedurchsatz, den die Tabelle immer unterstützen sollte. Der Wert muss zwischen 1 und dem maximalen Kontingent für den Durchsatz pro Sekunde für Ihr Konto liegen (standardmäßig 40.000). + `maximum_units`— Der maximale Lesedurchsatz, den die Tabelle immer unterstützen sollte. Der Wert muss zwischen 1 und dem maximalen Kontingent für den Durchsatz pro Sekunde für Ihr Konto liegen (standardmäßig 40.000). + `scaling_policy`— Amazon Keyspaces unterstützt die Richtlinie zur Zielverfolgung. Das Auto Scaling-Ziel ist die bereitgestellte Lesekapazität der Tabelle. + `target_tracking_scaling_policy_configuration`— Um die Zielverfolgungsrichtlinie zu definieren, müssen Sie den Zielwert definieren. Weitere Informationen zu Target Tracking und Cooldown-Perioden finden Sie unter [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) im *Application Auto Scaling User Guide*. + `target_value`— Die Zielauslastungsrate der Tabelle. Die auto Skalierung von Amazon Keyspaces stellt sicher, dass das Verhältnis zwischen verbrauchter Lesekapazität und bereitgestellter Lesekapazität bei oder nahe diesem Wert bleibt. Sie definieren `target_value` als Prozentsatz. Ein Doppelter zwischen 20 und 90. (Erforderlich) + `scale_in_cooldown`— Eine Abklingzeit in Sekunden zwischen den Skalierungsaktivitäten, sodass sich die Tabelle stabilisiert, bevor eine weitere Aktivitätsskala beginnt. Wenn kein Wert angegeben wird, ist der Standardwert 0. (Optional) + `scale_out_cooldown`— Eine Abklingzeit in Sekunden zwischen Skalierungsaktivitäten, durch die sich die Tabelle stabilisiert, bevor eine weitere Scale-Out-Aktivität beginnt. Wenn kein Wert angegeben wird, ist der Standardwert 0. (Optional) + `disable_scale_in`: A`boolean`, das angibt, ob `scale-in` es für die Tabelle deaktiviert oder aktiviert ist. Dieser Parameter ist standardmäßig deaktiviert. Stellen Sie zum `scale-in` Einschalten den `boolean` Wert auf ein`FALSE`. Das bedeutet, dass die Lesekapazität für eine Tabelle in Ihrem Namen automatisch herunterskaliert wird. (Optional) + `default_time_to_live`— Die Standardeinstellung für die Gültigkeitsdauer der Tabelle in Sekunden. + `TAGS`— Eine Liste von Schlüssel-Wert-Paar-Tags, die bei ihrer Erstellung an die Ressource angehängt werden sollen. + `clustering_order`besteht aus den folgenden Teilen: + *`column_name`*— Der Name der Spalte. + *`ASC | DESC`*— Legt den Modifikator für die aufsteigende (`ASC`) oder absteigende (`DESC`) Reihenfolge fest. Wenn er nicht angegeben ist, ist die Standardreihenfolge ASC. **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](static-columns.md) **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: + `table_name`ist der Name der Tabelle, die geändert werden soll. + `column_definition`ist der Name der Spalte und des Datentyps, die hinzugefügt werden sollen. + `column_definition_list`ist eine durch Kommas getrennte Liste von Spalten, die in Klammern stehen. + `table_options`besteht aus den folgenden Komponenten: + `AUTOSCALING_SETTINGS`beinhaltet die optionalen Auto Scaling-Einstellungen für bereitgestellte Tabellen. Die Syntax und ausführliche Beschreibungen finden Sie unter[CREATE TABLE](#cql.ddl.table.create). Beispiele finden Sie unter [Konfigurieren Sie die automatische Skalierung für eine bestehende Tabelle](autoscaling.configureTable.md). + *`cdc`*— Ein boolescher Wert, der angibt, ob Amazon Keyspaces einen CDC-Stream (Change Data Capture) für die Tabelle erstellt. Der Standardwert ist `false`. Um bei der Aktivierung eines `view type` Streams den anzugeben, legen Sie den Wert mit fest. `cdc_specification` `CUSTOM_PROPERTIES` + *`CUSTOM_PROPERTIES`*— Eine Karte mit Einstellungen, die für Amazon Keyspaces spezifisch sind. + `capacity_mode`: Gibt den Lese-/Schreibdurchsatzkapazitätsmodus für die Tabelle an. Die Optionen sind `throughput_mode:PAY_PER_REQUEST` und `throughput_mode:PROVISIONED`. Der bereitgestellte Kapazitätsmodus erfordert `read_capacity_units` und `write_capacity_units` als Eingaben. Der Standardwert ist `throughput_mode:PAY_PER_REQUEST`. + `cdc_specification`: Gibt den Wert `view_type` des CDC-Streams an. Die Optionen sind: + `NEW_AND_OLD_IMAGES`— beide Versionen der Zeile, vor und nach der Änderung. Dies ist die Standardeinstellung. + `NEW_IMAGE`— die Version der Zeile nach der Änderung. + `OLD_IMAGE`— die Version der Zeile vor der Änderung. + `KEYS_ONLY`— die Partitions- und Clusterschlüssel der Zeile, die geändert wurde. Weitere Hinweise zu CDC-Streams finden Sie unter. [Arbeiten mit Change Data Capture (CDC) -Streams in Amazon Keyspaces](cdc.md) Codebeispiele finden Sie unter [Einen CDC-Stream für eine bestehende Tabelle in Amazon Keyspaces aktivieren](keyspaces-enable-cdc-alter-table.md). + `client_side_timestamps`: Gibt an, ob clientseitige Zeitstempel für die Tabelle aktiviert oder deaktiviert sind. Die Optionen sind `{'status': 'enabled'}` und `{'status': 'disabled'}`. Wenn es nicht angegeben ist, ist die Standardeinstellung. `status:disabled` Nachdem clientseitige Zeitstempel für eine Tabelle aktiviert wurden, kann diese Einstellung nicht deaktiviert werden. + `encryption_specification`: Gibt die Verschlüsselungsoption für die Verschlüsselung im Ruhezustand an. Die Optionen sind `encryption_type:AWS_OWNED_KMS_KEY` und `encryption_type:CUSTOMER_MANAGED_KMS_KEY`. Die vom Kunden verwaltete Verschlüsselungsoption erfordert den AWS KMS Schlüssel im Format Amazon Resource Name (ARN) als Eingabe:`kms_key_identifier:ARN`. + `point_in_time_recovery`: Gibt an, ob die point-in-time Wiederherstellung für die Tabelle aktiviert oder deaktiviert ist. Die Optionen sind `status:enabled` und `status:disabled`. Der Standardwert ist `status:disabled`. + `replica_updates`: Gibt die AWS-Region spezifischen Einstellungen einer Tabelle mit mehreren Regionen an. Bei einer Tabelle mit mehreren Regionen können Sie die Lesekapazität der Tabelle je nach Region unterschiedlich konfigurieren. AWS-Region Sie können dies tun, indem Sie die folgenden Parameter konfigurieren. Weitere Informationen und Beispiele finden Sie unter [Aktualisieren Sie die bereitgestellten Kapazitäten und Auto-Scaling-Einstellungen für eine Tabelle mit mehreren Regionen in Amazon Keyspaces](tables-mrr-autoscaling.md). + `region`— Das AWS-Region des Tabellenreplikats mit den folgenden Einstellungen: + `read_capacity_units` + `ttl`: Aktiviert benutzerdefinierte Time to Live-Einstellungen für die Tabelle. Verwenden Sie zum Aktivieren`status:enabled`. Der Standardwert ist `status:disabled`. Nach `ttl` der Aktivierung können Sie es für die Tabelle nicht mehr deaktivieren. + `default_time_to_live`: Die Standardeinstellung „Time to Live“ in Sekunden für die Tabelle. + `TAGS`ist eine Liste von Schlüssel-Wert-Paar-Tags, die an die Ressource angehängt werden sollen. **Anmerkung** Mit ALTER TABLE können Sie nur eine einzige benutzerdefinierte Eigenschaft ändern. Sie können nicht mehr als einen ALTER TABLE-Befehl in derselben Anweisung kombinieren. **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: + Eine eingefrorene Sammlungsspalte`col_frozen_list`, die eine verschachtelte eingefrorene Sammlung enthält + Eine nicht eingefrorene Sammlungsspalte`col_map`, die eine verschachtelte eingefrorene Sammlung enthält ``` ALTER TABLE my_Table ADD(col_frozen_list FROZEN>>>, col_map MAP>>); ``` 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](PointInTimeRecovery.md). **Syntax** ``` restore_table_statement ::= RESTORE TABLE restored_table_name FROM TABLE source_table_name [ WITH table_options [ , ... ] ]; ``` Wobei Folgendes gilt: + `restored_table_name`ist der Name der wiederhergestellten Tabelle. + `source_table_name`ist der Name der Quelltabelle. + `table_options`besteht aus den folgenden Teilen: + `restore_timestamp`ist die Uhrzeit des Wiederherstellungspunkts im Format ISO 8601. Wenn er nicht angegeben ist, wird der aktuelle Zeitstempel verwendet. + *`CUSTOM_PROPERTIES`*— Eine Karte mit Einstellungen, die für Amazon Keyspaces spezifisch sind. + `capacity_mode`: Gibt den Lese-/Schreibdurchsatzkapazitätsmodus für die Tabelle an. Die Optionen sind `throughput_mode:PAY_PER_REQUEST` und `throughput_mode:PROVISIONED`. Der bereitgestellte Kapazitätsmodus erfordert `read_capacity_units` und `write_capacity_units` als Eingaben. Die Standardeinstellung ist die aktuelle Einstellung aus der Quelltabelle. + `encryption_specification`: Gibt die Verschlüsselungsoption für die Verschlüsselung im Ruhezustand an. Die Optionen sind `encryption_type:AWS_OWNED_KMS_KEY` und `encryption_type:CUSTOMER_MANAGED_KMS_KEY`. Die vom Kunden verwaltete Verschlüsselungsoption erfordert den AWS KMS Schlüssel im Format Amazon Resource Name (ARN) als Eingabe:`kms_key_identifier:ARN`. Um eine mit einem vom Kunden verwalteten Schlüssel verschlüsselte Tabelle in eine mit einem verschlüsselte Tabelle wiederherzustellen AWS-eigener Schlüssel, benötigt Amazon Keyspaces Zugriff auf den AWS KMS Schlüssel der Quelltabelle. + `point_in_time_recovery`: Gibt an, ob point-in-time die Wiederherstellung für die Tabelle aktiviert oder deaktiviert ist. Die Optionen sind `status:enabled` und `status:disabled`. Anders als beim Erstellen neuer Tabellen ist der Standardstatus für wiederhergestellte Tabellen darauf `status:enabled` zurückzuführen, dass die Einstellung von der Quelltabelle übernommen wird. Um PITR für wiederhergestellte Tabellen zu deaktivieren, müssen Sie `status:disabled` dies explizit festlegen. + `replica_updates`: Gibt die AWS-Region spezifischen Einstellungen einer Tabelle mit mehreren Regionen an. Bei einer Tabelle mit mehreren Regionen können Sie die Lesekapazität der Tabelle je nach Region unterschiedlich konfigurieren. AWS-Region Sie können dies tun, indem Sie die folgenden Parameter konfigurieren. + `region`— Das AWS-Region des Tabellenreplikats mit den folgenden Einstellungen: + `read_capacity_units` + `AUTOSCALING_SETTINGS`beinhaltet die optionalen Auto Scaling-Einstellungen für bereitgestellte Tabellen. Eine ausführliche Syntax und Beschreibungen finden Sie unter[CREATE TABLE](#cql.ddl.table.create). + `TAGS`ist eine Liste von Schlüssel-Wert-Paar-Tags, die an die Ressource angehängt werden sollen. **Anmerkung** Gelöschte Tabellen können nur bis zum Zeitpunkt des Löschvorgangs wiederhergestellt werden. **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: + `IF EXISTS``DROP TABLE`verhindert, dass ein Fehler auftritt, wenn die Tabelle nicht existiert. (Optional) + `table_name`ist der Name der Tabelle, die gelöscht werden soll. **Beispiel** ``` DROP TABLE my_keyspace.my_table; ```