Interrogation de vos données Amazon OpenSearch Service avec SQL

Vous pouvez utiliser le 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.

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

OpenSearch
OpenSearch version	Version du plug-in SQL	Fonctionnalités notables
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

Le support SQL est disponible sur les domaines exécutant OpenSearch Elasticsearch 6.5 ou version ultérieure. La documentation complète du plugin SQL est disponible dans la OpenSearchdocumentation.

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.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.