Ir para o conteúdo

Atividade de Consulta de Banco de Dados

Introdução

Uma Consulta de Banco de Dados consulta dados de um endpoint de Banco de Dados e destina-se a ser usada como uma fonte para fornecer dados para uma operação ou para ser chamada em um script. Depois de configurar uma conexão com o banco de dados, você pode configurar quantas atividades de banco de dados desejar para cada conexão com o banco de dados.

Crie uma Atividade de Banco de Dados

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

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada nestes locais:

Configurar uma Atividade de Consulta de Banco de Dados

As etapas para configurar uma atividade de consulta de banco de dados diferem dependendo do caso de uso e se você já conhece a instrução SQL:

  • Consulta de objeto único usando assistente: siga estas etapas para consultar apenas um único objeto sem junções quando a instrução SQL for desconhecida.
  • Consulta de múltiplos objetos usando assistente: siga estas etapas para consultar vários objetos com junções quando a instrução SQL for desconhecida.
  • Consulta Manual: siga estas etapas para consultar um ou vários objetos fornecendo manualmente uma instrução SQL. Esta opção está disponível apenas com conexões de banco de dados usando um driver JDBC e não está disponível para aquelas configuradas usando ODBC.

Consulta de Objeto Único Usando Assistente

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

Etapa 1: Insira um Nome e Selecione um Objeto

atividade de consultar de banco de dados 1 único objeto

  • Nome: Insira um nome a ser usado para identificar a atividade do banco de dados. O nome deve ser exclusivo 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 quaisquer filtros aplicados, após usar o ícone de atualização ícone de atualização para o carregamento inicial de objetos. Se houver muitos objetos no banco de dados, você poderá filtrar os objetos usando Visualizar ou Pesquisar antes da atualização. Se a busca 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 uma das "Tabelas, Visualizações", "Tabelas", "Visualizações" ou "Tabelas do Sistema". Por padrão, a visualização "Tabelas, Visualizações" é mostrada.
    • Pesquisar: Insira qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas. A lista de objetos pode ser filtrada automaticamente ou pode ser necessário atualizá-la, dependendo se os objetos já foram recuperados:

      • Se estiver pesquisando objetos que já foram recuperados do banco de dados e já aparecem na lista, quaisquer termos de pesquisa digitados na caixa de pesquisa filtrarão 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 próximo à caixa de pesquisa para busque os objetos do banco de dados usando o filtro.

        Nota

        Para bancos de dados que não suportam pesquisa em objetos, como o Microsoft Access, nenhum resultado é retornado.

    • Atualizar: Clique no ícone de atualização ícone de atualização para carregar ou recarregar tabelas do endpoint do banco de dados. Isto deve ser usado para o carregamento inicial de quaisquer objetos. Além disso, também pode ser útil se você tiver adicionado recentemente objetos ao banco de dados ou se tiver 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: Marque 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 ver e selecionar a tabela no esquema correto.

    • Selecione 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 a aplicação de um filtro, a opção Conexão com banco de dados pode não ter sucesso. 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 ícone de exclusã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 ativado, clique para salvar a configuração desta etapa e feche 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/gravar instrução SQL: Se presente, não clique nas palavras Ignorar assistente/gravar instrução SQL. Isso fará com que todos os objetos selecionados nesta etapa sejam ignorados e, em vez disso, use uma instrução SQL na próxima etapa que substitui quaisquer seleções feitas aqui.

  • Descartar alterações: Após fazer as 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

atividade de consultar de banco de dados 2 objeto único

Dica

