Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Abfragen Ihrer Amazon OpenSearch Service-Daten mit SQL
Sie können SQL verwenden, um Ihren Amazon OpenSearch Service abzufragen, anstatt die JSON-basierte [OpenSearch Abfrage](https://docs.opensearch.org/latest/opensearch/query-dsl/full-text/) DSL zu verwenden. Abfragen mit SQL sind nützlich, wenn Sie bereits mit der Sprache vertraut sind oder Ihre Domain in eine Anwendung integrieren möchten, die sie verwendet. SQL-Unterstützung ist für Domains verfügbar, auf denen Elasticsearch 6.5 OpenSearch oder höher ausgeführt wird.
**Anmerkung**
Diese Dokumentation beschreibt die Versionskompatibilität zwischen OpenSearch Service und verschiedenen Versionen des SQL-Plug-ins sowie des JDBC- und ODBC-Treibers. Informationen zur Syntax für grundlegende und komplexe Abfragen, Funktionen, Metadatenabfragen und Aggregatfunktionen finden Sie in der [OpenSearchOpen-Source-Dokumentation](https://opensearch.org/docs/latest/search-plugins/sql/sql/index/).
In der folgenden Tabelle finden Sie die Version des SQL-Plug-ins, die von den einzelnen OpenSearch Elasticsearch-Versionen unterstützt wird.
**OpenSearch**
| OpenSearch Version | SQL-Plug-In-Version | Bemerkenswerte Funktionen |
| --- | --- | --- |
| 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) | Unterstützung für PPL-Sprache und Abfragen hinzufügen |
| 2.9.0 | [2.9.0.0](https://github.com/opensearch-project/sql/releases/tag/2.9.0.0) | Spark-Konnektor hinzufügen und Tabellen- und PromQL-Funktionen unterstützen |
| 2.7.0 | [2.7.0.0](https://github.com/opensearch-project/sql/releases/tag/2.7.0.0) | API hinzufügen `datasource` |
| 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) | Hinzufügen von `maketime`- und `makedate`-Datum- und Uhrzeit-Funktionen |
| 1.3.0 | [1.3.0.0](https://github.com/opensearch-project/sql/releases/tag/1.3.0.0) | Support für standardmäßige Abfragelimitgröße und IN-Klausel zur Auswahl innerhalb einer Werteliste |
| 1.2.0 | [1.2.0.0](https://github.com/opensearch-project/sql/releases/tag/1.2.0.0) | Neues Protokoll für das Visualisierungs-Antwortformat hinzugefügt. |
| 1.1.0 | [1.1.0.0](https://github.com/opensearch-project/sql/releases/tag/1.1.0.0) | Match-Funktion als Filter in SQL und PPL wird unterstützt |
| 1.0.0 | [1.0.0.0](https://github.com/opensearch-project/sql/releases/tag/1.0.0.0) | Support von Abfragen eines Datenstroms |
**Open Distro für Elasticsearch**
| Elasticsearch Version | SQL-Plug-In-Version | Bemerkenswerte Funktionen |
| --- | --- | --- |
| 7.10 | [1,13,0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.13.0.0) | NULL FIRST und LAST für Fensterfunktionen, CAST () -Funktion, SHOW- und DESCRIBE-Befehle |
| 7.9 | [1.11.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.11.0.0) | Zusätzliche date/time Funktionen hinzufügen, Schlüsselwort 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) | Mehrere Zeichenfolgen- und Zahlenoperatoren |
| 7.1 | [1.1.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.1.0.0) | |
## Beispielaufruf
Um Ihre Daten mit SQL abzufragen, senden Sie HTTP-Anforderungen im folgenden Format an `_sql`:
```
POST domain-endpoint/_plugins/_sql
{
"query": "SELECT * FROM my-index LIMIT 50"
}
```
**Anmerkung**
Wenn auf Ihrer Domain Elasticsearch und nicht ausgeführt wird OpenSearch, lautet das Format. `_opendistro/_sql`
## Hinweise und Unterschiede
Aufrufe an `_plugins/_sql` enthalten Indexnamen im Anforderungstext, es gelten also die gleichen [Überlegungen zur Zugriffsrichtlinie](ac.md#ac-advanced) wie bei den Operationen bulk, mget und msearch. Befolgen Sie wie immer das Prinzip der [geringsten Rechte](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) wenn Sie API-Operationen Berechtigungen erteilen.
Sicherheitsüberlegungen bezüglich der Verwendung von SQL mit differenzierter Zugriffskontrolle finden Sie unter Differenzierte Zugriffskontrolle in [Feinkörnige Zugriffskontrolle in Amazon Service OpenSearch](fgac.md).
Das OpenSearch SQL-Plugin enthält viele [einstellbare Einstellungen](https://docs.opensearch.org/latest/search-plugins/sql/settings/). Verwenden Sie im OpenSearch Service den `_cluster/settings` Pfad, nicht den Pfad der Plugin-Einstellungen (`_plugins/_query/settings`):
```
PUT _cluster/settings
{
"transient" : {
"plugins.sql.enabled" : true
}
}
```
Ersetzen Sie für ältere Elasticsearch-Domains `plugins` mit `opendistro`:
```
PUT _cluster/settings
{
"transient" : {
"opendistro.sql.enabled" : true
}
}
```
## SQL Workbench
Die SQL Workbench ist eine OpenSearch Dashboard-Benutzeroberfläche, mit der Sie bei Bedarf SQL-Abfragen ausführen, SQL in das REST-Äquivalent übersetzen und Ergebnisse als Text, JSON, JDBC oder CSV anzeigen und speichern können. Weitere Informationen finden Sie unter [Workbench abfragen](https://docs.opensearch.org/latest/search-plugins/sql/workbench/).
## SQL CLI
SQL-CLI ist eine eigenständige Python-Anwendung, die Sie mit dem Befehl `opensearchsql` starten können. Schritte zum Installieren, Konfigurieren und Verwenden finden Sie unter [SQL CLI](https://docs.opensearch.org/latest/search-plugins/sql/cli/).
## JDBC-Treiber
Mit dem Java Database Connectivity (JDBC) -Treiber können Sie OpenSearch Service-Domains in Ihre bevorzugten Business Intelligence (BI) -Anwendungen integrieren. Um den Treiber herunterzuladen, klicken Sie [hier](https://artifacts.opensearch.org/opensearch-clients/jdbc/opensearch-sql-jdbc-1.1.0.1.jar). [Weitere Informationen finden Sie im GitHub Repository.](https://github.com/opensearch-project/sql-jdbc)
## ODBC-Treiber
Der Open Database Connectivity (ODBC) -Treiber ist ein schreibgeschützter ODBC-Treiber für Windows und macOS, mit dem Sie Business Intelligence- und Datenvisualisierungsanwendungen wie [Microsoft Excel](https://github.com/opensearch-project/sql-odbc/blob/main/docs/user/microsoft_excel_support.md) mit dem SQL-Plugin verbinden können.
[Informationen zur Installation des Treibers finden Sie im SQL-Repository unter. GitHub](https://github.com/opensearch-project/sql-odbc)