Saltar al contenido principal
Documentación
Documentación
Adaptive Planning
Última actualización: 2024-09-20
Pasos: configuración de orígenes de datos de la base de datos JDBC

Pasos: configuración de orígenes de datos de la base de datos JDBC

Puede usar
Adaptive Planning
 Integración para extraer información de bases de datos compatibles con JDBC. La mayoría de las bases de datos utilizadas para aplicaciones de contabilidad y finanzas son bases de datos compatibles con JDBC (conectividad a bases de datos de Java). JDBC es un estándar que utiliza el lenguaje de programación Java para proporcionar conectividad a una amplia gama de bases de datos.
Un origen de datos de base de datos compatible con JDBC requiere un controlador. La siguiente tabla aporta información sobre los controladores JDBC más comunes.
Los agentes de datos de Adaptive Planning solo se conectan a bases de datos locales. No se admite la conexión a bases de datos en la nube con un agente.
Origen JDBC
Información general
JAR de proveedor
Clase de controlador
Ejemplo de JDBC/URL
Información de URL de JDBC
Oracle
ojdbc6-11.2.0.3.jar
Puede obtener este archivo desde el sitio web de Oracle o a través del repositorio Maven de Oracle.
oracle.jdbc.OracleDriver
jdbc:oracle:thin:@example-win-db:1521:ANACONDA
SQL Server
jtds-1.3.1.jar distribuido en la carpeta Complementos de agente de datos.
net.sourceforge.jtds.jdbc.Driver
jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS
SQL Server
sqljdbc41.jar distribuido en la carpeta Complementos de agente de datos.
com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;
MySql
com.mysql.jdbc.Driver
jdbc:mysql://localhost:3306/AGENT_TEST
h2
Busque h2*.jar en la distribución Workday Adaptive Planning Data Agent Service Manager. Para las versiones del agente de datos 7.1.44 y anteriores, busque h2.jar en la distribución del gestor del servicio de agente de datos de Adaptive.
org.h2.Driver
jdbc:h2:/data/test
Los archivos jar se encuentran en el
C:/Program Files/Workday Adaptive Planning Data Agent/Plugins.
Para las versiones de agente de datos 7.1.44 y anteriores, utilice
C:/Program Files/Adaptive Data Agent/Plugins
en el equipo que aloja el servicio de agente de datos.
Después de añadir un archivo .jar, debe acceder a los servicios locales y reiniciar el servicio del agente de datos.
Antes de poder definir un origen de datos a partir de una base de datos local, debe haber creado un Agente de datos que le indique
Adaptive Planning
 Integración: cómo comunicarse con la base de datos. Para obtener información sobre cómo crear agentes de datos, consulte Create Data Agents.
Para configurar un origen de datos de base de datos JDBC, siga estos pasos:
  1. Acceda al diseñador de datos en
    Integración > Diseñador de datos
    .
  2. En la carpeta Origen de datos de la Biblioteca de componentes situada en la derecha de la pantalla, haga clic en
    Crear nuevo origen de datos
    . Aparecerá el cuadro de diálogo Crear nuevo.
  3. Seleccione Origen de datos JDBC como tipo de origen de datos, introduzca el nombre de la base de datos y seleccione el agente que desee utilizar para este origen de datos.
  4. Haga clic en
    Crear
    . En el centro de la pantalla se mostrará la configuración del nuevo origen de datos y otra información.
  5. Introduzca la siguiente información del origen de datos:
    • Agente asociado:
       seleccione el agente de datos de Adaptive Planning al que desea conectarse. Esta lista contiene todos los agentes de datos que se encuentran en
      Agentes de datos
      de biblioteca de componentes
      .
    • Clase de controlador:
       introduzca la clase de controlador para la base de datos. (Puede obtener esta información del proveedor de la base de datos).
    • URL:
       introduzca la URL de la base de datos.
    • Nombre de usuario:
       introduzca el nombre de usuario utilizado para acceder a la base de datos.
    • Contraseña:
       introduzca la contraseña asociada al nombre de usuario.
    • Filtro de esquema:
       introduzca el nombre del esquema o los esquemas de los que desea importar los datos. Si va a introducir varios nombres de esquema, sepárelos con punto y coma. Utilice este campo para restringir el número de tablas que deben actualizarse en
      Adaptive Planning
       Integración Este campo es opcional.
    • Nivel de registro:
      seleccione un nivel de registro de la lista desplegable para especificar los detalles para el registro de este origen de datos. Tiene las siguientes opciones:
      • Error:
         solo registra errores graves.
      • Información:
         registra toda la información básica, como las fechas de actualización del origen de datos.
      • Detallado:
         proporciona información pormenorizada sobre todas las fases y acciones. (Este nivel se utiliza principalmente para la depuración o la auditoría, ya que puede generar más información de registro de la que resulta práctica para el uso habitual).
  6. Haga clic en
    Guardar
    en el menú Acciones.
