Ir para o conteúdo

Atividade Database Query no Jitterbit Studio

Introdução

Uma atividade Database Query, usando sua conexão Database, consulta dados de um endpoint Database e é destinada a ser usada como uma fonte para fornecer dados em uma operação.

Criar uma atividade Database Query

Uma instância de uma atividade Database Query é criada a partir de uma conexão Database usando seu tipo de atividade Query.

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 detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade Database Query existente pode ser editada a partir destes locais:

Configurar uma atividade Database Query

Siga as etapas em uma destas seções para configurar uma atividade Database Query:

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 nenhuma junção com outros objetos. Se precisar juntar múltiplos objetos, consulte Consulta de múltiplos objetos usando assistente, ou se já conhecer a instrução SQL e estiver usando um driver JDBC, consulte Consulta manual.

Etapa 1: Inserir um nome e selecionar um objeto

  • Menu de endpoint: Se você tiver múltiplos endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado no momento.

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

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

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

  • Pesquisa: Digite 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 pesquisar objetos que já foram recuperados do banco de dados e já aparecem na lista, qualquer termo de pesquisa digitado na caixa de pesquisa filtra automaticamente a lista.

    • Se pesquisar 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.

      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 endpoint do Banco de Dados. Isso deve ser usado para o carregamento inicial de qualquer objeto. Além disso, também pode ser útil se você adicionou recentemente objetos ao banco de dados ou se tem critérios de pesquisa adicionais que deseja aplicar antes de recuperar objetos do banco de dados.

  • Incluir o schema/proprietário nos nomes das tabelas: Marque esta caixa de seleção para incluir o schema nos nomes das tabelas. Isso pode ser útil se você usar o mesmo nome de tabela em múltiplos schemas (como para desenvolvimento e produção) para permitir que você veja e selecione a tabela no schema 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ê está consultando múltiplos objetos que precisam ser unidos, consulte Consulta de múltiplos objetos usando assistente.

    Dica

    Se a lista não for preenchida com objetos disponíveis mesmo após aplicar um filtro, a Conexão com banco de dados pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente 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 objeto único 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ê está consultando múltiplos objetos que precisam ser unidos, consulte Consulta de múltiplos objetos usando assistente.

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

  • Próximo: Clique para armazenar temporariamente a configuração desta 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.

  • Ignorar Assistente / Escrever Instrução SQL: Mude para escrever manualmente uma instrução SQL personalizada.

    Nota

    Salvar uma instruçã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 nenhuma etapa. Uma mensagem solicita que você confirme 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 de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

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

    • Pesquisar: Digite 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 digitação.

    • Selecionar Tudo: 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 recolhidos não são selecionados).

    • Selecionar Campos: Marque as caixas de seleção dos campos que você deseja incluir na consulta para adicioná-los automaticamente à instruçã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.

  • Instrução SQL: A instrução de consulta é preenchida automaticamente com o objeto e qualquer campo selecionado à 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 a cláusula manualmente na caixa de texto inferior. Existem exemplos de cláusulas WHERE nas páginas de instruções descrevendo 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 ativar 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ética
      Operador Descrição
      + Adição
      - Subtração
      * Multiplicação
      / Divisão
      % Módulo
      Bit a Bit
      Operador Descrição
      & AND bit a bit
      | OR bit a bit
      ^ XOR bit a bit (OR exclusivo)
      Comparação
      Operador Descrição
      = Igual a
      > Maior que
      \< Menor que
      >= Maior que ou igual a
      \<= Menor que ou igual a
      != Não igual a
      Composto
      Operador Descrição
      += Adição com atribuição
      -= Subtração com atribuição
      *= Multiplicação com atribuição
      /= Divisão com atribuição
      %= Módulo com atribuição
      &= AND bit a bit com atribuição
      |*= OR bit a bit com atribuição
      ^-= XOR bit a bit com atribuição
Lógico
Operador Descrição
ALL VERDADEIRO se todos os valores da subconsulta atenderem à condição
AND VERDADEIRO se todas as condições separadas por AND forem VERDADEIRAS
ANY VERDADEIRO se algum dos valores da subconsulta atender à condição
BETWEEN VERDADEIRO se o operando estiver dentro do intervalo de comparações
EXISTS VERDADEIRO se a subconsulta retornar um ou mais registros
IN VERDADEIRO se o operando for igual a uma das expressões da lista
LIKE VERDADEIRO se o operando corresponder a um padrão
NOT Exibe um registro se a(s) condição(ões) NÃO for VERDADEIRA
OR VERDADEIRO se alguma das condições separadas por OR for VERDADEIRA
SOME VERDADEIRO se algum dos valores da subconsulta atender à condição

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

    Dica

    Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para permitir testes de script. Sem valores padrão, os testes podem falhar, pois as variáveis globais recebem valores apenas em tempo de execução.

  • Adicionar: Cria a cláusula a partir das 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 várias 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 levar em conta as condições adicionais.

  • Testar 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 amostra.

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 posteriormente 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 muito mais.

    Nota

    Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração de atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere no 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 de atividade.

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

