Database Node
Consultar bases de datos relacionales directamente desde sus flujos de trabajo.
Descripción general
El Database Node le permite conectarse a bases de datos MySQL, PostgreSQL o MongoDB y ejecutar consultas. Admite tanto la construcción visual de consultas simples como el modo avanzado de SQL/consultas sin procesar.
¿No necesita una base de datos externa? Si desea almacenar y consultar datos directamente en Ubex sin configurar MySQL, PostgreSQL o MongoDB, use Tables en My Data en su lugar. Las Tables funcionan como tablas de base de datos integradas con soporte CRUD completo mediante los nodos Query Data y Write Data. Consulte la documentación de My Data para más detalles.
Bases de datos compatibles
| Base de datos | Puerto | Descripción |
|---|---|---|
| MySQL | 3306 | Base de datos relacional de código abierto popular |
| PostgreSQL | 5432 | Base de datos relacional de código abierto avanzada |
| MongoDB | 27017 | Base de datos de documentos NoSQL |
Configuración
Ajustes de conexión
| Campo | Descripción | Obligatorio |
|---|---|---|
Database Type |
MySQL, PostgreSQL o MongoDB | Sí |
Connection |
Seleccionar conexión guardada o crear una nueva | Sí |
Output Variable |
Nombre de la variable para almacenar los resultados de la consulta | Sí |
Nueva conexión
| Campo | Descripción |
|---|---|
Host |
Dirección del servidor de base de datos |
Port |
Puerto de la base de datos (se completa automáticamente según el tipo) |
Username |
Usuario de la base de datos |
Password |
Contraseña de la base de datos |
Database Name |
Nombre de la base de datos a la que conectarse |
SSL |
Habilitar cifrado SSL/TLS |
Túnel SSH (Opcional)
| Campo | Descripción |
|---|---|
SSH Host |
Dirección del servidor SSH |
SSH Port |
Puerto SSH (predeterminado: 22) |
SSH Username |
Usuario SSH |
SSH Password |
Contraseña SSH o clave privada |
Modos de consulta
Modo simple
Construya consultas visualmente sin escribir SQL:
- Seleccionar tabla - Elegir entre las tablas disponibles
- Seleccionar columnas - Elegir las columnas a devolver (o todas)
- Agregar condiciones - Filtrar con cláusulas WHERE
- Ordenar por - Ordenar resultados
- Agrupar por - Agregar datos
- Limit/Offset - Paginación
Modo avanzado
Escribir consultas SQL sin procesar con control total:
SELECT u.name, COUNT(o.id) as order_count
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.created_at > '2024-01-01'
GROUP BY u.id
ORDER BY order_count DESC
LIMIT 10
Operadores de condición
| Operador | Descripción |
|---|---|
= |
Igual a |
!= |
Diferente de |
> / < |
Mayor/Menor que |
>= / <= |
Mayor/Menor o igual que |
LIKE |
Coincidencia de patrones |
IN |
Valor en lista |
IS NULL |
El valor es nulo |
IS NOT NULL |
El valor no es nulo |
Uso de variables
Use variables de plantilla en sus consultas:
SELECT * FROM users WHERE id = {{user_id}}
O en condiciones (Modo simple):
Column: status
Operator: =
Value: {{filter_status}}
Parámetros de consulta
En el modo avanzado, use consultas parametrizadas para mayor seguridad:
SELECT * FROM users WHERE email = $1 AND status = $2
Luego asigne los parámetros:
$1→{{user_email}}$2→{{status}}
Buenas prácticas
- Guardar y reutilizar conexiones entre flujos de trabajo
- Usar consultas parametrizadas para prevenir SQL injection
- Agregar índices apropiados para columnas consultadas frecuentemente
- Usar LIMIT para evitar devolver demasiados datos
- Probar las consultas primero con conjuntos de datos pequeños