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.
Consultar los datos de Amazon OpenSearch Service con SQL
Puede utilizar SQL para consultar su Amazon OpenSearch Service, en lugar de utilizar la Consulta de OpenSearch DSL
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 documentación de código abierto de OpenSearch
Utilice la siguiente tabla para buscar la versión del complemento SQL compatible con cada versión de OpenSearch y Elasticsearch.
| Versión de OpenSearch | Versión del complemento de SQL | Características notables |
|---|---|---|
| 2.19.0 | 2.19.0.0 |
|
| 2.18.0 | 2.18.0.0 |
|
| 2.17.0 | 2.17.0.0 |
|
| 2.15.0 | 2.15.0.0 |
|
| 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 |
| 2.5.0 | 2.5.0.0 |
|
| 2.3.0 | 2.3.0.0 |
Se añadieron funciones de fecha y hora |
| 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 |
| 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:
POSTdomain-endpoint/_plugins/_sql { "query": "SELECT * FROM my-index LIMIT 50" }
nota
Si el dominio ejecuta Elasticsearch en lugar de OpenSearch, el formato es _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 SQL de OpenSearch incluye muchas opciones de configuración ajustables_cluster/settings, en lugar de 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 permite ejecutar consultas SQL bajo demanda, traducir SQL en su equivalente REST y ver y guardar 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 Java Database Connectivity (JDBC) permite integrar dominios de OpenSearch Service en sus aplicaciones favoritas de inteligencia empresarial (BI). Para descargar el controlador, haga clic aquí
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
Para obtener más información sobre cómo instalar el controlador, consulte el Repositorio SQL en GitHub
