Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Éléments du langage de requête Cassandra (CQL) dans Amazon Keyspaces

Découvrez les éléments du langage de requête Cassandra (CQL) pris en charge par Amazon Keyspaces, notamment les identifiants, les constantes, les termes et les types de données.

Identifiants

Les identificateurs (ou noms) sont utilisés pour identifier les tables, colonnes et autres objets. Un identifiant peut être entre apostrophes ou pas. Les conditions suivantes s'appliquent :

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

Les constantes suivantes sont définies.

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+

Conditions

Un terme désigne le type de valeurs prises en charge. Les termes sont définis par ce qui suit.

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

Types de données

Amazon Keyspaces prend en charge les types de données suivants :

Types de chaîne

Types numériques

Compteurs

Une colonne counter contient un entier signé 64 bits. La valeur du compteur est incrémentée ou décrémentée à l'aide de l'instruction UPDATE, et ne peut pas être définie directement. Cela rend les colonnes counter utiles pour le suivi des dénombrements. Par exemple, vous pouvez utiliser des compteurs pour suivre le nombre d'entrées dans un fichier journal ou le nombre de fois qu'une publication a été consultée sur un réseau social. Les restrictions ci-après s'appliquent aux colonnes counter :

Dans les cas où la mise à jour d'un compteur échoue (par exemple, en raison d'un délai d'attente ou d'une perte de connexion avec Amazon Keyspaces), le client ne sait pas si la valeur du compteur a été mise à jour. Si la mise à jour est réessayée, la mise à jour de la valeur du compteur peut être appliquée une deuxième fois.

Type de blob

Type Boolean

Types liés au temps

Types de collections

Vous déclarez une colonne de collection en utilisant le type de collection suivi d'un autre type de données (par exemple, TEXT ouINT) entre crochets. Vous pouvez créer une colonne avec un SET deTEXT, ou vous pouvez créer une paire clé-valeur TEXT et une MAP paire INT clé-valeur, comme indiqué dans l'exemple suivant.

SET <TEXT>
MAP <TEXT, INT>

Une collection non figée vous permet de mettre à jour chaque élément de collection individuel. Les horodatages côté client et les paramètres de durée de vie (TTL) sont enregistrés pour les éléments individuels.

Lorsque vous utilisez le FROZEN mot clé sur un type de collection, les valeurs de la collection sont sérialisées en une seule valeur immuable, et Amazon Keyspaces les traite comme un. BLOB Il s'agit d'une collection surgelée. Une UPDATE déclaration INSERT OR remplace l'ensemble de la collection Frozen. Vous ne pouvez pas mettre à jour des éléments individuels d'une collection figée.

Les paramètres d'horodatage et de durée de vie (TTL) côté client s'appliquent à l'ensemble de la collection figée, et non à des éléments individuels. Frozenles colonnes de collection peuvent faire partie PRIMARY KEY d'un tableau.

Vous pouvez imbriquer des collections congelées. Par exemple, vous pouvez définir un MAP dans un SET si le FROZEN mot clé MAP est utilisé, comme illustré dans l'exemple suivant.

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

Amazon Keyspaces prend en charge l'imbrication d'un maximum de 8 niveaux de collections figées par défaut. Pour de plus amples informations, veuillez consulter Quotas de service Amazon Keyspaces. Pour plus d'informations sur les différences fonctionnelles avec Apache Cassandra, consultezFROZENcollections. Pour plus d'informations sur la syntaxe CQL, consultez CREATE TABLE etALTER TABLE.

Type de tuple

Le type de tuple données représente un groupe limité d'éléments littéraux. Vous pouvez utiliser un tuple comme alternative à unuser defined type. Il n'est pas nécessaire d'utiliser le FROZEN mot-clé pour les tuples. En effet, un tuple est toujours figé et vous ne pouvez pas mettre à jour les éléments individuellement.

Autres types

Statique

Dans un tableau Amazon Keyspaces avec des colonnes de regroupement, vous pouvez utiliser le STATIC mot clé pour créer une colonne statique de n'importe quel type.

La déclaration suivante en est un exemple.

my_column INT STATIC

Pour plus d'informations sur l'utilisation de colonnes statiques, consultezEstimation de la consommation de capacité pour les colonnes statiques dans Amazon Keyspaces.

Types définis par l'utilisateur () UDTs

Amazon Keyspaces prend en charge les types définis par l'utilisateur (). UDTs Vous pouvez utiliser n'importe quel type de données Amazon Keyspaces valide pour créer un UDT, y compris les collections et autres données existantes. UDTs Vous créez UDTs dans un espace de touches et vous pouvez les utiliser pour définir des colonnes dans n'importe quel tableau de l'espace de touches.

Pour plus d'informations sur la syntaxe CQL, consultezTypes définis par l'utilisateur () UDTs. Pour plus d'informations sur l'utilisation UDTs, consultezTypes définis par l'utilisateur (UDTs) dans Amazon Keyspaces.

Pour connaître le nombre de valeurs UDTs prises en charge par espace de touches, les niveaux d'imbrication pris en charge, ainsi que les autres valeurs par défaut et quotas associés UDTs, voir. Quotas et valeurs par défaut pour les types définis par l'utilisateur (UDTs) dans Amazon Keyspaces

Encodage JSON des types de données Amazon Keyspaces

Amazon Keyspaces propose les mêmes mappages de types de données JSON qu'Apache Cassandra. Le tableau suivant décrit les types de données qu'Amazon Keyspaces accepte dans les INSERT JSON instructions et les types de données qu'Amazon Keyspaces utilise lorsqu'il renvoie des données avec l'instruction. SELECT JSON

Pour les types de données à champ unique tels que floatint,UUID, etdate, vous pouvez également insérer des données sous forme destring. Pour les types de données composés et les collections, tels que tuplemap, etlist, vous pouvez également insérer des données au format JSON ou sous forme codéeJSON string.