Orígenes de datos desde bases de datos

Orígenes de datos desde bases de datos

Resumen

El conector a bases de datos permite recolectar datos desde MySQL, MongoDB, PostgreSQL, SQL Server y Oracle, o configurar acciones de escritura, para luego crear vistas de datos y exponerlas en métodos de su API. Esta guía explica la conexión, el pool y las propiedades del driver, los tiempos de espera y la consulta.

Antes de comenzar

  • Tenga el endpoint de la base, con la forma servidor:puerto/nombreBaseDeDatos, sin protocolo. El servidor puede ser una IP o un dominio.
  • Tenga un usuario y contraseña con permiso para la operación que va a hacer. Si la base exige otro esquema de seguridad, contáctese con soporte.
  • Si la base está detrás de un firewall, habilite las conexiones desde las IPs de la plataforma.

Operaciones

El selector Lectura, a la derecha del endpoint, define la operación: Lectura (sentencias SELECT), Escritura (INSERT), Actualización (UPDATE) o Borrado (DELETE). Además de una consulta puede ejecutar un procedimiento almacenado desde la pestaña Procedimientos de almacenados.

Motores soportados

Las pestañas del formulario son los motores disponibles y el selector de versión, las versiones que soporta el driver de cada uno:

  • MySQL: 8.0 a 5.1.
  • MongoDB: 5.0 a 3.4.
  • PostgreSQL: 15 a 8.2.
  • SQL Server: 2019 a 2000.
  • Oracle: 21.1 a 12.2.

Si su motor o versión no está en el selector, contáctese con soporte.

Configurar la conexión

Motor, versión y endpoint

Desde Orígenes de datos > Nuevo origen de datos, elija Desde una base de datos. Elija la pestaña del motor, la versión y escriba el endpoint.

Autenticación

En la pestaña Autenticación elija Usuario / Contraseña e ingrese las credenciales.

Formulario Desde una base de datos con MySQL 8.0, el endpoint y la pestaña Autenticación con usuario y contraseña

Pool de conexiones

Un pool es un conjunto limitado de conexiones que se reutilizan entre consultas. En la pestaña Pool de conexiones defina las Conexiones iniciales (1 por defecto), las Conexiones activas máximas (10) y las Conexiones en espera máximas (5).

Pestaña Pool de conexiones con conexiones iniciales, activas y en espera, y los campos de tiempos de espera y lectura

Propiedades de la conexión

En la pestaña Propiedades de la conexión se agregan pares propiedad y valor que se pasan al driver. Cada motor trae propiedades precargadas (MySQL, por ejemplo, serverTimezone=UTC y useSSL=false) y el selector sugiere las más comunes, pero acepta cualquier nombre que el driver entienda. Con Agregar se suma a la lista; con el lápiz y el tacho se edita o se quita.

Pestaña Propiedades de la conexión con las propiedades precargadas de MySQL

Tiempos de espera

Hay dos lugares para los tiempos de espera, según de quién dependen.

Del motor de Vor-Tex

Debajo del pool, en Tiempos de espera y lectura:

  • Filas por lectura: cuántas filas trae el driver por viaje (fetchSize), entre 1 y 100.000. Vacío usa el valor del driver.
  • Timeout de consulta: segundos máximos de ejecución de la sentencia (queryTimeout), entre 1 y 3.600; vacío usa 30.

En MongoDB hay una pestaña Tiempos de espera propia con el Timeout de conexión y el Timeout de socket, en milisegundos; vacíos usan 60.000.

Del driver

Los tiempos de conexión y de lectura del driver JDBC se definen como propiedades de la conexión, con el nombre y la unidad que usa cada motor:

  • MySQL: connectTimeout y socketTimeout, en milisegundos.
  • PostgreSQL: connectTimeout, socketTimeout y loginTimeout, en segundos.
  • SQL Server: loginTimeout en segundos y socketTimeout en milisegundos.
  • Oracle: oracle.net.CONNECT_TIMEOUT y oracle.jdbc.ReadTimeout, en milisegundos.

Probar y escribir la consulta

Probar la conexión

Haga clic en Probar. Si la conexión es correcta, a la izquierda aparece el listado de tablas de la base.

Sentencia

Escriba la sentencia según la operación elegida. Dentro de la sentencia puede usar mapeos, que luego se exponen como parámetros de la vista y del método:

SELECT * FROM ventas WHERE region = {{region}} ORDER BY fecha {{orden}}

Indique si la respuesta trae títulos o cabeceras y si, ante un error, se muestra el mensaje original de la base. Con Previsualizar ejecuta la sentencia y ve la tabla.

Listado de tablas de la base y la sentencia SELECT en el panel Configurar consulta

Resultado esperado

Al hacer clic en Continuar se completan los metadatos, la frecuencia de actualización y, si hace falta, el Spool. El origen queda en Borrador, listo para crear una vista de datos con los mapeos como parámetros.

Errores frecuentes

  • Probar no lista tablas: endpoint con protocolo (jdbc:// o http://), puerto cerrado para las IPs de la plataforma, o credenciales sin permiso.
  • La consulta tarda y falla: suba el Timeout de consulta o agregue un filtro con mapeo para traer menos filas. Recuerde el límite de filas de las vistas.
  • Error de zona horaria o de SSL en MySQL: revise las propiedades precargadas serverTimezone y useSSL.

Artículos relacionados