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

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

Prerequisites

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

Note

Atualmente, há duas atividades de pipeline Invoke. O pipeline Invoke (Legacy) só suporta pipelines do Fabric na mesma área de trabalho que o pipeline pai. Podes apenas monitorizar o pipeline pai e não podes invocar pipelines ADF (Azure Data Factory) ou Synapse usando a atividade antiga. A utilização da nova atividade de pipeline 'Invoke' permite-lhe invocar pipelines nos espaços de trabalho do Fabric, a partir de ADF ou Synapse, e monitorizar pipelines secundários.

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

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

Criar a atividade

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

  2. Pesquise por invocar pipeline no painel Atividades e selecione-o para o adicionar à tela do pipeline.

    Captura de ecrã da interface Fabric com o painel de Atividades e a atividade do pipeline Invocar destacados.

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

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

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

Consulte as orientações gerais de configuração para configurar o separador Configurações Gerais.

Invocar configurações de canalização (legado)

Selecione a guia Configurações e escolha um pipeline existente na lista suspensa 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. Neste caso, o pipeline invocado é executado em paralelo com as atividades subsequentes dentro do fluxo de execução do processo principal.

Captura de tela exibindo a aba de configurações da atividade de invocação do pipeline (Legado), destacando essa aba.

Invocar configurações de pipeline

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

Invocar pipelines a partir do Fabric

  • Tipo: Selecione Fabric a origem do seu pipeline.

  • Ligação: Cada atividade Invoke pipeline requer um objeto Connection armazenado no armazenamento seguro de credenciais Fabric. Este objeto de ligação armazena o seu token de utilizador associado ao seu espaço de trabalho Fabric. Se você ainda não criou uma nova atividade de pipeline Invoke, é 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á 3 opções para o tipo de autenticação: Conta organizacional, entidade de serviço ou identidade do espaço de trabalho.

    Captura de ecrã mostrando a ligação do pipeline definida com o tipo de autenticação realçado.

  • Espaço de Trabalho: Escolha o espaço de trabalho Fabric onde está localizado o pipeline de destino que pretende invocar do seu pipeline principal.

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

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

Invoque pipelines do ADF e Synapse

  • Tipo: Escolha a origem do seu pipeline (Fabric, Azure Data Factory, Synapse)
  • Ligação: Referência ao Fabric, Azure Data Factory ou Synapse registada como ligação
  • Pipeline: Selecione o nome do pipeline que você deseja invocar

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

Utilização do Fabric Workspace Identity (WI) na atividade Invoke Pipeline

  1. Criar a Identidade do Espaço de Trabalho

    Deve ativar o WI no seu espaço de trabalho (isto pode demorar algum tempo a carregar). Crie uma Identidade de Espaço de Trabalho no seu espaço de trabalho Fabric. Note que o WI deve ser criado no mesmo espaço de trabalho do seu Pipeline.

    Consulta a documentação sobre o Workspace Identity.

  2. Ativar definições ao nível do inquilino

    Ative a seguinte configuração de inquilino (está desativada por defeito): Os aplicativos principais podem chamar as APIs públicas do Fabric.

    Pode ativar esta definição no portal de administração Fabric. Para mais informações sobre esta configuração, consulte o artigo relativo à ativação da autenticação do principal de serviço para APIs de administrador.

  3. Conceder permissões de espaço de trabalho à Identidade do Espaço de Trabalho

    Abra o espaço de trabalho, selecione Gerir acesso e atribua permissões à Identidade do Espaço de Trabalho. O acesso dos colaboradores é suficiente para a maioria dos cenários. Se o Pipeline que está a invocar não se encontrar no mesmo espaço de trabalho que o seu, terá de atribuir pelo menos permissões de Contribuidor ao WI que criou no espaço de trabalho do seu Pipeline.

    Consulta a documentação sobre Dar acesso aos utilizadores aos espaços de trabalho.

Salvar e executar ou agendar o pipeline

Altere para o separador Início no topo do editor de pipeline e selecione o botão de guardar para salvar o seu pipeline. Selecione Executar para executar diretamente ou Agendar para agendar corridas em horários ou intervalos específicos. Para obter mais informações sobre execuções de pipeline, consulte: agendar execuções de pipeline.

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

Depois de executar, podes monitorizar a execução do pipeline e ver o histórico de execuções a partir do separador Output abaixo da tela.