Conectar-se à Microsoft usando o conector de Banco de Dados no Jitterbit Studio

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

• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server

Microsoft Access

É necessário executar um agente privado para conectar-se ao Microsoft Access. O Microsoft Office deve estar instalado no mesmo sistema no qual o agente privado está em execução e esse sistema deve ser um sistema operacional Windows. Observe que a equipe do Jitterbit não testou drivers ODBC do Linux para 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. Porém, se seu banco de dados for Access 2007 ou posterior com extensão .accdb, talvez seja necessário obter uma versão mais recente do driver ODBC, como o Microsoft Access 2016 Redistributable.

Configurar a conexão de Banco de Dados

Após instalar o driver, especifique essas entradas durante a configuração da conexão de Banco de Dados:

• Tipo de Driver: Selecione ODBC.

• Driver: Selecione o driver Microsoft Access.

• Usar String de Conexão: Em Configurações Opcionais, marque essa 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=<database-path>;UID=<username>;PWD=<password>;
  

  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.

  Microsoft Access Driver (\*.mdb) sem Senha

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

  Microsoft Access Driver (\*.mdb, \*.accdb) com Senha

  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 de atividade de Banco de Dados, observe que o driver ODBC do Microsoft Access não oferece suporte para buscar objetos. Não insira critérios de busca na caixa de pesquisa de seleção de tabela, pois nenhum resultado será retornado.

Exemplos de cláusula WHERE

Esses exemplos de cláusula WHERE são fornecidos como 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 conectar-se a uma planilha Microsoft Excel.

Instalar o driver ODBC

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

Por exemplo, o Windows 10 é fornecido com drivers ODBC x32 .xls que oferecem suporte às versões do Excel 3.0, 4.0, 5.0/95 e 97-2000. Porém, para obter os drivers ODBC mais recentes que oferecem suporte a todas essas versões e 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 do banco de dados

Após instalar o driver, especifique essas entradas durante a configuração da Conexão do banco de dados:

• Tipo de driver: Selecione ODBC.

• Driver: Selecione o driver do Microsoft Excel.

• Usar string de conexão: Em Configurações opcionais, marque essa caixa de seleção.

• String de conexão: Em Configurações opcionais, use uma dessas strings de conexão, dependendo da versão do Excel. Substitua o caminho da pasta e o nome do arquivo por aqueles 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:\Folder Path\My File Name.xls;
  

  Excel 2007, Excel 2010, Excel 2013

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Folder Path\My File Name.xlsx;
  

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

  Atualizável

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Folder Path\My File Name.xlsx;ReadOnly=0;
  

  Dica

  Consulte opções adicionais para strings de conexão do Excel em Microsoft Excel 2007 ODBC Driver connection strings na The Connection Strings Reference.

Configurar atividades de banco de dados

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

Microsoft SQL Server

Os bancos de dados Microsoft SQL Server estão acessíveis para agentes em nuvem e privados. Windows ODBC em agentes privados é recomendado para desempenho otimizado. Se você quiser usar recursos adicionais, como fornecer uma consulta manual, esses estão disponíveis apenas usando o driver JDBC. O Harmony oferece suporte a essas 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 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 é compatível apenas com ODBC e JDBC 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. Acesse a guia Fazer Logon. Selecione Esta conta e insira o nome e as credenciais da conta que você deseja usar para autenticação. Depois clique em Aplicar.

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

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

6. Reinicie os serviços do Jitterbit.

Após concluir essas etapas, acesse o Studio e configure seu banco de dados normalmente, especificando estas entradas durante a configuração da Conexão de banco de dados:

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

  Importante

  A autenticação do Windows é compatível com os seguintes drivers JDBC:

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

  Para usar a autenticação do Windows com um driver JDBC, copie um arquivo DLL para o agente, dependendo do driver selecionado:

  • SQL Server jTDS: Copie o arquivo ntlmauth.dll da pasta x64/SSO do pacote de download do projeto jTDS para a pasta C:\Program Files\Jitterbit Agent\jre\bin no agente.

  • SQL Server MS JDBC ou uma versão mais recente do Microsoft JDBC Driver para SQL Server: Copie o arquivo mssql-jdbc_auth-x.x.x.x64.dll agrupado com o pacote de download do driver para ambas as pastas C:\Program Files\Jitterbit Agent\jre\bin e C:\Program Files\Jitterbit Agent\jre\lib no agente. A versão da DLL deve corresponder à versão do arquivo JAR do JDBC agrupado com o agente. Faça uma cópia de backup do arquivo, pois ele pode ser deletado durante atualizações principais do agente.

• Driver: Selecione o driver SQL Server.

• Nome do Servidor: Insira o nome ou endereço IP do servidor que executa o SQL Server ao qual o Harmony precisa se conectar. Talvez seja 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.

• Logon 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]: Digite integratedSecurity=true.

• SQL Server MS JDBC [JDBC]: Digite integratedSecurity=true;trustServerCertificate=true.

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

Autenticação do SQL Server

Acesse o Studio e configure seu banco de dados normalmente. Especifique estas configurações durante a configuração da Conexão com 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 MS JDBC, o driver JDBC da Microsoft para SQL Server.

• Nome do Servidor: Digite o nome ou endereço IP do servidor que executa o SQL Server ao qual o Harmony precisa se conectar. Pode ser necessário especificar o nome da instância do SQL Server (NomeDoHost\NomeDaInstância).

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

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

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

Criptografia de conexão e certificados do servidor

As versões atuais do driver SQL Server MS JDBC solicitam uma conexão criptografada por padrão (encrypt=true) e validam o certificado que o servidor de banco de dados apresenta. Se o driver não conseguir validar o certificado do servidor em relação ao keystore do Java do agente, a conexão falha com um erro semelhante a este:

"encrypt" property is set to "true" and "trustServerCertificate" property is set to "false" but the driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption: Error: (certificate_unknown) PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.

Isto afeta qualquer SQL Server cujo certificado não possa ser rastreado até uma autoridade de certificação (CA) que o agente já confia, incluindo um certificado autoassinado ou emitido internamente. Amazon RDS para SQL Server é um exemplo: uma instância do RDS apresenta um certificado emitido por uma CA do Amazon RDS que não está no keystore padrão do agente. Um banco de dados pode ter criptografia habilitada e um certificado válido instalado e ainda assim falhar nessa validação, porque a falha é uma questão de confiança e não de criptografia.

A versão 12.8 do agente atualizou o driver JDBC do Microsoft SQL Server agrupado. A Microsoft alterou o valor padrão de encrypt de false para true na versão 10.2 do driver e documenta essa alteração como uma quebra de compatibilidade, descrita em encrypt em Definir as propriedades de conexão na documentação da Microsoft. Uma conexão que funcionava em um agente anterior à versão 12.8 pode começar a falhar após a atualização.

Para resolver isso, digite encrypt=false; no campo Parâmetros Adicionais da String de Conexão em Configurações Opcionais da Conexão com banco de dados, ou inclua-o em uma string de conexão manual. Isto funciona em agentes na nuvem e privados.

Sua configuração do SQL Server pode exigir outras propriedades de conexão também. Para as propriedades que o driver suporta, consulte Definir as propriedades de conexão na documentação da Microsoft.

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)
• Search Condition (Transact-SQL)