Use a atividade de invocação de pipeline para executar outro pipeline

A atividade de pipeline Invoke do Fabric pode executar outro pipeline do Microsoft Fabric. Você pode utilizar essa atividade para orquestrar a execução de um ou vários pipelines a partir de um único pipeline. Isso é útil para organizar, reutilizar e gerenciar fluxos de trabalho complexos. A atividade de pipeline de invocação pode ser muito útil para criar padrões de pipeline modulares e reutilizáveis, chamando outros pipelines que têm uma finalidade específica.

Prerequisites

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

Note

Atualmente, há duas atividades de pipeline Invoke. O pipeline Invoke (Legado) suporta apenas pipelines Fabric no mesmo workspace que seu pipeline pai. Você também só pode monitorar o pipeline pai e não pode invocar pipelines do ADF (Azure Data Factory) ou do Synapse usando a atividade herdada. O uso da nova atividade de pipeline Invoke permite invocar pipelines entre os Fabric workspaces, do ADF ou do Synapse, e monitorar pipelines secundários.

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

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

Criar a atividade

  1. Crie uma nova pipeline na sua área de trabalho.

  2. Pesquise invocar pipeline no painel Atividades do pipeline e selecione-o para adicioná-lo à área de trabalho do pipeline.

    Screenshot da interface do usuário Fabric com o painel Atividades e a atividade de pipeline Invoke realçada.

    Captura de tela mostrando a janela do editor de pipeline com o botão Invocar pipeline na guia atividades sem o texto descritivo.

  3. Selecione a nova atividade Invocar pipeline no canvas se ela ainda não estiver selecionada.

    Captura de tela mostrando a guia de Configurações Gerais da atividade de invocação do pipeline.

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

Invocar configurações de pipeline (herdado)

Selecione a guia Configurações e escolha um pipeline existente no menu suspenso pipeline invocado ou use o botão + Novo para criar um novo pipeline diretamente. Você pode optar por aguardar a conclusão ou continuar diretamente. Nesse caso, o pipeline invocado será executado em paralelo com as atividades que o seguem no fluxo de execução do pipeline pai.

Captura de tela mostrando a guia Invocar pipeline (Herdado) das configurações de atividade, realçando a guia.

Configurações de Invocar pipeline

Selecione a guia Configurações e configure sua atividade.

Invocar pipelines de Fabric

  • Tipo: Selecione Fabric a origem do pipeline.

  • Conexão: cada atividade Invoke do pipeline requer um objeto Connection armazenado no repositório seguro de credenciais do Fabric. Esse objeto de conexão armazena o token de usuário associado ao workspace Fabric. Se você ainda não criou uma nova atividade de pipeline Invoke, será necessário criar um novo objeto de conexão primeiro antes de poder usar a atividade.

    Ao configurar sua conexão de pipeline, agora você terá três opções para tipo de autenticação: conta organizacional, entidade de serviço ou identidade do workspace.

    Captura de tela mostrando a conexão de pipeline configurada com o tipo autenticação realçado.

  • Workspace: escolha o workspace Fabric onde o pipeline de destino que você deseja invocar do pipeline pai está localizado.

  • Pipeline: selecione o pipeline que você deseja invocar.

Captura de tela mostrando a janela do editor de pipeline com o espaço de trabalho da atividade Invocar pipeline e a seleção de conexão.

Invocar pipelines do ADF e do Synapse

  • Tipo: escolha a origem do pipeline (Fabric, Azure Data Factory, Synapse)
  • Conexão: referência a Fabric, Azure Data Factory ou Synapse registrada como uma conexão
  • Pipeline: selecione o nome do pipeline que você deseja invocar

Captura de tela mostrando a guia de configurações da atividade Invocar pipeline, destacando ADF e Synapse.

Usando Fabric WI (Identidade do Workspace) na atividade Invocar Pipeline

  1. Criar a identidade do Workspace

    Você deve habilitar a WI em seu workspace (isso pode levar um momento para ser carregado). Crie uma Identidade de Espaço de Trabalho em seu Espaço de Trabalho Fabric. Observe que a WI deve ser criada no mesmo ambiente de trabalho que o Pipeline.

    Confira a documentação sobre a Identidade do Workspace.

  2. Habilitar configurações no nível do locatário

    Habilite a seguinte configuração de locatário (ela está desabilitada por padrão): Os principais de serviço podem chamar APIs públicas do Fabric.

    Você pode habilitar essa configuração no Fabric portal de administração. Para obter mais informações sobre essa configuração, consulte o artigo sobre a habilitação da autenticação do principal de serviço para APIs administrativas.

  3. Conceder permissões de workspace à Identidade do Workspace

    Abra o workspace, selecione Gerenciar acesso e atribua permissões à Identidade do Workspace. O acesso de colaborador é suficiente para a maioria das situações. Se o pipeline (que você está invocando) não estiver na mesma área de trabalho que o seu pipeline, você precisará atribuir o WI que você criou na área de trabalho do seu pipeline com pelo menos acesso de Colaborador à área de trabalho do pipeline.

    Confira a documentação em Conceder aos usuários acesso aos workspaces.

Salve e execute ou agende o pipeline

Alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar. Selecione Executar para executá-lo diretamente ou Agendar para agendar execuções em intervalos ou horários específicos. Para obter mais informações sobre execuções de pipeline, consulte: cronograma de execuções de pipeline.

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.

Depois de executar, você pode monitorar a execução do pipeline e exibir o histórico de execução na guia Saída abaixo da tela.

Conteúdo relacionado

  • Last updated on