Ir para o conteúdo principal
Documentação
Documentação
Adaptive Planning
Última atualização: 2024-09-20
Etapas: definir fontes de dados do banco de dados JDBC

Etapas: definir fontes de dados do banco de dados JDBC

Você pode usar
Adaptive Planning
 Integração para extrair informações de bancos de dados compatíveis com JDBC. A maioria dos bancos de dados usados nos aplicativos de contabilidade e finanças é compatível com JDBC (conectividade de banco de dados Java). O JDBC é um padrão que usa a linguagem de programação Java para prover conectividade a uma ampla variedade de bancos de dados.
Uma fonte de dados de banco de dados compatível com JDBC requer um driver. A tabela a seguir mostra as informações dos drivers JDBC mais comuns.
Os agentes de dados do Adaptive Planning se conectam somente a bancos de dados locais. Não há suporte para a conexão a bancos de dados em nuvem com um agente.
Fonte JCBC
Visão geral
Jar do provedor
Classe do driver
Exemplo de JDBC/URL
Informações do URL JDBC
Oracle
ojdbc6-11.2.0.3.jar
Você pode obter esse arquivo no site da Oracle ou por meio do repositório Maven da Oracle.
oracle.jdbc.OracleDriver
jdbc:oracle:thin:@example-win-db:1521:ANACONDA
SQL Server
jtds-1.3.1.jar na pasta de plug-ins do agente de dados.
net.sourceforge.jtds.jdbc.Driver
jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS
SQL Server
sqljdbc41.jar na pasta de plug-ins do agente de dados.
com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;
MySql
com.mysql.jdbc.Driver
jdbc:mysql://localhost:3306/AGENT_TEST
h2
Procure h2*.jar na distribuição do gerenciador de serviços do agente de dados do Workday Adaptive Planning. Para versões de agente de dados 7.1.44 e anteriores, procure h2.jar na distribuição do gerenciador de serviços do agente de dados do Adaptive.
org.h2.Driver
jdbc:h2:/data/test
Os arquivos jar residem no
C:/Program Files/Workday Adaptive Planning Data Agent/Plugins.
Para versões do agente de dados 7.1.44 e anteriores, use
C:/Program Files/Adaptive Data Agent/Plugins
no computador que hospeda o serviço do agente de dados.
Depois de adicionar um arquivo jar, você precisa acessar os serviços locais e reiniciar o serviço do agente de dados.
Antes de definir uma fonte de dados de um banco de dados local, você precisa criar um agente de dados que informe
Adaptive Planning
 Integração como se comunicar com o banco de dados. Para obter informações sobre como criar agentes de dados, consulte Create Data Agents.
Para definir uma fonte de dados de banco de dados JDBC, siga estas etapas:
  1. Acesse o Designer de dados em
    Integração > Designer de dados
    .
  2. Na pasta Fonte de dados na Biblioteca de componentes, no lado direito da tela, clique em
    Criar nova fonte de dados
    . A caixa de diálogo Criar novo é exibida.
  3. Selecione Banco de dados JDBC como o tipo de fonte de dados, informe o nome do banco de dados e selecione o agente que você quer usar para essa fonte de dados.
  4. Clique em
    Criar
    . A área central da tela exibe as configurações da nova fonte de dados e outras informações.
  5. Insira as informações da fonte de dados:
    • Agente associado:
       selecione o agente de dados do Adaptive Planning ao qual você quer se conectar. Essa lista contém todos os agentes de dados encontrados em
      Component Library
      Data Agents
      .
    • Classe do driver
      : informe a classe do driver do banco de dados. (Você pode obter essas informações com o fornecedor do banco de dados.)
    • URL
      : informe o URL do banco de dados.
    • Nome de usuário
      : informe o nome de usuário usado para acessar o banco de dados.
    • Senha
      : informe a senha associada ao nome de usuário.
    • Filtro de esquema
      : informe o nome dos esquemas dos quais você quer importar dados. Se quiser informar mais de um esquema, separe-os usando ponto-e-vírgula. Use esse campo para restringir o número de tabelas que precisam ser atualizadas no
      Adaptive Planning
       Integração Este campo é opcional.
    • Nível de registro
      : selecione um nível de registro na lista suspensa para especificar os detalhes de registro dessa fonte de dados. Suas opções são:
      • Erro
        : registra somente erros graves.
      • Informações
        : registra todas as informações básicas, como por exemplo, a data em que a fonte de dados foi atualizada.
      • Detalhado
        : apresenta informações muito detalhadas sobre todas as fases e ações. (Este nível é usado principalmente para depuração ou auditoria, pois pode produzir mais informações de registro do que as necessárias para o uso geral.)
  6. Clique em
    Salvar
    no menu Ações.
