As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Crie uma tabela no Amazon Keyspaces
Nesta seção, você cria uma tabela usando o cqlsh
console ou o AWS CLI.
Uma tabela é onde seus dados são organizados e armazenados. A chave primária da tabela determina como os dados são particionados na tabela. A chave primária é composta por uma chave de partição necessária e uma ou mais colunas de agrupamento opcionais. Os valores combinados que compõem a chave primária devem ser exclusivos em todos os dados da tabela. Para obter mais informações sobre tabelas, consulte os tópicos a seguir:
Design da chave de partição: Como usar chaves de partição de forma eficaz no Amazon Keyspaces
Trabalhar com tabelas: Verifique o status de criação da tabela no Amazon Keyspaces
-
DDLdeclarações na referência do CQL idioma: Tabelas
Gerenciamento de recursos da tabela: Gerenciamento de recursos sem servidor no Amazon Keyspaces (para Apache Cassandra)
Monitoramento da utilização dos recursos da tabela: Monitorando o Amazon Keyspaces com a Amazon CloudWatch
Ao criar uma tabela, especifique o seguinte:
-
O nome da tabela.
-
O nome e o tipo de dados de cada coluna em uma tabela.
-
A chave primária da tabela.
-
Chave de partição: obrigatória
-
Colunas de clustering: opcional
-
Use o procedimento a seguir para criar uma tabela com as colunas, os tipos de dados, as chaves de partição e as colunas de agrupamento especificadas.
O procedimento a seguir cria a tabela book_awards
com essas colunas e tipos de dados.
year int
award text
rank int
category text
book_title text
author text
publisher text
Para criar uma tabela usando o console
-
Faça login no AWS Management Consolee abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.
-
No painel de navegação, escolha Keyspaces.
-
Escolha
catalog
como o espaço de chave em que você deseja criar essa tabela. -
Escolha Create table.
-
Na caixa Nome da tabela, insira
book_awards
como nome da tabela.Restrições de nome:
-
O nome não pode estar vazio.
-
Caracteres permitidos: caracteres alfanuméricos e sublinhado (
_
). -
O tamanho máximo é de 48 caracteres.
-
-
Na seção Colunas, repita as etapas a seguir para cada coluna que você deseja adicionar a essa tabela.
Adicione as colunas e os tipos de dados a seguir.
year int award text rank int category text book_title text author text publisher text
-
Nome: insira o nome da coluna.
Restrições de nome:
-
O nome não pode estar vazio.
-
Caracteres permitidos: caracteres alfanuméricos e sublinhado (
_
). -
O tamanho máximo é de 48 caracteres.
-
-
Tipo: na lista de tipos de dados, escolha o tipo de dados para essa coluna.
-
Para adicionar outra coluna, escolha Adicionar coluna.
-
-
Escolha
award
eyear
como as chaves de partição em Chave de partição. É necessária uma chave de partição para cada tabela. A chave de partição pode ser composta por uma ou mais colunas. -
Adicione
category
erank
como colunas de agrupamento. As colunas de clustering são opcionais e determinam a ordem de classificação em cada partição.-
Para adicionar uma coluna de clustering, escolha Adicionar coluna de clustering.
-
Na lista de colunas, escolha a categoria. Na lista Ordem, escolha ASCclassificar em ordem crescente nos valores dessa coluna. (Escolha DESCpor ordem decrescente.)
Em seguida, selecione Adicionar coluna de agrupamento e escolha a classificação.
-
-
Na seção Configurações da tabela, escolha Configurações padrão.
-
Escolha Create table.
-
Verifique se sua tabela foi criada.
-
No painel de navegação, selecione Tabelas.
-
Confirme se sua tabela está na lista de tabelas.
-
Escolha o nome da sua tabela.
-
Confirme se todas as suas colunas e tipos de dados estão corretos.
nota
As colunas podem não estar listadas na mesma ordem em que você as adicionou à tabela.
-
Esse procedimento cria uma tabela com as seguintes colunas e tipos de dados usandoCQL. As award
colunas year
e são chaves de partição com category
e rank
como colunas de agrupamento. Juntas, elas formam a chave primária da tabela.
year int
award text
rank int
category text
book_title text
author text
publisher text
Para criar uma tabela usando CQL
Abra o AWS CloudShell e conecte-se ao Amazon Keyspaces usando o comando a seguir. Certifique-se de atualizar
us-east-1
com sua própria região.cqlsh-expansion cassandra.
us-east-1
.amazonaws.com 9142 --sslA saída do comando deve ser algo parecido com isso.
Connected to Amazon Keyspaces at cassandra.us-east-1.amazonaws.com:9142 [cqlsh 6.1.0 | Cassandra 3.11.2 | CQL spec 3.4.4 | Native protocol v4] Use HELP for help. cqlsh current consistency level is ONE.
-
No prompt do espaço de chave (
cqlsh:keyspace_name>
), crie sua tabela inserindo o código a seguir na janela de comando.CREATE TABLE
catalog.book_awards
( year int, award text, rank int, category text, book_title text, author text, publisher text, PRIMARY KEY ((year, award), category, rank) );nota
ASC
é a ordem de clustering padrão. Você também pode especificarDESC
para ordem decrescente.Observe que
year
eaward
são colunas de chave de partição. Em seguida,category
erank
são as colunas de agrupamento ordenadas por ordem crescente ().ASC
Juntas, essas colunas formam a chave primária da tabela. -
Verifique se sua tabela foi criada.
SELECT * from system_schema.tables WHERE keyspace_name='catalog.book_awards' ;
A saída deve ser semelhante a esta.
keyspace_name | table_name | bloom_filter_fp_chance | caching | cdc | 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 ---------------+------------+------------------------+---------+-----+---------+------------+-------------+------------------+----------------------------+----------------------+------------+-------+------------------+----+--------------------+-----------------------------+--------------------+--------------------+------------------- (0 rows)
> -
Verifique a estrutura da sua tabela.
SELECT * FROM system_schema.columns WHERE keyspace_name = 'catalog' AND table_name = 'book_awards';
A saída dessa declaração deve ser semelhante a este exemplo.
keyspace_name | table_name | column_name | clustering_order | column_name_bytes | kind | position | type ---------------+-------------+-------------+------------------+------------------------+---------------+----------+------ catalog | book_awards | year | none | 0x79656172 | partition_key | 0 | int catalog | book_awards | award | none | 0x6177617264 | partition_key | 1 | text catalog | book_awards | category | asc | 0x63617465676f7279 | clustering | 0 | text catalog | book_awards | rank | asc | 0x72616e6b | clustering | 1 | int catalog | book_awards | author | none | 0x617574686f72 | regular | -1 | text catalog | book_awards | book_title | none | 0x626f6f6b5f7469746c65 | regular | -1 | text catalog | book_awards | publisher | none | 0x7075626c6973686572 | regular | -1 | text (7 rows)
Confirme se todas as colunas e tipos de dados estão conforme o esperado. A ordem das colunas pode ser diferente da instrução
CREATE
.
Esse procedimento cria uma tabela com as seguintes colunas e tipos de dados usando o AWS CLI. As award
colunas year
e formam a chave de partição com category
e rank
como colunas de agrupamento.
year int
award text
rank int
category text
book_title text
author text
publisher text
Para criar uma tabela usando o AWS CLI
O comando a seguir cria uma tabela com o nome book_awards. A chave de partição da tabela consiste nas colunas year
e award
e a chave de agrupamento consiste nas colunas category
de rank
. As duas colunas de agrupamento usam a ordem de classificação crescente. (Para facilitar a leitura, o comando schema-definition
de criação da tabela nesta seção é dividido em linhas separadas.)
-
Você pode criar a tabela usando a seguinte declaração.
aws keyspaces create-table --keyspace-name 'catalog' \ --table-name 'book_awards' \ --schema-definition 'allColumns=[{name=year,type=int},{name=award,type=text},{name=rank,type=int}, {name=category,type=text}, {name=author,type=text},{name=book_title,type=text},{name=publisher,type=text}], partitionKeys=[{name=year},{name=award}],clusteringKeys=[{name=category,orderBy=ASC},{name=rank,orderBy=ASC}]'
Este comando resulta na seguinte saída.
{ "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/catalog/table/book_awards" }
-
Para confirmar os metadados e as propriedades da tabela, você pode usar o seguinte comando:
aws keyspaces get-table --keyspace-name 'catalog' --table-name 'book_awards'
Este comando retorna a seguinte saída.
{ "keyspaceName": "catalog", "tableName": "book_awards", "resourceArn": "arn:aws:cassandra:us-east-1:123SAMPLE012:/keyspace/catalog/table/book_awards", "creationTimestamp": "2024-07-11T15:12:55.571000+00:00", "status": "ACTIVE", "schemaDefinition": { "allColumns": [ { "name": "year", "type": "int" }, { "name": "award", "type": "text" }, { "name": "category", "type": "text" }, { "name": "rank", "type": "int" }, { "name": "author", "type": "text" }, { "name": "book_title", "type": "text" }, { "name": "publisher", "type": "text" } ], "partitionKeys": [ { "name": "year" }, { "name": "award" } ], "clusteringKeys": [ { "name": "category", "orderBy": "ASC" }, { "name": "rank", "orderBy": "ASC" } ], "staticColumns": [] }, "capacitySpecification": { "throughputMode": "PAY_PER_REQUEST", "lastUpdateToPayPerRequestTimestamp": "2024-07-11T15:12:55.571000+00:00" }, "encryptionSpecification": { "type": "AWS_OWNED_KMS_KEY" }, "pointInTimeRecovery": { "status": "DISABLED" }, "defaultTimeToLive": 0, "comment": { "message": "" }, "replicaSpecifications": [] }
Para realizar operações CRUD (criar, ler, atualizar e excluir) nos dados em sua tabela, prossiga paraCrie, leia, atualize e exclua dados (CRUD) usando CQL no Amazon Keyspaces.