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 le SQL pour interroger votre Amazon OpenSearch Service, plutôt que d'utiliser le DSL de [OpenSearch requête](https://docs.opensearch.org/latest/opensearch/query-dsl/full-text/) 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](https://opensearch.org/docs/latest/search-plugins/sql/sql/index/) 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.19.0 | [2.19.0.0](https://github.com/opensearch-project/sql/releases/tag/2.19.0.0) | |
| 2.18.0 | [2.18.0.0](https://github.com/opensearch-project/sql/releases/tag/2.18.0.0) | |
| 2.17.0 | [2.17.0.0](https://github.com/opensearch-project/sql/releases/tag/2.17.0.0) | |
| 2.15.0 | [2.15.0.0](https://github.com/opensearch-project/sql/releases/tag/2.15.0.0) | |
| 2.13.0 | [2.13.0.0](https://github.com/opensearch-project/sql/releases/tag/2.13.0.0) | |
| 2.11.0 | [2.11.0.0](https://github.com/opensearch-project/sql/releases/tag/2.11.0.0) | Ajout de la prise en charge du langage PPL et des requêtes |
| 2.9.0 | [2.9.0.0](https://github.com/opensearch-project/sql/releases/tag/2.9.0.0) | Ajout du connecteur Spark et des fonctions de table de support et ProMQL |
| 2.7.0 | [2.7.0.0](https://github.com/opensearch-project/sql/releases/tag/2.7.0.0) | Ajouter une `datasource` API |
| 2.5.0 | [2.5.0.0](https://github.com/opensearch-project/sql/releases/tag/2.5.0.0) | |
| 2.3.0 | [2.3.0.0](https://github.com/opensearch-project/sql/releases/tag/2.3.0.0) | Ajouter des fonctions datetime `maketime` et `makedate` |
| 1.3.0 | [1.3.0.0](https://github.com/opensearch-project/sql/releases/tag/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](https://github.com/opensearch-project/sql/releases/tag/1.2.0.0) | Ajout d'un nouveau protocole pour le format de réponse de visualisation |
| 1.1.0 | [1.1.0.0](https://github.com/opensearch-project/sql/releases/tag/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](https://github.com/opensearch-project/sql/releases/tag/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](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.13.0.0) | NULL FIRST et LAST pour les fonctions de fenêtrage, fonction CAST (), commandes SHOW et DESCRIBE |
| 7,9 | [1,11,0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.11.0.0) | Ajouter des date/time fonctions supplémentaires, mot-clé ORDER BY |
| 7.8 | [1,9.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.9.0.0) | |
| 7.7 | [1.8.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.8.0.0) | |
| 7.3 | [1.3.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.3.0.0) | Opérateurs de chaîne et de nombre multiples |
| 7.1 | [1.1.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.1.0.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](ac.md#ac-advanced) que les opérations bulk, mget et msearch. Comme toujours, suivez le principe du [moindre privilège](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) 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](fgac.md).
Le plugin OpenSearch SQL inclut de nombreux [paramètres réglables.](https://docs.opensearch.org/latest/search-plugins/sql/settings/) 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](https://docs.opensearch.org/latest/search-plugins/sql/workbench/).
## 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](https://docs.opensearch.org/latest/search-plugins/sql/cli/).
## 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](https://artifacts.opensearch.org/opensearch-clients/jdbc/opensearch-sql-jdbc-1.1.0.1.jar). Pour plus d'informations, consultez le [GitHubréférentiel](https://github.com/opensearch-project/sql-jdbc).
## 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](https://github.com/opensearch-project/sql-odbc/blob/main/docs/user/microsoft_excel_support.md).
Pour plus d'informations sur l'installation du pilote, consultez le [référentiel SQL sur GitHub](https://github.com/opensearch-project/sql-odbc).