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.
# DDL-Anweisungen (Datendefinitionssprache) in Amazon Keyspaces
*Data Definition Language* (DDL) ist der Satz von Cassandra Query Language (CQL) -Anweisungen, die Sie verwenden, um Datenstrukturen in Amazon Keyspaces (für Apache Cassandra) zu verwalten, z. B. Schlüsselräume und Tabellen. Sie verwenden DDL, um diese Datenstrukturen zu erstellen, sie nach ihrer Erstellung zu ändern und sie zu entfernen, wenn sie nicht mehr verwendet werden. Amazon Keyspaces führt DDL-Operationen asynchron aus. Weitere Informationen darüber, wie Sie überprüfen können, ob ein asynchroner Vorgang abgeschlossen wurde, finden Sie unter. [Asynchrones Erstellen und Löschen von Schlüsselräumen und Tabellen](functional-differences.md#functional-differences.table-keyspace-management)
Die folgenden DDL-Anweisungen werden unterstützt:
+ [SCHLÜSSELRAUM ERSTELLEN](cql.ddl.keyspace.md#cql.ddl.keyspace.create)
+ [SCHLÜSSELRAUM ÄNDERN](cql.ddl.keyspace.md#cql.ddl.keyspace.alter)
+ [KEYSPACE LÖSCHEN](cql.ddl.keyspace.md#cql.ddl.keyspace.drop)
+ [BENUTZE](cql.ddl.keyspace.md#cql.ddl.keyspace.use)
+ [TABELLE ERSTELLEN](cql.ddl.table.md#cql.ddl.table.create)
+ [ALTER TABLE](cql.ddl.table.md#cql.ddl.table.alter)
+ [TABELLE WIEDERHERSTELLEN](cql.ddl.table.md#cql.ddl.table.restore)
+ [TABELLE LÖSCHEN](cql.ddl.table.md#cql.ddl.table.drop)
+ [TYP ERSTELLEN](cql.ddl.type.md#cql.ddl.type.create)
+ [TYP LÖSCHEN](cql.ddl.type.md#cql.ddl.type.drop)
**Topics**
+ [Keyspaces](cql.ddl.keyspace.md)
+ [Tabellen](cql.ddl.table.md)
+ [Benutzerdefinierte Typen () UDTs](cql.ddl.type.md)
# Keyspaces
Ein *Schlüsselraum* gruppiert verwandte Tabellen, die für eine oder mehrere Anwendungen relevant sind. In Bezug auf ein relationales Datenbankmanagementsystem (RDBMS) ähneln Schlüsselräume in etwa Datenbanken, Tablespaces oder ähnlichen Konstrukten.
**Anmerkung**
In Apache Cassandra bestimmen Schlüsselräume, wie Daten zwischen mehreren Speicherknoten repliziert werden. Amazon Keyspaces ist jedoch ein vollständig verwalteter Service: Die Details der Speicherebene werden in Ihrem Namen verwaltet. Aus diesem Grund sind Schlüsselräume in Amazon Keyspaces nur logische Konstrukte und haben nichts mit dem zugrunde liegenden physischen Speicher zu tun.
Informationen zu Kontingentbeschränkungen und Einschränkungen für Amazon Keyspaces-Keyspaces finden Sie unter. [Kontingente für Amazon Keyspaces (für Apache Cassandra)](quotas.md)
**Topics**
+ [SCHLÜSSELRAUM ERSTELLEN](#cql.ddl.keyspace.create)
+ [SCHLÜSSELRAUM ÄNDERN](#cql.ddl.keyspace.alter)
+ [SCHLÜSSELRAUM LÖSCHEN](#cql.ddl.keyspace.drop)
+ [USE](#cql.ddl.keyspace.use)
## SCHLÜSSELRAUM ERSTELLEN
Verwenden Sie die `CREATE KEYSPACE` Anweisung, um einen neuen Schlüsselraum zu erstellen.
**Syntax**
```
create_keyspace_statement ::=
CREATE KEYSPACE [ IF NOT EXISTS ] keyspace_name
WITH options
```
Wobei Folgendes gilt:
+ `keyspace_name`ist der Name des zu erstellenden Schlüsselraums.
+ Bei den *Optionen* handelt es sich um eine oder mehrere der folgenden Optionen:
+ `REPLICATION`— Eine Map, die die Replikationsstrategie für den Schlüsselraum angibt:
+ `SingleRegionStrategy`— Für einen Schlüsselraum mit nur einer Region. (Erforderlich)
+ `NetworkTopologyStrategy`— Geben Sie mindestens zwei an. AWS-Regionen Der Replikationsfaktor für jede Region ist drei. (Optional)
+ `DURABLE_WRITES`— Schreibvorgänge in Amazon Keyspaces sind immer dauerhaft, sodass diese Option nicht erforderlich ist. Falls angegeben, muss der Wert jedoch sein. `true`
+ `TAGS`— Eine Liste von Schlüssel-Wert-Paar-Tags, die bei der Erstellung an die Ressource angehängt werden sollen. (Optional)
**Beispiel**
Erstellen Sie einen Schlüsselraum wie folgt.
```
CREATE KEYSPACE my_keyspace
WITH REPLICATION = {'class': 'SingleRegionStrategy'} and TAGS ={'key1':'val1', 'key2':'val2'} ;
```
Um einen Schlüsselraum für mehrere Regionen zu erstellen, geben Sie mindestens zwei an `NetworkTopologyStrategy` und schließen Sie sie ein. AWS-Regionen Der Replikationsfaktor für jede Region ist drei.
```
CREATE KEYSPACE my_keyspace
WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3'};
```
## SCHLÜSSELRAUM ÄNDERN
*Sie können die `ALTER KEYSPACE WITH` Anweisung für die folgenden Optionen verwenden*
+ `REPLICATION`— Verwenden Sie diese Option, um einem Schlüsselraum ein neues AWS-Region Replikat hinzuzufügen. Sie können eine neue Region zu einem Schlüsselraum mit einer oder mehreren Regionen hinzufügen.
+ `TAGS`— Verwenden Sie diese Option, um Tags zu einem Schlüsselraum hinzuzufügen oder daraus zu entfernen.
**Syntax**
```
alter_keyspace_statement ::=
ALTER KEYSPACE keyspace_name
WITH options
```
Wobei Folgendes gilt:
+ `keyspace_name`ist der Name des Schlüsselraums, der geändert werden soll.
+ Es gibt eine der folgenden *Optionen*:
+ `ADD | DROP TAGS`— Eine Liste von Schlüssel-Wert-Paar-Tags, die dem Schlüsselraum hinzugefügt oder daraus entfernt werden sollen.
+ `REPLICATION`— Eine Karte, die die Replikationsstrategie für den Schlüsselraum angibt;
+ `class`— `NetworkTopologyStrategy` definiert den Schlüsselraum als einen Schlüsselraum mit mehreren Regionen.
+ `region`— Geben Sie einen zusätzlichen AWS-Region für diesen Schlüsselraum an. Der Replikationsfaktor für jede Region ist drei.
+ `CLIENT_SIDE_TIMESTAMPS`— Die Standardeinstellung ist`DISABLED`. Sie können den Status nur auf ändern`ENABLED`.
**Beispiele**
Ändern Sie einen Schlüsselraum wie im folgenden Beispiel gezeigt, um Tags hinzuzufügen.
```
ALTER KEYSPACE my_keyspace ADD TAGS {'key1':'val1', 'key2':'val2'};
```
Um einem Schlüsselraum mit mehreren Regionen eine dritte Region hinzuzufügen, können Sie die folgende Anweisung verwenden.
```
ALTER KEYSPACE my_keyspace
WITH REPLICATION = {
'class': 'NetworkTopologyStrategy',
'us-east-1': '3',
'us-west-2': '3',
'us-west-1': '3'
} AND CLIENT_SIDE_TIMESTAMPS = {'status': 'ENABLED'};
```
## SCHLÜSSELRAUM LÖSCHEN
Verwenden Sie die `DROP KEYSPACE` Anweisung, um einen Schlüsselraum einschließlich seines gesamten Inhalts, z. B. Tabellen, zu entfernen.
**Syntax**
```
drop_keyspace_statement ::=
DROP KEYSPACE [ IF EXISTS ] keyspace_name
```
Wobei Folgendes gilt:
+ *keyspace\$1name ist der Name des* Schlüsselraums, der gelöscht werden soll.
**Beispiel**
```
DROP KEYSPACE my_keyspace;
```
## USE
Verwenden Sie die `USE` Anweisung, um den aktuellen Schlüsselraum zu definieren. Auf diese Weise können Sie auf Objekte verweisen, die an einen bestimmten Schlüsselraum gebunden sind, z. B. Tabellen und Typen, ohne den vollqualifizierten Namen zu verwenden, der das Schlüsselraumpräfix enthält.
**Syntax**
```
use_statement ::=
USE keyspace_name
```
Wobei Folgendes gilt:
+ *keyspace\$1name ist der Name* des zu verwendenden Schlüsselraums.
**Beispiel**
```
USE my_keyspace;
```
# 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;
```
# Benutzerdefinierte Typen () UDTs
*UDT* — Eine Gruppierung von Feldern und Datentypen, die Sie verwenden können, um eine einzelne Spalte in Amazon Keyspaces zu definieren. Gültige Datentypen für UDTs sind alle unterstützten Cassandra-Datentypen, einschließlich Sammlungen und anderer, UDTs die Sie bereits im selben Schlüsselraum erstellt haben. Weitere Informationen zu den unterstützten Cassandra-Datentypen finden Sie unter. [Unterstützung des Cassandra-Datentyps](cassandra-apis.md#cassandra-data-type)
```
user_defined_type::= udt_name
udt_name::= [ keyspace_name '.' ] identifier
```
**Topics**
+ [CREATE TYPE](#cql.ddl.type.create)
+ [DROP TYPE](#cql.ddl.type.drop)
## CREATE TYPE
Verwenden Sie die `CREATE TYPE` Anweisung, um einen neuen Typ zu erstellen.
**Syntax**
```
create_type_statement ::= CREATE TYPE [ IF NOT EXISTS ] udt_name
'('field_definition ( ',' field_definition)* ')'
field_definition::= identifier cql_type
```
Wobei Folgendes gilt:
+ `IF NOT EXISTS``CREATE TYPE`verhindert, dass ein Fehler auftritt, wenn der Typ bereits existiert. (Optional)
+ `udt_name`ist beispielsweise der vollständig qualifizierte Name der UDT im Typformat. `my_keyspace.my_type` Wenn Sie den aktuellen Schlüsselraum mit der `USE` Anweisung definieren, müssen Sie den Schlüsselraumnamen nicht angeben.
+ `field_definition`besteht aus einem Namen und einem Typ.
Die folgende Tabelle zeigt Beispiele für zulässige UDT-Namen. Die erste Spalte zeigt, wie Sie den Namen eingeben, wenn Sie den Typ erstellen, die zweite Spalte zeigt, wie Amazon Keyspaces den Namen intern formatiert. Amazon Keyspaces erwartet den formatierten Namen für Operationen wie. `GetType`
| Eingegebener Name | Formatierter Name | Hinweis |
| --- | --- | --- |
| MY\$1UDT | my\$1udt | Ohne doppelte Anführungszeichen konvertiert Amazon Keyspaces alle Großbuchstaben in Kleinbuchstaben. |
| "MY\$1UDT" | MY\$1UDT | Bei doppelten Anführungszeichen respektiert Amazon Keyspaces die Großbuchstaben und entfernt die doppelten Anführungszeichen aus dem formatierten Namen. |
| "1234" | 1234 | Bei doppelten Anführungszeichen kann der Name mit einer Zahl beginnen, und Amazon Keyspaces entfernt die doppelten Anführungszeichen aus dem formatierten Namen. |
| "Special\$1Ch@r@cters<>\$1\$1" | Special\$1Ch@r@cters<>\$1\$1 | Bei doppelten Anführungszeichen kann der Name Sonderzeichen enthalten, und Amazon Keyspaces entfernt die doppelten Anführungszeichen aus dem formatierten Namen. |
| "nested""""""quotes" | nested"""quotes | Amazon Keyspaces entfernt die äußeren doppelten Anführungszeichen und die doppelten Escape-Anführungszeichen aus dem formatierten Namen. |
**Beispiele**
```
CREATE TYPE my_keyspace.phone (
country_code int,
number text
);
```
Sie können verschachteln, UDTs wenn das verschachtelte UDT eingefroren ist. Weitere Informationen zu Standardwerten und Kontingenten für Typen finden Sie unter. [Amazon Keyspaces UDT-Kontingente und Standardwerte](quotas.md#udt-table)
```
CREATE TYPE my_keyspace.user (
first_name text,
last_name text,
phones FROZEN
);
```
Weitere Codebeispiele zur Erstellung finden Sie UDTs unter[Benutzerdefinierte Typen (UDTs) in Amazon Keyspaces](udts.md).
## DROP TYPE
Verwenden Sie die `DROP TYPE` Anweisung, um eine UDT zu löschen. Sie können nur einen Typ löschen, der nicht von einem anderen Typ oder einer anderen Tabelle verwendet wird.
**Syntax**
```
drop_type_statement ::= DROP TYPE [ IF EXISTS ] udt_name
```
Wobei Folgendes gilt:
+ `IF EXISTS``DROP TYPE`verhindert, dass ein Fehler auftritt, wenn der Typ nicht existiert. (Optional)
+ `udt_name`ist beispielsweise der vollständig qualifizierte Name der UDT im Typformat. `my_keyspace.my_type` Wenn Sie den aktuellen Schlüsselraum mit der `USE` Anweisung definieren, müssen Sie den Schlüsselraumnamen nicht angeben.
**Beispiel**
```
DROP TYPE udt_name;
```