Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elementi Cassandra Query Language (CQL) in Amazon Keyspaces

Scopri gli elementi Cassandra Query Language (CQL) supportati da Amazon Keyspaces, inclusi identificatori, costanti, termini e tipi di dati.

Identificatori

Gli identificatori (o nomi) vengono utilizzati per identificare tabelle, colonne e altri oggetti. Un identificatore può essere citato o non quotato. Si applica quanto segue.

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

Costanti

Sono definite le seguenti costanti.

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+

Termini

Un termine indica il tipo di valori supportati. I termini sono definiti come segue.

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

Tipi di dati

Amazon Keyspaces supporta i seguenti tipi di dati:

Tipo stringa

Tipi numerici

Contatori

UN counter la colonna contiene un numero intero con segno a 64 bit. Il valore del contatore viene incrementato o decrementato utilizzando UPDATE dichiarazione e non può essere impostato direttamente. Questo rende counter colonne utili per tenere traccia dei conteggi. Ad esempio, puoi utilizzare i contatori per tenere traccia del numero di voci in un file di registro o del numero di volte in cui un post è stato visualizzato su un social network. Le seguenti restrizioni si applicano a counter colonne:

Nei casi in cui un contatore non viene aggiornato (ad esempio, a causa di timeout o perdita di connessione con Amazon Keyspaces), il cliente non sa se il valore del contatore è stato aggiornato. Se l'aggiornamento viene ripetuto, l'aggiornamento del valore del contatore potrebbe essere applicato una seconda volta.

Tipo di blob

Tipo booleano

Time-related tipi

Tipi di raccolta

Si dichiara una colonna di raccolta utilizzando il tipo di raccolta seguito da un altro tipo di dati (ad esempio, TEXT o INT) tra parentesi angolate. È possibile creare una colonna con SET di TEXT, oppure puoi creare un MAP di TEXT e INT coppie chiave-valore, come mostrato nell'esempio seguente.

SET <TEXT>
MAP <TEXT, INT>

A non congelato la raccolta consente di apportare aggiornamenti a ogni singolo elemento della raccolta. Client-side i timestamp e le impostazioni Time to Live (TTL) vengono memorizzati per i singoli elementi.

Quando si utilizza FROZEN parola chiave su un tipo di raccolta, i valori della raccolta vengono serializzati in un unico valore immutabile e Amazon Keyspaces li tratta come un BLOB. Questo è un ghiacciato collezione. Un INSERT o UPDATE l'istruzione sovrascrive l'intera raccolta congelata. Non è possibile apportare aggiornamenti a singoli elementi all'interno di una raccolta congelata.

Client-side i timestamp e le impostazioni Time to Live (TTL) si applicano all'intera raccolta congelata, non ai singoli elementi. Frozen le colonne della raccolta possono far parte di PRIMARY KEY di una tabella.

Puoi annidare le raccolte congelate. Ad esempio, puoi definire un MAP all'interno di un SET se MAP sta usando il FROZEN parola chiave, come mostrato nell'esempio seguente.

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

Amazon Keyspaces supporta l'annidamento di un massimo di 8 livelli di raccolte bloccate per impostazione predefinita. Per ulteriori informazioni, consulta Quote di servizio Amazon Keyspaces. Per ulteriori informazioni sulle differenze funzionali con Apache Cassandra, consulta FROZENcollezioni. Per ulteriori informazioni sulla sintassi CQL, vedere CREATE TABLE e ALTER TABLE.

Tipo di tupla

Il tuple il tipo di dati rappresenta un gruppo limitato di elementi letterali. Puoi usare una tupla come alternativa a a user defined type. Non è necessario utilizzare FROZEN parola chiave per le tuple. Questo perché una tupla è sempre bloccata e non è possibile aggiornare gli elementi singolarmente.

Altri tipi

Statico

In una tabella Amazon Keyspaces con colonne di clustering, puoi utilizzare STATIC parola chiave per creare una colonna statica di qualsiasi tipo.

La seguente dichiarazione ne è un esempio.

my_column INT STATIC

Per ulteriori informazioni sull'utilizzo delle colonne statiche, vedere Stima del consumo di capacità per le colonne statiche in Amazon Keyspaces.

User-defined tipi (UDT)

Amazon Keyspaces supporta i tipi definiti dall'utente (UDT). Puoi utilizzare qualsiasi tipo di dati Amazon Keyspaces valido per creare un UDT, incluse raccolte e altri UDT esistenti. Gli UDT vengono creati in un keyspace e possono essere utilizzati per definire colonne in qualsiasi tabella nel keyspace.

Per ulteriori informazioni sulla sintassi CQL, vedere User-defined tipi (UDT). Per ulteriori informazioni sull'utilizzo degli UDT, vedere User-defined tipi (UDT) in Amazon Keyspaces.

Per vedere quanti UDT sono supportati per keyspace, i livelli di annidamento supportati e altri valori e quote predefiniti relativi agli UDT, vedi Quote e valori predefiniti per i tipi definiti dall'utente (UDT) in Amazon Keyspaces.

Codifica JSON dei tipi di dati Amazon Keyspaces

Amazon Keyspaces offre le stesse mappature dei tipi di dati JSON di Apache Cassandra. La tabella seguente descrive i tipi di dati in cui Amazon Keyspaces accetta INSERT JSON dichiarazioni e i tipi di dati utilizzati da Amazon Keyspaces per la restituzione di dati con SELECT JSON dichiarazione.

Per tipi di dati a campo singolo come float, int, UUID, e date, puoi anche inserire dati come string. Per tipi e raccolte di dati composti, ad esempio tuple, map, e list, puoi anche inserire dati come JSON o come codificati JSON string.