Usar a atividade Pesquisa para pesquisar dados de uma fonte de dados

A atividade de pesquisa pode recuperar um conjunto de dados de qualquer uma das fontes de dados com suporte dos pipelines do data factory e do Synapse. Você pode usá-la para determinar dinamicamente em quais objetos operar em uma atividade subsequente, em vez de embutir o nome do objeto. Alguns exemplos de objeto são arquivos e tabelas.

A atividade Lookup lê e retorna o conteúdo de um arquivo de configuração ou tabela. Ela também retorna o resultado da execução de uma consulta ou procedimento armazenado. A saída pode ser um valor singleton ou uma matriz de atributos, que pode ser consumida em uma cópia subsequente, uma transformação ou em atividades de fluxo de controle, como a atividade ForEach.

Pré-requisitos

Para começar, você deve concluir os seguintes pré-requisitos:

Adicionar uma atividade do Spark a um pipeline com a interface do usuário

Para usar uma atividade de pesquisa em um pipeline, conclua as seguintes etapas:

Criando a atividade

  1. Crie um pipeline no seu workspace.

  2. Procure por Pesquisa no painel Atividades do pipeline e arraste uma atividade de Pesquisa para a tela do pipeline.

    Captura de tela da IU do Fabric com o painel Activities e a atividade Lookup realçados.

  3. Selecione a nova atividade de Pesquisa na tela se ela ainda não estiver selecionada.

    Captura de tela mostrando a guia Configurações gerais da atividade de Pesquisa.

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Configurações da pesquisa

Selecione a guia Configurações , selecione uma conexão existente no menu suspenso Conexão ou crie uma nova conexão e especifique seus detalhes de configuração.

Captura de tela mostrando a guia Configurações da atividade de pesquisa destacando a guia e onde escolher uma nova conexão.

O exemplo na imagem anterior mostra uma conexão de armazenamento de blobs, mas cada tipo de conexão tem seus próprios detalhes de configuração específicos para a fonte de dados selecionada.

Funcionalidades com suporte

  • A atividade de pesquisa pode retornar até 5.000 linhas; se o conjunto de resultados contiver mais registros, as primeiras 5.000 linhas serão retornadas.
  • A saída da atividade de Pesquisa aceita até 4 MB de tamanho, a atividade falhará se o tamanho exceder o limite.
  • A maior duração da atividade de Pesquisa antes de atingir o tempo limite é de 24 horas.

Observação

Quando você usa a consulta ou o procedimento armazenado para pesquisar dados, retorne um conjunto de resultados e um exato. Caso contrário, a atividade de Pesquisa falhará.

O Fabric é compatível com os armazenamentos de dados listados no artigo Visão geral do Conector . Dados de qualquer fonte podem ser usados.

Salvar e executar ou agendar o pipeline

Alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar para salvar o pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode exibir o histórico de execuções aqui ou definir outras configurações.

Captura de tela mostrando a guia Início no editor de pipeline com o nome da guia e os botões Salvar, Executar e Agendar realçados.