Conectar ao Microsoft usando o conector de Banco de Dados no Jitterbit Studio

Esta página explica como se conectar a esses serviços da Microsoft usando o conector de Banco de Dados:

• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server

Microsoft Access

É necessário estar executando um agente privado para se conectar ao Microsoft Access. O Microsoft Office deve estar instalado no mesmo sistema em que o agente privado está sendo executado, e esse sistema deve ser um sistema operacional Windows. Observe que a equipe do Jitterbit não testou drivers ODBC do Linux para o Microsoft Access.

Instalar o driver ODBC

O driver ODBC do Microsoft Access é normalmente instalado como parte do Windows. Drivers mais antigos suportam a extensão de arquivo .mdb. No entanto, se seu banco de dados for Access 2007 ou posterior com a extensão .accdb, pode ser necessário obter uma versão mais recente do driver ODBC, como o Microsoft Access 2016 Redistributable.

Configurar a conexão do Banco de Dados

Após a instalação do driver, especifique estas entradas durante a configuração da conexão do Banco de Dados:

• Tipo de Driver: Selecione ODBC.

• Driver: Selecione o driver do Microsoft Access.

• Usar String de Conexão: Em Configurações Opcionais, marque esta caixa de seleção.

• String de Conexão: Em Configurações Opcionais, insira a string de conexão manual usando este formato:

  DRIVER=<driver>;DBQ=<caminho-do-banco>;UID=<nome-de-usuário>;PWD=<senha>;
  

  Use uma dessas strings de conexão, dependendo da versão e se você tem uma senha. Substitua o caminho da pasta e o nome do arquivo pelos específicos do arquivo localizado em seu agente privado.

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

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

Configurar atividades de banco de dados

Durante a configuração da atividade de banco de dados, observe que o driver ODBC do Microsoft Access não suporta a busca por objetos. Não insira critérios de pesquisa na caixa de seleção da tabela, pois nenhum resultado será retornado.

Exemplos de cláusula WHERE

Estes exemplos de cláusula WHERE são fornecidos para fins de referência ao configurar uma atividade de consulta de banco de dados:

WHERE [LastName]='Bagel'

WHERE field1 LIKE field2

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

Para exemplos adicionais, consulte a documentação da Microsoft:

• Access SQL: cláusula WHERE
• Exemplos de critérios de consulta

Microsoft Excel

É necessário usar um agente privado para se conectar a uma planilha do Microsoft Excel.

Instalar o driver ODBC

Para se conectar a planilhas do Excel, pode ser necessário instalar um driver se o driver apropriado não estiver incluído no sistema operacional do agente privado.

Por exemplo, o Windows 10 vem com drivers ODBC x32 .xls que suportam as versões do Excel 3.0, 4.0, 5.0/95 e 97-2000. No entanto, para obter os drivers ODBC mais recentes que suportam todas essas versões e o Excel 12.0 (Excel 2007), você pode instalar um desses drivers:

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

Configurar a conexão com o banco de dados

Após a instalação do driver, especifique estas entradas durante a configuração da conexão com o banco de dados:

• Tipo de Driver: Selecione ODBC.

• Driver: Selecione o driver do Microsoft Excel.

• Usar String de Conexão: Em Configurações Opcionais, selecione esta caixa de seleção.

• String de Conexão: Em Configurações Opcionais, use uma das seguintes strings de conexão, dependendo da sua versão do Excel. Substitua o caminho da pasta e o nome do arquivo pelos específicos do arquivo localizado no agente privado.

  Excel 97, Excel 2000, Excel 2002, Excel 2003

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Caminho da Pasta\Meu Nome de Arquivo.xls;
  

  Excel 2007, Excel 2010, Excel 2013

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Caminho da Pasta\Meu Nome de Arquivo.xlsx;
  

  Para especificar que a conexão deve ser atualizável (por exemplo, se você quiser permitir a gravação em um arquivo de destino), você pode adicionar ReadOnly=0; ao final da string de conexão. Por exemplo:

  Atualizável

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Caminho da Pasta\Meu Nome de Arquivo.xlsx;ReadOnly=0;
  

  Dica

  Veja opções adicionais para strings de conexão do Excel em Strings de conexão do driver ODBC do Microsoft Excel 2007 no Referência de Strings de Conexão.

Configurar atividades de banco de dados

Durante a configuração da atividade de banco de dados, você pode selecionar e juntar planilhas dentro da planilha do Excel.

Microsoft SQL Server

Bancos de dados do Microsoft SQL Server são acessíveis para agentes em nuvem e privados. O ODBC do Windows em agentes privados é recomendado para desempenho otimizado. Se você deseja usar recursos adicionais, como fornecer uma consulta manual, esses estão disponíveis apenas usando o driver JDBC. O Harmony suporta as seguintes opções de autenticação:

