Ir para o conteúdo

Atividade de Consulta ao Banco de Dados

Introdução

Uma atividade de Consulta ao Banco de Dados, utilizando sua Conexão com o banco de dados, consulta dados de um endpoint de Banco de Dados e é destinada a ser usada como uma fonte para fornecer dados em uma operação.

Criar uma atividade de Consulta ao Banco de Dados

Uma instância de uma atividade de Consulta ao Banco de Dados é criada a partir de uma Conexão com o banco de dados usando seu tipo de atividade Consulta.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para mais detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de Consulta ao Banco de Dados existente pode ser editada a partir destes locais:

Configurar uma atividade de Consulta ao Banco de Dados

Siga os passos em uma dessas seções para configurar uma atividade de Consulta ao Banco de Dados:

Consulta de objeto único usando assistente

Siga estas etapas para usar o assistente se você estiver consultando um único objeto e não precisar criar junções com outros objetos. Se precisar juntar vários objetos, consulte em vez disso Consulta de múltiplos objetos usando o assistente, ou se você já souber a instrução SQL e estiver usando um driver JDBC, veja Consulta manual.

Etapa 1: Insira um nome e selecione um objeto

  • Nome: Insira um nome para identificar a atividade do Banco de Dados. O nome deve ser exclusivo para cada atividade de Consulta do Banco de Dados e não deve conter barras (/) ou dois-pontos (:).

  • Selecionar Tabela(s): Esta seção exibe as tabelas disponíveis no endpoint do Banco de Dados usando quaisquer filtros aplicados, após usar o ícone de atualização para o carregamento inicial dos objetos. Se houver muitos objetos no banco de dados, você pode filtrar os objetos usando Visualizar ou Pesquisar antes de atualizar. Se a recuperação dos objetos expirar mesmo após a aplicação de filtros, use uma instrução SQL manual.

    • Visualizar: Use o menu suspenso para filtrar a lista de objetos exibidos para um de "Tabelas, Visualizações", "Tabelas", "Visualizações", ou "Tabelas do Sistema". Por padrão, a visualização "Tabelas, Visualizações" é mostrada.

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa não diferencia maiúsculas de minúsculas. A lista de objetos pode ser filtrada automaticamente, ou você pode precisar atualizar a lista, dependendo de os objetos já terem sido recuperados:

      • Se estiver pesquisando em objetos que já foram recuperados do banco de dados e já aparecem na lista, quaisquer termos de pesquisa digitados na caixa de pesquisa filtram automaticamente a lista.

  • Se estiver pesquisando em objetos que ainda não foram recuperados, por exemplo, ao tentar limitar o número de objetos recuperados para bancos de dados com um grande número de objetos, use o ícone de atualização ao lado da caixa de pesquisa para buscar os objetos do banco de dados usando o filtro.

        !!! note "Nota"
        Bancos de dados como Microsoft Access não suportam pesquisa de objetos e não retornarão resultados.

    • Atualizar: Clique no ícone de atualização para carregar ou recarregar tabelas do ponto de extremidade do Banco de Dados. Isso deve ser usado para o carregamento inicial de quaisquer objetos. Além disso, pode ser útil se você adicionou recentemente objetos ao banco de dados ou se você tem critérios de pesquisa adicionais que deseja aplicar antes de recuperar objetos do banco de dados.

    • Incluir o esquema/proprietário nos nomes das tabelas: Selecione esta caixa de seleção para incluir o esquema nos nomes das tabelas. Isso pode ser útil se você usar o mesmo nome de tabela em vários esquemas (como para desenvolvimento e produção) para permitir que você veja e selecione a tabela no esquema correto.

    • Selecionar Tabela(s): A lista de objetos é exibida em uma coluna à esquerda. Clique em um único objeto para adicioná-lo à tabela à direita. Se você estiver consultando vários objetos que precisam ser unidos, consulte Consulta de múltiplos objetos usando o assistente.

      Dica

      Se a lista não for preenchida com objetos disponíveis mesmo após aplicar um filtro, a Conexão com o banco de dados pode não ter sido bem-sucedida. Certifique-se de que você está conectado reabrindo a conexão e retestando as credenciais.

    • Tabela de objetos selecionados: O objeto selecionado é exibido em uma tabela à direita. As colunas nesta tabela não são relevantes para consultas de um único objeto e esses campos não podem ser editados, exceto para remover o objeto (passe o mouse sobre a coluna mais à direita e clique no ícone de remoção ). Se você estiver consultando vários objetos que precisam ser unidos, consulte Consulta de múltiplos objetos usando o assistente.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Pular Assistente / Escrever Declaração SQL: Mude para escrever manualmente uma declaração SQL personalizada.

    Nota

    Salvar uma declaração SQL personalizada sobrescreve qualquer consulta de assistente salva anteriormente.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Adicionar condições

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Selecionar Campos: Esta seção exibe campos para o(s) objeto(s) selecionado(s) que estão disponíveis no endpoint do Banco de Dados. Objetos que foram selecionados na etapa anterior são mostrados em negrito.

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada tecla pressionada.

    • Selecionar Todos: Ao usar a caixa de pesquisa para filtrar, você pode usar esta caixa de seleção para selecionar todos os campos visíveis de uma vez (objetos e campos colapsados não são selecionados).

    • Selecionar Campos: Selecione as caixas de seleção dos campos que você deseja incluir na consulta para que eles sejam adicionados automaticamente à declaração SQL à direita. A menos que esteja usando a caixa de pesquisa, você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma vez.

  • Declaração SQL: A declaração de consulta é preenchida automaticamente com o objeto e quaisquer campos selecionados à esquerda.

  • Cláusula WHERE (Opcional): Para adicionar uma cláusula WHERE, você pode usar os campos abaixo como entrada para ajudar a construir a cláusula, ou pode inserir manualmente a cláusula na caixa de texto inferior. Existem exemplos de cláusulas WHERE nas páginas de como fazer que descrevem como se conectar a bancos de dados comumente usados. Após adicionar uma cláusula WHERE, você deve primeiro testar a consulta usando o botão Testar Consulta para habilitar o botão Próximo.

    • Objeto: Campo: Use o menu suspenso para selecionar um campo do objeto selecionado.

    • Operador: Use o menu suspenso para selecionar o(s) operador(es) apropriado(s):

      Aritmético
      Operador Descrição
      + Adicionar
      - Subtrair
      * Multiplicar
      / Dividir
      % Módulo
      Bitwise
      Operador Descrição
      & E bit a bit
      | OU bit a bit
      ^ XOR bit a bit (OU exclusivo)
      Comparação
      Operador Descrição
      = Igual a
      > Maior que
      \< Menor que
      >= Maior ou igual a
      \<= Menor ou igual a
      != Diferente de
      Composto
      Operador Descrição
      += Adicionar igual
      -= Subtrair igual
      *= Multiplicar igual
      /= Dividir igual
      %= Módulo igual
      &= E bit a bit igual
      |*= OU bit a bit igual
      ^-= OU exclusivo bit a bit igual
      Lógico
      Operador Descrição
      ALL VERDADEIRO se todos os valores da subconsulta atendem à condição
      AND VERDADEIRO se todas as condições separadas por AND são VERDADEIRAS
      ANY VERDADEIRO se qualquer um dos valores da subconsulta atende à condição
      BETWEEN VERDADEIRO se o operando está dentro do intervalo de comparações
      EXISTS VERDADEIRO se a subconsulta retorna um ou mais registros
      IN VERDADEIRO se o operando é igual a uma das expressões de uma lista
      LIKE VERDADEIRO se o operando corresponde a um padrão
      NOT Exibe um registro se a(s) condição(ões) NÃO for(ão) VERDADEIRA(S)
      OR VERDADEIRO se qualquer uma das condições separadas por OR for VERDADEIRA
      SOME VERDADEIRO se qualquer um dos valores da subconsulta atende à condição

  • Valor: Insira o valor a ser usado com o campo e operador selecionados.

    !!! tip "Dica"
    Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para habilitar o teste do script. Sem valores padrão, o teste pode falhar, pois as variáveis globais só recebem valores em tempo de execução.

  • Adicionar: Cria a cláusula a partir de suas seleções e a adiciona à caixa de texto abaixo.

    Cuidado

    Ao escrever cláusulas WHERE manualmente, use a sintaxe exata exigida pelo seu banco de dados. Você também pode adicionar uma cláusula ORDER BY aqui, que afetará tanto os registros filhos quanto os pais.

    Dica

    Para adicionar múltiplas condições à cláusula WHERE, repita o processo adicionando seleções adicionais. Observe que pode ser necessário adicionar um operador lógico como AND ou OR para considerar as condições adicionais.

  • Teste de Consulta: Valida sua consulta. Se não for válida, mensagens de erro são exibidas. Se válida, exibe até 20 registros de exemplo.

