Centro de soporte de Workiva

Con el conector JDBC, puedes utilizar comandos en una cadena para realizar operaciones en lenguaje de consulta estructurado (SQL) en soluciones locales que admitan la conectividad de bases de datos Java® (JDBC). Por ejemplo, con este conector, puedes:

• Ejecutar comandos SQL, incluida una sentencia CREATE o UPDATE o una consulta SELECT.
• Recuperar detalles sobre una tabla de base de datos
• Inserta Registros en una Base de Datos mediante JDBC.

Nota: Para conectar con Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) o Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, o Snowflake®, utiliza su respectivo conector en su lugar.

Requisitos previos

Para asegurar la conexión JDBC, el conector utiliza la autenticación básica de nombre de usuario y contraseña. Para configurar el conector, necesitarás:

• Un usuario de integración designado establecido en la solución a la que te conectas.
• Credenciales de autenticación del usuario de integración.
• La URL de la conexión JDBC, como jdbc:solution://host:port/database
• Un GroundRunner dedicado al conector, ya que no se admiten CloudRunners.
• El controlador JDBC para la conexión, incluyendo su nombre de clase y la ruta en el sistema de archivos de GroundRunner.
• Para proporcionar opciones personalizadas de Java al utilizar este conector, establece la variable de entorno JDK_JAVA_OPTIONS para el GroundRunner. Por ejemplo, si utilizas Databricks, utilizarías lo siguiente:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Esto es similar a las variables de Configuración establecidas en Instalar y gestionar GroundRunners. 
  Importante: Debes reiniciar el ordenador en el que esté funcionando la unidad GroundRunner después de establecer esta variable.

Nota: El controlador debe estar ubicado en el GroundRunner, ya que los archivos .jar no pueden cargarse como Recursos.

Establece el conector JDBC

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

1. Desde Generador de cadenas, haz clic en Conexiones compare_arrows, y luego en Crear en la parte superior derecha.
2. En Conexión de conectores, selecciona JDBC y el GroundRunner para utilizarlo con la conexión.
   
3. En Información básica, ingresa un nombre único y una descripción para ayudar a identificar la conexión.

4. En Propiedades, ingresa los detalles de la conexión:
   

   Propiedad	Detalles
   Nombre de usuario	Introduce el Nombre de usuario del usuario de integración del conector.
   Contraseña	Introduce la Contraseña para la propiedad Nombre de usuario.
   URL de conexión	Introduce la URL de la conexión JDBC, como jdbc:solution://host:port/database.
   Clase de unidad JDBC	Introduce el nombre de la clase del archivo .jar del controlador JDBC. Por ejemplo, para Sybase®, introduce com.sybase.jdbc.sybdriver.
   Ruta al controlador JDBC	Introduce la ruta de instalación del controlador JDBC en el sistema de archivos del GroundRunner.

   Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

5. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
6. Apaga y reinicia el ordenador en el que se está ejecutando el GroundRunner para reinicializar la JVM.
7. Para probar la conexión, crea y ejecuta una cadena con el comando Obtener definición de tabla del conector, y comprueba que devuelve un resultado válido.

Solución de problemas

Si falla la conexión JDBC:

• Verifica las credenciales de autenticación del usuario de integración.
• Comprueba la URL de la conexión JDBC, incluyendo su servidor, puerto y Base de datos.
• Verifica el nombre de clase o la ruta del controlador JDBC introducidos para el conector.

Si la conexión no ejecuta un comando, comprueba que sus entradas (como la sintaxis SQL o la tabla) son válidas.