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.

DDLdeclaraciones (lenguaje de definición de datos) en Amazon Keyspaces

El lenguaje de definición de datos (DDL) es el conjunto de sentencias de Cassandra Query Language (CQL) que se utilizan para gestionar las estructuras de datos en Amazon Keyspaces (para Apache Cassandra), como los espacios de claves y las tablas. Se utilizan DDL para crear estas estructuras de datos, modificarlas después de crearlas y eliminarlas cuando ya no se utilizan. Amazon Keyspaces realiza DDL operaciones de forma asíncrona. Para obtener más información sobre cómo confirmar si una operación asíncrona se ha completado, consulte Creación y eliminación asíncronas de espacios de claves y tablas.

Se admiten las siguientes afirmaciones: DDL

Keyspaces

Un espacio de claves agrupa tablas relacionadas que son relevantes para una o más aplicaciones. En términos de un sistema de administración de bases de datos relacionales (RDBMS), los espacios clave son más o menos similares a las bases de datos, los espacios de tablas o estructuras similares.

Para obtener información sobre los límites de cuota y las restricciones de los espacios de claves de Amazon Keyspaces, consulte Cuotas para Amazon Keyspaces (para Apache Cassandra).

CREATE KEYSPACE

Utilice la instrucción CREATE KEYSPACE para crear un nuevo espacio de claves.

Sintaxis

create_keyspace_statement ::= 
    CREATE KEYSPACE [ IF NOT EXISTS ] keyspace_name
    WITH options

Donde:

Ejemplo

Cree un espacio de claves de la siguiente manera.

CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class': 'SingleRegionStrategy'} and TAGS ={'key1':'val1', 'key2':'val2'} ;

Para crear un espacio de claves multirregional, especifique NetworkTopologyStrategy e incluya al menos dos y hasta seis Regiones de AWS. El factor de replicación de cada región es tres.

CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3'};

ALTER KEYSPACE

Se puede utilizar ALTER KEYSPACE para añadir o eliminar etiquetas de un espacio de claves.

Para añadir o eliminar etiquetas, puede utilizar la siguiente sintaxis.

Sintaxis

