Atividade de consulta de banco de dados

Introdução

Uma atividade de Consulta ao Banco de Dados, usando sua Conexão ao Banco de Dados, consulta dados de um endpoint do banco de dados e deve ser usado como uma fonte para fornecer dados em uma operação.

Criar uma atividade de consulta de banco de dados

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

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

Uma atividade de Consulta de banco de dados existente pode ser editada nestes locais:

• A quadro de design (veja menu de ações do componente em Tela de design).

• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

Configurar uma atividade de consulta de banco de dados

Siga as etapas em uma destas seções para configurar uma atividade de Consulta do Banco de Dados:

• consultar de objeto único usando assistente: Para uma consultar de objeto único sem junções.

• consultar de múltiplos objetos usando assistente: Para vários objetos com junções.

• consultar manual: Para fornecer uma instrução SQL manualmente (somente em conexões JDBC).

Consultar 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 precisar unir vários objetos, consulte consultar de vários objetos usando o assistente, ou se você já conhece a instrução SQL e está usando um driver JDBC, consulte consultar manual.

• Etapa 1: Digite um nome e selecione um objeto

• Etapa 2: Adicionar condições

• Etapa 3: Revise o esquema de dados

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 ao 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 de objetos. Se houver muitos objetos no banco de dados, você pode filtrá-los usando Exibir ou Pesquisar antes da atualização. Se a busca de objetos expirar mesmo após a aplicação dos filtros, use uma instrução SQL manual.

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

  • Pesquisa: 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 atualizá-la, dependendo se os objetos já foram recuperados:

    • Ao pesquisar por 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 a lista automaticamente.

    • Se estiver pesquisando por 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 o Microsoft Access não oferecem suporte à 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. Este ícone deve ser usado para o carregamento inicial de quaisquer objetos. Além disso, também pode ser útil se você adicionou objetos recentemente 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 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 estiver consultando vários objetos que precisam ser unidos, consulte consultar de vários 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 Conexão com o banco de dados pode não ser bem-sucedido. Certifique-se de estar conectado reabrindo a conexão e testando as credenciais novamente.

  • 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 botão ícone de remoção). Se estiver consultando vários objetos que precisam ser unidos, consulte consultar de vários objetos usando o 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 prosseguir para a próxima. 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: Alternar para manualmente escrevendo uma instrução SQL personalizada.

  Nota

  Salvar uma instrução SQL personalizada substitui qualquer consultar do assistente salva anteriormente.

• 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 solicitará que você confirme se deseja descartar as alterações.

Etapa 2: adicionar condições

• Selecionar Campos: Esta seção exibe os 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 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 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 só 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 esteja usando a caixa de pesquisa, você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma só vez.

• Instrução SQL: A instrução de consultar é preenchida automaticamente com o objeto e todos os 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 a cláusula manualmente na caixa de texto inferior. Há exemplos de cláusulas WHERE nas páginas de tutorial descrevendo como se conectar a bancos de dados comumente usados. Após adicionar uma cláusula WHERE, você deve primeiro testar a consultar usando o botão Testar Consulta para habilitar o botão Avançar.

  • 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
    \<	Menor que
    >=	Maior ou igual a
    \<=	Menor ou igual a
    !=	Diferente de

    Composto
    Operador	Descrição
    +=	Adicionar iguais
    -=	Subtrair é igual a
    *=	Multiplicar é igual a
    /=	Dividir é igual a
    %=	Módulo é igual a
    &=	AND bit a bit é igual a
    |*=	OU bit a bit é igual a
    ^-=	OU exclusivo bit a bit é igual a

    Lógico
    Operador	Descrição
    ALL	TRUE se todos os valores da subconsulta atenderem à condição
    E	VERDADEIRO se todas as condições separadas por E forem VERDADEIRAS
    QUALQUER	VERDADEIRO se algum dos valores da subconsulta atender à condição
    BETWEEN	TRUE se o operando estiver dentro do intervalo de comparações
    EXISTS	TRUE se a subconsulta retornar um ou mais registros
    IN	TRUE se o operando for igual a uma de uma lista de expressões
    LIKE	TRUE se o operando corresponder a um padrão
    NÃO	Exibe um registro se a(s) condição(ões) NÃO FOR(EM) VERDADEIRA(S)
    OU	VERDADEIRO se qualquer uma das condições separadas por OU for VERDADEIRA
    SOME	TRUE se algum dos valores da subconsulta atender à condição

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

    Dica

    Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para habilitar o teste de 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, o que afetará os registros filho e pai.

  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 contabilizar as condições adicionais.

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

  

Etapa 3: Revise o esquema de dados

• Esquema de Dados: O esquema de dados de origem é exibido. Se a operação utilizar 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 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Consultar de múltiplos objetos usando assistente

Siga estas etapas para consultar vários objetos com junções:

• Etapa 1: Digite um nome e selecione os objetos

• Etapa 2: Adicionar condições

• Etapa 3: Revise o esquema de dados

Etapa 1: insira um nome e selecione os objetos

