

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Interrogazione dei dati OpenSearch di Amazon Service con SQL
<a name="sql-support"></a>

Puoi usare SQL per interrogare il tuo Amazon OpenSearch Service, anziché usare la [OpenSearch query](https://docs.opensearch.org/latest/opensearch/query-dsl/full-text/) DSL basata 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. Il supporto SQL è disponibile sui domini che eseguono Elasticsearch 6.5 OpenSearch o versioni successive. 

**Nota**  
Questa documentazione descrive la compatibilità delle versioni tra OpenSearch Service e varie versioni del plug-in SQL, nonché il driver JDBC e ODBC. Consulta la [OpenSearchdocumentazione](https://opensearch.org/docs/latest/search-plugins/sql/sql/index/) open source per informazioni sulla sintassi di query, funzioni, query di metadati e funzioni aggregate di base e complesse.

Usa la tabella seguente per trovare la versione del plugin SQL supportata da ciascuna versione e da Elasticsearch. OpenSearch 


**OpenSearch**  

| OpenSearch versione | Versione del plug-in SQL | Caratteristiche da tenere in considerazione | 
| --- | --- | --- | 
| 2.19.0 | [2.19.0.0](https://github.com/opensearch-project/sql/releases/tag/2.19.0.0) |    | 
| 2.18.0 | [2,180,0](https://github.com/opensearch-project/sql/releases/tag/2.18.0.0) |    | 
| 2.17.0 | [2,170,0](https://github.com/opensearch-project/sql/releases/tag/2.17.0.0) |    | 
| 2.15.0 | [2,150,0](https://github.com/opensearch-project/sql/releases/tag/2.15.0.0) |    | 
| 2.13.0 | [2,130,0](https://github.com/opensearch-project/sql/releases/tag/2.13.0.0) |    | 
| 2.11.0 | [211,0,0](https://github.com/opensearch-project/sql/releases/tag/2.11.0.0) |  Aggiunge il supporto per il linguaggio e le query PPL  | 
| 2.9.0 | [2.9.0.0](https://github.com/opensearch-project/sql/releases/tag/2.9.0.0) |  Aggiungi il connettore Spark e supporta le funzioni tabellari e PromQL  | 
| 2.7.0 | [2.7.0.0](https://github.com/opensearch-project/sql/releases/tag/2.7.0.0) |  Aggiungi API `datasource`  | 
| 2.5.0 | [2.5.0.0](https://github.com/opensearch-project/sql/releases/tag/2.5.0.0) |    | 
| 2.3.0 | [2,30,0](https://github.com/opensearch-project/sql/releases/tag/2.3.0.0) |  Aggiungi funzioni di datetime `maketime` e `makedate`  | 
| 1.3.0 | [1,30.0](https://github.com/opensearch-project/sql/releases/tag/1.3.0.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](https://github.com/opensearch-project/sql/releases/tag/1.2.0.0) |  Aggiungi un nuovo protocollo per il formato della risposta di visualizzazione  | 
|  1.1.0  | [1.1.0.0](https://github.com/opensearch-project/sql/releases/tag/1.1.0.0) |  Supporto per la funzione di corrispondenza come filtro in SQL e PPL  | 
| 1.0.0 | [1.0.0.0](https://github.com/opensearch-project/sql/releases/tag/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](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.13.0.0) | NULL FIRST e LAST per le funzioni finestra, la funzione CAST(), i comandi SHOW e DESCRIBE | 
| 7.9 | [1.11.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.11.0.0) | Aggiungi date/time funzioni aggiuntive, ORDER BY keyword | 
| 7.8 | [1.9.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.9.0.0) |  | 
| 7.7 | [18.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) | Operatori multipli di stringhe e numeri | 
| 7.1 | [1.1.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.1.0.0) |  | 

## Chiamata di esempio
<a name="sql-sample"></a>

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 utilizza Elasticsearch anziché Elasticsearch OpenSearch, il formato è. `_opendistro/_sql`

## Note e differenze
<a name="sql-diff"></a>

Le chiamate a `_plugins/_sql` includono i nomi degli indici nel corpo della richiesta e quindi hanno le stesse [considerazioni delle policy di accesso](ac.md#ac-advanced) delle operazioni bulk, mget e msearch. Come sempre, seguire il principio del [privilegio minimo](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) 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](fgac.md).

Il plugin OpenSearch SQL include molte impostazioni [regolabili](https://docs.opensearch.org/latest/search-plugins/sql/settings/). 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
<a name="workbench"></a>

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](https://docs.opensearch.org/latest/search-plugins/sql/workbench/).

## SQL CLI
<a name="cli"></a>

SQL CLI è un'applicazione Python autonoma che è possibile avviare con il comando `opensearchsql`. Per la procedura di installazione, configurazione e utilizzo, consulta [SQL CLI](https://docs.opensearch.org/latest/search-plugins/sql/cli/).

## Driver JDBC
<a name="jdbc-driver"></a>

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](https://artifacts.opensearch.org/opensearch-clients/jdbc/opensearch-sql-jdbc-1.1.0.1.jar). [Per ulteriori informazioni, consulta il repository. GitHub](https://github.com/opensearch-project/sql-jdbc)

## Driver ODBC
<a name="odbc"></a>

[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.](https://github.com/opensearch-project/sql-odbc/blob/main/docs/user/microsoft_excel_support.md)

[Per informazioni sull'installazione del driver, consulta l'archivio SQL su. GitHub](https://github.com/opensearch-project/sql-odbc)