Consulta tus datos de Amazon OpenSearch Service con SQL - OpenSearch Servicio Amazon

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Consulta tus datos de Amazon OpenSearch Service con SQL

Puedes usar SQL para consultar tu Amazon OpenSearch Service, en lugar de usar la OpenSearch consulta DSL basada en JSON. Consultar con SQL es útil si ya está familiarizado con el lenguaje o si desea integrar su dominio en una aplicación que lo utilice. La compatibilidad con SQL está disponible en los dominios que ejecutan Elasticsearch OpenSearch 6.5 o superior.

nota

Esta documentación describe la compatibilidad de versiones entre OpenSearch Service y varias versiones del complemento SQL, así como los controladores JDBC y ODBC. Consulte la OpenSearchdocumentación de código abierto para obtener información sobre la sintaxis de las consultas básicas y complejas, las funciones, las consultas de metadatos y las funciones agregadas.

Usa la siguiente tabla para encontrar la versión del complemento de SQL compatible con cada versión OpenSearch y con Elasticsearch.

OpenSearch
OpenSearch versión Versión del complemento de SQL Características notables
2.13.0 2.13.0.0

2.11.0 2.11.0.0

Adición de compatibilidad con el lenguaje y las consultas de PPL

2.9.0 2.9.0.0

Se añadió el conector Spark y admite funciones de tabla y ProMQL

2.7.0 2.7.0.0

Se añadió API datasource

2.5.0 2.5.0.0

2.3.0 2.3.0.0

Se añadieron funciones de fecha y hora maketime y makedate

1.3.0 1.3.0.0

Admite tamaño límite de consulta predeterminado y cláusula IN al seleccionar de una lista de valores

1.2.0 1.2.0.0

Se añadió nuevo protocolo para el formato de respuesta de visualización

1.1.0

1.1.0.0

Admite la función de coincidencia como filtro en SQL y PPL

1.0.0 1.0.0.0 Admite la consulta de un flujo de datos
Open Distro para Elasticsearch
Versión de Elasticsearch Versión del complemento de SQL Características notables
7,10 1.13.0 NULL FIRST y LAST para funciones de ventana, función CAST(), comandos SHOW y DESCRIBE
7.9 1.11.0 Se añadieron funciones de fecha/hora adicionales, palabra clave ORDER BY
7.8 1.9.0
7.7 1.8.0

7.3

1.3.0 Varios operadores de cadena y número
7.1 1.1.0

Ejemplo de llamada

Para consultar los datos con SQL, envíe solicitudes HTTP a _sql con el formato siguiente:

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

Si tu dominio ejecuta Elasticsearch en lugar de hacerlo OpenSearch, el formato será. _opendistro/_sql

Notas y diferencias

Las llamadas a _plugins/_sql incluyen los nombres de índice en el cuerpo de la solicitud y, por lo tanto, se aplican las mismas consideraciones de política de acceso que en las operaciones bulk, mget y msearch. Como siempre, siga el principio de privilegios mínimos cuando conceda permisos a las operaciones de API.

Para consideraciones de seguridad relacionadas con la utilización de SQL con el control de acceso detallado, consulte Control de acceso detallado en Amazon Service OpenSearch .

El complemento OpenSearch SQL incluye muchos ajustes que se pueden ajustar. En OpenSearch Service, usa la _cluster/settings ruta, no la ruta de configuración del complemento (_plugins/_query/settings):

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

En los dominios de Elasticsearch heredados, reemplace plugins con opendistro:

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

SQL Workbench

SQL Workbench es una interfaz de usuario de OpenSearch Dashboards que le permite ejecutar consultas de SQL bajo demanda, traducir SQL a su equivalente en REST y ver y guardar los resultados como texto, JSON, JDBC o CSV. Para más información, consulte Query Workbench.

CLI SQL

La CLI SQL es una aplicación Python independiente que se puede iniciar con el comando opensearchsql. Para obtener información sobre los pasos para instalar, configurar y utilizar, consulte SQL CLI.

Controlador JDBC

El controlador de conectividad de bases de datos Java (JDBC) le permite integrar los dominios de OpenSearch servicio con sus aplicaciones de inteligencia empresarial (BI) favoritas. Para descargar el controlador, haga clic aquí. Para obtener más información, consulte el GitHub repositorio.

En las tablas siguientes, se resume la compatibilidad de las versiones para el controlador.

OpenSearch
OpenSearch versión Versión del controlador 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 para Elasticsearch
Versión de Elasticsearch Versión del controlador 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

Controlador ODBC

El controlador de Open Database Connectivity (ODBC) es un controlador de ODBC de solo lectura para Windows y macOS que permite conectar aplicaciones de inteligencia empresarial y visualización de datos como Microsoft Excel al complemento SQL.

Puede descargar un ejemplo de archivo de controlador que funcione en la página de OpenSearch artefactos. Para obtener información sobre la instalación del controlador, consulte el repositorio de SQL en GitHub.