Arbeiten mit Keyspaces in Amazon Keyspaces

Dieser Abschnitt enthält Details zum Arbeiten mit Keyspaces in Amazon Keyspaces (für Apache Cassandra).

Arbeiten mit System-Keyspaces in Amazon Keyspaces

Amazon Keyspaces verwendet vier System-Keyspaces:

• system

• system_schema

• system_schema_mcs

• system_multiregion_info

Die folgenden Abschnitte enthalten Details zu den System-Keyspaces und den Systemtabellen, die in Amazon Keyspaces unterstützt werden.

system

Dies ist ein Cassandra-Schlüsselraum. Amazon Keyspaces verwendet die folgenden Tabellen.

Tabellennamen	Spaltennamen	Kommentare
local	key, bootstrapped, broadcast_address, cluster_name, cql_version, data_center, gossip_generation, host_id, listen_address, native_protocol_version, partitioner, rack, release_version, rpc_address, schema_version, thrift_version, tokens, truncated_at	Informationen über den lokalen Keyspace.
peers	peer, data_center, host_id, preferred_ip, rack, release_version, rpc_address, schema_version, tokens	Fragen Sie diese Tabelle ab, um die verfügbaren Endpunkte anzuzeigen. Wenn Sie beispielsweise eine Verbindung über einen öffentlichen Endpunkt herstellen, wird eine Liste mit neun verfügbaren IP-Adressen angezeigt. Wenn Sie eine Verbindung über einen FIPS-Endpunkt herstellen, wird eine Liste mit drei IP-Adressen angezeigt. Wenn Sie eine Verbindung über einen AWS PrivateLink VPC-Endpunkt herstellen, wird die Liste der IP-Adressen angezeigt, die Sie konfiguriert haben. Weitere Informationen finden Sie unter Auffüllen von system.peers Tabelleneinträgen mit VPC-Endpunktinformationen der Schnittstelle.
size_estimates	keyspace_name, table_name, range_start, range_end, mean_partition_size, partitions_count	Diese Tabelle definiert die Gesamtgröße und die Anzahl der Partitionen für jeden Tokenbereich für jede Tabelle. Dies ist für den Apache Cassandra Spark Connector erforderlich, der die geschätzte Partitionsgröße verwendet, um die Arbeit zu verteilen.
prepared_statements	prepared_id, logged_keyspace, query_string	Diese Tabelle enthält Informationen zu gespeicherten Abfragen.

system_schema

Dies ist ein Cassandra-Schlüsselraum. Amazon Keyspaces verwendet die folgenden Tabellen.

Tabellennamen	Spaltennamen	Kommentare
keyspaces	keyspace_name, durable_writes, replication	Informationen zu einem bestimmten Keyspace.
tables	keyspace_name, table_name, bloom_filter_fp_chance, caching, comment, compaction, compression, crc_check_chance, dclocal_read_repair_chance, default_time_to_live, extensions, flags, gc_grace_seconds, id, max_index_interval, memtable_flush_period_in_ms, min_index_interval, read_repair_chance, speculative_retry	Informationen zu einer bestimmten Tabelle.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Informationen zu einer bestimmten Spalte.

system_schema_mcs

Dies ist ein Amazon Keyspaces Keyspace, der Informationen zu AWS oder Amazon Keyspaces spezifischen Einstellungen speichert.

