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á.
Nesta etapa, você cria uma tabela usando o console, cqlsh
ou AWS CLI.
Uma tabela é onde seus dados são organizados e armazenados. A chave primária da tabela determina como os dados serã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 de 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
-
Instruções DDL na referência da linguagem CQL: Tabelas
Gerenciamento de recursos da tabela: Como gerenciar os recursos de tecnologia 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 clustering especificados.
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 Console e abra o console do Amazon Keyspaces em https://console.aws.amazon.com/keyspaces/home
. -
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:
-
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:
-
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, selecione Add column.
-
-
Escolha
award
eyear
como 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 clustering. 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 ASC para classificar em ordem crescente nos valores dessa coluna. (Escolha DESC para ordem decrescente.)
Então, selecione Adicionar coluna de clustering e escolha 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.
-
Este procedimento cria uma tabela com as seguintes colunas e tipos de dados usando CQL. As colunas year
e award
são chaves de partição com category
e rank
como colunas de clustering. 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 AWS CloudShell e se conecte 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 clustering ordenadas em 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 desta instruçã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
.
Este procedimento cria uma tabela com as seguintes colunas e tipos de dados usando AWS CLI. As colunas year
e award
formam a chave de partição com category
e rank
como colunas de clustering.
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 schema-definition
do comando de criação de tabela nesta seção é dividido em linhas separadas.)
-
Você pode criar uma tabela usando a instrução a seguir.
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 da tabela, vá para Crie, leia, atualize e exclua dados (CRUD) usando CQL no Amazon Keyspaces.