Como trabalhar com espaços de chaves no Amazon Keyspaces

Esta seção fornece detalhes sobre como trabalhar com espaços de chaves no Amazon Keyspaces (para Apache Cassandra).

Como trabalhar com espaços de chaves do sistema no Amazon Keyspaces

O Amazon Keyspaces usa quatro espaços de chaves do sistema:

• system

• system_schema

• system_schema_mcs

• system_multiregion_info

As seções a seguir fornecem detalhes sobre os espaços de chave do sistema e as tabelas do sistema que são compatíveis com o Amazon Keyspaces.

system

Este é um espaço de chaves do Cassandra. O Amazon Keyspaces usa as tabelas a seguir.

Nomes das tabelas	Nomes de colunas	Comentários
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	Informações sobre o espaço de chaves local.
peers	peer, data_center, host_id, preferred_ip, rack, release_version, rpc_address, schema_version, tokens	Consulte essa tabela para ver os endpoints disponíveis. Por exemplo, se você estiver se conectando por meio de um endpoint público, verá uma lista de nove endereços IP disponíveis. Se você estiver se conectando por meio de um endpoint FIPS, verá uma lista de três endereços IP. Se você estiver se conectando por meio de um AWS PrivateLink VPC endpoint, verá a lista de endereços IP que você configurou. Para ter mais informações, consulte Como preencher entradas da tabela system.peers com informações do endpoint da VPC de interface.
size_estimates	keyspace_name, table_name, range_start, range_end, mean_partition_size, partitions_count	Essa tabela define o tamanho total e o número de partições para cada intervalo de tokens para cada tabela. Isso é necessário para o conector Apache Cassandra do Spark, que usa o tamanho estimado da partição para distribuir o trabalho.
prepared_statements	prepared_id, logged_keyspace, query_string	Essa tabela contém informações sobre consultas salvas.

system_schema

Este é um espaço de chaves do Cassandra. O Amazon Keyspaces usa as tabelas a seguir.

Nomes das tabelas	Nomes de colunas	Comentários
keyspaces	keyspace_name, durable_writes, replication	Informações sobre um espaço de chaves específico.
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	Informações sobre uma tabela específica.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Informações sobre uma coluna específica.

system_schema_mcs

Esse é um keyspace do Amazon Keyspaces que armazena informações sobre ou configurações específicas do AWS Amazon Keyspaces.

Nomes das tabelas	Nomes de colunas	Comentários
keyspaces	keyspace_name, durable_writes, replication	Consulte essa tabela para descobrir programaticamente se um espaço de chaves foi criado. Para ter mais informações, consulte Como criar espaços de chaves no 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	Consulte essa tabela para descobrir o status de uma tabela específica. Para ter mais informações, consulte Como criar tabelas no Amazon Keyspaces. Você também pode consultar essa tabela para listar as configurações específicas do Amazon Keyspaces e armazenadas como. custom_properties Por exemplo: . 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	Consulte essa tabela para saber mais sobre as alterações de esquema de uma tabela específica.
columns	keyspace_name, table_name, column_name, clustering_order, column_name_bytes, kind, position, type	Essa tabela é idêntica à tabela Cassandra no espaço de chaves system_schema.
tags	resource_id, keyspace_name, resource_name, resource_type, tags	Consulte essa tabela para descobrir se um espaço de chaves tem tags. Para ter mais informações, consulte Adição de tags a espaços de chaves e tabelas novos ou existentes usando o CQL.
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update	Consulte essa tabela para obter as configurações de escalonamento automático de uma tabela provisionada. Observe que essas configurações não estarão disponíveis até que a tabela esteja ativa. Para consultar essa tabela, você precisa especificar keyspace_name e table_name na cláusula WHERE. Para ter mais informações, consulte Gerenciando a escalabilidade automática do Amazon Keyspaces com a Cassandra Query Language (CQL).

system_multiregion_info

Esse é um espaço de chaves do Amazon Keyspaces que armazena informações sobre replicação multirregional.

Nomes das tabelas	Nomes de colunas	Comentários
tables	keyspace_name, table_name, region, status	Essa tabela contém informações sobre tabelas multirregionais — por exemplo, em Regiões da AWS que a tabela é replicada e o status da tabela. Você também pode consultar essa tabela para listar as configurações específicas do Amazon Keyspaces que são armazenadas como. custom_properties Por exemplo: . capacity_mode Para consultar essa tabela, você precisa especificar keyspace_name e table_name na cláusula WHERE. Para ter mais informações, consulte Como criar um espaço de chaves multirregional (CQL).
autoscaling	keyspace_name, table_name, provisioned_read_capacity_autoscaling_update, provisioned_write_capacity_autoscaling_update, region	Consulte essa tabela para obter as configurações de escalonamento automático de uma tabela provisionada por várias regiões. Observe que essas configurações não estarão disponíveis até que a tabela esteja ativa. Para consultar essa tabela, você precisa especificar keyspace_name e table_name na cláusula WHERE. Para ter mais informações, consulte Usando o CQL para criar e gerenciar tabelas multirregionais.

Como criar espaços de chaves no Amazon Keyspaces

O Amazon Keyspaces executa operações de linguagem de definição de dados (DDL), como criar e excluir espaços de chaves de forma assíncrona.

Você pode monitorar o status de criação de novos espaços de chave no AWS Management Console, que indica quando um espaço de tecla está pendente ou ativo. Você também pode monitorar o status de criação de um novo espaço de chaves programaticamente usando o espaço de chaves system_schema_mcs. Um espaço de teclas fica visível na system_schema_mcs keyspaces tabela quando está pronto para uso.

O padrão de design recomendado para verificar quando um novo espaço de chaves está pronto para uso é pesquisar as tabelas system_schema_mcs keyspaces do Amazon Keyspaces (system_schema_mcs.*). Para obter uma lista de instruções DDL para espaços de chaves, consulte a seção Keyspaces na referência da linguagem CQL.

A consulta a seguir mostra se um espaço de chaves foi criado com sucesso.

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

Para um espaço de chave que foi criado com sucesso, a saída da consulta é semelhante à seguinte.

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