Interrogation de vos données Amazon OpenSearch Service avec SQL - Amazon OpenSearch Service

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.

Interrogation de vos données Amazon OpenSearch Service avec SQL

Vous pouvez utiliser SQL pour interroger votre Amazon OpenSearch Service, plutôt que d'utiliser le DSL de OpenSearch requête basé sur JSON. Interroger avec SQL est utile si vous êtes déjà familiarisé avec le langage ou que vous souhaitez intégrer votre domaine avec une application qui l'utilise. Le support SQL est disponible sur les domaines exécutant OpenSearch Elasticsearch 6.5 ou version ultérieure.

Note

Cette documentation décrit la compatibilité des versions entre OpenSearch Service et les différentes versions du plugin SQL, ainsi que les pilotes JDBC et ODBC. Consultez la OpenSearchdocumentation open source pour plus d'informations sur la syntaxe des requêtes de base et complexes, des fonctions, des requêtes de métadonnées et des fonctions d'agrégation.

Utilisez le tableau suivant pour trouver la version du plug-in SQL prise en charge par chaque version, ainsi que par chaque version OpenSearch d'Elasticsearch.

OpenSearch
OpenSearch version Version du plug-in SQL Fonctionnalités notables
2.13.0 2.13.0.0

2.11.0 2.11.0.0

Ajout de la prise en charge du langage PPL et des requêtes

2.9.0 2.9.0.0

Ajout du connecteur Spark et des fonctions de table de support et ProMQL

2.7.0 2.7.0.0

Ajouter une datasource API

2.5.0 2.5.0.0

2.3.0 2.3.0.0

Ajouter des fonctions datetime maketime et makedate

1.3.0 1.3.0.0

Prise en charge de la taille limite par défaut des requêtes et de la clause IN pour effectuer une sélection dans une liste de valeurs

1.2.0 1.2.0.0

Ajout d'un nouveau protocole pour le format de réponse de visualisation

1.1.0

1.1.0.0

Prise en charge de la fonction de correspondance comme filtre dans SQL et PPL

1.0.0 1.0.0.0 Prise en charge de l'interrogation d'un flux de données
Open Distro for Elasticsearch
Version Elasticsearch. Version du plug-in SQL Fonctionnalités notables
7,10 1,13,0 NULL FIRST et LAST pour les fonctions de fenêtrage, fonction CAST (), commandes SHOW et DESCRIBE
7,9 1,11,0 Ajouter des fonctions de date/heure supplémentaires, le mot-clé ORDER BY
7.8 1,9.0
7.7 1.8.0

7.3

1.3.0 Opérateurs de chaîne et de nombre multiples
7.1 1.1.0

Exemple d'appel

Pour interroger vos données avec SQL, envoyez des requêtes HTTP à la fonction _sql en utilisant le format suivant :

POST domain-endpoint/_plugins/_sql { "query": "SELECT * FROM my-index LIMIT 50" }
Note

Si votre domaine exécute Elasticsearch à la place OpenSearch, le format est. _opendistro/_sql

Remarques et différences

Les appels à la fonction _plugins/_sql incluent les noms d'index dans le corps de la requête et prennent donc en compte les mêmes considérations en matière de stratégie d'accès que les opérations bulk, mget et msearch. Comme toujours, suivez le principe du moindre privilège lorsque vous accordez des autorisations aux opérations d'API.

Pour de plus amples informations sur la sécurité concernant l'utilisation de SQL avec le contrôle précis des accès, consultez Contrôle d'accès précis dans Amazon Service OpenSearch .

Le plugin OpenSearch SQL inclut de nombreux paramètres réglables. Dans OpenSearch Service, utilisez le _cluster/settings chemin, et non le chemin des paramètres du plugin (_plugins/_query/settings) :

PUT _cluster/settings { "transient" : { "plugins.sql.enabled" : true } }

Pour les domaines Elasticsearch hérités, remplacez plugins avec opendistro :

PUT _cluster/settings { "transient" : { "opendistro.sql.enabled" : true } }

SQL Workbench

SQL Workbench est une interface utilisateur de OpenSearch tableaux de bord qui vous permet d'exécuter des requêtes SQL à la demande, de traduire le SQL en son équivalent REST, et d'afficher et d'enregistrer les résultats sous forme de texte, JSON, JDBC ou CSV. Pour plus d'informations, consultez Workbench de requête.

CLI SQL

L'interface CLI SQL est une application Python autonome que vous pouvez lancer avec la commande opensearchsql. Pour connaître les étapes d'installation, de configuration et d'utilisation, consultez CLI SQL.

Pilote JDBC

Le pilote Java Database Connectivity (JDBC) vous permet d'intégrer des domaines de OpenSearch service à vos applications de business intelligence (BI) préférées. Pour télécharger le pilote, cliquez ici. Pour plus d'informations, consultez le GitHubréférentiel.

Les tableaux suivants résument la compatibilité de version pour le pilote.

OpenSearch
OpenSearch version Version du pilote JDBC
2,13 1.1.0.1
2.11 1.1.0.1
2.9 1.1.0.1
2.7 1.1.0.1
2,5 1.1.0.1
2.3 1.1.0.1
1.3 1.1.0.1
1.2 1.1.0.1
1.1 1.1.0.1
1.0 1.1.0.1
Open Distro for Elasticsearch
Version d'Elasticsearch Version du pilote JDBC
7,10 1,13,0
7,9 1,11,0
7.8 1,9.0
7.7 1.8.0
7.4 1.4.0
7.1 1.0.0
6.8 0.9.0
6.7 0.9.0
6,5 0.9.0

Pilote ODBC

Le pilote Open Database Connectivity (ODBC) est un pilote ODBC en lecture seule pour Windows et macOS qui vous permet de connecter des applications de business intelligence et de visualisation de données telles que Microsoft Excel au plug-in SQL.

Vous pouvez télécharger un exemple de fichier de pilote fonctionnel sur la page OpenSearch des artefacts. Pour plus d'informations sur l'installation du pilote, consultez le référentiel SQL sur GitHub.