• Nome: Insira um nome para identificar a atividade do Banco de Dados. O nome deve ser exclusivo para cada atividade de Consulta ao 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 de objetos. Se houver muitos objetos no banco de dados, você pode filtrá-los usando Exibir ou Pesquisar antes da atualização. Se a busca dos objetos expirar, mesmo após a aplicação dos filtros, use uma instrução SQL manual.

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

  • Pesquisa: 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 atualizá-la, dependendo se os objetos já foram recuperados:

    • Ao pesquisar por 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 a lista automaticamente.

    • Se estiver pesquisando por 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 o Microsoft Access não oferecem suporte à 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. Este ícone deve ser usado para o carregamento inicial de quaisquer objetos. Além disso, também pode ser útil se você adicionou objetos recentemente 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 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 por 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 consultar de objeto único 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 Conexão com o banco de dados pode não ser bem-sucedido. Certifique-se de estar conectado reabrindo a conexão e testando as credenciais novamente.

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

      !!! tip "Dica" Tabelas com caracteres especiais, como + em seus nomes exigem uma consultar manual. O nome da tabela deve ser colocado entre colchetes por exemplo, SELECT * FROM [table+].

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

    • Tipo de Uniã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.

      • 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 Vinculação: Para cada objeto filho com um Pai selecionado, clique no link vermelho Atribuir para configurar os relacionamentos de chaves:

    • Chaves de Vinculação: Em cada objeto filho que está sendo unido, assim que 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:

      

      • 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 os campos, se necessário.

      • Objeto filho: Exibe o objeto filho e seus campos à direita. Use a caixa de pesquisa para filtrar os 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 o processo para várias 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 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 Remover ícone.

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

    • Avançar: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. Este botão não será habilitado até que você especifique quaisquer objetos Pai, defina o Tipo de Junção e atribua Chaves de Link. 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: Alternar para manualmente escrevendo uma instrução SQL personalizada.

      Nota

      Salvar uma instrução SQL personalizada substitui qualquer consultar do assistente salva anteriormente.

    • 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 solicitará que você confirme se deseja descartar as alterações.

Etapa 2: adicionar condições

• 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 do objeto selecionado. A pesquisa 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 só vez (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 classificação:

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

    Cuidado

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

    Dica

    Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para habilitar o teste de 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 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.

• Avançar: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. 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 solicitará que você confirme se deseja descartar as alterações.

Etapa 3: Revise o esquema de dados

• Esquema de Dados: O esquema de dados de origem é exibido. Se a operação utilizar 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 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Consultar manual

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

• Etapa 1: insira um nome e pule o assistente

• Etapa 2: Insira uma instrução SQL

• Etapa 3: Revise o esquema de dados

Etapa 1: insira um nome e pule o assistente

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

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

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

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

• 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 solicitará que você confirme se deseja descartar as alterações.

Etapa 2: Insira uma instrução SQL

• Escrever ou Colar Instrução SQL: Insira a instrução de consultar SQL. Observação:

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

  • 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 do projeto, ou variáveis Jitterbit.

  • Ao usar variáveis globais em uma cláusula WHERE, especifique um valor padrão para habilitar o teste de script. Sem valores padrão, o teste pode falhar, pois as variáveis globais só recebem valores em tempo de execução. Há exemplos de cláusulas WHERE nas páginas de tutorial descrevendo como se conectar a bancos de dados comumente usados.

  • Ao configurar uma instrução SQL em um script acima na cadeia a esta 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 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 pais.

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

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

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

  

Etapa 3: Revise o esquema de dados

• Esquema de Dados: O esquema de dados de origem é exibido. Se a operação utilizar 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 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Próximos passos

Depois de configurar uma atividade de Consulta no Banco de Dados, você pode usá-la em uma operação ou script, conforme descrito abaixo.

Concluir a operação

Após configurar uma atividade de Consulta ao Banco de Dados, conclua 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 estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte menu de ações da atividade em Noções básicas do conector.

As atividades de Consulta do banco de dados podem ser usadas como uma fonte com estes padrões de operação:

• Padrão de Transformação
• Padrão de arquivamento de dois alvos (apenas como primeira fonte)
• Padrão de arquivo HTTP de dois alvos (apenas como primeira fonte)
• Padrão de duas transformações (apenas como primeira fonte)

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

Dentro de uma transformação, se usar 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 percorridos (consulte Nós de loop em Estruturas de dados).

Além disso, ao unir tabelas de banco de dados, observe que os valores dos campos unidos de uma tabela filha são, por 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, implantar e executar a operação e validar o comportamento verificando os logs de operação.

Use atividades de banco de dados em scripts

As atividades de Consulta do 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 Jitterbit JavaScript

• Jitterbit.DbExecute
• Jitterbit.DbLookup

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

Use fragmentação de dados

Ao usar a fragmentação de dados em uma operação cuja origem é uma atividade de Banco de Dados, os dados são fragmentados na transformação, não quando são recuperados. Os dados de destino são primeiro gravados em vários arquivos temporários (um para cada fragmento). 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.