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 * frommykeyspace.mytableWHERE primary.key1 IN (1,2) and clustering.key1 = 2; SELECT * frommykeyspace.mytableWHERE primary.key1 IN (1,2) and clustering.key1 <= 2; SELECT * frommykeyspace.mytableWHERE primary.key1 = 1 and clustering.key1 IN (1, 2); SELECT * frommykeyspace.mytableWHERE 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) frommy_table; SELECT TOKEN(id) frommy_tableWHERE 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) frommy_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) frommy_table;
Le WRITETIME la fonction ne peut pas être utilisée sur des colonnes à cellules multiples telles que des collections.
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.