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 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](bp-partition-key-design.md) + Trabalhar com tabelas: [Verifique o status de criação da tabela no Amazon Keyspaces](tables-create.md) + Instruções DDL na referência da linguagem CQL: [Tabelas](cql.ddl.table.md) + Gerenciamento de recursos da tabela: [Como gerenciar os recursos de tecnologia sem servidor no Amazon Keyspaces (para Apache Cassandra)](serverless_resource_management.md) + Monitoramento da utilização dos recursos da tabela: [Monitorando o Amazon Keyspaces com a Amazon CloudWatch](monitoring-cloudwatch.md) + [Cotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md) 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. ## Utilizar o console 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 Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, escolha **Keyspaces**. 1. Escolha `catalog` como o espaço de chave em que você deseja criar essa tabela. 1. Escolha **Criar tabela**. 1. Na caixa **Nome da tabela**, insira **book\$1awards** 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. 1. 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:** + Nome não pode estar vazio. + Caracteres permitidos: caracteres alfanuméricos e sublinhado ( `_` ). + O tamanho máximo é de 48 caracteres. 1. **Tipo**: na lista de tipos de dados, escolha o tipo de dados para essa coluna. 1. Para adicionar outra coluna, selecione **Add column**. 1. Escolha `award` e `year` 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. 1. Adicione `category` e `rank` como **Colunas de clustering**. 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**. 1. 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.) 1. Então, selecione **Adicionar coluna de clustering** e escolha **classificação**. 1. Na seção **Configurações da tabela**, escolha **Configurações padrão**. 1. Escolha **Criar tabela**. 1. Verifique se sua tabela foi criada. 1. No painel de navegação, selecione **Tabelas**. 1. Confirme se sua tabela está na lista de tabelas. 1. Escolha o nome da sua tabela. 1. 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. ## Usar SSL 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** 1. Abra 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. ``` 1. 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 clustering ordenadas em ordem crescente (`ASC`). Juntas, essas colunas formam a chave primária da tabela. 1. 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) ``` 1. 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`. ## Usando o AWS CLI 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\$1awards*. 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.) 1. 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:111122223333:/keyspace/catalog/table/book_awards" } ``` 1. 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:111122223333:/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](getting-started.dml.md).