Puede probar la información de conexión en el nuevo origen de datos haciendo clic en
Prueba de conexión
 en el menú
Acciones
. El sistema intentará conectarse a la base de datos utilizando la información de los campos de origen de datos. Si el sistema consigue conectarse a la base de datos, haga clic en
Aceptar
. Si hay problemas de conexión, corrija los errores y vuelva a intentarlo.
Cuando consiga conectarse a la base de datos, todo estará listo para importar la estructura de datos. Eso le permite ver las tablas y columnas de la base de datos.
Solo aparecen las columnas de los tipos admitidos. Tipos de columna admitidos, enumera los tipos de columna admitidos para los distintos tipos de bases de datos.
Para importar la estructura de la base de datos JDBC, haga lo siguiente:
  1. Haga clic en
    Importar estructura
     en el menú
    Acciones
    . Las tablas y columnas aparecen en el menú
    Componentes de datos
    .
    Los modos de importación de datos afectan a la forma en que se sincronizan los datos. El modo de importación por defecto (con todos los registros sustituidos) para un origen de datos JDBC es el siguiente:
  2. Se importan los datos JDBC.
  3. Los datos del origen JDBC rellenan la tabla de almacenamiento provisional.
  4. Si hay un filtro SQL personalizado, se aplicará a los datos que se van a importar desde el servidor de la base de datos para determinar el subconjunto de datos que se va a importar.
También puede optar por añadir información importada, en cuyo caso los datos importados se añaden a la tabla de almacenamiento provisional existente, o por fusionar la información importada, en cuyo caso las filas existentes de los datos JDBC se fusionan con las filas de la zona de almacenamiento provisional.

Introducción de tablas en un origen de datos JDBC

Una vez que haya importado la estructura de la base de datos, podrá especificar la información que desea importar de la base de datos. La sección
Tablas para importar
 le permite configurar los datos importados desde la base de datos.
Para especificar las tablas que se van a importar desde la base de datos, siga estos pasos:
  1. Expanda la entrada del origen de datos en el menú
    Componentes de datos
    .
    Cada tabla de la base de datos aparece como un elemento independiente.
  2. Arrastre y suelte las tablas que desea importar en la sección
    Tablas para importar
     en el centro de la pantalla.
    A medida que arrastra cada tabla a la sección Tablas para importar, aparece una ficha para la tabla e información de la base de datos en la sección Tablas para importar, que le permite ver el tipo de información que ha añadido. La ficha de cada tabla también tiene un menú desplegable, al que puede acceder haciendo clic en la flecha que aparece junto al nombre de la tabla.

Gestión de columnas

Si una tabla con la que está trabajando tiene un gran número de columnas, puede usar la opción
Gestionar columnas
 para editar rápidamente las columnas que desea importar. El cuadro de diálogo
Gestionar columnas
 muestra las columnas en una tabla para que pueda marcarlas o desmarcarlas para importarlas.
Para gestionar las columnas de cara a la importación, siga estos pasos:
  1. Haga clic en la flecha de la ficha situada a la derecha del nombre de la tabla.
  2. Haga clic en
    Gestionar columnas
     en el menú flotante.
  3. Marque la casilla junto a la columna para importarla.
    Cuando marca una columna, la columna también aparece en la ventana de vista previa después de que se guarde el contenido de la ventana emergente. Al desmarcar una columna, se elimina de la ventana de vista previa.
También puede cambiar el estado de importación en columnas individuales de la siguiente manera:
  • Seleccionando propiedades de columna y definiendo la propiedad.
  • Arrastrando y soltando las columnas en el diseñador.
No puede cambiar el estado de importación de los campos generados por el sistema como
isDeleted
.

Personalización de las tablas

