Utilisation des espaces de saisie dans Amazon Keyspaces

Cette section fournit des informations sur l'utilisation des espaces de touches dans Amazon Keyspaces (pour Apache Cassandra).

Utilisation des espaces de touches du système dans Amazon Keyspaces

Amazon Keyspaces utilise quatre espaces de touches système :

• system

• system_schema

• system_schema_mcs

• system_multiregion_info

Les sections suivantes fournissent des informations sur les espaces de touches du système et les tables système pris en charge dans Amazon Keyspaces.

system

Il s'agit d'un keyspace de Cassandra. Amazon Keyspaces utilise les tableaux suivants.

Noms des tables	Noms de colonnes	Commentaires
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	Informations sur le keyspace local.
peers	peer, data_center, host_id, preferred_ip, rack, release_version, rpc_address, schema_version, tokens	Consultez ce tableau pour voir les points de terminaison disponibles. Par exemple, si vous vous connectez via un point de terminaison public, une liste de neuf adresses IP disponibles s'affiche. Si vous vous connectez via un point de terminaison FIPS, une liste de trois adresses IP s'affiche. Si vous vous connectez via un point de terminaison AWS PrivateLink VPC, la liste des adresses IP que vous avez configurées s'affiche. Pour de plus amples informations, veuillez consulter Remplissage des entrées de system.peers table avec les informations de point de terminaison VPC de l'interface.
size_estimates	keyspace_name, table_name, range_start, range_end, mean_partition_size, partitions_count	Ce tableau définit la taille totale et le nombre de partitions pour chaque plage de jetons pour chaque table. Cela est nécessaire pour le connecteur Apache Cassandra Spark, qui utilise la taille de partition estimée pour distribuer le travail.
prepared_statements	prepared_id, logged_keyspace, query_string	Ce tableau contient des informations sur les requêtes enregistrées.

system_schema

Il s'agit d'un keyspace de Cassandra. Amazon Keyspaces utilise les tableaux suivants.

Noms des tables	Noms de colonnes	Commentaires
keyspaces	keyspace_name, durable_writes, replication	Informations relatives à un keyspace spécifique.
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	Informations relatives à une table spécifique.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Informations relatives à une colonne spécifique.

system_schema_mcs

Il s'agit d'un espace de touches Amazon Keyspaces qui stocke des informations ou des paramètres spécifiques à AWS Amazon Keyspaces.

Noms des tables	Noms de colonnes	Commentaires
keyspaces	keyspace_name, durable_writes, replication	Interrogez cette table pour savoir par programmation si un espace de touches a été créé. Pour de plus amples informations, veuillez consulter Création d'espaces de touches dans 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	Interrogez cette table pour connaître le statut d'une table spécifique. Pour de plus amples informations, veuillez consulter Création de tables dans Amazon Keyspaces. Vous pouvez également consulter ce tableau pour répertorier les paramètres spécifiques à Amazon Keyspaces et stockés sous le nom de. custom_properties Par exemple : 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	Interrogez cette table pour en savoir plus sur les modifications apportées au schéma d'une table spécifique.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Cette table est identique à la table Cassandra dans le system_schema keyspace.
tags	resource_id, keyspace_name, resource_name, resource_type, tags	Interrogez ce tableau pour savoir si un espace de touches contient des balises. Pour de plus amples informations, veuillez consulter Ajout d'étiquettes à des tables et des espaces clés nouveaux ou existants à l'aide du CQL.
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update	Interrogez cette table pour obtenir les paramètres de dimensionnement automatique d'une table provisionnée. Notez que ces paramètres ne seront pas disponibles tant que le tableau ne sera pas actif. Pour interroger cette table, vous devez spécifier keyspace_name et table_name dans la WHERE clause. Pour de plus amples informations, veuillez consulter Gestion du dimensionnement automatique d'Amazon Keyspaces avec Cassandra Query Language (CQL).

system_multiregion_info

Il s'agit d'un espace de touches Amazon Keyspaces qui stocke des informations sur la réplication multirégionale.

Noms des tables	Noms de colonnes	Commentaires
tables	keyspace_name, table_name, region, status	Ce tableau contient des informations sur les tables multirégionales, par exemple les informations dans Régions AWS lesquelles la table est répliquée et le statut de la table. Vous pouvez également consulter ce tableau pour répertorier les paramètres spécifiques à Amazon Keyspaces stockés sous le nom de. custom_properties Par exemple : capacity_mode Pour interroger cette table, vous devez spécifier keyspace_name et table_name dans la WHERE clause. Pour de plus amples informations, veuillez consulter Création d'un keyspace multirégional (CQL).
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update, region	Interrogez cette table pour obtenir les paramètres de dimensionnement automatique d'une table provisionnée multirégionale. Notez que ces paramètres ne seront pas disponibles tant que le tableau ne sera pas actif. Pour interroger cette table, vous devez spécifier keyspace_name et table_name dans la WHERE clause. Pour de plus amples informations, veuillez consulter Utilisation de CQL pour créer et gérer des tables multirégionales.

Création d'espaces de touches dans Amazon Keyspaces

Amazon Keyspaces exécute des opérations de langage de définition de données (DDL), telles que la création et la suppression d'espaces clés, de manière asynchrone.

Vous pouvez surveiller l'état de création de nouveaux espaces clés dans le AWS Management Console, ce qui indique lorsqu'un espace clé est en attente ou actif. Vous pouvez également contrôler l'état de création d'un nouvel espace de touches par programmation à l'aide de l'espace de touches. system_schema_mcs Un espace de touche devient visible dans le system_schema_mcs keyspaces tableau lorsqu'il est prêt à être utilisé.

Le modèle de conception recommandé pour vérifier qu'un nouvel espace de touches est prêt à être utilisé consiste à interroger la table Amazon system_schema_mcs keyspaces Keyspaces (system_schema_mcs.*). Pour obtenir la liste des instructions DDL pour les espaces clés, consultez la Keyspaces section du manuel de référence du langage CQL.

La requête suivante indique si un espace de touches a été créé avec succès.

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

Pour un espace de touches créé avec succès, le résultat de la requête ressemble à ce qui suit.

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