Você pode testar as informações de conexão na nova fonte de dados clicando em
Testar conexão
 no menu
Ações
. O sistema tenta se conectar ao banco de dados usando as informações nos campos da fonte de dados. Se o sistema conseguir se conectar ao banco de dados, clique em
OK
. Se ocorrerem problemas na conexão, corrija os erros e tente novamente.
Depois de se conectar ao banco de dados, você pode importar a estrutura de dados. Você vê as tabelas e colunas do banco de dados.
Somente as colunas para os tipos com suporte são exibidas. Tipos de colunas com suporte, lista os tipos de coluna com suporte para os vários tipos de bancos de dados.
Para importar a estrutura do banco de dados JDBC, faça o seguinte:
  1. Clique em
    Importar estrutura
     no menu
    Ações
    . As tabelas e colunas são mostradas no menu
    Componentes de dados
    .
    Os modos de importação de dados afetam a forma como os dados são sincronizados. O modo de importação por padrão (todos os registros substituídos) para uma fonte de dados JDBC é o seguinte:
  2. Os dados JDBC são importados.
  3. Os dados da fonte JDBC são preenchidos na tabela de preparação.
  4. Quando há um filtro SQL personalizado, ele se aplica aos dados do servidor de banco de dados para determinar o subconjunto de dados a ser importado.
Você também pode optar por adicionar informações importadas (os dados importados são anexados à tabela de preparação existente) ou mesclar informações importadas (as linhas existentes nos dados JDBC são mescladas com as linhas da área de preparação).

Como adicionar tabelas a uma fonte de dados JDBC

Depois de importar a estrutura do banco de dados, especifique as informações que você quer importar do banco de dados. A seção
Tabelas a serem importadas
 permite configurar os dados a serem importados do banco de dados.
Para especificar as tabelas a serem importadas do banco de dados, siga estas etapas:
  1. Expanda a entrada da fonte de dados no menu
    Componentes de dados
    .
    Cada tabela do banco de dados aparece como um item separado.
  2. Para selecionar as tabelas que você quer importar, arraste-as e solte-as na seção
    Tabelas a serem importadas
    , no centro da tela.
    À medida que você arrasta cada tabela para a seção Tabelas a serem importadas, é exibida uma guia da tabela e as informações do banco de dados são exibidas na seção Tabelas a serem importadas, mostrando o tipo de informação que você adicionou. Cada guia da tabela também tem um menu suspenso que pode ser acessado clicando na seta ao lado do nome.

Como gerenciar colunas

Se você está trabalhando com uma tabela que tem um grande número de colunas, pode usar a caixa de diálogo
Gerenciar colunas
 para fazer edições rápidas nas colunas que você quer importar. A caixa de diálogo
Gerenciar colunas
 exibe as colunas da tabela para que você possa marcar ou desmarcar as colunas para importação.
Para gerenciar as colunas para importação, siga estas etapas:
  1. Na guia, clique na seta à direita do nome da tabela.
  2. Clique em
    Gerenciar colunas
     no menu flutuante.
  3. Marque a caixa ao lado da coluna para importá-la.
    Quando você marca uma coluna, ela também aparece na janela de pré-visualização depois que o conteúdo do pop-up é salvo. O ato de desmarcar a coluna a remove da janela de pré-visualização.
Você pode alterar o status da importação em colunas individuais quando:
  • Seleciona as propriedades da coluna e define a propriedade.
  • Arrasta e solta as colunas no designer
Você não consegue alterar o status de importação em campos gerados pelo sistema, como o
isDeleted
.

Como personalizar tabelas

