Esecuzione di query sui dati di Amazon OpenSearch Service con SQL - Amazon OpenSearch Service

Esecuzione di query sui dati di Amazon OpenSearch Service con SQL

È possibile usare SQL per eseguire query su Amazon OpenSearch Service piuttosto che utilizzare il DSL di query OpenSearch basato su JSON. Le query con SQL sono utili se si ha già familiarità con SQL o si desidera integrare il dominio con un'applicazione che utilizza SQL.

Utilizzare la tabella seguente per trovare la versione del plug-in SQL supportata da ogni versione di OpenSearch ed Elasticsearch.

OpenSearch
Versione di OpenSearch Versione del plug-in SQL Caratteristiche da tenere in considerazione
1.2.0 1.2.0.0

Aggiungi un nuovo protocollo per il formato della risposta di visualizzazione

1.1.0

1.1.0.0

Supporto per la funzione di corrispondenza come filtro in SQL e PPL

1.0.0 1.0.0.0 Supporto per l'interrogazione di un flusso dei dati
Open Distro per Elasticsearch
Versione di Elasticsearch Versione del plug-in SQL Caratteristiche da tenere in considerazione
7.10 1.13.0 NULL FIRST e LAST per le funzioni finestra, la funzione CAST(), i comandi SHOW e DESCRIBE
7.9 1.11.0 Aggiunta di ulteriori funzioni di data/ora, parola chiave ORDER BY
7.8 1.9.0
7.7 1.8.0

7.3

1.3.0 Operatori multipli di stringhe e numeri
7.1 1.1.0

Il supporto SQL è disponibile su domini che eseguono OpenSearch o Elasticsearch 6.5 o versioni successive. La documentazione completa per il plug-in SQL è disponibile nella documentazione di OpenSearch.

Chiamata di esempio

Per eseguire query sui dati con SQL, inviare le richieste HTTP a _sql utilizzando il seguente formato:

POST domain-endpoint/_plugins/_sql { "query": "SELECT * FROM my-index LIMIT 50" }
Nota

Se il dominio esegue Elasticsearch anziché OpenSearch, il formato è _opendistro/_sql.

Note e differenze

Le chiamate a _plugins/_sql includono i nomi degli indici nel corpo della richiesta e quindi hanno le stesse considerazioni delle policy di accesso delle operazioni bulk, mget e msearch. Come sempre, seguire il principio del privilegio minimo quando si concedono autorizzazioni alle operazioni API.

Per le considerazioni sulla sicurezza relativa all'utilizzo di SQL con il controllo granulare degli accessi, consultare Controllo granulare degli accessi in Amazon OpenSearch Service.

Il plug-in OpenSearch SQL include molti impostazioni ottimizzabili. In OpenSearch Service, utilizzare il percorso _cluster/settings, non il percorso delle impostazioni del plug-in (_plugins/_query/settings):

PUT _cluster/settings { "transient" : { "plugins.sql.enabled" : true } }

Per i domini Elasticsearch legacy, sostituisci plugins con opendistro:

PUT _cluster/settings { "transient" : { "opendistro.sql.enabled" : true } }

SQL Workbench

SQL Workbench è un'interfaccia utente di OpenSearch Dashboards che consente di eseguire query SQL on demand, convertire SQL nel relativo equivalente REST e visualizzare e salvare i risultati come testo, JSON, JDBC o CSV. Per ulteriori informazioni, consultare Query Workbench.

SQL CLI

SQL CLI è un'applicazione Python autonoma che è possibile avviare con il comando opensearchsql. Per la procedura di installazione, configurazione e utilizzo, consulta SQL CLI.

Driver JDBC

Il driver JDBC (Java Database Connectivity) consente di integrare i domini con le applicazioni di Business Intelligence (BI) preferite. Per iniziare, consulta il repository GitHub. La tabella seguente riepiloga la compatibilità delle versioni per il driver. Il driver Open Distro for Elasticsearch è disponibile per il download qui. I driver OpenSearch non sono ancora disponibili per il download.

OpenSearch
Versione di OpenSearch Versione driver JDBC
1.2 1.0.0.0
1.1 1.0.0.0
1.0 1.0.0.0
Open Distro per Elasticsearch
Versione di Elasticsearch Versione driver 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

Driver ODBC

Il driver ODBC (Open Database Connectivity) è un driver di sola lettura per Windows e macOS che consente di connettere applicazioni di Business Intelligence (BI) e visualizzazione di dati come Tableau, Microsoft Excel e Power BI al plug-in SQL. Il driver Open Distro for Elasticsearch è disponibile per il download qui. I driver OpenSearch non sono ancora disponibili per il download. Per informazioni sull'installazione del driver, consulta Repository SQL su GitHub.