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.
servidor:puerto/nombreBaseDeDatos, sin protocolo. El servidor puede ser una IP o un dominio.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.
Las pestañas del formulario son los motores disponibles y el selector de versión, las versiones que soporta el driver de cada uno:
Si su motor o versión no está en el selector, contáctese con soporte.
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.
En la pestaña Autenticación elija Usuario / Contraseña e ingrese las credenciales.
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).
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.
Hay dos lugares para los tiempos de espera, según de quién dependen.
Debajo del pool, en Tiempos de espera y lectura:
fetchSize), entre 1 y 100.000. Vacío usa el valor del driver.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.
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:
connectTimeout y socketTimeout, en milisegundos.connectTimeout, socketTimeout y loginTimeout, en segundos.loginTimeout en segundos y socketTimeout en milisegundos.oracle.net.CONNECT_TIMEOUT y oracle.jdbc.ReadTimeout, en milisegundos.Haga clic en Probar. Si la conexión es correcta, a la izquierda aparece el listado de tablas de la base.
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.
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.
jdbc:// o http://), puerto cerrado para las IPs de la plataforma, o credenciales sin permiso.serverTimezone y useSSL.