Etapa 3: Revisar o esquema de dados

  • Esquema de Dados: O esquema de dados de origem é exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

    Nota

    Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração da atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede que você confirme que deseja descartar as alterações.

Consulta de múltiplos objetos usando o assistente

Siga estas etapas para consultar múltiplos objetos com junções:

Etapa 1: Insira um nome e selecione objetos

  • Nome: Insira um nome para identificar a atividade do Banco de Dados. O nome deve ser exclusivo para cada atividade de Consulta do Banco de Dados e não deve conter barras (/) ou dois-pontos (:).

  • Selecionar Tabela(s): Esta seção exibe as tabelas disponíveis no endpoint do Banco de Dados usando quaisquer filtros aplicados, após usar o ícone de atualizar para o carregamento inicial dos objetos. Se houver muitos objetos no banco de dados, você pode filtrar os objetos usando Visualizar ou Pesquisar antes de atualizar. Se a busca pelos objetos exceder o tempo limite, mesmo após aplicar filtros, use uma declaração SQL manual.

    • Visualizar: Use o menu suspenso para filtrar a lista de objetos exibidos para um dos "Tabelas, Visões", "Tabelas", "Visões", ou "Tabelas do Sistema". Por padrão, a visualização "Tabelas, Visões" é mostrada.

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa não diferencia maiúsculas de minúsculas. A lista de objetos pode ser filtrada automaticamente, ou pode ser necessário atualizar a lista, dependendo se os objetos já foram recuperados:

      • Se a pesquisa for em objetos que já foram recuperados do banco de dados e já aparecem na lista, quaisquer termos de pesquisa digitados na caixa de pesquisa filtram automaticamente a lista.

      • Se a pesquisa for em objetos que ainda não foram recuperados, por exemplo, ao tentar limitar o número de objetos recuperados para bancos de dados com um grande número de objetos, use o ícone de atualizar ao lado da caixa de pesquisa para buscar os objetos do banco de dados usando o filtro.

        Nota

        Bancos de dados como o Microsoft Access não suportam busca de objetos e não retornarão resultados.

    • Atualizar: Clique no ícone de atualização para carregar ou recarregar tabelas do endpoint do Banco de Dados. Isso deve ser usado para o carregamento inicial de quaisquer objetos. Além disso, pode ser útil se você adicionou recentemente objetos ao banco de dados ou se possui critérios de busca adicionais que deseja aplicar antes de recuperar objetos do banco de dados.

    • Incluir o esquema/proprietário nos nomes das tabelas: Selecione esta caixa de seleção para incluir o esquema nos nomes das tabelas. Isso pode ser útil se você usar o mesmo nome de tabela em múltiplos esquemas (como para desenvolvimento e produção) para permitir que você veja e selecione a tabela no esquema correto.

    • Selecionar Tabela(s): A lista de objetos é exibida em uma coluna à esquerda. Clique nos objetos um de cada vez para adicioná-los à tabela à direita. Qualquer combinação de tabelas, visualizações e/ou tabelas de sistema pode ser selecionada. Se você precisar consultar um único objeto sem junções, consulte em vez disso Consulta de objeto único usando assistente.

      Dica

      Se a lista não for preenchida com objetos disponíveis mesmo após aplicar um filtro, a Conexão com o banco de dados pode não ter sido bem-sucedida. Certifique-se de que você está conectado reabrindo a conexão e retestando as credenciais.

    • Tabela de objetos selecionados: Os objetos selecionados são exibidos em uma tabela à direita. Cada coluna é detalhada abaixo:

      • Tabela: O nome do objeto selecionado, uma tabela, visualização ou tabela de sistema.

        Dica

        Tabelas com caracteres especiais, como + em seus nomes, requerem uma consulta manual. O nome da tabela deve ser colocado entre colchetes ([ ]). Por exemplo, SELECT * FROM [table+].

      • Pai: Para cada objeto filho que está sendo unido, selecione seu objeto pai. Isso estabelece a hierarquia de relacionamento e ajuda a derivar chaves de link.

      • Tipo de Junção: Após atribuir Chaves de Link, selecione o tipo de relacionamento para cada objeto filho:

        • Um ou Mais: Cada registro pai deve ter pelo menos 1 registro filho.

        • Apenas Um: Cada registro pai deve ter exatamente 1 registro filho.

        • Zero ou Mais: Cada registro pai pode ter 0 ou mais registros filhos.

        • Zero ou Um: Cada registro pai pode ter 0 ou 1 registro filho.

      • Chaves de Link: Para cada objeto filho com um Pai selecionado, clique no link vermelho Atribuir para configurar os relacionamentos de chave:

      • Chaves de Link: Em cada objeto filho que está sendo unido, uma vez que um objeto é selecionado como o Pai, um link vermelho Atribuir aparece dentro deste campo. Clique em Atribuir para abrir uma janela separada onde você atribui as chaves de link.

        • Objeto pai: Exibe o objeto pai e seus campos à esquerda. As chaves primárias têm um ícone de chave . Use a caixa de pesquisa para filtrar campos, se necessário.

        • Objeto filho: Exibe o objeto filho e seus campos à direita. Use a caixa de pesquisa para filtrar campos, se necessário.

        • Atribuir chave(s) de link: Arraste um campo do pai para o filho (ou vice-versa) para criar um link. Repita para múltiplas chaves.

        • Desatribuir chave(s) de link: Para desatribuir chaves de link, clique em qualquer campo que já tenha sido vinculado. Os campos vinculados ficam desmarcados.

        • Recomeçar: Limpa todas as chaves de link atribuídas.

        • Concluir: Salva suas chaves de link e mostra a contagem na coluna Chaves de Link. O dropdown Tipo de Junção se torna disponível.

      • Remover: Para remover um objeto selecionado da tabela, passe o mouse sobre a coluna mais à direita e clique no ícone de remover .

      • Salvar & Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

      • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. Este botão não será habilitado até que você tenha especificado quaisquer objetos Pai, definido o Tipo de Junção e atribuído Chaves de Link. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Pular Assistente / Escrever Declaração SQL: Mude para escrever manualmente uma declaração SQL personalizada.

        !!! note "Nota"
        Salvar uma declaração SQL personalizada sobrescreve qualquer consulta do assistente salva anteriormente.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Adicionar condições

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Fonte: Exibe campos para cada objeto selecionado. Campos identificados como chaves devem ser incluídos.

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada tecla pressionada.

    • Selecionar Todos: Selecione a caixa de seleção para selecionar todos os objetos e campos visíveis de uma vez (objetos colapsados não são selecionados). Este modo de seleção não está disponível se seleções em nível de objeto estiverem em uso, mas está disponível ao usar a caixa de pesquisa.

    • Selecionar campos: Selecione as caixas de seleção dos campos que você deseja incluir na consulta para que sejam adicionados automaticamente à declaração SQL à direita. Você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma vez.

  • Tabela de campos de objeto: Os objetos selecionados e seus campos são exibidos em tabelas à direita, com campos opcionais para adicionar condições e ordenação:

    • Condição de Filtro: Opcionalmente, insira uma condição na forma do argumento de uma cláusula WHERE; ou seja, operador(es) seguido(s) por valor(es). Existem exemplos de cláusulas WHERE nas páginas de como fazer que descrevem como se conectar a bancos de dados comumente usados.

      Cuidado

      Se fornecer uma cláusula WHERE manualmente, você deve inseri-la na sintaxe que o banco de dados requer.

      Dica

      Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para habilitar o teste do script. Sem valores padrão, o teste pode falhar, pois as variáveis globais só recebem valores em tempo de execução.

    • Classificar: Opcionalmente, selecione Nenhum, Crescente ou Decrescente para aplicar uma ordem de classificação. Selecionar a opção Nenhum é o mesmo que deixar este campo em branco.

      Cuidado

      Usar ORDER BY em campo(s) filho(s) também afeta os registros pai.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 3: Revisar o esquema de dados

  • Esquema de Dados: O esquema de dados de origem é exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

    Nota

    Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração da atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração para todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Consulta manual