Os procedimentos abaixo mostram como configurar o Microsoft SQL Server como uma Conexão de banco de dados usando autenticação do Windows ou do SQL Server. Eles também incluem exemplos de cláusulas WHERE que você pode usar com atividades de banco de dados.

Autenticação do Windows

A autenticação do Windows é suportada usando ODBC e JDBC apenas em agentes privados. Ela pode ser usada com apenas uma conta de domínio. Para usar a autenticação do Windows, configure estas propriedades no Windows:

1. Abra a ferramenta Serviços Administrativos (Iniciar > Ferramentas Administrativas > Serviços).

2. Se estiver usando ODBC, clique com o botão direito no serviço Jitterbit Apache Server e selecione Propriedades. Se estiver usando JDBC, clique com o botão direito no serviço Jitterbit Tomcat Server e selecione Propriedades.

3. Vá para a aba Log On. Selecione Esta conta e insira o nome e as credenciais da conta que deseja usar para autenticação. Em seguida, clique em Aplicar.

4. Repita para o serviço Jitterbit Process Engine.

5. Defina TempDir no arquivo de configuração do agente (jitterbit.conf) como C:\Windows\Temp\jitterbit.

6. Reinicie os serviços Jitterbit.

Após a conclusão desses passos, vá para o Studio e configure seu banco de dados como de costume, especificando essas entradas durante a configuração da Conexão com o banco de dados:

• Tipo de Driver: Selecione ODBC ou JDBC, conforme apropriado.

  Importante

  A autenticação do Windows é suportada com os seguintes drivers JDBC:

  • SQL Server jTDS [JDBC]
  • SQL Server Microsoft [JDBC]
  • Versões mais recentes do Driver JDBC da Microsoft para SQL Server

Para usar a autenticação do Windows com os drivers JDBC da Microsoft, copie o arquivo mssql-jdbc_auth-x.x.x.x64.dll incluído no pacote de download do driver para a pasta C:\Program Files\Jitterbit Agent\jre\bin no agente. Faça uma cópia de backup do arquivo, pois ele pode ser excluído durante grandes atualizações do agente.

• Driver: Selecione o driver do SQL Server.

• Nome do Servidor: Insira o nome ou endereço IP do servidor que está executando o SQL Server ao qual o Harmony precisa se conectar. Pode ser necessário especificar o nome da instância do SQL Server (HostName\InstanceName).

• Nome do Banco de Dados: Insira o nome do banco de dados no servidor ao qual o Harmony precisa se conectar.

• Login e Senha: Deixe esses campos em branco.

• Parâmetros Adicionais da String de Conexão: Em Configurações Opcionais, insira o seguinte dependendo do seu driver:

  • ODBC SQL Server: Se você estiver usando o driver ODBC SQL Server, insira integratedSecurity=true. Se isso não funcionar, insira Trusted_Connection=yes.

  • ODBC Driver 11 para SQL Server, SQL Server Native Client 10.0, SQL Server Native Client 11.0: Se você estiver usando outro driver ODBC SQL Server, insira Trusted_Connection=yes.

  • SQL Server jTDS [JDBC], SQL Server Microsoft [JDBC]: Se você estiver usando um driver JDBC SQL Server, insira integratedSecurity=true.

O driver agora irá autenticar como o usuário de domínio do Windows especificado acima.

Autenticação do SQL Server

Vá para o Studio e configure seu banco de dados como de costume. Especifique essas configurações durante a configuração da Conexão com o Banco de Dados:

• Tipo de Driver: Selecione ODBC ou JDBC, conforme apropriado.

• Driver: Selecione o driver do SQL Server. Ao selecionar um driver JDBC, recomendamos usar SQL Server Microsoft.

• Nome do Servidor: Insira o nome ou endereço IP do servidor que está executando o SQL Server ao qual o Harmony precisa se conectar. Pode ser necessário especificar o nome da instância do SQL Server (HostName\InstanceName).

• Nome do Banco de Dados: Insira o nome do banco de dados no servidor ao qual o Harmony precisa se conectar.

• Login e Senha: Insira o nome de usuário e a senha para autenticação do SQL Server.

O driver agora irá autenticar usando as credenciais de autenticação do SQL Server conforme especificado.

Exemplos de cláusula WHERE

Estes exemplos de cláusula WHERE são fornecidos para fins de referência ao configurar uma atividade de consulta de banco de dados:

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 exemplos adicionais, consulte a documentação da Microsoft:

• WHERE (Transact-SQL)
• Condição de Busca (Transact-SQL)