Puede personalizar la forma en la que se importan los datos en cada tabla.
Para personalizar la configuración de la tabla, siga estos pasos:
  1. Haga clic en la flecha de la ficha situada a la derecha del nombre de la tabla.
  2. Haga clic en
    Configuración de tabla
     en el menú flotante.
  3. Edite los siguientes parámetros de configuración de la tabla:
    • Modo de importación de datos:
       seleccione una de las opciones de la lista desplegable.
      • Todos los registros se sustituyen cada vez que se ejecuta una importación de datos.
         Esta es la opción definida por defecto. Sustituye los datos de la tabla de almacenamiento provisional por datos importados desde el origen.
      • Remote cache used to identify and send changed records on import
        . Con esta opción, solo se importan los registros de la base de datos que han cambiado o son nuevos. Los registros modificados sobrescriben los existentes en la zona de almacenamiento provisional. Los nuevos registros se añaden al final de la información en la zona de almacenamiento provisional.
      • Se han transmitido todos los registros incluidos en un rango de periodo.
         Se importan todos los registros del rango de periodo que especifique. Los registros de la tabla de almacenamiento provisional que coinciden con los periodos importados se eliminan antes de importar los datos más recientes desde el origen.
    • Filtro de importación de datos:
       utilice esta opción para introducir una expresión SQL que filtre o aplique formato a la información que se va a importar. El filtro SQL se aplica antes de extraer los datos de la base de datos para reducir la cantidad de datos que se deben importar, lo que le proporciona un nivel adicional de control de los datos que se van a introducir en la zona de almacenamiento provisional. Haga clic en el campo para que se muestre el cuadro de diálogo
      Editar filtro SQL
       (el filtro que introduzca aquí se aplicará a los datos reales de la base de datos, no a los datos de vista previa que aparecen en la zona de almacenamiento provisional). No todos los orígenes de datos admiten el mismo nivel de capacidad de filtrado de SQL.
  4. Haga clic en
    Aplicar
    para aplicar la configuración.
  5. Repita los pasos 1 a 3 para cada tabla.
    Si la tabla de una base de datos tiene claves definidas, esta información también se incorpora a la tabla de almacenamiento provisional. Puede revisar esta información y modificarla según sea necesario.
  6. Haga clic en
    Guardar
    para guardar la configuración en el origen de datos.

Configuración de opciones de columna

Cuando usa la sección
Tablas para importar
, aparece una vista previa de los datos tal y como están en el origen de datos o en la zona de almacenamiento provisional después de haberlos importado. Puede cambiar las opciones de cada columna manteniendo el puntero del ratón sobre la cabecera y haciendo clic en el menú desplegable junto al nombre. Tiene las siguientes opciones:
  • Orden ascendente
    : ordene toda la tabla en función de esta columna en orden ascendente.
  • Orden descendente
    : ordene toda la tabla en función de esta columna en orden descendente.
  • Configuración de columnas
    : este cuadro de diálogo se utiliza para cambiar las propiedades de la columna dentro de la tabla de almacenamiento provisional.
    • Nombre
      : el nombre de la columna que se muestra en la cabecera.
    • Tipo de columna
      : el tipo de datos utilizados en la columna.
    • Convertir tipo de columna
      : seleccione el nuevo tipo en este menú desplegable.
  • Excluir columna de la importación
    : seleccione esta opción para eliminar esta columna de los datos que se están importando.
  • Eliminar columna personalizada
    : seleccione esta opción para eliminar la columna. (Disponible solo para columnas personalizadas).

Descarga de datos de una tabla de almacenamiento provisional

Puede descargar datos de una sola tabla de almacenamiento provisional.
Para descargar datos de una sola tabla de almacenamiento provisional, siga estos pasos:
  1. Haga clic en la flecha hacia abajo de la cabecera de una tabla en la sección Tablas para importar.
  2. Seleccione
    Descargar datos
    .
  3. Haga clic en
    Enviar
     en la lista de valores
    . Esta operación enviará un correo electrónico con una URL para descargar los datos
    .
    Adaptive Planning
     La integración envía un correo electrónico que contiene una URL a la cuenta de correo electrónico asociada al diseñador de datos.
  4. Abra el correo electrónico y haga clic en la URL.
    Los datos se descargan en formato .csv.

Uso del filtro avanzado

Debajo del menú desplegable
Origen
, puede hacer clic en
Filtro avanzado
 para que se muestren las opciones de filtrado de los datos en el área de vista previa de
Tablas para importar
. El
filtro avanzado
 proporciona herramientas para ver y explorar un subconjunto de los datos dentro de una tabla de almacenamiento provisional o directamente desde el origen remoto (si selecciona Origen de datos JDBC en el menú desplegable Origen). Al cambiar las propiedades de filtro, puede cambiar la vista de los datos que se muestran en la ventana de vista previa sin cambiar los datos en la zona de almacenamiento provisional.
