Crie uma tabela no Amazon Keyspaces - Amazon Keyspaces (para Apache Cassandra)

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:

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
  1. Faça login no AWS Management Consolee abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.

  2. No painel de navegação, escolha Keyspaces.

  3. Escolha catalog como o espaço de chave em que você deseja criar essa tabela.

  4. Escolha Create table.

  5. 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.

  6. 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
    1. 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.

    2. Tipo: na lista de tipos de dados, escolha o tipo de dados para essa coluna.

    3. Para adicionar outra coluna, escolha Adicionar coluna.

  7. Escolha award e year 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.

  8. Adicione category e rank como colunas de agrupamento. As colunas de clustering são opcionais e determinam a ordem de classificação em cada partição.

    1. Para adicionar uma coluna de clustering, escolha Adicionar coluna de clustering.

    2. Na lista de colunas, escolha a categoria. Na lista Ordem, escolha ASCclassificar em ordem crescente nos valores dessa coluna. (Escolha DESCpor ordem decrescente.)

    3. Em seguida, selecione Adicionar coluna de agrupamento e escolha a classificação.

  9. Na seção Configurações da tabela, escolha Configurações padrão.

  10. Escolha Create table.

  11. Verifique se sua tabela foi criada.

    1. No painel de navegação, selecione Tabelas.

    2. Confirme se sua tabela está na lista de tabelas.

    3. Escolha o nome da sua tabela.

    4. 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
  1. 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 --ssl

    A 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.
  2. 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 especificar DESC para ordem decrescente.

    Observe que year e award são colunas de chave de partição. Em seguida, category e rank são as colunas de agrupamento ordenadas por ordem crescente (). ASC Juntas, essas colunas formam a chave primária da tabela.

  3. 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)>
  4. 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.)

  1. 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" }
  2. 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.