Consulta de múltiplos objetos usando 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 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): Esta seção exibe as tabelas disponíveis no endpoint do Banco de Dados usando filtros aplicados, após usar o ícone de atualização para o carregamento inicial de objetos. Se houver muitos objetos no banco de dados, você pode filtrar os objetos usando Visualizar ou Pesquisar antes de atualizar. Se a busca dos objetos expirar, mesmo após aplicar 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" é exibida.

    • Pesquisar: Digite 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 se os objetos já foram recuperados:

      • Se pesquisar em objetos que já foram recuperados do banco de dados e já aparecem na lista, qualquer termo de pesquisa digitado na caixa de pesquisa filtra automaticamente a lista.

      • Se pesquisar 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.

        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 endpoint do Banco de Dados. Isso deve ser usado para o carregamento inicial de qualquer objeto. Além disso, também pode ser útil se você adicionou recentemente objetos ao banco de dados ou se tem critérios de pesquisa adicionais que deseja aplicar antes de recuperar objetos do banco de dados.

    • Incluir o schema/proprietário nos nomes das tabelas: Marque esta caixa de seleção para incluir o schema nos nomes das tabelas. Isso pode ser útil se você usar o mesmo nome de tabela em vários schemas (como para desenvolvimento e produção) para permitir que você veja e selecione a tabela no schema 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 do sistema pode ser selecionada. Se, em vez disso, você precisar consultar um único objeto sem junções, consulte 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 do Banco de Dados pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente 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 do sistema.

        Dica

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

      • Pai: Para cada objeto filho sendo unido, selecione seu objeto pai. Isso estabelece a hierarquia de relacionamento e ajuda a derivar as chaves de ligação.

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

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

        • Um Apenas: 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 Ligação: Para cada objeto filho com um Pai selecionado, clique no link Atribuir em vermelho para configurar relacionamentos de chave:

  • Chaves de Link: Em cada objeto filho sendo unido, uma vez que um objeto é selecionado como Pai, um link Atribuir vermelho aparece neste 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.

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

    • Concluir: Salva suas chaves de link e exibe a contagem na coluna Chaves de Link. O menu suspenso Tipo de Junção fica disponível.

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

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

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. Este botão não será habilitado até que você tenha especificado qualquer objeto Pai, definido o Tipo de Junção e atribuído as 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 Instrução SQL: Mude para escrever manualmente uma instrução SQL personalizada.

    Nota

    Salvar uma instruçã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 nenhuma etapa. Uma mensagem pede que você confirme que deseja descartar as alterações.

Etapa 2: Adicionar condições

Dica

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

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

    • Pesquisa: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos do objeto selecionado. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada digitação.

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

    • Selecionar campos: Marque as caixas de seleção dos campos que deseja incluir na consulta para adicioná-los automaticamente à instruçã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 classificação:

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

      Cuidado

      Se fornecer uma cláusula WHERE manualmente, você deve digitá-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 permitir testes de script. Sem valores padrão, os testes podem falhar, pois as variáveis globais recebem valores apenas em tempo de execução.

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

    Cuidado

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

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

  • Próximo: Clique para armazenar temporariamente a configuração desta 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 nenhuma etapa. Uma mensagem solicita que você confirme 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 muito mais.

    Nota

    Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração de atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere no 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 de atividade.

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

Consulta manual

Siga estas etapas se você conhecer 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 ignore 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): Ignore esta seção, pois não é relevante para consultas manuais. Você especificará as tabelas em sua instrução SQL.

  • Próximo: Este botão não deve estar ativado, 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).

  • Ignorar 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 nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Insira uma instrução SQL

  • Escrever ou colar instrução SQL: Insira a instrução de consulta SQL. Observação:

    • Use 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 a limitação de caracteres é criar visualizações de banco de dados.

    • Para usar variáveis, insira-as usando a sintaxe de colchetes descrita na documentação de 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 usando a sintaxe inline (por exemplo, [customer_id{123}]) para permitir o teste de script. Sem valores padrão, o teste pode falhar, pois as variáveis globais recebem valores apenas em tempo de execução. Há exemplos de cláusulas WHERE nas páginas de instruções descrevendo como conectar a bancos de dados comumente usados.

  • Ao configurar uma instrução SQL em um script anterior a esta atividade, variáveis podem ser concatenadas com outras strings para criar SQL válido. Por exemplo, "SELECT * FROM " + $databaseName + ".Table". A string resultante pode então 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.

  • É possível 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. Consulte 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+].

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

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 é possível mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e muito mais.

    Nota

    Para atualizar um esquema de dados em uma atividade existente, é necessário avançar por cada etapa de configuração de atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere no 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 de atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma 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, é possível usá-la em uma operação ou script conforme descrito abaixo.

Concluir a operação

Após configurar uma atividade de Consulta de Banco de Dados, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas de operação. Também é possível configurar as definições de operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos de trabalho diferentes.

As ações de menu de uma atividade são acessíveis no painel do projeto e na tela de design. Para detalhes, consulte Menu de ações de atividade em Noções básicas do conector.

As atividades de Consulta de Banco de Dados podem ser usadas como uma origem com estes padrões de operação:

Outros padrões não são válidos ao usar atividades de Query de banco de dados. Consulte os padrões de validação na página Validade da operação.

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

Além disso, ao fazer join de tabelas de banco de dados, observe que os valores dos campos unidos de uma tabela filha assumem como padrão 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

As atividades de Query de banco de dados também podem ser referenciadas em um script para uso com funções de script que usam um databaseId como parâmetro, incluindo estas:

Funções Jitterbit Script

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

Funções Jitterbit JavaScript

  • Jitterbit.DbExecute
  • Jitterbit.DbLookup

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

Usar chunking

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

Para instruções e práticas recomendadas sobre como usar chunking, consulte Opções de operação.