Configurar uma fonte de banco de dados Microsoft SQL no Jitterbit Design Studio

Esta página descreve como configurar o Microsoft SQL Server como origem ou destino no Jitterbit Studio usando autenticação do Windows ou SQL Server. Consulte Database para informações sobre os tipos de autenticação suportados para vários sistemas.

Autenticação do Windows

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

1. Abra a ferramenta Serviços Administrativos (Iniciar > Ferramentas Administrativas > Serviços).
2. Se usar ODBC, clique com o botão direito no serviço Jitterbit Apache Server e selecione Propriedades. Se usar 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. Em seguida, 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 as etapas acima, acesse o Jitterbit Studio e configure sua origem ou destino normalmente. Na tela de definição da origem/destino do banco de dados, em Parâmetros de Conexão, especifique o seguinte:

• 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 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 um Microsoft JDBC Driver for SQL Server mais recente: Copie o arquivo mssql-jdbc_auth-x.x.x.x64.dll incluído no pacote de download do driver para 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 incluído no agente. Faça uma cópia de backup do arquivo, pois ele pode ser excluído durante atualizações principais do agente.

• Nome do Servidor: Insira o nome ou endereço IP do servidor que executa o SQL Server ao qual o Jitterbit 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 com o qual o Jitterbit precisa se integrar.
• Logon: Deixe este campo em branco.
• Senha: Deixe este campo em branco.

• Opções: Clique para expandir configurações adicionais. No campo Parâmetros de Cadeia de Conexão Adicionais, insira o seguinte dependendo do seu driver:

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

• ODBC Driver 11 for SQL Server [ODBC], SQL Server Native Client 10.0 [ODBC], SQL Server Native Client 11.0 [ODBC]: Se você estiver usando outro driver SQL Server, insira Trusted_Connection=yes.
• SQL Server jTDS [JDBC]: Insira integratedSecurity=true.
• SQL Server MS JDBC [JDBC]: Insira integratedSecurity=true;trustServerCertificate=true.

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

Autenticação do SQL Server

Acesse o Jitterbit Studio e configure sua origem ou destino normalmente. Na tela de definição de origem/destino, em Parâmetros de Conexão, especifique o seguinte:

• Driver: O driver SQL Server pode ser um driver ODBC ou JDBC.

  Nota

  Ao selecionar um driver JDBC, recomendamos usar "SQL Server MS JDBC [JDBC]", o driver JDBC da Microsoft para SQL Server, que é incluído nos agentes Jitterbit a partir da versão 9.3.

• Nome do Servidor: Insira o nome ou endereço IP do servidor que executa o SQL Server ao qual o Jitterbit precisa se conectar. Você pode ter que especificar o nome da instância do SQL Server (NomeDoHost\NomeDaInstância).

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

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

• Senha: Insira a senha para autenticação do SQL Server.

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

Criptografia de conexão e certificados de 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 falhará 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 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 mesmo 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 fornecido. A Microsoft mudou o valor padrão de encrypt de false para true na versão do driver 10.2 e documenta essa mudança como uma quebra de compatibilidade, descrita em encrypt em Definir as propriedades de conexão na documentação da Microsoft. Uma origem que funcionava em um agente anterior à versão 12.8 pode começar a falhar após a atualização.

Para resolver isso, expanda Opções e insira encrypt=false; no campo Parâmetros Adicionais de String de Conexão, ou inclua-o na string de conexão se selecionou Construir string de conexão manualmente. Isso 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.