Conectar a Microsoft utilizando el conector de Base de Datos en Jitterbit Integration Studio

Esta página explica cómo conectarse a estos servicios de Microsoft utilizando el conector de Base de Datos:

• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server

Microsoft Access

Debe estar ejecutando un agente privado para poder conectarse a Microsoft Access. Microsoft Office debe estar instalado en el mismo sistema en el que se está ejecutando el agente privado, y ese sistema debe ser un sistema operativo Windows. Tenga en cuenta que el equipo de Jitterbit no ha probado los controladores ODBC de Linux para Microsoft Access.

Instalar el controlador ODBC

El controlador ODBC de Microsoft Access generalmente se instala como parte de Windows. Los controladores más antiguos son compatibles con la extensión de archivo .mdb. Sin embargo, si su base de datos es Access 2007 o posterior con la extensión .accdb, es posible que necesite obtener una versión más reciente del controlador ODBC, como el Microsoft Access 2016 Redistributable.

Configurar la conexión de Base de Datos

Después de instalar el controlador, especifique estas entradas durante la configuración de la conexión de Base de Datos:

• Tipo de Controlador: Seleccione ODBC.

• Controlador: Seleccione el controlador de Microsoft Access.

• Usar Cadena de Conexión: En Configuraciones Opcionales, seleccione esta casilla.

• Cadena de Conexión: En Configuraciones Opcionales, ingrese la cadena de conexión manual utilizando este formato:

  DRIVER=<driver>;DBQ=<database-path>;UID=<username>;PWD=<password>;
  

  Utilice una de estas cadenas de conexión, dependiendo de la versión y si tiene una contraseña. Reemplace la ruta de la carpeta y el nombre del archivo con los específicos del archivo ubicado en su agente privado.

  Controlador de Microsoft Access (\*.mdb) sin contraseña

  DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=C:\myfolder\mydatabase.accdb;
  

  Controlador de Microsoft Access (\*.mdb, \*.accdb) con contraseña

  DRIVER={Microsoft Access Driver(*.mdb, *accdb)};DBQ=C:\myfolder\mydatabase.accdb;UID=nombredeusuario;PWD=contraseña;
  

Configurar actividades de base de datos

Durante la configuración de la actividad de base de datos, tenga en cuenta que el controlador ODBC de Microsoft Access no admite la búsqueda de objetos. No ingrese criterios de búsqueda en el cuadro de búsqueda de selección de tabla, ya que no se devolverán resultados.

Ejemplos de cláusulas WHERE

Estos ejemplos de cláusulas WHERE se proporcionan como referencia al configurar una actividad de consulta de base de datos:

WHERE [LastName]='Bagel'

WHERE field1 LIKE field2

WHERE City = "Chicago" OR BirthDate < DateAdd (" yyyy ", -40, Date())

Para ejemplos adicionales, consulte la documentación de Microsoft:

• Access SQL: cláusula WHERE
• Ejemplos de criterios de consulta

Microsoft Excel

Debe estar utilizando un agente privado para poder conectarse a una hoja de cálculo de Microsoft Excel.

Instalar el controlador ODBC

Para conectarse a hojas de cálculo de Excel, es posible que necesite instalar un controlador si el controlador apropiado no está incluido en el sistema operativo del agente privado.

Por ejemplo, Windows 10 viene con controladores ODBC x32 .xls que admiten las versiones de Excel 3.0, 4.0, 5.0/95 y 97-2000. Sin embargo, para obtener los controladores ODBC más nuevos que admiten todas estas versiones y Excel 12.0 (Excel 2007), puede instalar uno de estos controladores:

• Microsoft Access 2016 Runtime (Win 7/8/10/2008 R2/2012)
• Microsoft Access 2016 Redistributable

Configurar la conexión a la base de datos

Después de instalar el controlador, especifique estas entradas durante la configuración de la conexión a la base de datos:

• Tipo de controlador: Seleccione ODBC.

• Controlador: Seleccione el controlador de Microsoft Excel.

• Usar cadena de conexión: En Configuraciones opcionales, seleccione esta casilla.

• Cadena de conexión: En Configuraciones opcionales, use una de estas cadenas de conexión, dependiendo de su versión de Excel. Reemplace la ruta de la carpeta y el nombre del archivo con los específicos del archivo ubicado en el agente privado.

  Excel 97, Excel 2000, Excel 2002, Excel 2003

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Ruta de Carpeta\Nombre de Mi Archivo.xls;
  

  Excel 2007, Excel 2010, Excel 2013

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Ruta de Carpeta\Nombre de Mi Archivo.xlsx;
  

  Para especificar que la conexión sea actualizable (por ejemplo, si desea permitir la escritura en un archivo de destino), puede agregar ReadOnly=0; al final de la cadena de conexión. Por ejemplo:

  Actualizable

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Ruta de Carpeta\Nombre de Mi Archivo.xlsx;ReadOnly=0;
  

  Consejo

  Vea opciones adicionales para cadenas de conexión de Excel en Cadenas de conexión del controlador ODBC de Microsoft Excel 2007 en La referencia de cadenas de conexión.

Configurar actividades de base de datos

Durante la configuración de la actividad de base de datos, puede seleccionar y unir hojas de trabajo dentro de la hoja de cálculo de Excel.

Microsoft SQL Server