Siga estas etapas se você souber a instrução SQL e estiver usando uma conexão de driver JDBC (não disponível para ODBC):

Etapa 1: Insira um nome e pule o assistente

  • Nome: Insira um nome para identificar a atividade de Banco de Dados. O nome deve ser único para cada atividade de Consulta de Banco de Dados e não deve conter barras (/) ou dois pontos (:).

  • Selecionar Tabela(s): Pule esta seção, pois não é relevante para consultas manuais. Você especificará tabelas em sua instrução SQL.

  • Próximo: Este botão não deve estar habilitado, pois é aplicável apenas ao usar o assistente de Consulta de Banco de Dados (consulte Consulta de objeto único usando assistente ou Consulta de múltiplos objetos usando assistente).

  • Pular Assistente / Escrever Instrução SQL: Clique para continuar para a etapa de entrada de SQL.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Insira uma Instrução SQL

  • Escreva ou Cole a Instrução SQL: Insira a instrução de consulta SQL. Observe:

    • Use a sintaxe compatível com ANSI-SQL para o driver JDBC do seu banco de dados específico.

    • Há um limite de 2.000 caracteres para instruções SQL.

      Nota

      Uma solução alternativa para instruções SQL que excedem o limite de caracteres é criar visualizações de banco de dados.

    • Para usar variáveis, insira-as usando a sintaxe de colchetes descrita na documentação para variáveis globais, variáveis de projeto ou variáveis Jitterbit.

  • Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para habilitar o teste do script. Sem valores padrão, os testes podem falhar, pois as variáveis globais recebem valores apenas em tempo de execução. Existem exemplos de cláusulas WHERE nas páginas de como fazer que descrevem como se conectar a bancos de dados comumente usados.

  • Ao configurar uma instrução SQL em um script antes desta atividade, as variáveis podem ser concatenadas com outras strings para criar um SQL válido. Por exemplo, "SELECT * FROM " + $databaseName + ".Table". A string resultante pode ser armazenada em outra variável e aplicada diretamente a este campo usando as informações acima.

  • O uso de cláusulas ORDER BY em campos filhos também afeta os registros pai.

  • Você pode usar Funções Definidas pelo Usuário (UDF) dentro da instrução SQL usando a função <UDF>. Esta função permite usar qualquer função de banco de dados suportada pelo banco de dados de destino, como a função TO_DATE no Oracle, ou a função CONVERT() no SQL Server. Veja os detalhes em Funções de banco de dados.

  • Para usar caracteres especiais como + em nomes de tabelas, o nome da tabela deve estar entre colchetes ([ ]). Por exemplo, SELECT * FROM [Table+].

  • Teste de Consulta: Valida sua consulta. Se não for válida, mensagens de erro são exibidas. Se for válida, exibe até 20 registros de exemplo.