Campos com ícone de variável ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

  • Selecionar campos: Esta seção exibe campos para os objetos selecionados que estão disponíveis no endpoint do banco de dados. Os objetos selecionados na etapa anterior são mostrados em negrito.

    • Pesquisar: Insira qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.
    • 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 deseja incluir na consultar para que sejam adicionados automaticamente à instrução SQL à direita. A menos que use 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 consultar é 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. Para obter exemplos de cláusulas WHERE, consulte Informações específicas do banco de dados. Depois de adicionar uma cláusula WHERE, você deve primeiro testar a consultar usando o botão Test Query para ativar o botão Next.

    • 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
      + Adicionar
      - Subtrair
      * Multiplicar
      / Dividir
      % Módulo
      Bit a bit
      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
      \< Menos que
      >= Maior ou igual a
      \<= Menor ou igual a
      != Diferente de
      Composto
      Operador Descrição
      += Adicionar iguais
      -= Subtrair é igual a
      *= Multiplicar iguais
      /= Dividir é igual
      %= Módulo é igual a
      &= E bit a bit é igual a
      |*= OU bit a bit é igual a
      ^-= OR exclusivo bit a bit é igual a
      Lógico
      Operador Descrição
      TODOS TRUE se todos os valores da subconsulta atenderem à condição
      E TRUE se todas as condições separadas por AND forem TRUE
      QUALQUER TRUE se algum dos valores da subconsulta atender à condição
      ENTRE TRUE se o operando estiver dentro do intervalo de comparações
      EXISTE TRUE se a subconsulta retornar um ou mais registros
      DENTRO TRUE se o operando for igual a uma lista de expressões
      GOSTO TRUE se o operando corresponder a um padrão
      NÃO Exibe um registro se a(s) condição(ões) NÃO for VERDADEIRA
      OU TRUE se alguma das condições separadas por OR for TRUE
      ALGUNS TRUE se algum dos valores da subconsulta atender à condição
    • Valor: Insira o valor desejado para usar com as seleções suspensas.

      Dica

      Ao usar variáveis globais em uma cláusula WHERE, é recomendado especificar um valor padrão para que o teste do script seja possível. Caso contrário, como as variáveis globais obtêm seu valor em tempo de execução, a sintaxe poderá ser invalidada durante o teste se nenhum valor padrão for especificado.

    • Adicionar: Clique no anexo link para construir automaticamente a cláusula com base nas seleções suspensas e no valor inserido. A cláusula construída automaticamente aparece na caixa de texto inferior.

    Cuidado

    Se fornecer uma cláusula WHERE manualmente, você deverá inseri-la na sintaxe exigida pelo banco de dados. Você também pode incluir manualmente uma cláusula ORDER BY nesta seção. Usar ORDER BY em campos filho também afeta os registros pai.

    Dica

    Para adicionar diversas 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 dar conta das condições adicionais.

  • Consulta de teste: Clique neste botão para validar se a consultar é válida. Se a consultar não for válida, as mensagens de erro fornecerão detalhes adicionais. Se a consultar for válida, uma amostra de até 20 registros será exibida em uma tabela semelhante à mostrada abaixo:

    atividade de consultar de banco de dados 2 consultar de teste de objeto único

Etapa 3: Revise o Esquema de Dados

atividade de consultar de banco de dados 3 objeto único

  • 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 mapeamento da transformação, onde você pode mapear 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 novamente em cada etapa de configuração da atividade, 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 as 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 se estiver consultando vários objetos e criando junções entre eles. Se você precisar consultar um único objeto, consulte Consulta de objeto único usando o assistente, ou se você já conhece a instrução SQL e está usando um driver JDBC, consulte Consulta Manual.

Etapa 1: Insira um Nome e Selecione Objetos

