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

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.13.0	2.13.0.0
2.11.0	2.11.0.0	Unterstützung für PPL-Sprache und Abfragen hinzufügen
2.9.0	2.9.0.0	Spark-Konnektor hinzufügen und Tabellen- und PromQL-Funktionen unterstützen
2.7.0	2.7.0.0	API hinzufügen datasource
2.5.0	2.5.0.0
2.3.0	2.3.0.0	Hinzufügen von maketime- und makedate-Datum- und Uhrzeit-Funktionen
1.3.0	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	Neues Protokoll für das Visualisierungs-Antwortformat hinzugefügt.
1.1.0	1.1.0.0	Match-Funktion als Filter in SQL und PPL wird unterstützt
1.0.0	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	NULL FIRST und LAST für Fensterfunktionen, CAST () -Funktion, SHOW- und DESCRIBE-Befehle
7.9	1.11.0	Zusätzliche Datums-/Uhrzeitfunktionen hinzufügen, ORDER BY-Schlüsselwort
7.8	1.9.0
7.7	1.8.0
7.3	1.3.0	Mehrere Zeichenfolgen- und Zahlenoperatoren
7.1	1.1.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 wie bei den Operationen bulk, mget und msearch. Befolgen Sie wie immer das Prinzip der geringsten Rechte 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 .

Das OpenSearch SQL-Plugin enthält viele einstellbare Einstellungen. 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.

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.

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. Weitere Informationen finden Sie im GitHub Repository.

Die folgenden Tabellen beschreiben die versionsabhängige Kompatibilität des Treibers.

OpenSearch
OpenSearch Version	JDBC-Treiberversion
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 für Elasticsearch
Elasticsearch Version	JDBC-Treiber-Version
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

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 mit dem SQL-Plug-In verbinden können.

Sie können ein Beispiel für eine funktionierende Treiberdatei auf der Seite mit den Artefakten herunterladen. OpenSearch Informationen zur Installation des Treibers finden Sie im SQL-Repository unter GitHub.