Para cada tabela, você pode personalizar a forma como os dados são importados.
Para personalizar as configurações da tabela, siga estas etapas:
  1. Na guia, clique na seta à direita do nome da tabela.
  2. Clique em
    Configurações de tabela
     no menu flutuante.
  3. Insira as configurações da tabela:
    • Modo de importação de dados
      : selecione uma das opções na lista suspensa.
      • Todos os registros são substituídos toda vez que a importação de dados é executada
        . Esse é o padrão. Substitui os dados na tabela de preparação pelos dados importados da origem.
      • Cache remoto usado para identificar e enviar registros alterados na importação
        . São importados somente os registros do banco de dados que foram alterados ou são novos. Os registros alterados substituem os registros existentes na área de preparação. Os novos registros são adicionados ao final das informações na área de preparação.
      • Todos os registros que estão em um intervalo de tempo transmitido
        . São importados todos os registros no intervalo de tempo especificado. Os registros na tabela de preparação que corresponderem aos períodos importados são excluídos antes da importação dos dados mais recentes da origem.
    • Filtro de importação de dados
      : use para inserir uma expressão SQL que filtre ou formate as informações que estão sendo importadas. O filtro SQL é aplicado antes que os dados sejam extraídos do banco de dados para reduzir a quantidade de informações que precisam ser importadas, proporcionando um nível adicional de controle dos dados que são trazidos para a área de preparação. Clique no campo para exibir a caixa de diálogo
      Editar filtro SQL
       (o filtro inserido aqui é aplicado nos dados do banco de dados e não nos dados pré-visualizados na área de preparação). Nem todas as fontes de dados têm suporte para o mesmo nível de recurso de filtragem de SQL.
  4. Clique em
    Aplicar
    para aplicar as configurações.
  5. Repita as etapas de 1 a 3 para cada tabela.
    Se uma tabela de banco de dados tem chaves definidas, essas informações também são trazidas para a tabela de preparação. Você pode revisar e modificar essas informações conforme necessário.
  6. Clique em
    Salvar
     para salvar as configurações na fonte de dados.

Como definir opções de coluna

Use a seção
Tabelas a serem importadas
 para pré-visualizar os dados tal como estão na fonte de dados ou como ficaram na área de preparação após a importação. Você pode alterar as opções de cada coluna posicionando o cursor do mouse sobre o título e clicando no menu suspenso ao lado do nome. As opções são:
  • Classificar em ordem crescente
    : classifica toda a tabela em ordem crescente com base nesta coluna.
  • Classificar em ordem decrescente
    : classifica toda a tabela em ordem decrescente com base nesta coluna.
  • Configurações de coluna
    : esta caixa de diálogo é usada para alterar as propriedades da coluna na tabela de preparação.
    • Nome
      : nome da coluna, exibido no cabeçalho.
    • Tipo de coluna
      : tipo de dados usados na coluna.
    • Converter tipo de coluna
      : selecione o novo tipo neste menu suspenso.
  • Excluir coluna da importação
    : selecione para remover esta coluna dos dados que estão sendo importados.
  • Excluir coluna personalizada
    : selecione para excluir a coluna. (Disponível somente para colunas personalizadas.)

Como baixar dados de uma tabela de preparação

Você pode baixar dados de uma única tabela de preparação.
Para baixar dados de uma única tabela de preparação, siga estas etapas:
  1. Clique na seta para baixo no cabeçalho da tabela na seção Tabelas a serem importadas.
  2. Selecione
    Baixar dados
    .
  3. Clique em
    Enviar
     na mensagem
    Esta operação enviará um e-mail com um URL para baixar os dados
    .
    Adaptive Planning
     A Integração envia um e-mail contendo um URL para a conta de e-mail associada ao designer de dados.
  4. Abra o e-mail e clique no URL.
    Os dados são baixados no formato .csv.

Como usar opções avançadas de filtro

Abaixo do menu suspenso
Origem
, clique em
Opções avançadas de filtro
 para ver as opções para filtrar os dados na área de pré-visualização das
Tabelas a serem importadas
. O recurso
Opções avançadas de filtro
 disponibiliza ferramentas para visualizar e navegar por um subconjunto dos dados em uma tabela de preparação ou diretamente na origem remota (se você selecionar Banco de dados JDBC no menu suspenso Origem). Quando altera as propriedades do filtro, você também pode alterar como os dados são mostrados na janela de pré-visualização, sem modificar os dados na área de preparação.
