As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Consultando seus dados do Amazon OpenSearch Service com SQL
Você pode usar o SQL para consultar seu Amazon OpenSearch Service, em vez de usar a DSL de [OpenSearch consulta](https://docs.opensearch.org/latest/opensearch/query-dsl/full-text/) baseada em JSON. Consultar com SQL é útil se você já está familiarizado com a linguagem ou se deseja integrar seu domínio a uma aplicação que usa SQL. O suporte a SQL está disponível em domínios que executam o Elasticsearch 6.5 OpenSearch ou superior.
**nota**
Esta documentação descreve a compatibilidade de versões entre o OpenSearch Service e várias versões do plug-in SQL, bem como o driver JDBC e ODBC. Consulte a [OpenSearchdocumentação](https://opensearch.org/docs/latest/search-plugins/sql/sql/index/) de código aberto para obter informações sobre a sintaxe de consultas básicas e complexas, funções, consultas de metadados e funções agregadas.
Use a tabela a seguir para encontrar a versão do plug-in SQL compatível com cada uma OpenSearch das versões do Elasticsearch.
**OpenSearch**
| OpenSearch versão | Versão do plug-in SQL | Recursos notáveis |
| --- | --- | --- |
| 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) | Adicionar suporte para linguagem e consultas PPL |
| 2.9.0 | [2.9.0.0](https://github.com/opensearch-project/sql/releases/tag/2.9.0.0) | Adicione o conector Spark e suporte à tabela e às funções PromQL |
| 2.7.0 | [2.7.0.0](https://github.com/opensearch-project/sql/releases/tag/2.7.0.0) | Adicionar 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.3.0.0](https://github.com/opensearch-project/sql/releases/tag/2.3.0.0) | Adicione funções de data e hora `maketime` e `makedate` |
| 1.3.0 | [1.3.0.0](https://github.com/opensearch-project/sql/releases/tag/1.3.0.0) | Suporta tamanho limite de consulta padrão e cláusula IN para selecionar em uma lista de valores |
| 1.2.0 | [1.2.0.0](https://github.com/opensearch-project/sql/releases/tag/1.2.0.0) | Adicionar novo protocolo para o formato de resposta de visualização |
| 1.1.0 | [1.1.0.0](https://github.com/opensearch-project/sql/releases/tag/1.1.0.0) | Ofereça suporte à função de correspondência como um filtro no SQL e PPL |
| 1.0.0 | [1.0.0.0](https://github.com/opensearch-project/sql/releases/tag/1.0.0.0) | Suporte à consulta de um fluxo de dados |
**Open Distro for Elasticsearch**
| Versão do Elasticsearch | Versão do plug-in SQL | Recursos notáveis |
| --- | --- | --- |
| 7.10 | [1.13.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.13.0.0) | NULL FIRST e LAST para funções de janela, função CAST (), comandos SHOW e DESCRIBE |
| 7.9 | [1.11.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.11.0.0) | Adicione date/time funções adicionais, palavra-chave 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) | Operadores de strings e numéricos diversos |
| 7.1 | [1.1.0](https://github.com/opendistro-for-elasticsearch/sql/releases/tag/v1.1.0.0) | |
## Chamada de exemplo
Para consultar seus dados usando o SQL, envie solicitações HTTP para `_sql` usando o seguinte formato:
```
POST domain-endpoint/_plugins/_sql
{
"query": "SELECT * FROM my-index LIMIT 50"
}
```
**nota**
Se seu domínio estiver executando o Elasticsearch em vez de OpenSearch, o formato é. `_opendistro/_sql`
## Notas e diferenças
As chamadas para `_plugins/_sql` incluem nomes de índice no corpo da solicitação, portanto, elas têm as mesmas [considerações da política de acesso](ac.md#ac-advanced) das operações bulk, mget, e msearch. Como sempre, siga o princípio do [privilégio mínimo](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) ao conceder permissões para operações de API.
Para obter considerações de segurança sobre o uso de SQL com o controle de acesso refinado, consulte [Controle de acesso refinado no Amazon Service OpenSearch](fgac.md).
O plug-in OpenSearch SQL inclui muitas [configurações ajustáveis.](https://docs.opensearch.org/latest/search-plugins/sql/settings/) No OpenSearch Serviço, use o `_cluster/settings` caminho, não o caminho das configurações do plug-in (`_plugins/_query/settings`):
```
PUT _cluster/settings
{
"transient" : {
"plugins.sql.enabled" : true
}
}
```
Para domínios herdados do Elasticsearch, substitua `plugins` por `opendistro`:
```
PUT _cluster/settings
{
"transient" : {
"opendistro.sql.enabled" : true
}
}
```
## SQL Workbench
O SQL Workbench é uma interface de usuário de OpenSearch painéis que permite executar consultas SQL sob demanda, traduzir SQL em seu equivalente REST e visualizar e salvar resultados como texto, JSON, JDBC ou CSV. Para saber mais, consulte [Query Workbench](https://docs.opensearch.org/latest/search-plugins/sql/workbench/).
## SQL CLI
O SQL CLI é uma aplicação Python autônoma que você pode executar com o comando `opensearchsql`. Para obter as etapas de instalação, configuração e uso, consulte [SQL CLI](https://docs.opensearch.org/latest/search-plugins/sql/cli/).
## Driver JDBC
O driver Java Database Connectivity (JDBC) permite integrar domínios OpenSearch de serviço com seus aplicativos favoritos de business intelligence (BI). Para baixar o driver, clique [aqui](https://artifacts.opensearch.org/opensearch-clients/jdbc/opensearch-sql-jdbc-1.1.0.1.jar). Para obter mais informações, consulte o [GitHubrepositório.](https://github.com/opensearch-project/sql-jdbc)
## Driver ODBC
O driver de conectividade do banco de dados aberta (ODBC) é um driver ODBC somente leitura para Windows e macOS que permite conectar aplicativos de business intelligence e visualização de dados, como o [Microsoft Excel](https://github.com/opensearch-project/sql-odbc/blob/main/docs/user/microsoft_excel_support.md), ao plug-in SQL.
Para obter informações sobre a instalação do driver, consulte o [repositório SQL em GitHub](https://github.com/opensearch-project/sql-odbc).