O que é um plano de implementação na Microsoft Fabric? (pré-visualização)

Um plano de implementação Microsoft Fabric é um item de espaço de trabalho que adiciona ordem explícita de itens e ações automatizadas a uma operação de implementação. Use um plano para distribuir itens numa sequência específica. Também pode utilizá-lo para executar um notebook, um pipeline de dados ou outro item suportado antes ou depois de um item ser implementado.

Um plano de implantação funciona com estas ferramentas de implantação:

  • Integração com Git
  • Linhas de implementação
  • APIs REST suportadas

Neste artigo, ferramenta de implementação refere-se a qualquer uma destas ferramentas suportadas. Não se executa um plano por si só. Conecta-o quando inicia uma operação com uma ferramenta de implantação.

Importante

Este recurso está em pré-visualização.

Quando usar um plano de implantação

Use um plano de implantação quando:

Scenario Como um plano ajuda
Os itens têm de ser distribuídos numa ordem que a linhagem Fabric não representa. O plano define dependências explícitas entre grupos de implementação.
O trabalho deve ser executado antes ou depois de um item ser implementado. O plano executa itens suportados como ações de pré-implementação ou pós-implementação.
A operação requer tanto ordenação explícita como dependências de itens do Fabric. Fabric combina o plano com a linhagem quando determina a ordem dos itens.

Não precisa de um plano de implantação quando a ordem padrão da ferramenta de implementação é suficiente e não são necessárias ações.

Componentes do plano de implantação

Um plano de implementação contém os seguintes componentes:

Componente Purpose
Grupo de implementação Um item a implementar e as suas ações pré-implantação ou pós-implantação.
Step Implementa o item num grupo de implementação.
Action Uma execução de um item compatível ocorre antes ou depois da implantação do item do grupo.

Para tipos de ações suportados e comportamento de ação, veja Ações do plano de implementação.

Como funciona um plano de implantação

Cada operação de implantação combina três entradas:

  • Itens selecionados: Os itens selecionados para a operação.
  • Plano de implantação: A ordem explícita e as ações associadas a esses itens.
  • Linhagem Fabric: As dependências que Fabric deteta entre os itens.

Diagrama que mostra os itens selecionados, um plano de implementação e a linhagem do Fabric, que se combinam para determinar a ordem dos itens e as ações para um espaço de trabalho de destino.

Determinar o âmbito de implementação

A ferramenta de implementação determina a origem, o alvo e os itens na operação. Anexar um plano não substitui essa escolha. Os itens selecionados que não pertencem a um grupo de implementação continuam a ser implementados através do comportamento padrão da ferramenta.

Anexar um plano não seleciona automaticamente os itens que refere. Numa superfície de implementação seletiva, selecione os itens que quer implementar e certifique-se de que os itens exigidos pelas ações do plano estão disponíveis no espaço de trabalho alvo quando essas ações são executadas.

Um plano de implantação controla a distribuição e as ações dos itens. Não implementa configurações ao nível do espaço de trabalho, como identidades de espaços de trabalho, ligações, ligações de gateway ou definições do Spark. Configurar o espaço de trabalho de destino antes de uma ação depende dessas definições.

Determinar a ordem de implementação

O Fabric combina dependências explícitas entre grupos de implementação com dependências detetadas pela linhagem. Um plano pode adicionar uma ordem que a linhagem não representa, mas não remove dependências que o Fabric deteta.

Para um cenário detalhado que mostra como os itens selecionados, dependências do plano, linhagem e ações de runtime funcionam em conjunto, veja exemplos de planos de implantação.

Executar grupos de implementação e ações

Para cada grupo de implantação, o Fabric executa as suas ações pré-implantação, implementa o item do grupo e depois executa as ações pós-implantação. As dependências entre grupos e ações determinam a sua ordem. A posição de um item no ficheiro do plano não define a sua ordem.

Anexar um plano é opcional. Sem um plano, a ferramenta de implementação selecionada utiliza o seu comportamento padrão.