El área de vista previa está diseñada específicamente para obtener una vista previa de una pequeña parte de los datos de la zona de almacenamiento provisional (o el origen de datos JDBC). Puede explorar los datos que están disponibles en el origen de datos JDBC y verificar que obtiene los datos esperados examinando la zona de almacenamiento provisional. También puede usarla para ajustar el filtro de importación de datos que desea usar. (Los filtros definidos en la función de vista previa no afectan a los datos reales de la zona de almacenamiento provisional).
El
Filtro avanzado
 incluye lo siguiente:
  • Filas distintas
    : marque esta casilla para ocultar las filas duplicadas.
  • Máximo de filas
    : limite el número de filas que se muestran en el área de vista previa introduciendo un número en el cuadro de texto.
  • Columnas
    : marque o desmarque las columnas en este menú desplegable para mostrar u ocultar las columnas que aparecen.
    Al eliminar una columna de esta lista, no se elimina la columna de la lista de importación.
  • Filtro SQL
    : haga clic en el cuadro de texto grande para que se muestre el cuadro de diálogo
    Editar filtro SQL
    , donde puede introducir un filtro SQL para restringir las filas que se previsualizan. Haga clic en
    Aplicar
     para comprobar automáticamente la sintaxis SQL del filtro. (Si hay algún error, se indicará en la expresión). La expresión que ha introducido aparece en el campo
    Filtro avanzado
    . Para obtener ayuda detallada sobre la sintaxis SQL, puede hacer clic en la ayuda en línea de la sección
    Notas
     .
Haga clic en
Eliminar filtro
 (junto al menú desplegable Origen) para borrar toda la configuración de filtro avanzado.
Como parte del proceso de personalización de la tabla, también puede crear tablas combinadas y columnas personalizadas mediante expresiones SQL.

Importación de datos de un origen de datos JDBC

Una vez que haya configurado y guardado el origen de datos JDBC, podrá importar datos.
Para importar datos de un origen de datos JDBC, haga lo siguiente:
  1. Haga clic en
    Importar datos
     en el menú
    Acciones
    .
    Los datos seleccionados se filtran mediante cualquier expresión SQL y se cargan en la zona de almacenamiento provisional. Puede obtener una vista previa de los datos en la zona de almacenamiento provisional.
La información permanece en la zona de almacenamiento provisional hasta que la borra manualmente o hasta que una carga de datos posterior la borra según el modo de importación.
Para borrar datos de la zona de almacenamiento provisional, haga lo siguiente:
  1. Haga clic en
    Borrar tablas de almacenamiento provisional
     en el menú
    Acciones
    . Se borra el contenido de la zona de almacenamiento provisional de todas las tablas del origen de datos.
Para eliminar los caracteres especificados de secuencias de texto de entrada en los orígenes de datos JDBC:

Asociación de un origen de datos JDBC con un agente de datos de Adaptive Planning diferente

Puede cambiar el agente de datos de Adaptive Planning que asocia con su origen de datos JDBC.
  1. Verifique que el agente de datos al que desea conectarse aparezca en
    Agentes de datos
    de biblioteca de componentes
    .
  2. Navegue hasta el origen de datos JDBC en Design Integrations.
  3. Seleccione el agente de datos en el campo
    Agente asociado
     de la sección
    Configuración
     .

Esquemas excluidos de origen de datos JDBC

Los orígenes de datos JDBC que se conectan a Oracle o MS SQL Server excluyen explícitamente algunos esquemas que no están relacionados con datos financieros.

Esquemas excluidos del origen de datos JDBC de Oracle

CTXSYS, MDSYS, SYSTEM, SYS, XDB

Esquemas excluidos del origen de datos JDBC de MS SQL Server

INFORMATION_SCHEMA, SYS

Consejos para la resolución de problemas

Hay algunos problemas de origen de datos que puede experimentar, cuyas soluciones no son evidentes de inmediato.
Cuando importa la estructura para una base de datos y la base de datos tiene más de 1000 tablas, obtiene un error que le aconseja que filtre la lista de tablas. Puede resolver este error realizando una de las siguientes acciones:
  • Editar el origen de datos JDBC e introducir un filtro de esquema.
  • Cambiar los permisos asociados con el inicio de sesión que está utilizando en el acceso al servidor para que se pueda acceder a menos tablas a través de ese inicio de sesión.
Cuando importa la estructura de una base de datos Oracle, los siguientes esquemas no se importan como parte de la estructura:
CTXSYS, MDSYS, SYSTEM, SYS,
y
XDB
. Estos son esquemas de sistemas de Oracle y no son necesarios para la integración de datos.
Cuando se importa la estructura de una base de datos MS SQL, los siguientes esquemas no se importan como parte de la estructura: INFORMATION_SCHEMA y sys. Estos son esquemas de sistemas MS SQL y no son necesarios para la integración de datos.