Informações Específicas do Banco de Dados¶

Introdução¶

Esta página fornece informações sobre a instalação e configuração de determinados drivers de banco de dados. Observe que esta página não é abrangente; O Jitterbit Harmony suporta a maioria dos bancos de dados compatíveis com ODBC e JDBC.

Os drivers de banco de dados são detectados automaticamente no Harmony Agente. Para Agentes em Nuvem, gerenciados pelo Jitterbit, um conjunto de drivers JDBC comumente usados já está fornecido. Para Agentes Privados, os drivers instalados são detectados a partir do sistema operacional onde cada Agente Privado está instalado. Além disso, você pode instalar outros drivers de banco de dados em Agentes Privados conforme necessário. Para obter informações gerais e instruções sobre como instalar drivers adicionais em Agentes Privados, consulte Instalar drivers ODBC ou JDBC adicionais.

IBM DB2 (AS400)¶

Você pode se conectar ao DB2 no iSeries usando um driver JDBC ou ODBC. Observe que, se você quiser usar recursos adicionais, como fornecer uma consultar manual, eles estão disponíveis usando apenas o driver JDBC. Estas instruções são para instalar o driver JTOpen (AS400) JDBC.

Instale o Driver JDBC¶

1. Baixe JTOpen. O arquivo ZIP inclui o arquivo do driver JDBC jt400.jar.

2. Instale o driver em um Agente Privado descompactando o download e copiando o jt400.jar arquivo para <JITTERBIT_HOME>/tomcat/drivers/lib/, substituindo <JITTERBIT_HOME> com o caminho para o diretório raiz do Agente Privado.

3. Edite o arquivo <JITTERBIT_HOME>/JdbcDrivers.conf e adicione esta entrada de driver:

   <Driver>
   <Name>IBM DB2</Name>
   <Class>com.ibm.as400.access.AS400JDBCDriver</Class>
   <Subprotocol>as400</Subprotocol>
   </Driver>
   

4. Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

   Na máquina onde cada Agente Privado está instalado, primeiro pare os serviços e depois reinicie-os. Consulte Reiniciar um Agente Privado do Windows ou Reiniciar um Agente Privado do Linux Para maiores informações.

Configurar a Conexão do Banco de Dados¶

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

• Tipo de Driver: Selecione JDBC.

• Driver: Selecione o driver IBM DB2 (AS400).

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

• Connection String: Em Option Settings, insira uma string de conexão manual, substituindo este exemplo por seu próprio hospedar, bibliotecas e nome do banco de dados (se aplicável):

  Sample Connection String

  jdbc:as400://example.com;libraries=LIB1;Database=S12345;socket timeout=30000
  

Exemplos de Cláusulas WHERE¶

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

  WHERE WORKDEPT = 'D21' AND HIREDATE > '1987-12-31'

  WHERE WORKDEPT = 'C01' OR WORKDEPT = 'D11'

  WHERE WORKDEPT = 'E11' AND NOT JOB = 'ANALYST'

  WHERE EDLEVEL > 12 AND
     (WORKDEPT = 'E11' OR WORKDEPT = 'E21')

  WHERE WORKDEPT = 'E11' AND EDLEVEL = 12 AND JOB = 'CLERK'

  WHERE (WORKDEPT, EDLEVEL, JOB) = ('E11', 12, 'CLERK')

Para obter exemplos adicionais, consulte os artigos do IBM Knowledge Center para a versão específica:

• Especificando uma condição de pesquisa usando a cláusula WHERE
• Múltiplas condições de pesquisa dentro de uma cláusula WHERE
• Definindo condições de pesquisa complexas

IBM DB2 (JCC)¶

Você pode se conectar ao DB2 no iSeries usando um driver JDBC ou ODBC. Observe que, se você quiser usar recursos adicionais, como fornecer uma consultar manual, eles estão disponíveis usando apenas o driver JDBC. Estas instruções destinam-se à instalação do driver JCC JDBC.

Instale o Driver JDBC¶

1. Faça o download do JCC da IBM Versões e downloads do driver JDBC do DB2. O arquivo TAR.GZ inclui um arquivo ZIP com o arquivo do driver JDBC db2jcc4.jar.

   Nota

   O arquivo do driver db2jcc.jar usa a especificação JDBC 3 e está obsoleto. Use o arquivo do driver db2jcc4.jar, que usa a especificação JDBC 4 em vez disso.