A área de pré-visualização serve especificamente para ver uma pequena parte dos dados na área de preparação (ou no banco de dados JDBC) Para verificar se está obtendo os dados esperados, examine a área de preparação e explore os dados disponíveis na fonte de dados JDBC. Você também pode usar esse recurso para refinar o filtro de importação de dados que você quer usar. (Os filtros definidos na função de pré-visualização não afetam os dados reais na área de preparação.)
As
Opções avançadas de filtro
 incluem:
  • Linhas distintas
    : marque esta caixa para ocultar linhas duplicadas.
  • Máx. de linhas
    : informe um número na caixa de texto para limitar o número de linhas exibidas na área de pré-visualização.
  • Colunas
    : marque ou desmarque as colunas neste menu suspenso para mostrar ou ocultar colunas.
    A remoção de uma coluna desta lista não remove a coluna da lista de importação.
  • Filtro SQL
    : clique na caixa de texto grande para exibir a caixa de diálogo
    Editar filtro SQL
    , em que você pode inserir um filtro SQL para restringir as linhas que estão sendo visualizadas. Clique em
    Aplicar
     para verificar automaticamente a sintaxe SQL do filtro. (Se houver algum erro, ele é indicado na expressão.) A expressão que você inseriu aparece no campo
    Opções avançadas de filtro
    . Para obter ajuda detalhada sobre sintaxe SQL, clique na ajuda on-line da seção
    Observações
     .
Clique em
Remover filtro
 (ao lado do menu suspenso Origem) para limpar todas as configurações de opções avançadas de filtro.
Como parte do processo de personalização de tabelas, você também pode criar tabelas de junção e colunas personalizadas usando expressões SQL.

Como importar dados de um banco de dados JDBC

Depois de definir e salvar a fonte de dados JDBC, você pode importar os dados.
Para importar os dados de um banco de dados JDBC, faça o seguinte:
  1. Clique em
    Importar dados
     no menu
    Ações
    .
    Os dados selecionados são filtrados pelas expressões SQL e carregados na área de preparação. Você pode pré-visualizar os dados na área de preparação.
As informações permanecem na área de preparação até que você as limpe manualmente ou até que um carregamento de dados subsequente as limpe de acordo com o modo de importação.
Para limpar os dados da área de preparação, faça o seguinte:
  1. Clique em
    Limpar tabelas de preparação
     no menu
    Ações
    . A área de preparação de todas as tabelas na fonte de dados é limpa.
Para remover caracteres especificados de fluxos de texto de entrada em fontes de dados JDBC:

Associar uma fonte de dados JDBC a outro agente de dados do Adaptive Planning

Você pode alterar o agente de dados do Adaptive Planning associado à sua fonte de dados JDBC.
  1. Verifique se o agente de dados ao qual você quer se conectar está listado em
    Component Library
    Data Agents
    .
  2. Navegue até a fonte de dados JDBC no Design de integrações.
  3. Selecione o agente de dados no campo
    Agente associado
     da seção
    Configurações
     .

Esquemas excluídos de fontes de dados JDBC

As fontes de dados JDBC que se conectam ao Oracle ou MS SQL Server excluem explicitamente alguns esquemas que não estão relacionados a dados financeiros.

Esquemas excluídos de fontes de dados JDBC do Oracle

CTXSYS, MDSYS, SYSTEM, SYS, XDB

Esquemas excluídos de fontes de dados JDBC do MS SQL Server

INFORMATION_SCHEMA, SYS

Dicas para solução de problemas

Podem ocorrer alguns problemas relacionados a fontes de dados cujas soluções não são tão claras.
Quando você importa a estrutura de um banco de dados e o banco tem mais de mil tabelas, ocorre um erro recomendando que você filtre a lista de tabelas. Para resolver esse erro, execute uma das seguintes ações:
  • Edite a fonte de dados JDBC e insira um filtro de esquema.
  • Altere as permissões associadas ao logon que você está usando para acessar o servidor para fazer com que menos tabelas sejam acessadas usando esse logon.
Quando você importa a estrutura de um banco de dados Oracle, os seguintes esquemas não são importados como parte da estrutura:
CTXSYS, MDSYS, SYSTEM, SYS,
e
XDB
. São esquemas de sistemas Oracle e não são necessários para a integração de dados.
Quando você importa a estrutura de um banco de dados MS SQL, os seguintes esquemas não são importados como parte da estrutura: INFORMATION_SCHEMA e sys. São esquemas de sistemas MS SQL e não são necessários para a integração de dados.