Compartilhar via


Use a atividade Switch para ramificar condicionalmente a execução em um pipeline

A atividade Switch no Microsoft Fabric fornece a mesma funcionalidade que uma instrução switch fornece em linguagens de programação. Ele avalia um conjunto de atividades correspondentes a um caso que corresponde à avaliação da condição.

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 Switch em um pipeline, conclua as seguintes etapas:

Criando a atividade

  1. Crie um pipeline no seu workspace.

  2. Pesquise a atividade Switch na barra de ferramentas Atividades do pipeline e selecione-a para adicioná-la à tela do pipeline. Talvez seja necessário expandir a lista de atividades usando o botão +, pois há mais atividades disponíveis do que normalmente cabem no espaço da barra de ferramentas.

    Screenshot of the Fabric UI with the Activities pane and Switch activity highlighted.

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

    Screenshot showing the General settings tab of the Switch activity.

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

Configurações de atividades

Selecione a guia de Atividades e você verá o caso Padrão já adicionado à lista de casos.

A cláusula Expressão é onde você fornece uma expressão a ser avaliada e comparada com as opções Caso e dá suporte a conteúdo dinâmico que permite usar parâmetros, variáveis de sistema, funções e variáveis locais do seu projeto para comparar com os vários casos.

Você pode usar o ícone de lápis à direita de cada caso na guia de Atividades para configurar as atividades que serão executadas quando esse caso corresponder à Expressão. Você pode usar o botão + Adicionar caso para adicionar novos casos além do padrão que é executado se nenhum outro caso corresponder ao resultado da Expressão. Você também pode adicionar casos e atividades diretamente na interface de atividade Switch na própria tela do pipeline selecionando o botão + para adicionar um caso ou o ícone de lápis ao lado dos casos listados para configurar atividades para cada caso.

Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

Configurando atividades de caso

Ao editar as atividades de um caso selecionando o ícone de lápis ao lado dele, no painel de configurações de Atividades ou diretamente na interface de atividade Switch na tela do pipeline, você verá o editor de atividades do caso. Isso é semelhante ao editor de pipeline, mas específico para o caso selecionado. Você pode adicionar qualquer número de atividades, assim como acontece com um pipeline, e elas serão executadas quando o caso selecionado corresponder à atividade de Expressão para o Switch. Neste exemplo, uma atividade Copy foi adicionada ao caso padrão e será executada sempre que nenhum dos outros casos corresponder à Expressão definida na atividade Switch.

Screenshot showing the case activities editor pane for the default case with a sample Copy activity added to it.

Observe o pipeline e o caso no canto superior esquerdo do editor de atividades do caso. Ao terminar de configurar as atividades do caso, você poderá selecionar o link do nome do pipeline para navegar de volta ao editor principal do pipeline novamente.

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.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.