Conexión Fuente IBM DB2

Requisitos Previos

Antes de configurar la conexión de origen IBM DB2 en Crestone, asegúrese de contar con lo siguiente:

Requisito Principal: Una instancia activa y accesible de IBM DB2 LUW (Linux/Unix/Windows) con un usuario que posea privilegios de lectura en la base de datos de destino. Las siguientes versiones son compatibles:

Nota: Crestone se conecta a IBM DB2 mediante jaydebeapi con el controlador IBM JDBC (db2jcc4.jar versión 11.5.8.0). No se requiere ningún software cliente de DB2 ni IBM Data Server Client en el servidor de Crestone.

Información Requerida:

Paso de Pre-Verificación

Antes de configurar la conexión en Crestone, recomendamos verificar sus credenciales utilizando un cliente SQL compatible como DBeaver o DataGrip. Esto asegura que el servidor sea accesible y que las credenciales sean correctas antes de continuar.

Consejo para DBeaver: Para conectarse a IBM DB2 desde DBeaver, seleccione IBM DB2 como el tipo de controlador y elija la variante DB2 LUW. Utilice el mismo host, puerto (50000), nombre de base de datos, usuario y contraseña que ingresará en Crestone.

Pasos de Configuración

Siga estos pasos para crear una nueva conexión de origen IBM DB2 en Crestone:

1. Navegue a Connections en la barra de navegación superior.
2. Seleccione la pestaña Source.
3. Haga clic en el botón + para crear una nueva conexión.
4. Complete el campo Connection Name con un nombre descriptivo (ej. Mi Fuente DB2).
5. En el menú desplegable Source Type, seleccione IBM DB2.
6. Complete el formulario de credenciales con los campos requeridos:
   • Server — host o dirección IP de su instancia DB2
   • Port — predeterminado 50000
   • Database — nombre de la base de datos DB2 a la que conectarse
   • Username — usuario de la base de datos
   • Password — contraseña del usuario
7. Haga clic en Test Connection para validar que Crestone pueda comunicarse exitosamente con la base de datos.
8. Una vez superada la prueba, haga clic en Create Source para guardar la conexión.

Edición de una Conexión Existente

Para actualizar las credenciales de una conexión de origen IBM DB2 existente:

1. Navegue a Connections y localice su origen IBM DB2.
2. Haga clic en Edit.
3. Modifique los campos deseados en el formulario de credenciales.
4. Haga clic en Test Connection para verificar las nuevas credenciales.
5. Haga clic en Confirm para guardar los cambios.

Uso de IBM DB2 como Fuente en un Nodo de Extracción

Una vez creada la conexión, puede utilizarla como origen de un Extraction Node. Hay dos modos de extracción disponibles:

Modo Visual

Configure la extracción sin necesidad de escribir código SQL:

1. Abra o cree un Extraction Node y diríjase a la pestaña Source.
2. En Select Source, elija su conexión IBM DB2.
3. En Select Schema, elija el esquema que contiene las tablas que desea extraer.
4. En Select Table, elija la tabla a extraer.
5. En Select Fields, seleccione las columnas específicas que desea, o déjelo vacío para extraer todas las columnas.
6. Opcionalmente, agregue una condición WHERE para filtrar filas.
7. El panel de Preview muestra una muestra de los datos que se extraerán.

Modo SQL Script

Escriba una consulta SQL personalizada para extracciones más complejas:

1. Seleccione la fuente y el esquema como en el Modo Visual.
2. Cambie al modo SQL Script.
3. Escriba su consulta SQL utilizando la sintaxis estándar de DB2 SQL.
4. Haga clic en Run Preview para validar y previsualizar los resultados de la consulta.

Nota: El modo SQL Script admite cualquier sentencia SELECT válida de DB2, incluyendo JOIN, subconsultas, funciones de agregación y GROUP BY. Evite sentencias DDL (CREATE, DROP, ALTER) en este campo.

Nota sobre límite de filas: DB2 utiliza la sintaxis FETCH FIRST n ROWS ONLY (no LIMIT ni TOP). Crestone gestiona esto automáticamente en el Modo Visual. Si redacta un SQL Script personalizado, use la misma sintaxis: SELECT * FROM schema.table FETCH FIRST 100 ROWS ONLY.

Nota sobre esquemas: En IBM DB2, los esquemas son espacios de nombres lógicos que agrupan objetos de base de datos. Un esquema se identifica por su nombre (ej. DB2INST1, CRESTONE). Crestone lista todos los esquemas visibles en SYSCAT.SCHEMATA, excluyendo los esquemas del sistema (SYS%, NULLID, SQLJ, DB2GSE, SYSTOOLS).

Manejo de Tipos de Datos

Cuando Crestone lee datos de IBM DB2, los tipos de columna se devuelven a través del cursor JDBC y se asignan internamente a tipos Polars:

Nota: Los tipos de Python no estándar devueltos por el puente JDBC (ej. java.math.BigDecimal, java.sql.Timestamp) se convierten automáticamente a string para garantizar la compatibilidad entre todos los conectores de destino.

Problemas Frecuentes

Permisos Requeridos

Para acceso de solo lectura (extracción de origen), el usuario de base de datos requiere como mínimo los siguientes privilegios:

-- Conceder privilegio CONNECT en la base de datos
GRANT CONNECT ON DATABASE TO USER crestone_user;

-- Conceder SELECT en tablas específicas
GRANT SELECT ON TABLE schema_name.table_name TO USER crestone_user;

-- O conceder SELECT en todas las tablas de un esquema (requiere SCHEMAADM o DBADM)
GRANT SELECT ON TABLE schema_name.* TO USER crestone_user;

Nota: Para listar esquemas y tablas en la interfaz de descubrimiento de esquemas, Crestone consulta SYSCAT.SCHEMATA y SYSCAT.TABLES. Estas vistas de catálogo son legibles de manera predeterminada por cualquier usuario autenticado con privilegio CONNECT en DB2.