alter_keyspace_statement ::= 
    ALTER KEYSPACE keyspace_name
    [[ADD | DROP] TAGS

Donde:

Ejemplo

Modifique un espacio de claves de la siguiente manera.

ALTER KEYSPACE my_keyspace ADD TAGS {'key1':'val1', 'key2':'val2'};

DROP KEYSPACE

Utilice la DROP KEYSPACE instrucción para eliminar un espacio de claves, incluido todo su contenido, como las tablas.

Sintaxis

drop_keyspace_statement ::= 
    DROP KEYSPACE [ IF EXISTS ] keyspace_name

Donde:

Ejemplo

DROP KEYSPACE "myGSGKeyspace";

Tablas

Las tablas son las estructuras de datos principales de Amazon Keyspaces. Los datos de una tabla se organizan en filas y columnas. Un subconjunto de esas columnas se utiliza para determinar la partición (y, en última instancia, la ubicación de los datos) mediante la especificación de una clave de partición.

Otro conjunto de columnas puede definirse en columnas de agrupación, lo que significa que pueden participar como predicados en la ejecución de consultas.

De forma predeterminada, las tablas nuevas se crean con capacidad de rendimiento bajo demanda. Puede cambiar el modo de capacidad para las tablas nuevas y existentes. Para obtener más información sobre los modos de capacidad de rendimiento de lectura/escritura, consulte Configurar los modos de capacidad de lectura/escritura en Amazon Keyspaces.

Para las tablas en modo aprovisionado, puede configurar lo opcionalAUTOSCALING_SETTINGS. Para obtener más información sobre el escalado automático de Amazon Keyspaces y las opciones disponibles, consulte. Configure el escalado automático en una tabla existente

Para obtener información sobre los límites de cuota y las restricciones de las tablas de Amazon Keyspaces, consulte Cuotas para Amazon Keyspaces (para Apache Cassandra).

CREATE TABLE

Utilice la instrucción CREATE TABLE para crear una tabla nueva.

Sintaxis

create_table_statement ::=  CREATE TABLE [ IF NOT EXISTS ] table_name
    '('
        column_definition 
        ( ',' column_definition )*
        [ ',' PRIMARY KEY '(' primary_key ')' ]
    ')' [ WITH table_options ]

column_definition      ::=  column_name cql_type [ FROZEN ][ STATIC ][ PRIMARY KEY]

primary_key            ::=  partition_key [ ',' clustering_columns ]

partition_key          ::=  column_name
                              | '(' column_name ( ',' column_name )* ')'

clustering_columns     ::=  column_name ( ',' column_name )*

table_options          ::=  [table_options]
                              | CLUSTERING ORDER BY '(' clustering_order ')' [ AND table_options ]
                              | options
                              | CUSTOM_PROPERTIES
                              | AUTOSCALING_SETTINGS
                              | default_time_to_live
                              | TAGS

clustering_order       ::=  column_name (ASC | DESC) ( ',' column_name (ASC | DESC) )*

Donde:

Ejemplo

CREATE TABLE IF NOT EXISTS "my_keyspace".my_table (
                                            id text,
                                            name text,
                                            region text,
                                            division text,
                                            project text,
                                            role text,
                                            pay_scale int,
                                            vacation_hrs float,
                                            manager_id text,
                                            PRIMARY KEY (id,division))
                                            WITH CUSTOM_PROPERTIES={
                                                'capacity_mode':{
                                                        'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20
                                                    },
                                                'point_in_time_recovery':{'status': 'enabled'},
                                                'encryption_specification':{
                                                        'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                                                        'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'
                                                    }
                                            }
                                            AND CLUSTERING ORDER BY (division ASC) 
                                            AND TAGS={'key1':'val1', 'key2':'val2'}
                                            AND default_time_to_live = 3024000;

En una tabla que utilice columnas de agrupación, las columnas que no sean de agrupación pueden declararse como estáticas en la definición de la tabla. Para obtener más información sobre las columnas estáticas, consulte Estime el consumo de capacidad de las columnas estáticas en Amazon Keyspaces.

Ejemplo

CREATE TABLE "my_keyspace".my_table (
                                            id int,
                                            name text,
                                            region text,
                                            division text,
                                            project text STATIC,
                                            PRIMARY KEY (id,division));

ALTER TABLE

Utilice la instrucción ALTER TABLE para añadir nuevas columnas, añadir etiquetas o modificar las propiedades personalizadas de la tabla.

Sintaxis

alter_table_statement ::=  ALTER TABLE table_name    
 
        [ ADD ( column_definition | column_definition_list)  ] 
        [[ADD | DROP] TAGS {'key1':'val1', 'key2':'val2'}]            
        [ WITH table_options [ , ... ] ] ;
        
column_definition      ::=  column_name cql_type
                    
                

Donde:

Ejemplos

La siguiente instrucción muestra cómo añadir una columna a una tabla existente.

ALTER TABLE mykeyspace.mytable ADD (ID int);

Esta instrucción muestra cómo añadir dos columnas de colección a una tabla existente:

ALTER TABLE my_Table ADD(col_frozen_list FROZEN<LIST<FROZEN<SET<TEXT>>>>, col_map MAP<INT, FROZEN<SET<INT>>>);

Para cambiar el modo de capacidad de una tabla y especificar unidades de capacidad de lectura y escritura, puede utilizar la siguiente instrucción.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}};

La siguiente declaración especifica una KMS clave gestionada por el cliente para la tabla.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={     
              'encryption_specification':{ 
                      'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                      'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'     
                  } 
         };

Para habilitar point-in-time la restauración de una tabla, puede usar la siguiente declaración.

ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'point_in_time_recovery': {'status': 'enabled'}};

Para establecer un valor predeterminado de periodo de vida en segundos para una tabla, puede utilizar la siguiente instrucción.

ALTER TABLE my_table WITH default_time_to_live = 2592000;

Esta instrucción habilita la configuración personalizada de periodo de vida para una tabla.

ALTER TABLE mytable WITH CUSTOM_PROPERTIES={'ttl':{'status': 'enabled'}};

RESTORE TABLE

Use la instrucción RESTORE TABLE para restaurar una tabla a un momento dado. Esta declaración requiere que point-in-time la recuperación esté habilitada en una tabla. Para obtener más información, consulte Backup y restauración de datos con point-in-time recuperación para Amazon Keyspaces.

Sintaxis

restore_table_statement ::=  
    RESTORE TABLE restored_table_name FROM TABLE source_table_name 
                    [ WITH table_options [ , ... ] ];

Donde:

Ejemplo

RESTORE TABLE mykeyspace.mytable_restored from table mykeyspace.my_table 
WITH restore_timestamp = '2020-06-30T04:05:00+0000'
AND custom_properties = {'point_in_time_recovery':{'status':'disabled'}, 'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}}
AND TAGS={'key1':'val1', 'key2':'val2'};

DROP TABLE

Utilice la instrucción DROP TABLE para eliminar una tabla del espacio de claves.

Sintaxis

drop_table_statement ::=  
    DROP TABLE [ IF EXISTS ] table_name

Donde:

Ejemplo

DROP TABLE "myGSGKeyspace".employees_tbl;