atividade de consultar de banco de dados 1 objeto múltiplo

  • Nome: Insira um nome a ser usado para identificar a atividade do banco de dados. O nome deve ser exclusivo 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 quaisquer filtros aplicados, após usar o ícone ícone de atualização para o carregamento inicial de objetos. Se houver muitos objetos no banco de dados, você poderá filtrar os objetos usando Visualizar ou Pesquisar antes da atualização. Se a busca dos objetos expirar, mesmo depois de aplicar filtros, use uma instrução SQL manual.

    • Visualizar: Use o menu suspenso para filtrar a lista de objetos exibidos para uma das "Tabelas, Visualizações", "Tabelas", "Visualizações" ou "Tabelas do Sistema". Por padrão, a visualização "Tabelas, Visualizações" é mostrada.
    • Pesquisar: Insira qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas. A lista de objetos pode ser filtrada automaticamente ou pode ser necessário atualizá-la, dependendo se os objetos já foram recuperados:

      • Se estiver pesquisando objetos que já foram recuperados do banco de dados e já aparecem na lista, quaisquer termos de pesquisa digitados na caixa de pesquisa filtrarão 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 próximo à caixa de pesquisa para busque os objetos do banco de dados usando o filtro.

      Nota

      Para bancos de dados que não suportam pesquisa em objetos, como o Microsoft Access, nenhum resultado é retornado.

    • Atualizar: Clique no ícone de atualização ícone de atualização para carregar ou recarregar tabelas do endpoint do banco de dados. Isto deve ser usado para o carregamento inicial de quaisquer objetos. Além disso, também pode ser útil se você tiver adicionado recentemente objetos ao banco de dados ou se tiver 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: Marque 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 ver e selecionar a tabela no esquema correto.

    • Selecione 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, 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 a aplicação de um filtro, a opção Conexão com banco de dados pode não ter sucesso. 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 1 de múltiplos objetos do banco de dados

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

      • Pai: Em cada objeto filho sendo unido, use o menu suspenso para selecionar o nome do objeto que deve ser o pai. Isso é necessário para impor a integridade transacional de um objeto, bem como para derivar a(s) chave(s) de link para um objeto filho.

      • Tipo de junção: Em cada objeto filho sendo unido, um menu suspenso fica disponível depois que você atribui Chaves de link (abordado a seguir). Use o menu suspenso para definir o tipo de relacionamento entre os objetos selecionados:

        • Um ou mais: Este tipo de junção exige que cada registro pai tenha pelo menos 1 registro filho e possivelmente mais registros filhos.

        • Apenas um: Este tipo de junção requer que cada registro pai tenha 1 e apenas 1 registro filho.

        • Zero ou Mais: Este tipo de junção permite que cada registro pai tenha 0 ou mais registros filhos.

        • Zero ou Um: Este tipo de junção permite que cada registro pai tenha 0 registros filho ou apenas 1 registro filho.

      • Chaves de link: Em cada objeto filho sendo unido, quando um objeto é selecionado como Pai, um link vermelho Atribuir aparece neste campo. Clique em Atribuir para abrir uma janela separada onde você atribui as chaves de link:

        teclas de link de atribuição de banco de dados

        • Objeto pai: O objeto pai e a lista de campos são exibidos na coluna esquerda. Quaisquer campos usados como chaves primárias no banco de dados são indicados por um ícone de chave anexo. Se você tiver um grande número de campos, poderá usar a caixa de pesquisa para filtrar os campos por nome.

        • Objeto filho: O objeto filho e a lista de campos são exibidos na coluna da direita. Se você tiver um grande número de campos, poderá usar a caixa de pesquisa para filtrar os campos por nome.

        • Atribuir chave(s) de link: Para atribuir um campo como chave de link, arraste um campo do objeto pai à esquerda para um campo dentro do objeto filho à direita ou vice-versa. Para atribuir diversas chaves de link, repita esse processo conforme necessário.

        • Cancelar atribuição de chaves de link: Para cancelar a atribuição de chaves de link, clique em qualquer campo que já tenha sido vinculado. Os campos vinculados ficam desmarcados.

        • Recomeçar: Para limpar todas as chaves de link atribuídas, clique em Recomeçar localizado abaixo da lista pai à esquerda.

        • Concluir: Clique em Concluir para salvar as chaves de link atribuídas e fechar a janela. Em Chaves de link, você deverá ver agora o número de chaves de link atribuídas, nas quais você pode clicar para reabrir a janela de atribuição de chave de link. Além disso, o menu suspenso Tipo de junção fica disponível para você definir o tipo de relacionamento (cardinalidade) entre os objetos selecionados:

          tabela 2 de múltiplos objetos do banco de dados

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

      • Salvar e Sair: Se ativado, clique para salvar a configuração desta 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 Parent, 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.

      • Ignorar Assistente / Gravar Instrução SQL: Se presente, não clique nas palavras Ignorar Assistente / Gravar Instrução SQL. Isso fará com que todos os objetos selecionados nesta etapa sejam ignorados e, em vez disso, use uma instrução SQL na próxima etapa que substitui quaisquer seleções feitas aqui.

      • 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: Adicionar Condições

atividade de consultar de banco de dados 2 objeto múltiplo

Dica

Campos com ícone de variável ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

  • Fonte: Esta seção exibe campos para o objeto selecionado que estão disponíveis no endpoint do banco de dados. Se um campo for identificado pelo banco de dados como uma chave, esse campo deverá ser incluído.

    • Pesquisar: Insira qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos do objeto selecionado. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.
    • Selecionar tudo: Marque a caixa de seleção para selecionar todos os objetos e campos visíveis de uma vez (os objetos recolhidos não são selecionados). Este modo de seleção não estará disponível se seleções em nível de objeto estiverem em uso, mas estará disponível ao usar a caixa de pesquisa.
    • Selecionar campos: Marque as caixas de seleção dos campos que deseja incluir na consultar para que sejam adicionados automaticamente à instrução SQL à direita. Você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma só vez.
  • Tabela de Campos de Objetos: 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: Se desejar, insira uma condição na forma de argumento de uma cláusula WHERE; isto é, operador(es) seguido(s) de valor(es). Para obter exemplos de cláusulas WHERE, consulte Informações específicas do banco de dados.

      Cuidado

      Se fornecer uma cláusula WHERE manualmente, você deverá inseri-la na sintaxe exigida pelo banco de dados.

      Dica

      Ao usar variáveis globais em uma cláusula WHERE, é recomendado especificar um valor padrão para que o teste do script seja possível. Caso contrário, como as variáveis globais obtêm seu valor em tempo de execução, a sintaxe poderá ser invalidada durante o teste se nenhum valor padrão for especificado.

    • Classificar: Se desejar, use o menu suspenso para selecionar Nenhum, Crescente ou Decrescente para aplicar uma ordem de classificação. Selecionar a opção Nenhum equivale a deixar este campo em branco.

      Cuidado

      Usar ORDER BY em campos filhos também afeta os registros pais.

  • 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 as 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: Revise o Esquema de Dados

