SQL Executor
SQL Executor se conecta a una base de datos con su dirección de conexión y ejecuta la consulta SQL que le pases. Devuelve el resultado como texto.
Cuándo usarlo
- Ejecutar una consulta generada por un modelo a partir de una pregunta.
- Lanzar una consulta puntual sin configurar una credencial.
Configuración
| Campo | Qué hace |
|---|---|
| Query (obligatorio) | La consulta SQL que se ejecuta. |
| Database URL (obligatorio) | La dirección de conexión de la base, con usuario y contraseña, por ejemplo postgresql://usuario:contraseña@servidor:5432/ventas. |
| Include Columns | Incluye los nombres de las columnas en el resultado. Desactivado por defecto. |
| Passthrough | Si la consulta falla, devuelve la consulta en lugar de detener el flujo. Desactivado por defecto. |
| Add Error | Con Passthrough activado, añade también el error al resultado. Desactivado por defecto. |
Resultado
La salida es el resultado de la consulta como texto.
Ejemplo
Un analista quiere preguntar en lenguaje natural por las ventas.
- Conecta Natural Language to SQL para convertir la pregunta en consulta.
- Pasa la consulta a Query y escribe la dirección de la base en Database URL.
- Muestra el resultado en el chat.
Buenas prácticas
- La dirección incluye la contraseña: usa un usuario con permisos de solo lectura. Para conexiones guardadas en credenciales, usa componentes como Postgres SQL.
Componentes relacionados
- SQLDatabase: prepara una conexión para consultar en lenguaje natural.