Las bases de datos de Microsoft SQL Server son accesibles para agentes en la nube y privados. Se recomienda utilizar ODBC en agentes privados para un rendimiento optimizado. Si se desean utilizar características adicionales, como proporcionar una consulta manual, estas están disponibles únicamente utilizando el controlador JDBC. Harmony admite las siguientes opciones de autenticación:

Los procedimientos a continuación muestran cómo configurar Microsoft SQL Server como una conexión de base de datos utilizando autenticación de Windows o de SQL Server. También incluyen ejemplos de cláusulas WHERE que se pueden utilizar con actividades de base de datos.

Autenticación de Windows

La autenticación de Windows es compatible utilizando ODBC y JDBC solo en agentes privados. Se puede utilizar con solo una cuenta de dominio. Para usar la autenticación de Windows, configure estas propiedades en Windows:

1. Abra la herramienta Servicios Administrativos (Inicio > Herramientas Administrativas > Servicios).

2. Si utiliza ODBC, haga clic derecho en el servicio Jitterbit Apache Server y seleccione Propiedades. Si utiliza JDBC, haga clic derecho en el servicio Jitterbit Tomcat Server y seleccione Propiedades.

3. Ve a la pestaña Iniciar sesión. Selecciona Esta cuenta e ingresa el nombre y las credenciales de la cuenta que deseas usar para la autenticación. Luego haz clic en Aplicar.

4. Repite para el servicio Jitterbit Process Engine.

5. Establece TempDir en el archivo de configuración del agente (jitterbit.conf) a C:\Windows\Temp\jitterbit.

6. Reinicia los servicios de Jitterbit.

Una vez completados estos pasos, ve a Integration Studio y configura tu base de datos como de costumbre, especificando estas entradas durante la configuración de la Conexión a la base de datos:

• Tipo de controlador: Selecciona ODBC o JDBC según corresponda.

  Importante

  La autenticación de Windows es compatible con los siguientes controladores JDBC:

  • SQL Server jTDS [JDBC]
  • SQL Server Microsoft [JDBC]
  • Versiones más recientes del Controlador JDBC de Microsoft para SQL Server

  Para usar la autenticación de Windows con los controladores JDBC de Microsoft, copia el archivo mssql-jdbc_auth-x.x.x.x64.dll incluido en el paquete de descarga del controlador a la carpeta C:\Program Files\Jitterbit Agent\jre\bin en el agente. Haz una copia de seguridad del archivo, ya que puede ser eliminado durante las actualizaciones importantes del agente.

• Controlador: Selecciona el controlador de SQL Server.

• Nombre del servidor: Ingresa el nombre o la dirección IP del servidor que ejecuta el SQL Server al que Harmony necesita conectarse. Es posible que debas especificar el nombre de la instancia de SQL Server (HostName\InstanceName).

• Nombre de la base de datos: Ingresa el nombre de la base de datos en el servidor al que Harmony necesita conectarse.

• Inicio de sesión y Contraseña: Deja estos campos en blanco.

• Parámetros adicionales de la cadena de conexión: En Configuraciones opcionales, ingresa lo siguiente dependiendo de tu controlador:

  • ODBC SQL Server: Si estás utilizando el controlador ODBC SQL Server, ingresa integratedSecurity=true. Si esto no funciona, ingresa Trusted_Connection=yes.

  • ODBC Driver 11 para SQL Server, SQL Server Native Client 10.0, SQL Server Native Client 11.0: Si estás utilizando otro controlador ODBC SQL Server, ingresa Trusted_Connection=yes.

  • SQL Server jTDS [JDBC], SQL Server Microsoft [JDBC]: Si estás utilizando un controlador JDBC SQL Server, ingresa integratedSecurity=true.

El controlador ahora se autentificará como el usuario de dominio de Windows especificado anteriormente.

Autenticación de SQL Server

Ve a Integration Studio y configura tu base de datos como de costumbre. Especifica estas configuraciones durante la configuración de la conexión a la base de datos:

• Tipo de controlador: Selecciona ODBC o JDBC según corresponda.

• Controlador: Selecciona el controlador SQL Server. Al seleccionar un controlador JDBC, recomendamos usar SQL Server Microsoft.

• Nombre del servidor: Ingresa el nombre o la dirección IP del servidor que ejecuta SQL Server al que Harmony necesita conectarse. Es posible que debas especificar el nombre de la instancia de SQL Server (HostName\InstanceName).

• Nombre de la base de datos: Ingresa el nombre de la base de datos en el servidor al que Harmony necesita conectarse.

• Inicio de sesión y Contraseña: Ingresa el nombre de usuario y la contraseña para la autenticación de SQL Server.

El controlador ahora se autentificará utilizando las credenciales de autenticación de SQL Server según lo especificado.

Ejemplos de cláusula WHERE

Estos ejemplos de cláusula WHERE se proporcionan con fines de referencia al configurar una actividad de consulta de base de datos:

WHERE LastName = 'Smith' ;

WHERE LastName LIKE ('%Smi%');

WHERE EmployeeKey  <= 500;

WHERE EmployeeKey = 1 OR EmployeeKey = 8 OR EmployeeKey = 12;

WHERE EmployeeKey <= 500 AND LastName LIKE '%Smi%' AND FirstName LIKE '%A%';

WHERE LastName IN ('Smith', 'Godfrey', 'Johnson');

WHERE EmployeeKey Between 100 AND 200;

Para ejemplos adicionales, consulta la documentación de Microsoft:

• WHERE (Transact-SQL)
• Condición de Búsqueda (Transact-SQL)