atividade de consultar de banco de dados 3 vários objetos

  • 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 mapeamento da transformação, onde você pode mapear 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 novamente em cada etapa de configuração da atividade, 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 as 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ê conhece a instrução SQL da consultar e deseja fornecê-la manualmente. Esta opção está disponível apenas com conexões de banco de dados usando um driver JDBC e não está disponível para aquelas configuradas usando ODBC. Se você ainda não conhece a instrução ou se a conexão usa ODBC, siga Single-Object Query Using Wizard ou Consulta de múltiplos objetos usando o assistente acima.

Etapa 1: Insira um Nome e Ignore o Assistente

atividade de consultar de banco de dados 1 consultar manual

  • Nome: Insira um nome a ser usado para identificar a atividade do banco de dados. O nome deve ser exclusivo para cada atividade de consulta de banco de dados e não deve conter barras (/) ou dois pontos (:).

  • Selecione Tabela(s): Não use esta seção, pois ela não é relevante para consultas manuais. Esta seção é aplicável somente ao usar o assistente de consulta de banco de dados (consulte Consulta de objeto único usando o assistente ou Consulta de múltiplos objetos usando o assistente). Em vez disso, você especificará as tabelas (se houver alguma necessária) ao inserir a instrução SQL na próxima etapa.

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

  • Próximo: Este botão não deve ser habilitado, pois é aplicável somente ao usar o assistente de consulta de banco de dados (consulte Consulta de objeto único usando assistente ou Consulta de múltiplos objetos usando o assistente).

  • Ignorar assistente/gravar instrução SQL: Clique em Ignorar assistente/gravar instrução SQL para continuar na próxima etapa no fornecimento da instrução SQL manual.

    Aviso

    Se você selecionou alguma mesa, suas seleções serão perdidas.

  • Descartar alterações: Após fazer as 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

atividade de consultar de banco de dados 2 consultar manual

  • Escrever ou colar instrução SQL: Insira a instrução de consultar SQL na caixa de texto. Observação:

    • Todas as instruções SQL devem ser compatíveis com ANSI-SQL para o driver ODBC ou JDBC do banco de dados que você está acessando.

    • Há um limite de 2.000 caracteres para a instrução 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 para variáveis globais, variáveis do projeto ou variáveis Jitterbit.

    • Ao usar variáveis globais em uma cláusula WHERE, recomendamos especificar um valor padrão para que o teste do script seja possível. Caso contrário, como as variáveis globais obtêm seu valor em tempo de execução, a sintaxe poderá ser invalidada durante o teste se nenhum valor padrão for especificado. Para obter exemplos de cláusulas WHERE, consulte Informações específicas do banco de dados.

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

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

  • Consulta de Teste: Clique neste botão para validar se a consultar é válida. Se a consultar não for válida, as mensagens de erro fornecerão detalhes adicionais. Se a consultar for válida, uma amostra de até 20 registros será exibida em uma tabela semelhante à mostrada abaixo:

    atividade de consultar de banco de dados 2 consultar de teste de objeto único

Etapa 3: Revise o Esquema de Dados

atividade de consultar de banco de dados 3 consultar manual

  • 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 mapeamento da transformação, onde você pode mapear 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 novamente em cada etapa de configuração da atividade, 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 as 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óximos Passos

Depois de configurar uma atividade de Consulta de Banco de Dados, você poderá usá-la em uma operação ou script conforme descrito abaixo. Além disso, se você estiver atingindo limites de registro impostos pelo destino, talvez queira usar fragmentação de dados.

Conclua 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, transformações ou scripts como etapas de operação. Você também pode definir as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade de consulta de banco de dados for criada, as ações de menu para essa atividade estarão acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte Menu Ações de Atividade para detalhes.

As atividades de consulta de banco de dados podem ser usadas como origem com estes 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 Validade da Operação página.

Dentro de uma transformação, se estiver usando a opção para espelhar um esquema fornecido por uma atividade de banco de dados usando uma única tabela (sem junções), o esquema espelhado resultante é criado automaticamente com um nó adicional denominado 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 repetidos (consulte Nós de Loop em Nós e Campos).

Além disso, ao unir tabelas de banco de dados, observe que os valores dos campos associados de uma tabela filho são padronizados como os valores dos campos associados da tabela pai. Os campos associados de uma tabela filho não podem ser mapeados.

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

Usando Atividades de Banco de Dados em Scripts

As atividades de consulta 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 estes:

Funções de Jitterbit Script

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

Funções JavaScript Jitterbit

  • Jitterbit.DbExecute
  • Jitterbit.DbLookup

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

Usar Fragmentação

Ao usar a fragmentação de dados em uma operação em que a origem é uma atividade de banco de dados, os dados são fragmentados na transformação, e 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 bloco). Esses arquivos são então combinados em um arquivo de destino.

Para obter instruções e práticas recomendadas sobre o uso de fragmentação de dados, consulte Opções de operação.