2. Instale o driver em um Agente Privado extraindo o download e copiando o arquivo db2jcc4.jar para <JITTERBIT_HOME>/tomcat/drivers/lib/, substituindo <JITTERBIT_HOME> com o caminho para o diretório raiz do Agente Privado.

3. Edite o arquivo <JITTERBIT_HOME>/JdbcDrivers.conf e adicione esta entrada de driver:

   <Driver>
   <Name>IBM DB2 JCC Driver</Name>
   <Class>com.ibm.db2.jcc.DB2Driver</Class>
   <Subprotocol>db2</Subprotocol>
   </Driver>
   

4. Localize e copie seu arquivo de licença fornecido pela IBM db2jcc_license_cisuz-XX.jar para <JITTERBIT_HOME>/tomcat/shared/lib/.

5. Edite o arquivo <JITTERBIT_HOME>/tomcat/conf/catalina.properties e adicione esta entrada se não estiver presente:

   shared.loader=${catalina.home}/shared/lib/*.jar
   

6. Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

   Na máquina onde cada Agente Privado está instalado, primeiro pare os serviços e depois reinicie-os. Consulte Reiniciar um Agente Privado do Windows ou Reiniciar um Agente Privado do Linux Para maiores informações.

Configurar a Conexão do Banco de Dados¶

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

• Tipo de Driver: Selecione JDBC.

• Driver: Selecione o driver IBM DB2 (JCC).

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

• Connection String: Em Option Settings, insira uma string de conexão manual, substituindo este exemplo pelo seu próprio nome de hospedar e banco de dados (se aplicável):

  Sample Connection String

  jdbc:db2://example.com/DBNAME
  

Exemplos de Cláusulas WHERE¶

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

  WHERE WORKDEPT = 'D21' AND HIREDATE > '1987-12-31'

  WHERE WORKDEPT = 'C01' OR WORKDEPT = 'D11'

  WHERE WORKDEPT = 'E11' AND NOT JOB = 'ANALYST'

  WHERE EDLEVEL > 12 AND
     (WORKDEPT = 'E11' OR WORKDEPT = 'E21')

  WHERE WORKDEPT = 'E11' AND EDLEVEL = 12 AND JOB = 'CLERK'

  WHERE (WORKDEPT, EDLEVEL, JOB) = ('E11', 12, 'CLERK')

Para obter exemplos adicionais, consulte os artigos do IBM Knowledge Center para a versão específica:

• Especificando uma condição de pesquisa usando a cláusula WHERE
• Múltiplas condições de pesquisa dentro de uma cláusula WHERE
• Definindo condições de pesquisa complexas

Microsoft Access¶

Você deve estar executando um Agente Privado para se conectar ao Microsoft Access. O Microsoft Office deve ser 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 Linux ODBC para Microsoft Access.

Instale o Driver ODBC¶

O driver ODBC do Microsoft Access normalmente é instalado como parte do Windows. Drivers mais antigos suportam o .mdb extensão de arquivo. No entanto, se seu banco de dados for Access 2007 ou posterior com o .accdb extensão, pode ser necessário obter uma versão mais recente do driver ODBC, como o Microsoft Access 2010 Redistributable (Win XP/Vista/7/8/2003 R2/2008/2012).

Configurar a Conexão do Banco de Dados¶

Após a instalação do 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 Access.

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

• Connection String: Em Option Settings, 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ê possui 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) without Password

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

  Microsoft Access Driver (\*.mdb, \*.accdb) with Password

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

Configurar Atividades do Banco de Dados¶

Durante a configuração da atividade do banco de dados, observe que o driver ODBC do Microsoft Access não oferece suporte à pesquisa 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áusulas WHERE¶

Esses exemplos de cláusula WHERE são fornecidos para fins de referência ao configurar uma atividade de consulta ao 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:

• Acessar SQL: cláusula WHERE
• Exemplos de critérios de consultar

Microsoft Excel¶

Você deve estar usando um Agente Privado para se conectar a uma planilha do Excel.

Instale o Driver ODBC¶

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

Por exemplo, o Windows 10 vem com x32 .xls Drivers ODBC que oferecem suporte às versões 3.0, 4.0, 5.0/95 e 97-2000 do Excel. 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 destes drivers:

• tempo de execução do Microsoft Access 2016 (Win 7/8/10/2008 R2/2012)
• Microsoft Access 2010 Redistribuível (Win XP/Vista/7/8/2003 R2/2008/2012)

Configurar a Conexão do Banco de Dados¶

Após a instalação do 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.

• Use Connection String: Em Optional Settings, marque esta caixa de seleção.

• Cadeia de conexão: Em Configurações opcionais, use uma dessas cadeias 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:\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 a conexão a ser atualizável (por exemplo, se você deseja permitir a gravação em um arquivo de destino), você pode adicionar ReadOnly=0; ao final da string de conexão. Por exemplo:

  Updateable

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

  Dica

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

Configurar Atividades do Banco de Dados¶

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

Microsoft SQL Server¶

Os bancos de dados do Microsoft SQL Server são acessíveis a partir de Harmony Agents em execução no Windows ou Linux, com Windows ODBC em Agentes Privados recomendado para desempenho otimizado. No entanto, observe que, se você quiser usar recursos adicionais, como fornecer uma consultar manual, eles estão disponíveis usando apenas o driver JDBC. Jitterbit Harmony suporta estas opções de autenticação:

• MS SQL ODBC no Windows usando autenticação do Windows ou autenticação do SQL Server
• MS SQL JDBC no Windows usando autenticação do Windows ou autenticação do SQL Server
• MS SQL JDBC no Linux usando autenticação 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 ou SQL Server, seguidos de exemplos de cláusulas WHERE que podem ser usadas com atividades de banco de dados.

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 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 do mouse no serviço Jitterbit Apache Server e selecione Propriedades. Se estiver usando JDBC, clique com o botão direito do mouse no serviço Jitterbit Tomcat Server e selecione Propriedades.
3. Vá para a aba Logon. 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.

Depois que essas etapas forem concluídas, vá para o Cloud Studio e configure seu banco de dados como de costume, especificando essas entradas durante a configuração da Conexão do 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 Microsoft [JDBC]
  • Versões mais recentes do Microsoft JDBC Driver for SQL Server

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

• Driver: Selecione o driver do SQL Server.

• Nome do servidor: Insira o nome ou endereço IP do servidor 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: Digite o nome do banco de dados no servidor ao qual o Harmony precisa se conectar.
• Login e Senha: Deixe estes campos em branco.

• Parâmetros de string de conexão adicionais: Em Configurações opcionais, digite o seguinte, dependendo do seu driver:

  • ODBC SQL Server: Se você estiver usando o driver ODBC SQL Server digite integratedSecurity=true. Se isso não funcionar, digite 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 de servidor ODBC SQL, digite Trusted_Connection=yes.
  • SQL Server jTDS [JDBC], SQL Server Microsoft [JDBC]: Se você estiver usando um driver JDBC SQL Server digite integratedSecurity=true.

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

Autenticação do SQL Server¶

Vá para o Cloud Studio e configure seu banco de dados como de costume, especificando essas entradas durante a configuração da Conexão do 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 o uso do SQL Server MS JDBC.

• Nome do servidor: Insira o nome ou endereço IP do servidor 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: 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 será autenticado usando as credenciais de autenticação do SQL Server conforme especificado.

Exemplos de Cláusulas WHERE¶

Esses exemplos de cláusula WHERE são fornecidos para fins de referência ao configurar uma atividade de consulta ao 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:

• ONDE (Transact-SQL)
• Condição de Pesquisa (Transact-SQL)

MySQL¶

Recomendamos usar o driver MySQL JDBC para MySQL que vem com o Harmony Agente. O uso do driver JDBC é recomendado para recursos adicionais, como a capacidade de fornecer uma consultar manual, que não estão disponíveis por meio de uma conexão ODBC.

Se você quiser usar um driver ODBC (somente Agentes Privados ), um pode ser baixado em MySQL Community Downloads, Connector/ODBC.

ODBC e JDBC¶

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

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

• Driver: Selecione o driver MySQL. O driver é normalmente chamado de "MySQL" para JDBC ou "MySQL ODBC 3.51 Driver" para ODBC.

• Nome do servidor: Digite o nome ou endereço IP do servidor de banco de dados.

• Nome do banco de dados: Digite o nome do catálogo que o Jitterbit Harmony precisa acessar.

• Login e Senha: Insira as credenciais de usuário para o Jitterbit Harmony usar para acessar o banco de dados.

Se você ainda não conseguir ver o driver depois de vê-lo no gerenciador ODBC, verifique novamente se está se conectando à máquina correta. Para fazer isso, pare o serviço Jitterbit Apache nessa máquina e certifique-se de que você não pode mais se conectar usando o cliente.

Erros de Permissão¶

Se você receber erros de permissão, como "Access denied for user 'root'@'%' to database 'test'" e você tem certeza de que as credenciais estão corretas, pode ser um problema de configuração do MySQL. Você pode configurar o MySQL para aceitar diferentes credenciais para diferentes endereços IP ou um grupo de endereços. Consulte a documentação do MySQL ou entre em contato com o administrador do MySQL.

Portas¶

A porta necessária para permitir que o Harmony Agente se comunique com um banco de dados MySQL remoto depende da porta que o MySQL foi configurado para atender. Abra essa porta (padrão 3306) na máquina em que o servidor de banco de dados MySQL está sendo executado.

Proteger ou criptografar a conexão¶

A segurança da conexão entre um banco de dados e um Agente Privado depende do driver ODBC que está sendo usado. O driver MySQL ODBC padrão não usa criptografia. A melhor maneira de ativar essa criptografia é encapsular a conexão por meio do SSH. Isso pode ser feito apenas em Agentes Privados.

Exemplos de Cláusulas WHERE¶

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

WHERE
    jobtitle = 'Sales Rep' AND
    officeCode = 1;

WHERE
    jobtitle <> 'Sales Rep';

WHERE
    officecode > 5;

WHERE
    officecode <= 4;

WHERE t1.primary_key=1 AND t2.primary_key=t1.id;

WHERE key_part1=constant;

WHERE key_part1=val1 AND key_part2=val2;

Para exemplos adicionais, consulte Tutorial básico do MySQL e ao artigo do MySQL Reference Manual WHERE Clause Optimization.

Oracle¶

Você pode se conectar a um banco de dados Oracle usando um driver JDBC ou ODBC. O driver JDBC é recomendado para recursos adicionais, como a capacidade de fornecer uma consultar manual, que não estão disponíveis por meio de uma conexão ODBC. Esta seção descreve como configurar um banco de dados Oracle no Cloud Studio usando um driver ODBC em Agentes Privados.

Instale o Oracle Client no Harmony Agente Privado¶

Antes de estabelecer uma conexão com o Oracle por meio do ODBC, você deve ter o Oracle Client (incluindo o driver Oracle ODBC) instalado no Harmony Agente Privado. Se você estiver usando vários Agentes Privados em um Grupo de Agentes, o Oracle Client deverá ser instalado em todos os agentes do grupo. Consulte Agentes > Grupos de Agente para detalhes.

Configurar e Testar o Oracle Client¶

Depois de instalar o Oracle Client, configure o tnsnames.ora arquivo para fazer referência ao banco de dados que você está planejando usar. Isso faz parte do procedimento padrão de configuração do Oracle Client. Para obter informações adicionais, consulte Tnsnames.org - Oracle perguntas frequentes ou consulte a documentação do Oracle para a versão que você está usando.

Depois que o Oracle Client estiver configurado no Agente Privado, você deve testar o servidor para garantir que o Harmony tenha conectividade com o banco de dados. Uma maneira de fazer isso é conectar-se ao servidor por meio do SQL*Plus. Se for bem-sucedido, o Oracle Client deve operar corretamente com o Jitterbit Harmony.

Além disso, algumas versões do driver Oracle (não o driver Microsoft Oracle) podem exigir que uma ou mais variáveis de ambiente no sistema operacional sejam definidas. Por exemplo:

ORACLE_HOME=/usr/local/oracle/10.2.0
TNS_ADMIN=/usr/local/oracle/10.2.0/network/admin
TWO_TASK=//dbdpmr:1555/pmrd1

No Linux, você também pode precisar adicionar o diretório da biblioteca Oracle ao seu caminho (por exemplo, LD_LIBRARY_PATH). Adicione-os ao /etc/sysconfig/jitterbit arquivo. Alguns exemplos são mostrados abaixo, mas o caminho exato depende da instalação do Oracle Client:

LD_LIBRARY_PATH=/usr/local/oracle/lib
export ORACLE_HOME=/usr/local/oracle/10.2.0
export TNS_ADMIN=/usr/local/oracle/10.2.0/network/admin
export TWO_TASK=//dbdpmr:1555/pmrd1

Configurar a Conexão do Banco de Dados¶

Depois que o Oracle Client for configurado e testado, especifique essas entradas durante a configuração da Conexão do banco de dados:

• Tipo de Driver: Selecione ODBC.

• Driver: Selecione o driver Oracle. Se você não vir seu driver na lista, consulte Adicione seu driver ao arquivo de configuração do Jitterbit Agente abaixo.

• Use Connection String: Em Optional Settings, marque esta caixa de seleção. Você deve construir a string de conexão manualmente, pois o Oracle faz referência ao banco de dados com base na configuração em tnsnames.ora.

• Connection String: Em Optional Settings, insira a string de conexão manual para seu banco de dados Oracle específico. Por exemplo:

  Oracle in OraHome92

  Driver={Oracle in OraHome92};Dbq=myTNSServiceName;Uid=myUsername;Pwd=myPassword;
  

  Oracle in OraClient11g_home1

  DRIVER={Oracle in OraClient11g_home1};SERVER=[server SID];UID=[userid];
  PWD=[password];DBQ=[server SID];
  

  Dica

  Exemplos adicionais de strings de conexão Oracle estão disponíveis em The Connection Strings Reference.

Adicione seu Driver ao Arquivo de Configuração do Agente Privado¶

Devido às muitas variações no nome do driver Oracle, pode ser necessário adicionar as informações do driver ao arquivo de configuração do Agente Privado.

Depois que as informações do driver forem adicionadas conforme descrito abaixo, ao selecionar seu driver no Cloud Studio, você verá seu driver aparecer na lista de drivers ODBC. Se as etapas abaixo não forem bem-sucedidas, consulte Instalar drivers ODBC ou JDBC adicionais para obter detalhes sobre a instalação do driver.

Configuração do Agente Remoto¶

Se você tiver a configuração do agente remoto habilitada por meio do Management Console, você pode adicionar suas informações de driver na aba Db Drivers da seguinte maneira. Para obter detalhes sobre a configuração do agente remoto, consulte a seção Exibir ou editar Jitterbit Conf em Agentes > Grupos de Agente.

1. No Management Console, vá para Agentes > Grupos de Agente.

2. Dentro da tabela, encontre seu Grupo de Agentes e use o menu suspenso Action para selecionar Jitterbit Conf.

3. Na caixa de diálogo, selecione a aba Db Drivers e clique em Edit no canto superior direito. Localize a entrada de exemplo a seguir para uma versão específica do Oracle e substitua as informações de exemplo fornecidas por aquelas para seu driver ODBC Oracle específico. Ao concluir, clique em Enviar para salvar as informações do driver no arquivo de configuração do Agente Privado.

   #Oracle in OraClient10g_home2
   'Oracle in OraClient10g_home2 Quote Begin'='\"'
   'Oracle in OraClient10g_home2 Quote End'='\"'
   

4. Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

   Na máquina onde cada Agente Privado está instalado, primeiro pare os serviços e depois reinicie-os. Consulte Reiniciar um Agente Privado do Windows ou Reiniciar um Agente Privado do Linux Para maiores informações.

Configuração Manual do Agente¶

Se você estiver usando a configuração manual do agente, poderá adicionar as informações do driver no [DbDrivers] seção do jitterbit.conf localizado em cada Agente Privado. Para obter detalhes, consulte Editar o arquivo de configuração (jitterbit.conf).

1. Abra jitterbit.conf em um editor de texto e vá até o [DbDrivers] seção.

2. Localize a entrada de exemplo a seguir para uma versão específica do Oracle e substitua as informações de amostra fornecidas por aquelas de seu driver ODBC Oracle específico. Quando terminar, salve o jitterbit.conf arquivo.

   #Oracle in OraClient10g_home2
   'Oracle in OraClient10g_home2 Quote Begin'='\"'
   'Oracle in OraClient10g_home2 Quote End'='\"'
   

3. Todos os serviços Jitterbit devem ser reiniciados para que a nova configuração entre em vigor.

   Na máquina onde cada Agente Privado está instalado, primeiro pare os serviços e depois reinicie-os. Consulte Reiniciar um Agente Privado do Windows ou Reiniciar um Agente Privado do Linux Para maiores informações.

Exemplos de Cláusulas WHERE¶

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

WHERE
    product_name = 'Kingston';

WHERE
    list_price > 500;

WHERE
    list_price > 500
    AND category_id = 4;

WHERE
    list_price BETWEEN 650 AND 680

WHERE
    category_id IN(1, 4)

WHERE
    product_name LIKE 'Asus%'

WHERE business_seats_taken IS NULL
    OR business_seats_taken = 0

WHERE EMP_ACT.EMPNO = EMPLOYEE.EMPNO

WHERE THIS_EMP.JOB = 'SALESREP'
       AND THIS_EMP.WORKDEPT = DINFO.DEPTNO

Para exemplos adicionais, consulte Oracle Basics e o artigo da Oracle cláusula WHERE.

PostgreSQL¶

Você pode se conectar a um banco de dados PostgreSQL usando um driver JDBC ou ODBC. O driver JDBC é recomendado para recursos adicionais, como ser capaz de fornecer uma consultar manual, que não estão disponíveis por meio de uma conexão ODBC. Os drivers PostgreSQL já devem estar disponíveis no Harmony Agente, pois o agente atualmente usa o PostgreSQL para armazenar dados internos.

Codificação do c=Cliente¶

Se você receber um erro de "incompatibilidade de codificação do cliente" ao testar a conexão com um banco de dados PostgreSQL, isso significa que a codificação do servidor PostgreSQL ao qual você está se conectando é diferente da codificação padrão assumida pelo driver PostgreSQL.

Para resolver esse problema, defina a codificação do cliente no Windows como WIN1251 e especifique a codificação durante a configuração de uma conexão de banco de dados:

• Parâmetros de string de conexão adicionais: Em Configurações opcionais, insira este parâmetro adicional:

  ConnSettings=SET CLIENT_ENCODING to 'LATIN1'
  

Usuários do Linux¶

Ao executar o Harmony Agente no Linux, sempre use o driver PostgreSQL instalado com o agente. O driver PostgreSQL instalado com muitas distribuições como parte do unixODBC não funciona bem com o Jitterbit Harmony e produz erros.

Exemplos de Cláusulas WHERE¶

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

WHERE first_name = 'Jamie' AND
 last_name = 'Rice';

WHERE amount <= 1 OR amount >= 8;

WHERE distributors.name LIKE 'W%'

WHERE did = $1;

WHERE manager_name = 'Mary'

WHERE er.employee_name = e.manager_name

Para exemplos adicionais, consulte Tutorial do PostgreSQL e o Manual do PostgreSQL para sua versão.

Progress¶

Siga as etapas abaixo para configurar e usar o driver Progress JDBC em cada Harmony Agente Privado dentro de um Grupo de Agentes Privados:

1. Baixe o driver JDBC do banco de dados Progress (openedge.jar).

2. Pare os serviços Jitterbit executando StopServices.bat no diretório inicial do Agente Privado. O diretório raiz do Agente Privado geralmente está em um destes locais padrão:

   • Windows (Harmony): C:\Program Files (x86)\Jitterbit Agent\

   • Windows (v5.x): C:\Program Files (x86)\Jitterbit Integration Server\

   • Linux: /opt/jitterbit

3. Copie o arquivo JAR para este caminho de pasta recomendado: <JITTERBIT_HOME>/tomcat/drivers/lib/, substituindo <JITTERBIT_HOME> com o diretório raiz do Agente Privado.

   Cuidado

   Você também pode ter arquivos JAR localizados em <JITTERBIT_HOME>/tomcat/webapps/axis/WEB-INF/lib/; entretanto, este diretório pode ser sobrescrito se você atualizar seu Agente Privado. Em vez disso, recomendamos colocar todos os drivers instalados em <JITTERBIT_HOME>/tomcat/drivers/lib/.

4. Adicione essas linhas a JdbcDrivers.conf arquivo no diretório inicial do Agente Privado:

   <Driver>
   <Name>Progress OpenEdge</Name>
   <Class>com.ddtek.jdbc.openedge.OpenEdgeDriver</Class>
   <Subprotocol>datadirect:openedge</Subprotocol>
   </Driver>
   

5. Reinicie os serviços Jitterbit executando StartServices.bat no diretório inicial do Agente Privado.

6. Durante a configuração da Conexão do banco de dados, especifique estas entradas:

   • Tipo de Driver: Selecione JDBC.

   • Driver: Selecione o driver Progress OpenEdge.

   • Use Connection String: Em Optional Settings, marque esta caixa de seleção.

7. Connection String: Em Option Settings, insira a string de conexão manual com o hospedar, a porta e o nome do banco de dados apropriados:

   jdbc:datadirect:openedge://localhost:7777;databaseName=jb
   

8. Na conexão bem-sucedida, você poderá visualizar as tabelas e exibições durante a configuração da atividade do banco de dados.