Fontes e alvos de banco de dados no Jitterbit Design Studio
Bancos de dados podem ser definidos como uma fonte de banco de dados ou alvo de banco de dados dentro do Jitterbit Studio. Esta página fornece informações gerais sobre o uso de bancos de dados no Jitterbit.
Nota
Endpoints criados com uma fonte/alvo de banco de dados estão incluídos na reportagem de uso de endpoints e contam para sua licença.
Drivers
O Jitterbit se comunica com bancos de dados através de ODBC ou JDBC. Agentes em nuvem suportam um conjunto fornecido de drivers JDBC. Agentes privados suportam tanto drivers ODBC quanto JDBC. Além dos drivers fornecidos, você pode instalar drivers ODBC e JDBC adicionais em agentes privados.
Instruções SQL
Instruções SQL manuais são suportadas apenas para drivers JDBC. Todas as instruções SQL escritas usando o Construtor de Fórmulas durante o mapeamento de transformação devem ser compatíveis com ANSI-SQL para o driver JDBC do banco de dados que você está acessando. Há um limite de 2000 caracteres para as instruções SQL. Uma solução alternativa recomendada para a limitação de caracteres, se necessário, é criar visões de banco de dados para instruções SQL longas.
Autenticação
Credenciais válidas são necessárias para se conectar ao seu banco de dados. Geralmente, isso consiste em DSN (Nome da Fonte de Dados) ou nome de usuário/senha.
Tipos de dados não suportados
Estes itens não são suportados na versão atual do software:
- Dados binários
- Dados Unicode/UTF
- Tabelas e visões com espaços nos nomes
Versões TLS suportadas
Camadas de Segurança de Transporte (TLS) 1.3 e 1.2 são suportadas para endpoints de banco de dados JDBC.
Em agentes privados, o TLS 1.0 ou 1.1 pode ser reabilitado (embora não seja recomendado) removendo TLSv1 ou TLSv1.1 da propriedade de segurança jdk.tls.disabledAlgorithms no arquivo de configuração java.security do agente privado.
O arquivo de configuração java.security do agente privado está localizado nestes diretórios padrão:
- Windows:
C:\Program Files\Jitterbit Agent\jre\lib\security - Linux:
/opt/jitterbit/jre/lib/security
Caracteres especiais em nomes de tabelas/colunas de banco de dados
Se estiver usando um agente privado, você pode especificar os caracteres usados para definir delimitadores dentro dos nomes de tabelas/colunas de banco de dados no arquivo de configuração do agente privado na seção [DbDrivers].
Se estiver usando um driver de banco de dados ODBC, observe que alguns caracteres especiais em nomes de tabelas/colunas de 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 estão em conformidade com as especificações baseadas em SQL e podem não ser suportados. Se o banco de dados usar tais caracteres especiais em nomes de tabelas/colunas, como uma solução alternativa, recomendamos criar uma visão na tabela física que não utilize o caractere especial nos nomes das colunas e usar essa visão em vez disso.
Funções definidas pelo usuário
A tag Funções Definidas pelo Usuário (UDF) é encontrada na pasta funções de banco de dados do construtor de fórmulas. Esta função permite que você use qualquer função de banco de dados suportada por um banco de dados, como a função ToDate() no Oracle, ou a função Convert() no SQL Server.
Atualizar valor de campo
A Atualização de Valor de Campo atualiza um campo de um banco de dados de origem para um valor dado após a conclusão de uma operação. Este valor é utilizado ao realizar operações de lote de banco de dados de rotina para garantir que os dados que já foram processados durante uma operação anterior não sejam processados novamente. Também é útil se a operação fizer parte de um fluxo de trabalho e precisar definir o status de um campo para o próximo valor, indicando que foi concluído com sucesso ou que ocorreu uma falha.
Chaves primárias
Chaves primárias são definidas dentro do seu ambiente de banco de dados. Um campo que é definido como chave primária é utilizado na indexação das informações do banco de dados. Quando aplicável, o Jitterbit pode identificar automaticamente os campos-chave do seu banco de dados.
Nota
Como esses campos-chave são definidos dentro do ambiente de banco de dados, você não pode alterar suas configurações no Assistente de Transformação.
Tipos de banco de dados
A maioria dos bancos de dados compatíveis com ODBC ou JDBC é suportada. As seguintes são recomendações específicas para vários tipos de banco de dados.
Trabalhar com bancos de dados Oracle usando TNSNames.ora
O uso de drivers JDBC é altamente recomendado para bancos de dados Oracle. No entanto, se você quiser usar ODBC, é recomendado que utilize os drivers ODBC da Oracle que acompanham a versão do banco de dados que você está acessando. Você precisará instalar o Cliente Oracle e o driver ODBC no mesmo servidor que executa o Jitterbit.
Ao usar o Cliente Oracle, você deve fazer o upload de um arquivo TNSNames.ora válido no diretório apropriado que referencia o banco de dados que deseja acessar. Para referenciar o banco de dados no Jitterbit, insira sua referência TNSNames.ora no campo Servidor, juntamente com o ID de usuário e a senha apropriados.
Para mais informações, consulte estas páginas:
- Configurar uma fonte de banco de dados ODBC Oracle
- Configurar um destino de banco de dados ODBC Oracle
- Usar drivers ODBC ou JDBC proprietários com Jitterbit
Trabalhar com bancos de dados Microsoft SQL Server
Bancos de dados Microsoft SQL Server são acessíveis para agentes em nuvem e privados do Jitterbit. Em agentes privados, o ODBC do Windows é recomendado para desempenho otimizado. O Jitterbit suporta as seguintes opções de autenticação:
| JDBC | Windows | Autenticação do Windows | Somente 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 | Somente privado | |
Nota
Para configuração da autenticação Kerberos, consulte Autenticação Kerberos do SQL Server
Para mais informações, consulte:
- Configurar uma fonte de banco de dados Microsoft SQL
- Configurar um destino de banco de dados Microsoft SQL
Trabalhar com bancos de dados baseados em arquivos
Bancos de dados baseados em arquivos devem utilizar a arquitetura de agente privado. Para usar bancos de dados baseados em arquivos, como o Microsoft Access, o arquivo do banco de dados deve residir no sistema de arquivos local na máquina do agente.
As informações de localização e autenticação para bancos de dados de arquivos planos estão disponíveis na definição do banco de dados de origem ou de destino. Para acessar o banco de dados, não é necessário definir um Servidor, apenas um Nome de Banco de Dados.
Esta tabela fornece exemplos de acesso a bancos de dados de arquivos com parâmetros adicionais de string de conexão, se necessário.
Nota
Alguns bancos de dados exigem apenas um caminho de arquivo para o campo Nome do Banco de Dados; nenhum nome de arquivo é necessário. Na tabela abaixo, observe que as entradas de Nome do Banco de Dados DBASE e Paradox não fornecem nenhum nome de arquivo. Além disso, observe que alguns bancos de dados de arquivos planos exigirão uma string de conexão manual.
| Tipo de Banco de Dados | Driver | Nome do Banco de Dados | Parâmetros Adicionais da String de Conexão (se necessário) |
|---|---|---|---|
| Access | Microsoft Access Driver (*.mdb) | \solar\saturn\demo\access\demo.mdb | |
| Access (FileDSN) | Microsoft Access Driver (*.mdb) | \solar\saturn\demo\access\demo.mdb | FileDSN=Access.dsn; |
| DBASE | MicrosoftdBase Driver (*.dbf) | \solar\saturn\demo\dbase | |
| DBASE (FileDSN) | MicrosoftdBase Driver (*.dbf) | \solar\saturn\demo\dbase | FileDSN=dbase.dsn; |
| Excel | Microsoft Excel Driver (*.xls) | \solar\saturn\demo\excel\demo.xls | |
| Excel (FileDSN) | Microsoft Excel Driver (*.xls) | \solar\saturn\demo\excel\demo.xls | FileDSN=Excel.dsn; |
| Paradox | Microsoft Paradox Driver (*.db) | \solar\saturn\Paradox | ParadoxNetPath=\solar\saturn\Paradox;DefaultDir=\solar\saturn\Paradox; |
| Paradox (FileDSN) | Microsoft Paradox Driver (*.db) | \solar\saturn\Paradox | FileDSN=Paradox.dsn; |
Para mais informações, consulte estas páginas: