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.

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.

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"
}

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.

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.