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

Elementos do Cassandra Query Language (CQL) no Amazon Keyspaces

Saiba mais sobre os elementos da Cassandra Query Language (CQL) que são compatíveis com o Amazon Keyspaces, incluindo identificadores, constantes, termos e tipos de dados.

Identificadores

Identificadores (ou nomes) são usados para identificar tabelas, colunas e outros objetos. Um identificador pode ser citado ou não. O seguinte se aplica.

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

As seguintes constantes são definidas.

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+
            

Termos

Um termo denota o tipo de valores que são compatíveis. Os termos são definidos pelo seguinte.

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 dados

O Amazon Keyspaces é compatível com os seguintes tipos de dados:

Tipos de string

Tipos numéricos

Contadores

Uma counter coluna contém um número inteiro assinado de 64 bits. O valor do contador é incrementado ou diminuído usando a instrução UPDATE e não pode ser definido diretamente. Isso torna as colunas counter úteis para rastrear contagens. Por exemplo, você pode usar contadores para rastrear o número de entradas em um arquivo de log ou o número de vezes que uma publicação foi visualizada em uma rede social. As restrições a seguir se aplicam às colunas counter:

Nos casos em que uma atualização do contador falha (por exemplo, devido ao tempo limite ou à perda de conexão com o Amazon Keyspaces), o cliente não sabe se o valor do contador foi atualizado. Se a atualização for repetida, a atualização do valor do contador poderá ser aplicada pela segunda vez.

Tipo Blob

Tipo booliano

Tipos relacionados ao tempo

Tipos de coleção

Você declara uma coluna de coleta usando o tipo de coleta seguido por outro tipo de dados (por exemplo, TEXT ou INT) entre parênteses angulares “<>”. Você pode criar uma coluna com um SET de TEXT, ou você pode criar um par de valor-chave MAP de TEXT e INT, conforme mostrado no exemplo a seguir.

SET <TEXT>
MAP <TEXT, INT>

Uma coleção não congelada permite que você faça atualizações em cada elemento individual da coleção. Os timestamps do lado do cliente e as configurações de Time to Live (TTL) são armazenados para elementos individuais.

Quando você usa a palavra-chave FROZEN em um tipo de coleção, os valores da coleção são serializados em um único valor imutável, e o Amazon Keyspaces os trata como um BLOB. Esta é uma coleção congelada. Uma declaração INSERT ou UPDATE sobrescreve toda a coleção congelada. Você não pode fazer atualizações em elementos individuais dentro de uma coleção congelada.

Os timestamps do lado do cliente e as configurações Time to Live (TTL) se aplicam a toda a coleção congelada, não a elementos individuais. Frozencolunas de coleção podem fazer parte PRIMARY KEY de uma tabela.

Você pode aninhar coleções congeladas. Por exemplo, você pode definir o MAP dentro de um SET se MAP estiver usando a palavra-chave FROZEN, conforme mostrado no exemplo a seguir.

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

Por padrão, o Amazon Keyspaces suporta o aninhamento de até cinco níveis de coleções congeladas. Para obter mais informações, consulte Service Quotas do Amazon Keyspaces. Para obter mais informações sobre diferenças funcionais com o Apache Cassandra, consulte Coleções FROZEN. Para obter mais informações sobre CQL sintaxe, consulte CREATE TABLE e. ALTER TABLE

Tipo de tupla

O tipo de dados tuple representa um grupo limitado de elementos literais. Você pode usar uma tupla como alternativa a user defined type. Você não precisa usar a palavra-chave FROZEN para tuplas. Isso ocorre porque uma tupla está sempre congelada e você não pode atualizar elementos individualmente.

Outros tipos

Estático

Em uma tabela do Amazon Keyspaces com colunas de agrupamento, você pode usar a STATIC palavra-chave para criar uma coluna estática de qualquer tipo.

A instrução a seguir é um exemplo disso.

my_column INT STATIC

Para obter mais informações sobre como trabalhar com colunas estáticas, consulteEstime o consumo de capacidade para colunas estáticas no Amazon Keyspaces.

JSONcodificação dos tipos de dados do Amazon Keyspaces

O Amazon Keyspaces oferece os mesmos mapeamentos de tipos de JSON dados que o Apache Cassandra. A tabela a seguir descreve os tipos de dados que o Amazon Keyspaces aceita em declarações INSERT JSON e os tipos de dados que o Amazon Keyspaces usa ao retornar dados com a declaração SELECT JSON.

Para tipos de dados de campo único como float, int, UUID edate, você também pode inserir dados como string. Para tipos de dados compostos e coleções, comotuple,map, elist, você também pode inserir dados como JSON ou como codificadosJSON string.