Conectar ao Microsoft usando o conector de Banco de Dados no Jitterbit Studio
Esta página explica como conectar a esses serviços da Microsoft usando o conector de Banco de Dados:
Microsoft Access
É necessário executar 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 Microsoft Access.
Instalar o driver ODBC
O driver ODBC do Microsoft Access geralmente é instalado como parte do Windows. Os drivers mais antigos suportam a extensão de arquivo .mdb. No entanto, se o 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 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 Cadeia de Conexão: Em Configurações Opcionais, marque essa caixa de seleção.
-
Cadeia de Conexão: Em Configurações Opcionais, digite a cadeia de conexão manual usando este formato:
DRIVER=<driver>;DBQ=<database-path>;UID=<username>;PWD=<password>;Use uma dessas cadeias de conexão, dependendo da versão e se você tem uma senha. Substitua o caminho da pasta e o nome do arquivo por aqueles específicos do arquivo localizado no agente privado.
Microsoft Access Driver (\*.mdb) sem SenhaDRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=C:\myfolder\mydatabase.accdb;Microsoft Access Driver (\*.mdb, \*.accdb) com SenhaDRIVER={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 oferece suporte à busca de objetos. Não insira critérios de pesquisa na caixa de pesquisa de seleção de 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:
Microsoft Excel
É necessário usar um agente privado para se conectar a uma planilha do Microsoft Excel.
Instalar o driver ODBC
Para 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 .xls de 32 bits que suportam versões do Excel 3.0, 4.0, 5.0/95 e 97-2000. No entanto, para obter os drivers ODBC mais novos que suportam todas essas versões e Excel 12.0 (Excel 2007), é possível instalar um destes 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 instalar o driver, especifique estas entradas durante a configuração da conexão com 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 esta caixa de seleção.
-
String de Conexão: Em Configurações Opcionais, use uma destas strings de conexão, conforme 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 2003Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)}; DBQ=C:\Folder Path\My File Name.xls;Excel 2007, Excel 2010, Excel 2013Driver={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 desejar permitir a escrita em um arquivo de destino), você pode adicionar
ReadOnly=0;ao final da string de conexão. Por exemplo:AtualizávelDriver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)}; DBQ=C:\Folder Path\My File Name.xlsx;ReadOnly=0;Dica
Veja 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.
Nota
Ao executar a operação, se você receber um erro "[Microsoft][ODBC Excel Driver] Operation must use an updateable query", o arquivo do Excel pode estar somente leitura. Você pode permitir que seu arquivo do Excel seja atualizável adicionando ReadOnly=0; à sua string de conexão enquanto configura o endpoint conforme descrito acima.
Microsoft SQL Server
Os 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 desejar usar recursos adicionais, como fornecer uma consulta manual, estes estão disponíveis apenas com o driver JDBC. O Harmony oferece suporte a estas opções de autenticação:
| Tipo de driver | Sistema operacional | Métodos de autenticação | Tipo de agente | Requisitos adicionais |
|---|---|---|---|---|
| ODBC | Windows | Autenticação do Windows ou autenticação do SQL Server | Apenas privado | |
| JDBC | Windows | Autenticação do Windows | Apenas privado | |
| JDBC | Windows/Linux | Autenticação do SQL Server | Nuvem ou privado | |
| JDBC | Windows/Linux | Autenticação do Microsoft Entra | Nuvem ou privado | Agente 11.45 ou posterior |
| JDBC | Windows/Linux | Autenticação Kerberos | Apenas privado |
Nota
Para configurar a autenticação Kerberos, consulte Autenticação Kerberos do SQL Server.
Os procedimentos abaixo mostram como configurar o Microsoft SQL Server como uma conexão de banco de dados usando autenticação do Windows, SQL Server ou Microsoft Entra. 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. Pode ser usada com apenas uma conta de domínio. Para usar autenticação do Windows, configure estas propriedades no Windows:
-
Abra a ferramenta Serviços Administrativos (Iniciar > Ferramentas Administrativas > Serviços).
-
Se usar ODBC, clique com o botão direito do mouse no serviço Jitterbit Apache Server e selecione Propriedades. Se usar JDBC, clique com o botão direito do mouse no serviço Jitterbit Tomcat Server e selecione Propriedades.
-
Vá para a guia Fazer logon. Selecione Esta conta e digite o nome e as credenciais da conta que deseja usar para autenticação. Em seguida, clique em Aplicar.
-
Repita o procedimento para o serviço Jitterbit Process Engine.
-
Defina
TempDirno arquivo de configuração do agente (jitterbit.conf) comoC:\Windows\Temp\jitterbit.
Aviso
Certifique-se de que concedeu ao usuário do domínio o privilégio de Fazer logon como serviço e Agir como parte do sistema operacional. Certifique-se de que o usuário do domínio tem privilégios de leitura e gravação no diretório de instalação do agente privado.
Nota
Uma alternativa aos passos 1 a 4 acima é conceder à conta sendo usada na máquina do agente privado permissões para o SQL Server. O administrador do SQL Server pode fazer isso definindo a conta da máquina do agente privado no Active Directory do Windows (<domainName>\<machineName>$).
Após a conclusão dessas etapas, acesse o Studio e configure seu banco de dados normalmente, especificando essas 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 é suportada com os seguintes drivers JDBC:
- SQL Server jTDS [JDBC]
- SQL Server MS JDBC [JDBC]
- Versões mais recentes do Microsoft JDBC Driver for SQL Server
Para usar autenticação do Windows com um driver JDBC, copie um arquivo DLL para o agente, dependendo de qual driver você selecionar:
-
SQL Server jTDS: Copie o arquivo
ntlmauth.dllda pastax64/SSOdo pacote de download do projeto jTDS para a pastaC:\Program Files\Jitterbit Agent\jre\binno agente. -
SQL Server MS JDBC ou uma versão mais recente do Microsoft JDBC Driver for SQL Server: Copie o arquivo
mssql-jdbc_auth-x.x.x.x64.dllfornecido com o pacote de download do driver para as pastasC:\Program Files\Jitterbit Agent\jre\bineC:\Program Files\Jitterbit Agent\jre\libno agente. A versão da DLL deve corresponder à versão do arquivo JDBC JAR fornecido com o agente. Faça uma cópia de backup do arquivo, pois ele pode ser excluído durante atualizações principais do agente.
-
Driver: Selecione o driver do 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. Talvez seja necessário especificar o nome da instância do SQL Server (
HostName\InstanceName). -
Nome do Banco de Dados: Digite 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 de Cadeia de Conexão Adicional: Em Configurações opcionais, digite o seguinte dependendo do seu driver:
-
ODBC SQL Server: Se está usando o driver ODBC SQL Server, digite
integratedSecurity=true. Se isso não funcionar, digiteTrusted_Connection=yes. -
ODBC Driver 11 for SQL Server, SQL Server Native Client 10.0, SQL Server Native Client 11.0: Se está usando outro driver ODBC SQL Server, digite
Trusted_Connection=yes.
-
-
SQL Server jTDS [JDBC]: Digite
integratedSecurity=true.- SQL Server MS JDBC [JDBC]: Digite
integratedSecurity=true;trustServerCertificate=true.
- SQL Server MS JDBC [JDBC]: Digite
O driver agora 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 normalmente. Especifique estas configurações durante a configuração da conexão de 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 o SQL Server MS JDBC, o driver JDBC da Microsoft para SQL Server.
-
Nome do servidor: Digite o nome ou o 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.
Autenticação do Microsoft Entra
A autenticação do Microsoft Entra (anteriormente Azure Active Directory) é suportada usando JDBC em agentes na nuvem e privados. Configure seu banco de dados normalmente, usando o driver SQL Server MS JDBC, e especifique estas configurações na conexão de banco de dados:
-
Login e Senha: Digite o nome de usuário e a senha da conta do Microsoft Entra.
-
Parâmetros de cadeia de conexão adicionais: Em Configurações opcionais, digite
authentication=ActiveDirectoryPassword.
Se o banco de dados está protegido por um firewall, como o firewall do Azure SQL Database, permita que o agente se conecte. Para um grupo de agentes na nuvem, adicione os endereços IP do agente na nuvem do Jitterbit para sua região. Para um agente privado, permita o endereço IP do qual o agente se conecta. Caso contrário, a conexão falha com um erro informando que o endereço IP do cliente não tem permissão para acessar o servidor.
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 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.
Isso afeta qualquer SQL Server cujo certificado não pode 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 ativada e um certificado válido instalado e ainda assim falhar nesta 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 incluído. A Microsoft alterou o valor padrão de encrypt de false para true na versão 10.2 do driver e documenta essa mudança como uma que causa 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, insira 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 na string de conexão manual. Isso funciona em agentes na nuvem e privados.
Cuidado
Com encrypt=false, os dados trafegam entre o agente e o banco de dados sem criptografia. Use essa opção apenas onde seja aceitável para os dados e o caminho de rede envolvido.
A 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: