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.

Elementos de Cassandra Query Language (CQL) en Amazon Keyspaces

Obtenga información sobre los elementos de Cassandra Query Language (CQL) compatibles con Amazon Keyspaces, incluidos los identificadores, las constantes, los términos y los tipos de datos.

Identificadores

Los identificadores (o nombres) se utilizan para identificar tablas, columnas y otros objetos. Un identificador puede estar entre comillas o no. Se aplica lo siguiente.

identifier          ::=  unquoted_identifier | quoted_identifier
unquoted_identifier ::=  re('[a-zA-Z][a-zA-Z0-9_]*')
quoted_identifier   ::=  '"' (any character where " can appear if doubled)+ '"'
            

Constantes

Se definen las siguientes constantes.

constant ::=  string | integer | float | boolean | uuid | blob | NULL
string   ::=  '\'' (any character where ' can appear if doubled)+ '\''
              '$$' (any character other than '$$') '$$'
integer  ::=  re('-?[0-9]+')
float    ::=  re('-?[0-9]+(\.[0-9]*)?([eE][+-]?[0-9+])?') | NAN | INFINITY
boolean  ::=  TRUE | FALSE
uuid     ::=  hex{8}-hex{4}-hex{4}-hex{4}-hex{12}
hex      ::=  re("[0-9a-fA-F]")
blob     ::=  '0' ('x' | 'X') hex+
            

Términos

Un término denota el tipo de valores que se admiten. Los términos se definen del siguiente modo.

term                 ::=  constant | literal | function_call | arithmetic_operation | type_hint | bind_marker
literal              ::=  collection_literal | tuple_literal
function_call        ::=  identifier '(' [ term (',' term)* ] ')'
arithmetic_operation ::=  '-' term | term ('+' | '-' | '*' | '/' | '%') term
        

Tipos de datos

Amazon Keyspaces admite los siguientes tipos de datos:

Tipos de cadena

Tipos numéricos

Contadores

Una columna counter contiene un entero con signo de 64 bits. El valor del contador se incrementa o decrementa mediante la instrucción UPDATE y no se puede establecer directamente. Esto hace que las columnas counter sean útiles para el seguimiento de recuentos. Por ejemplo, puede utilizar contadores para realizar un seguimiento del número de entradas en un archivo de registro o del número de veces que se ha visto una publicación en una red social. Se aplican las siguientes restricciones a las columnas counter:

En los casos en que la actualización de un contador fallase (por ejemplo, debido a tiempos de espera o a la pérdida de conexión con Amazon Keyspaces), el cliente no sabe si el valor del contador se actualizó. Si se vuelve a intentar la actualización, es posible que la actualización del valor del contador se aplique por segunda vez.

Tipo de blob

Tipo booleano

Tipos relacionados en el tiempo

Tipos de colección

Una columna de colección se declara utilizando el tipo de colección seguido de otro tipo de datos (por ejemplo, TEXT o INT) entre corchetes angulares. Puede crear una columna con un SET de TEXT o puede crear un MAP de TEXT y pares clave-valor INT, como se muestra en el siguiente ejemplo.

SET <TEXT>
MAP <TEXT, INT>

Una colección no congelada le permite realizar actualizaciones en cada elemento individual de la colección. Las marcas de tiempo del cliente y los ajustes de Time to Live (TTL) se almacenan para los elementos individuales.

Al utilizar la palabra clave FROZEN en un tipo de colección, los valores de la colección se serializan en un único valor inmutable y Amazon Keyspaces los trata como un BLOB. Esto es una colección congelada. Una instrucción INSERT o UPDATE sobrescribe toda la colección congelada. No se pueden realizar actualizaciones de elementos individuales dentro de una colección congelada.

Las marcas de tiempo del cliente y los ajustes de Time to Live (TTL) se aplican a toda la colección congelada, no a elementos individuales. Frozenlas columnas de recopilación pueden formar parte de una tabla. PRIMARY KEY

Puede anidar colecciones congeladas. Por ejemplo, puede definir un MAP dentro de un SET si el MAP utiliza la palabra clave FROZEN, como se muestra en el siguiente ejemplo.

SET <FROZEN> <MAP <TEXT, INT>>>

Amazon Keyspaces admite el anidamiento de hasta cinco niveles de colecciones congeladas de forma predeterminada. Para obtener más información, consulte Cuotas de servicio de Amazon Keyspaces. Para obtener más información sobre las diferencias funcionales con Apache Cassandra, consulte Colecciones FROZEN. Para obtener más información sobre CQL la sintaxis, consulte CREATE TABLE yALTER TABLE.

Tipo de tupla

El tipo de datos tuple representa un grupo acotado de elementos literales. Puede utilizar una tupla como alternativa a un user defined type. No es necesario que utilice la palabra clave FROZEN para las tuplas. Esto se debe a que una tupla siempre está congelada y no puede actualizar los elementos de forma individual.

Otros tipos

Estático

En una tabla de Amazon Keyspaces con columnas agrupadas en clústeres, puede utilizar la STATIC palabra clave para crear una columna estática de cualquier tipo.

La siguiente instrucción es un ejemplo de ello.

my_column INT STATIC

Para obtener más información sobre cómo trabajar con columnas estáticas, consulte. Estime el consumo de capacidad de las columnas estáticas en Amazon Keyspaces

JSONcodificación de los tipos de datos de Amazon Keyspaces

Amazon Keyspaces ofrece las mismas asignaciones de tipos de JSON datos que Apache Cassandra. En la siguiente tabla se describen los tipos de datos que Amazon Keyspaces acepta en las instrucciones INSERT JSON y los tipos de datos que Amazon Keyspaces utiliza al devolver datos con la instrucción SELECT JSON.

En los tipos de datos de campo único como float, int, UUID y date también puede insertar datos como string. Para colecciones y tipos de datos compuestos, comotuple, y maplist, también puede insertar datos codificados JSON o codificados. JSON string