Crear una tabla en Amazon Keyspaces

Para crear una tabla con la consola

1. Inicie sesión en AWS Management Consoley abre la consola de Amazon Keyspaces en https://console.aws.amazon.com/keyspaces/ casa.

2. En el panel de navegación, elija Espacios de claves.

3. Elija catalog como el espacio de claves en el que desea crear esta tabla.

4. Elija Crear tabla.

5. En el cuadro Nombre de la tabla, introduzca book_awards como nombre para la tabla.

   Restricciones de nombres:

   • El nombre no puede estar vacío.

   • Caracteres permitidos: alfanuméricos y guion bajo (_).

   • La longitud máxima es de 48 caracteres.

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

   1. Nombre: introduzca un nombre para la columna.

      Restricciones de nombres:

      • El nombre no puede estar vacío.

      • Caracteres permitidos: alfanuméricos y guion bajo (_).

      • La longitud máxima es de 48 caracteres.

   2. Tipo: en la lista de tipos de datos, elija el tipo de datos para esta columna.

   3. Para añadir otra columna, selecciona Añadir columna.

7. Elija award y year 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.

8. Agregue category y rank como columnas de agrupamiento. Las columnas de agrupación son opcionales y determinan el orden de clasificación dentro de cada partición.

   1. Para añadir una columna de agrupación, elija Añadir columna de agrupación.

   2. En la lista de columnas, elija la categoría. En la lista Orden, elija ASCordenar en orden ascendente los valores de esta columna. (Elija DESCel orden descendente).

   3. A continuación, selecciona Añadir columna de agrupamiento y elige el rango.

9. En la sección Configuración de la tabla, elija Configuración predeterminada.

10. Elija Crear tabla.

11. Verifique que se haya creado su tabla.

    1. En el panel de navegación, elija Tablas.

    2. Confirme que su tabla se encuentre en la lista de tablas.

    3. Elija el nombre de su tabla.

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

Para crear una tabla mediante CQL

1. Abra AWS CloudShell y conéctese a Amazon Keyspaces mediante el siguiente comando. Asegúrese de actualizar us-east-1 con tu propia región.

   cqlsh-expansion cassandra.us-east-1.amazonaws.com 9142 --ssl

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

2. 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 especificar DESC para el orden descendente.

   Tenga en cuenta que las columnas year y award son claves de partición. Luego, category y rank son las columnas agrupadas ordenadas en orden ascendente ()ASC. Juntas, estas columnas forman la clave principal de la tabla.

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

4. Verifique la estructura de su tabla.

   SELECT * FROM system_schema.columns WHERE keyspace_name = 'catalog' AND table_name = 'book_awards';

   El resultado de esta declaración debería tener un aspecto similar al de este 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.

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 lectura, el comando schema-definition de creación de tablas de esta sección está dividido en líneas independientes).

1. Puede crear la tabla mediante 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"
   }

2. 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": []
   }