Conector de Banco de Dados¶

Resumo¶

O conector de banco de dados para Harmony Cloud Studio fornece uma interface para inserir informações fornecidas pelo usuário, como credenciais de servidor, para criar uma conexão de banco de dados. Essa conexão fornece a base para configurar atividades associadas do conector de banco de dados que interagem com a conexão. Juntos, uma conexão específica do banco de dados e suas atividades são chamadas de endpoint do banco de dados.

Visão Geral do Conector¶

Este conector é usado para primeiro configurar uma conexão de banco de dados, estabelecendo acesso a um banco de dados e, em seguida, usado para configurar uma ou mais atividades de banco de dados associadas a essa conexão como origem ou destino em uma operação ou script:

• Consulta: Consulta dados de um endpoint do banco de dados e destina-se a ser usado como fonte em uma operação ou chamado em um script.
• Inserir: Insere novos dados em um endpoint do banco de dados e se destina a ser usado como destino em uma operação ou chamado em um script.
• Atualizar: Atualiza os dados existentes em um endpoint do banco de dados e destina-se a ser usado como destino em uma operação ou chamado em um script.
• Inserir: Atualiza os dados existentes e insere novos dados em um endpoint do banco de dados e se destina a ser usado como destino em uma operação ou chamado em um script. (O Harmony suporta atividades Upsert para bancos de dados usando uma combinação de Consulta, Inserção e Atualização.)

Acessando o Conector¶

O conector do banco de dados é acessado na aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).

Bancos de Dados e Dados Suportados¶

A maioria dos bancos de dados compatíveis com JDBC e ODBC são suportados.

Em bancos de dados, o Jitterbit não oferece suporte a dados com estes tipos de codificação ou nomes de objetos:

• Dados binários
• Dados Unicode/UTF
• Tabelas ou visualizações com espaços nos nomes

Versões TLS Suportadas¶

O Transport Layer Security (TLS) 1.2 é suportado e recomendado para endpoints de banco de dados JDBC. TLS 1.0 e 1.1 não são mais suportados em Agentes em Nuvem e estão desabilitados por padrão em Agentes Privados versão 10.47 e posteriores.

Se um endpoint de banco de dados não funcionar mais após um upgrade para um agente 10.47 ou posterior, adicione enabledTLSProtocols=TLSv1.2 à string de conexão do banco de dados durante a configuração da Conexão do banco de dados para forçar o uso do TLS 1.2 (desde que a versão do protocolo seja suportada pelo endpoint do banco de dados).

Em Agentes Privados, se o TLS 1.2 não for compatível com o endpoint do banco de dados, o TLS 1.0 ou 1.1 poderá ser reativado (embora não recomendado) removendo-se TLSv1 ou TLSv1.1 de jdk.tls.disabledAlgorithms propriedade de segurança no Agente Privado java.security arquivo de configuração.

O Agente Privado java.security O arquivo de configuração está localizado nestes diretórios padrão:

• Windows: C:\Program Files\Jitterbit Agent\jre\lib\security
• Linux: /opt/jitterbit/jre/lib/security

Instalando Drivers JDBC Ou ODBC Adicionais¶

Os drivers de banco de dados são detectados automaticamente pelo Harmony Agente. Para Agentes em Nuvem, gerenciados pela Jitterbit, um conjunto de drivers JDBC comumente usados é suportado e já é fornecido. Para Agentes Privados, os drivers instalados são detectados no 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. Se você precisar do uso de um driver ODBC, poderá usar um Windows Agente Privado.

Para obter informações gerais e instruções sobre como instalar drivers adicionais em Agentes Privados, consulte Instalando drivers ODBC ou JDBC adicionais.

Caracteres Especiais em Nomes de Tabelas/colunas do Banco de Dados¶

Se estiver usando um Agente Privado, você pode especificar caracteres usados para definir delimitadores nos nomes de tabelas/colunas do banco de dados no arquivo de configuração do Agente Privado debaixo de [DbDrivers] seção.

Se estiver usando um driver de banco de dados ODBC, observe que alguns caracteres especiais nos nomes de tabelas/colunas do banco de dados não podem ser manipulados pelo driver. Por exemplo, campos de banco de dados que possuem um sinal de arroba (@) não são compatíveis com especificações baseadas em SQL e podem não ser suportadas. Se o banco de dados usar esses caracteres especiais em nomes de tabelas/colunas, como solução alternativa, recomendamos criar uma visualização na tabela física que não use caracteres especiais em nomes de colunas e usá-los.

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

Consulte Informações específicas do banco de dados para obter informações de referência sobre a configuração desses bancos de dados:

• IBM DB2 (AS400)
• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server
• MySQL
• Oracle
• PostgreSQL
• Progresso

Funções de Banco de Dados¶

Várias funções de banco de dados podem ser usadas em scripts para fornecer acesso a interações básicas de banco de dados, incluindo estas:

• CacheLookup
• CallStoredProcedure
• DBCloseConnection
• DBExecute
• DBLoad
• DBLookup
• DBLookupAll
• DBRollbackTransaction
• DBWrite
• SetDBInsert
• SetDBUpdate
• SQLEscape
• Unmap
• <SEQUENCE>
• <SQLIDENTITY>
• <UDF>

Para obter detalhes sobre como usar essas funções, consulte Funções de banco de dados.

Solução de Problemas¶

Se você tiver problemas com o conector do banco de dados, estas etapas de solução de problemas são recomendadas:

1. Certifique-se de que a conexão do banco de dados é bem-sucedido usando o botão Test na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado poderá fornecer uma indicação do problema.

2. Verifique os logs de operação para qualquer informação escrita durante a execução da operação.

3. Habilite o registro de depurar de operação (para Agentes em Nuvem ou para Agentes Privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.