Anexar um plano de implantação

Pode anexar um plano quando utiliza uma operação de integração Git suportada, implementa conteúdo através de um pipeline de implementação ou chama uma API REST suportada. O anexo aplica-se apenas a essa operação. Para as superfícies suportadas e o comportamento de seleção de planos, veja Anexar um plano de implantação.

Criar e versionar um plano de implementação

Crie um plano no canvas do plano de implementação, onde adiciona grupos de implementação, define a sua ordem e configura as ações. Para instruções, consulte Criar um plano de implantação.

Um plano de implementação é um item do espaço de trabalho. Quando o espaço de trabalho estiver ligado ao Git, compromete o plano com os itens que ele refere para que o plano possa avançar pelo seu processo CI/CD.

Se uma operação falhar

A operação para quando um item ou ação falha e não reverte o trabalho concluído. Para o comportamento de falhas e os passos de resolução, consulte Planos de implementação de resolução de problemas.

Considerações e limitações

Limitações do plano geral de implantação

  • Não podes usar um plano para implementar em mais do que um espaço de trabalho numa única execução.
  • Só pode anexar um plano de implantação a uma operação de implantação.

Limitações para anexar um plano

  • Um anexo de plano aplica-se apenas à operação atual. Não podes configurar um plano como padrão para futuras implementações nem agendar o plano propriamente dito. Se uma ferramenta de implementação agendar uma operação, a operação deve anexar o plano cada vez que é executada.
  • Não podes anexar um plano a uma operação de importação de um único item.
  • A fabric-cicd biblioteca não suporta planos de implementação.

Limitações durante uma implementação

  • Não podes implementar grupos de implantação independentes em paralelo.
  • Uma implementação falhada não é revertida. Os itens que já foram implementados ficam no espaço de trabalho alvo, e os itens posteriores não são implementados.

Limitações para as ações do plano

  • Apenas combinações suportadas de tipo de item e tipo de tarefa podem ser executadas como ações de pré-implementação ou pós-implementação. Vê Tipos de itens que podes usar como uma ação.
  • Não podes usar o mesmo item Dataflow Gen2 em mais do que uma ação num plano. A sua tarefa de atualização não pode ser executada mais do que uma vez em simultâneo, por isso a tela avisa quando é adicionada a segunda ocorrência, e essa segunda ocorrência é bloqueada durante a implementação.
  • Não pode devolver mais de 512 KB de uma ação de função de dados do utilizador. A produção maior é truncada. A ação continua a ser bem-sucedida.
  • Não é possível fazer uma ação esperar que os serviços que ela alimenta fiquem a par. Uma ação conclui-se quando a própria ação termina, pelo que a ação seguinte pode começar antes de os dados produzidos serem consultáveis.
  • Não pode usar um plano de implementação para alterar o conjunto de valores ativos de uma Biblioteca de Variáveis durante a implementação. As referências de variáveis são resolvidas com base no conjunto de valores que já está ativo no espaço de trabalho de destino. Num espaço de trabalho alvo recém-criado, o Padrão está ativo até selecionar e guardar outro conjunto de valores. Para mais informações, consulte Biblioteca de variáveis para CI/CD.

Limitações para a autoria de planos

  • Não podes adicionar mais de um item a um grupo de implementação.
  • A tela suporta apenas layout automático.

Limites de tamanho do plano de implantação

Um plano que ultrapasse qualquer um destes limites é rejeitado ao ser guardado. Os limites são aplicados sempre que um plano é guardado, por isso aplicam-se ao canvas, à API REST, a uma consulta do Git e a ferramentas externas.

Elemento Limit
Tamanho do plano 1 MB
Comprimento dos nomes de grupos ou passos 60 caracteres
Grupos num plano 1,000
Dependências de um grupo 1,000
Ações de pré-implementação em um grupo 20
Ações pós-implementação num grupo 20
Dependências numa ação 20
Parâmetros numa ação 20