Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
En este paso, creará una tabla utilizando la consola, cqlsh
o la AWS CLI.
Una tabla es el lugar donde se organizan y almacenan sus datos. La clave principal de su tabla determina cómo se particionan los datos en la tabla. La clave principal se compone de una clave de partición obligatoria y una o varias columnas de agrupación opcionales. Los valores combinados que componen la clave principal deben ser únicos en todos los datos de la tabla. Para obtener más información sobre las tablas, consulte los siguientes temas:
Diseño de claves de partición: Uso eficaz de las claves de partición en Amazon Keyspaces
Uso de tablas: Comprobación del estado de creación de las tablas en Amazon Keyspaces
-
Instrucciones DDL en la referencia del lenguaje CQL: Tablas
Administración de recursos de la tabla: Administración de recursos sin servidor en Amazon Keyspaces (para Apache Cassandra)
Monitoreo de utilización de recursos de la tabla: Supervisión de Amazon Keyspaces con Amazon CloudWatch
Al crear una tabla, especifica lo siguiente:
-
El nombre de la tabla.
-
El nombre y el tipo de datos de cada columna de la tabla.
-
La clave principal de la tabla.
-
Clave de partición: obligatorio
-
Columnas de agrupación: opcional
-
Utilice el siguiente procedimiento para crear una tabla con las columnas, los tipos de datos, las claves de partición y las columnas de agrupación especificados.
El siguiente procedimiento crea la tabla book_awards
con estas columnas y tipos de datos.
year int
award text
rank int
category text
book_title text
author text
publisher text
Para crear una tabla con la consola
-
Inicie sesión en la AWS Management Console y abra la consola de Amazon Keyspaces en https://console.aws.amazon.com/keyspaces/home
. -
En el panel de navegación, elija Espacios de claves.
-
Elija
catalog
como el espacio de claves en el que desea crear esta tabla. -
Elija Crear tabla.
-
En el cuadro Nombre de la tabla, introduzca
book_awards
como nombre para la tabla.Restricciones del nombre:
-
El nombre no puede estar vacío.
-
Caracteres permitidos: alfanuméricos y guion bajo (
_
). -
La longitud máxima es de 48 caracteres.
-
-
En la sección Columnas, repita los siguientes pasos para cada columna que desee añadir a esta tabla.
Añada las columnas y tipos de datos siguientes.
year int award text rank int category text book_title text author text publisher text
-
Nombre: introduzca un nombre para la columna.
Restricciones del nombre:
-
El nombre no puede estar vacío.
-
Caracteres permitidos: alfanuméricos y guion bajo (
_
). -
La longitud máxima es de 48 caracteres.
-
-
Tipo: en la lista de tipos de datos, elija el tipo de datos para esta columna.
-
Para añadir una columna, elija Agregar columna.
-
-
Elija
award
yyear
como claves de partición en Clave de partición. Se necesita una clave de partición para cada tabla. Una clave de partición puede estar formada por una o más columnas. -
Añada
category
yrank
como Columnas de agrupación en clústeres. Las columnas de agrupación son opcionales y determinan el orden de clasificación dentro de cada partición.-
Para añadir una columna de agrupación, elija Agregar columnas de agrupación en clústeres.
-
En la lista Columnas, elija la categoría. En la lista Orden, elija ASC para clasificar en orden ascendente los valores de esta columna. (Elija DESC para orden descendente).
A continuación, seleccione Agregar columnas de agrupación en clústeres y elija el rango.
-
-
En la sección Configuración de la tabla, elija Configuración predeterminada.
-
Elija Crear tabla.
-
Verifique que se haya creado su tabla.
-
En el panel de navegación, elija Tablas.
-
Confirme que su tabla se encuentre en la lista de tablas.
-
Elija el nombre de su tabla.
-
Confirme que todas sus columnas y tipos de datos sean correctos.
nota
Es posible que las columnas no aparezcan en el mismo orden en que las añadió a la tabla.
-
Este procedimiento crea una tabla con las siguientes columnas y tipos de datos utilizando CQL. Las columnas year
y award
son claves de partición con category
y rank
como columnas de agrupación en clústeres, juntas forman la clave principal de la tabla.
year int
award text
rank int
category text
book_title text
author text
publisher text
Para crear una tabla utilizando CQL
Abra AWS CloudShell y conéctese a Amazon Keyspaces mediante el siguiente comando. Asegúrese de actualizar
us-east-1
con su propia región.cqlsh-expansion cassandra.
us-east-1
.amazonaws.com 9142 --sslLa salida de ese comando debería tener este aspecto.
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.
-
En la línea de comandos del espacio de claves (
cqlsh:keyspace_name>
), cree su tabla introduciendo el siguiente código en su ventana de comandos.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
es el orden de agrupación predeterminado. También puede especificarDESC
para el orden descendente.Tenga en cuenta que
year
yaward
son columnas de las claves de partición. Además,category
yrank
son las columnas de agrupación colocadas por orden ascendente (ASC
). Juntas, estas columnas forman la clave principal de la tabla. -
Verifique que se haya creado su tabla.
SELECT * from system_schema.tables WHERE keyspace_name='catalog.book_awards' ;
La salida debería ser similar a la siguiente.
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 la estructura de su tabla.
SELECT * FROM system_schema.columns WHERE keyspace_name = 'catalog' AND table_name = 'book_awards';
La salida de esta instrucción debe ser similar al siguiente ejemplo.
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 que todas las columnas y tipos de datos sean los deseados. El orden de las columnas podría diferir al de la instrucción
CREATE
.
El siguiente procedimiento crea una tabla con las siguientes columnas y tipos de datos utilizando la AWS CLI. Las columnas year
y award
componen la clave de partición con category
y rank
como columnas de agrupación en clústeres.
year int
award text
rank int
category text
book_title text
author text
publisher text
Para crear una tabla con AWS CLI
El siguiente comando crea una tabla con el nombre book_awards. La clave de partición de la tabla está formada por las columnas year
y award
y la clave de agrupación está formada por las columnas category
y rank
; ambas columnas de agrupación utilizan el orden de clasificación ascendente. (Para facilitar la legibilidad, la schema-definition
del comando de creación de tabla de esta sección se divide en líneas separadas).
-
Puede crear la tabla con la siguiente instrucción.
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 da como resultado la siguiente salida.
{ "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/catalog/table/book_awards" }
-
Para confirmar los metadatos y las propiedades de la tabla, puede utilizar el siguiente comando.
aws keyspaces get-table --keyspace-name 'catalog' --table-name 'book_awards'
Este comando devuelve la siguiente salida.
{ "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 operaciones CRUD (crear, leer, actualizar y eliminar) en los datos de su tabla, vaya a Creación, lectura, actualización y eliminación de datos (CRUD) mediante CQL en Amazon Keyspaces.