Consultando seus dados do Amazon OpenSearch Service com SQL - OpenSearch Serviço Amazon

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

2.11.0 2.11.0.0

Adicionar suporte para linguagem e consultas PPL

2.9.0 2.9.0.0

Adicione o conector Spark e suporte à tabela e às funções PromQL

2.7.0 2.7.0.0

Adicionar API datasource

2.5.0 2.5.0.0

2.3.0 2.3.0.0

Adicione funções de data e hora maketime e makedate

1.3.0 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

Adicionar novo protocolo para o formato de resposta de visualização

1.1.0

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 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 NULL FIRST e LAST para funções de janela, função CAST (), comandos SHOW e DESCRIBE
7.9 1.11.0 Funções adicionais de data/hora adicionais, palavra-chave ORDER BY
7.8 1.9.0
7.7 1.8.0

7.3

1.3.0 Operadores de strings e numéricos diversos
7.1 1.1.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 das operações bulk, mget, e msearch. Como sempre, siga o princípio do privilégio mínimo 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 .

O plug-in OpenSearch SQL inclui muitas configurações ajustáveis. 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 obter mais informações, consulte Query 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.

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. Para obter mais informações, consulte o GitHubrepositório.

As tabelas a seguir resumem a compatibilidade de versões do driver.

OpenSearch
OpenSearch versão Versão do driver JDBC
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 for Elasticsearch
Versão do Elasticsearch Versão do 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

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, ao plug-in SQL.

Você pode baixar um exemplo de arquivo de driver funcional na página de OpenSearch artefatos. Para obter informações sobre a instalação do driver, consulte o repositório SQL em GitHub.