Compartilhar via


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

Atividade de invocação de pipeline 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. Pipeline Invoke (Herdado) dá suporte apenas a pipelines do Fabric no mesmo espaço de trabalho que o pipeline principal. Você só pode monitorar o pipeline principal e não consegue invocar pipelines do ADF (Azure Data Factory) ou do Synapse sem usar a atividade herdada. O uso da nova atividade de invocação de pipeline permite invocar pipelines em diferentes workspaces do Fabric, a partir do ADF ou do Synapse, e monitorar os pipelines filho.

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 um pipeline no seu workspace.

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

    Captura de tela da interface do usuário do Fabric com o painel Atividades e a atividade Invocar pipeline do Fabric destacada.

    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 é 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 no Fabric

  • Tipo: Selecione Fabric como a origem do seu pipeline.

  • Conexão: cada atividade de pipeline Invoke requer um objeto Connection armazenado no repositório de credenciais do Fabric seguro. Esse objeto de conexão armazena o token de usuário associado ao espaço de trabalho do 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.

  • Espaço de trabalho: escolha o espaço de trabalho Fabric onde o pipeline de destino está localizado que você deseja invocar do pipeline pai.

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

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

Usando a Identidade de Workspace do Fabric (WI) em pipelines de invocação

  1. Criar a Identidade de Espaço de Trabalho Crie uma Identidade de Espaço de Trabalho no espaço de trabalho do Fabric. Confira a documentação sobre a Identidade do Workspace.

  2. Habilitar configurações no nível do locatário No portal de administração do Fabric, habilite a seguinte configuração de locatário: as entidades de serviço podem chamar APIs públicas do Fabric. Essa configuração é necessária para que a Identidade do Workspace seja autenticada com êxito. Confira os documentos sobre habilitar a autenticação da entidade de serviço para APIs de administrador.

  3. Conceder permissões do espaço de trabalho à Identidade do Espaço de Trabalho Abra o espaço de trabalho, selecione a opção Gerenciar acesso e atribua permissões à Identidade do Espaço de Trabalho. O acesso de colaborador é suficiente para a maioria das situações. Confira a documentação em Conceder aos usuários acesso aos workspaces.

Invocar pipelines do ADF e do Synapse

  • Tipo: escolha a origem do pipeline (Fabric, Azure Data Factory, Synapse)
  • Conexão: referência ao Fabric, ao Azure Data Factory ou ao Synapse registrado 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.

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.