Compartilhar via


Usar a atividade switch para executar a ramificação condicional 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 de comutador a um pipeline com a interface do usuário

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

Criando a atividade

  1. Crie um novo pipeline em sua área de trabalho.

  2. Pesquise pela atividade de chave 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.

    Captura de tela da interface do usuário do Fabric com o painel Atividades e atividade de comutador realçado.

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

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

Veja 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 para ser avaliada e comparada com as opções de Caso, e dá suporte a conteúdo dinâmico, permitindo o uso de 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 de comutador 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.

Captura de tela mostrando a guia de configurações de atividades de troca destacando a guia e indicando onde escolher uma nova conexão.

Configurando atividades de caso

Ao editar as atividades de um caso selecionando o ícone de lápis ao lado dele, no painel Configurações de Atividades ou diretamente na interface de alternância de atividade na área de trabalho do pipeline, será exibido o editor de atividades do caso. Isso é semelhante ao editor de pipeline, mas específico ao caso selecionado. Você pode adicionar qualquer número de atividades, assim como em um pipeline, e elas serão executadas quando o caso selecionado corresponder à Expressão para a atividade de switch. Neste exemplo, uma atividade de cópia foi adicionada ao caso default e será executada sempre que nenhum dos outros casos corresponder à Expressão definida na atividade switch.

Captura de tela mostrando o painel do editor de atividades de caso para o caso padrão com uma atividade de cópia de exemplo adicionada a ela.

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.

Captura de tela mostrando a guia Página Inicial no editor de pipeline com o nome da guia e os botões Salvar, Executar e Agendar realçados.