Etapa 3: Revisar o esquema de dados

  • Esquema de Dados: O esquema de dados de origem é exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

    Nota

    Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração da atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração para todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Consulta de Banco de Dados, você pode usá-la dentro de uma operação ou script, conforme descrito abaixo.

Completar a operação

Após configurar uma atividade de Consulta de Banco de Dados, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Conceitos básicos do conector.

Atividades de Consulta de Banco de Dados podem ser usadas como fonte com esses padrões de operação:

Outros padrões não são válidos usando atividades de Consulta de Banco de Dados. Veja os padrões de validação na página de Validade da operação.

Dentro de uma transformação, ao usar a opção de espelhar um esquema fornecida por uma atividade de Banco de Dados usando uma única tabela (sem junções), o esquema espelhado resultante é criado automaticamente com um nó adicional chamado row. Quando os campos dentro deste nó adicional são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam percorridos (veja Nódulos de loop em Estruturas de dados).

Além disso, ao juntar tabelas de banco de dados, observe que os valores dos campos unidos de uma tabela filha são definidos como os valores dos campos unidos da tabela pai. Os campos unidos de uma tabela filha não podem ser mapeados.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.

Usar atividades de Banco de Dados em scripts

Atividades de Consulta de Banco de Dados também podem ser referenciadas em um script para uso com funções de script que utilizam um databaseId como parâmetro, incluindo estas:

Funções de Script Jitterbit

  • CacheLookup
  • CallStoredProcedure
  • DBCloseConnection
  • DBExecute
  • DBLookup
  • DBLookupAll
  • DBRollbackTransaction

Funções Jitterbit em JavaScript

  • Jitterbit.DbExecute
  • Jitterbit.DbLookup

Para mais detalhes sobre como referenciar endpoints em scripts, veja Endpoints em Jitterbit Script ou Endpoints em JavaScript.

Usar chunking

Ao usar chunking em uma operação onde a fonte é uma atividade de Banco de Dados, os dados são divididos em partes na transformação, não quando os dados são recuperados. Os dados de destino são primeiro gravados em vários arquivos temporários (um para cada parte). Esses arquivos são então combinados em um único arquivo de destino.

Para instruções e melhores práticas sobre o uso de chunking, veja Opções de operação.