Interrogazione dei dati OpenSearch di Amazon Service con SQL

Puoi usare SQL per interrogare Amazon OpenSearch Service, anziché usare la query DSL basata su JSONOpenSearch . 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.

Utilizza la tabella seguente per trovare la versione del plug-in SQL supportata da ciascuna versione OpenSearch e da Elasticsearch.

OpenSearch
OpenSearch versione	Versione del plug-in SQL	Caratteristiche da tenere in considerazione
2.11.0	2.11.0.0	Aggiunge il supporto per il linguaggio e le query PPL
2.9.0	2.9.0.0	Aggiungi il connettore Spark e supporta le funzioni tabellari e PromQL
2.7.0	2.7.0.0	Aggiungi API datasource
2.5.0	2.5.0.0
2.3.0	2,30,0	Aggiungi funzioni di datetime maketime e makedate
1.3.0	1,30.0	Supporta la dimensione limite predefinita della query e la clausola IN per eseguire la selezione all'interno di un elenco di valori
1.2.0	1,20.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	18.0
7.3	1.3.0	Operatori multipli di stringhe e numeri
7.1	1.1.0

Il supporto SQL è disponibile sui domini che eseguono Elasticsearch OpenSearch 6.5 o versioni successive. La documentazione completa del plugin SQL è disponibile nella documentazione. 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 tuo 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 Service OpenSearch .

Il plugin OpenSearch SQL include molte impostazioni regolabili. In OpenSearch Service, utilizzate il _cluster/settings percorso, non il percorso delle impostazioni del plugin path (_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 su richiesta, tradurre SQL nel suo 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 Java Database Connectivity (JDBC) consente di integrare i domini di OpenSearch servizio con le applicazioni di business intelligence (BI) preferite. Per scaricare il driver, fai clic qui. Per ulteriori informazioni, consulta il repository. GitHub

La tabella seguente riepiloga la compatibilità delle versioni per il driver.

OpenSearch
OpenSearch versione	Versione driver JDBC
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 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	18.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 Open Database Connectivity (ODBC) è un driver ODBC di sola lettura per Windows e macOS che consente di collegare applicazioni di business intelligence e visualizzazione dei dati come Microsoft Excel al plug-in SQL.

È possibile scaricare un file di driver funzionante di esempio nella pagina degli artefatti. OpenSearch Per informazioni sull'installazione del driver, consulta il repository SQL su. GitHub