Tabellennamen	Spaltennamen	Kommentare
keyspaces	keyspace_name, durable_writes, replication	Fragen Sie diese Tabelle ab, um programmgesteuert herauszufinden, ob ein Keyspace erstellt wurde. Weitere Informationen finden Sie unter Erstellen von Keyspaces in Amazon Keyspaces.
tables	keyspace_name, creation_time, speculative_retry, cdc, gc_grace_seconds, crc_check_chance, min_index_interval, bloom_filter_fp_chance, flags, custom_properties, dclocal_read_repair_chance, table_name, caching, default_time_to_live, read_repair_chance, max_index_interval, extensions, compaction, comment, id, compression, memtable_flush_period_in_ms, status	Fragen Sie diese Tabelle ab, um den Status einer bestimmten Tabelle zu ermitteln. Weitere Informationen finden Sie unter Erstellen von Tabellen in Amazon Keyspaces. Sie können diese Tabelle auch abfragen, um Einstellungen aufzulisten, die für Amazon Keyspaces spezifisch sind und als gespeichert werdencustom_properties. Beispielsweise: capacity_mode client_side_timestamps encryption_specification point_in_time_recovery ttl
tables_history	keyspace_name, table_name, event_time, creation_time, custom_properties, event	Fragen Sie diese Tabelle ab, um mehr über Schemaänderungen für eine bestimmte Tabelle zu erfahren.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Diese Tabelle ist mit der Cassandra-Tabelle im system_schema Keyspace identisch.
tags	resource_id, keyspace_name, resource_name, resource_type, tags	Fragen Sie diese Tabelle ab, um herauszufinden, ob ein Keyspace Tags hat. Weitere Informationen finden Sie unter Hinzufügen von von Spaces zu neuen oder vorhandenen Schlüsselräumen und Tabellen mit CQL.
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update	Fragen Sie diese Tabelle ab, um die Auto-Scaling-Einstellungen einer bereitgestellten Tabelle abzurufen. Beachten Sie, dass diese Einstellungen erst verfügbar sind, wenn die Tabelle aktiv ist. Um diese Tabelle abzufragen, müssen Sie keyspace_name und table_name in der -WHEREKlausel angeben. Weitere Informationen finden Sie unter Verwalten von Amazon Keyspaces Auto Scaling mit Cassandra Query Language (CQL).

system_multiregion_info

Dies ist ein Amazon Keyspaces Keyspace, der Informationen über die Multi-Region-Replikation speichert.

Tabellennamen	Spaltennamen	Kommentare
tables	keyspace_name, table_name, region, status	Diese Tabelle enthält Informationen über multiregionale Tabellen, z. B. die , in der AWS-Regionen die Tabelle repliziert wird, und den Status der Tabelle. Sie können diese Tabelle auch abfragen, um Einstellungen aufzulisten, die spezifisch für Amazon Keyspaces sind, die als gespeichert werdencustom_properties. Beispielsweise: capacity_mode Um diese Tabelle abzufragen, müssen Sie keyspace_name und table_name in der -WHEREKlausel angeben. Weitere Informationen finden Sie unter Erstellen eines multiregionalen Keyspace (CQL).
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update, region	Fragen Sie diese Tabelle ab, um die Auto-Scaling-Einstellungen einer multiregionalen bereitgestellten Tabelle abzurufen. Beachten Sie, dass diese Einstellungen erst verfügbar sind, wenn die Tabelle aktiv ist. Um diese Tabelle abzufragen, müssen Sie keyspace_name und table_name in der -WHEREKlausel angeben. Weitere Informationen finden Sie unter Verwenden von CQL zum Erstellen und Verwalten von multiregionalen Tabellen.

Erstellen von Keyspaces in Amazon Keyspaces

Amazon Keyspaces führt asynchron Data Definition Language (DDL)-Operationen wie das Erstellen und Löschen von Keyspaces durch.

Sie können den Erstellungsstatus neuer Keyspaces in der überwachen AWS Management Console, was angibt, wann ein Keyspace aussteht oder aktiv ist. Sie können den Erstellungsstatus eines neuen Keyspace auch programmgesteuert überwachen, indem Sie den system_schema_mcs Keyspace verwenden. Ein Keyspace wird in der system_schema_mcs keyspaces Tabelle sichtbar, wenn er einsatzbereit ist.

Das empfohlene Entwurfsmuster, das überprüft, wann ein neuer Keyspace einsatzbereit ist, besteht darin, die Amazon Keyspaces-system_schema_mcskeyspacesTabelle (system_schema_mcs.*) abzufragen. Eine Liste der DDL-Anweisungen für Keyspaces finden Sie im Keyspaces Abschnitt in der CQL-Sprachreferenz.

Die folgende Abfrage zeigt, ob ein Keyspace erfolgreich erstellt wurde.

SELECT * FROM system_schema_mcs.keyspaces WHERE keyspace_name = 'mykeyspace';

Für einen erfolgreich erstellten Keyspace sieht die Ausgabe der Abfrage wie folgt aus.

keyspace_name | durable_writes  | replication
--------------+-----------------+--------------
   mykeyspace | true            |{...} 1 item