View a markdown version of this page

SELECT - Amazon Keyspaces (pour Apache Cassandra)

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.

SELECT

Utilisez une instruction SELECT pour interroger les données.

Syntaxe

select_statement ::= SELECT [ JSON ] ( select_clause | '*' ) FROM table_name [ WHERE 'where_clause' ] [ ORDER BY 'ordering_clause' ] [ LIMIT (integer | bind_marker) ] [ ALLOW FILTERING ] select_clause ::= selector [ AS identifier ] ( ',' selector [ AS identifier ] ) selector ::= column_name | term | CAST '(' selector AS cql_type ')' | function_name '(' [ selector ( ',' selector )* ] ')' where_clause ::= relation ( AND relation )* relation ::= column_name operator term TOKEN operator ::= '=' | '<' | '>' | '<=' | '>=' | IN | CONTAINS | CONTAINS KEY ordering_clause ::= column_name [ ASC | DESC ] ( ',' column_name [ ASC | DESC ] )*

Exemples

SELECT name, id, manager_id FROM "myGSGKeyspace".employees_tbl ; SELECT JSON name, id, manager_id FROM "myGSGKeyspace".employees_tbl ;

Pour un tableau cartographique JSON-encoded types de données vers les types de données Amazon Keyspaces, voir Encodage JSON des types de données Amazon Keyspaces.

À l'aide du IN mot-clé

Le IN Le mot clé spécifie l'égalité pour une ou plusieurs valeurs. Il peut être appliqué à la clé de partition et à la colonne de clustering. Les résultats sont renvoyés dans l'ordre dans lequel les clés sont présentées dans SELECT déclaration.

Exemples

SELECT * from mykeyspace.mytable WHERE primary.key1 IN (1,2) and clustering.key1 = 2; SELECT * from mykeyspace.mytable WHERE primary.key1 IN (1,2) and clustering.key1 <= 2; SELECT * from mykeyspace.mytable WHERE primary.key1 = 1 and clustering.key1 IN (1, 2); SELECT * from mykeyspace.mytable WHERE primary.key1 <= 2 and clustering.key1 IN (1, 2) ALLOW FILTERING;

Pour plus d'informations sur le IN mot clé et comment Amazon Keyspaces traite la déclaration, voir Utiliser l'opérateur IN avec l'instruction SELECT dans une requête dans Amazon Keyspaces.

Résultats de commande

Le ORDER BY La clause spécifie l'ordre de tri des résultats renvoyés. Il prend comme arguments une liste de noms de colonnes ainsi que l'ordre de tri de chaque colonne. Vous ne pouvez spécifier des colonnes de clustering que dans les clauses de classement. Non-clustering les colonnes ne sont pas autorisées. Les options d'ordre de tri sont ASC pour l'ascension et DESC pour un ordre de tri décroissant. Si l'ordre de tri est omis, l'ordre par défaut de la colonne de clustering est utilisé. Pour les ordres de tri possibles, voir Résultats de commande avec ORDER BY dans Amazon Keyspaces.

Exemple

SELECT name, id, division, manager_id FROM "myGSGKeyspace".employees_tbl WHERE id = '012-34-5678' ORDER BY division;

Lors de l'utilisation ORDER BY avec le IN mot clé, les résultats sont classés au sein d'une page. La réorganisation complète avec pagination désactivée n'est pas prise en charge.

JETON

Vous pouvez appliquer le TOKEN fonction à PARTITION KEY colonne dans SELECT et WHERE clauses. Avec le TOKEN fonction, Amazon Keyspaces renvoie des lignes en fonction de la valeur du jeton mappé du PARTITION_KEY plutôt que sur la valeur de PARTITION KEY.

TOKEN les relations ne sont pas prises en charge avec IN mot clé.

Exemples

SELECT TOKEN(id) from my_table; SELECT TOKEN(id) from my_table WHERE TOKEN(id) > 100 and TOKEN(id) < 10000;

Fonction TTL

Vous pouvez utiliser le TTL fonction avec SELECT instruction permettant de récupérer le délai d'expiration en secondes enregistré pour une colonne. Si non TTL la valeur est définie, la fonction renvoie null.

Exemple

SELECT TTL(my_column) from my_table;

Le TTL la fonction ne peut pas être utilisée sur des colonnes à cellules multiples telles que des collections.

WRITETIME fonction

Vous pouvez utiliser le WRITETIME fonction avec SELECT instruction permettant de récupérer l'horodatage stocké en tant que métadonnées pour la valeur d'une colonne uniquement si la table utilise des horodatages côté client. Pour plus d’informations, consultez Client-side horodatages dans Amazon Keyspaces.

SELECT WRITETIME(my_column) from my_table;

Le WRITETIME la fonction ne peut pas être utilisée sur des colonnes à cellules multiples telles que des collections.

Note

Pour des raisons de compatibilité avec le comportement établi des pilotes Cassandra, les politiques d'autorisation basées sur des balises ne sont pas appliquées lorsque vous effectuez des opérations sur des tables système à l'aide d'appels d'API Cassandra Query Language (CQL) via des pilotes Cassandra et des outils de développement. Pour plus d’informations, consultez Accès aux ressources Amazon Keyspaces basé sur des balises.