Partilhar via

Transforme dados com uma atividade ForEach

  • Artigo

A atividade ForEach define um fluxo de controle repetitivo em um pipeline do Microsoft Fabric. Esta atividade é usada para iterar sobre uma coleção e executar atividades especificadas em um loop. A implementação de ciclo desta atividade é semelhante a uma estrutura de repetição ForEach em linguagens de programação.

Insira uma atividade ForEach num pipeline

Esta seção descreve como usar uma atividade ForEach em um pipeline.

Pré-requisitos

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

Criação da atividade

  1. Crie um novo pipeline em seu espaço de trabalho.

  2. Pesquise ForEach no pipeline painel Atividades e selecione-o para adicioná-lo à tela do pipeline. Se você não conseguir vê-lo inicialmente, use a seta no lado direito da barra de ferramentas de atividades para rolar para a direita e localizá-lo.

    Captura de tela da interface do usuário do Fabric com o painel Atividades e a atividade ForEach realçados.

  3. Selecione a nova atividade ForEach na tela, se ainda não estiver selecionada.

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

  4. Na guia Geral na parte inferior da tela, insira um nome para a atividade na propriedade Name.

  5. (Opcional) Você também pode inserir uma descrição.

Configurações ForEach

Selecione o separador Definições, onde pode especificar se o processamento dos itens do lote deve ser sequencial (ou, caso contrário, em paralelo). Você também pode especificar um número máximo de itens para processar simultaneamente com a opção de "Contagem de Lotes" . Finalmente, você deve especificar uma lista de itens delimitados por vírgulas , que podem ser parametrizados ou incluir conteúdo dinâmico. Adicione alguns itens à lista Itens, conforme mostrado no exemplo.

Captura de tela mostrando a guia Configurações do ForEach com vários itens adicionados à lista Itens.

Atividades ForEach

Você também define atividade(s) para cada item da lista, no painel de Atividades ForEach .

Captura de tela mostrando o painel de atividades ForEach.

Selecione o botão + para adicionar uma nova atividade ao painel. Você verá uma lista de atividades para escolher. Você pode adicionar várias atividades à atividade ForEach, e cada uma é executada em todos os itens na lista de Itens. Independentemente de a opção Sequencial estar selecionada nas configurações ForEach ou não, cada uma das atividades filhas no painel de atividades ForEach é processada sequencialmente uma após a outra para cada item. No entanto, se Sequencial não for selecionado, vários itens serão processados em paralelo, cada um deles sendo executado sequencialmente através da lista de atividades filho especificadas.

Captura de tela mostrando uma atividade ForEach com várias atividades infantis especificadas e o botão + realçado mostrando uma lista de atividades infantis para escolher ao adicionar novas atividades ao painel.

Referenciando um item dentro de uma atividade

Selecione uma das atividades filhas no painel de Atividades do ForEach , e alterne para o separador Configurações . Neste exemplo, foi selecionada uma atividade de Procedimento Armazenado . Preencha as configurações da atividade como faria normalmente ao selecionar uma conexão e um procedimento armazenado. Você pode usar o iterador @item() para se referir ao item atual que está sendo processado em qualquer lugar dentro de uma atividade que ofereça suporte a conteúdo dinâmico. Aqui, @item() foi usado como o valor para o parâmetro FruitName que é passado para um procedimento armazenado.

Captura de ecrã mostrando uma atividade subordinada de procedimento armazenado com um parâmetro que utiliza o @item() atual da lista de itens ForEach para o seu valor.

Conteúdo relacionado