Ações do plano de implantação (pré-visualização)

Uma ação é uma execução de um item de workspace que uma implementação executa em torno da implementação de outro item. As ações são a forma como um plano de implementação executa tarefas que a implementação apenas dos metadados dos itens não consegue realizar, como preencher uma tabela de um lakehouse antes de ser implementada uma vista de um armazém de dados que a lê.

Uma ação pertence a um grupo de deployment, e um grupo implementa exatamente um item. As ações do grupo giram em torno da implementação desse item.

Ações pré-implantação e pós-implantação

Cada grupo de implementação inclui dois conjuntos de ações:

• As ações pré-implantação são executadas antes do item do grupo ser implementado.
• As ações pós-implementação são executadas após o item do grupo ser implementado.

Uma ação pré-deploy não pode executar o mesmo item que o seu próprio grupo implementa, porque esse item ainda não foi implementado quando a ação é executada.

Tipos de itens que podes usar como ação

Os seguintes tipos de itens podem ser executados como ações do plano de implantação:

Para a estrutura de definição e as propriedades do trabalho, veja Definição do plano de implementação.

Cada ação executa o item. O item define o que a ação faz e quais os parâmetros que aceita, não o plano.

Nenhum outro tipo de item pode ser executado como ação. Para tipos de itens que estão em consideração mas não são suportados, veja Considerações e limitações.

Ordenar ações dentro de um grupo de destacamento

Encadeie ações para controlar a ordem em que são executadas. Quando encadeia uma ação a outra, a implementação executa-as nessa sequência, por isso pode ordenar uma ação que carrega dados antes da ação que os valida.

Na imagem anterior, a cadeia no grupo lakehouse é executada Refresh_Sales antes de Validate_Sales. O grupo de armazéns seguinte executa Notify antes de implementar o armazém.

Aplicam-se as seguintes regras:

• Pode encadear uma ação com outras ações no mesmo grupo de implementação. No ficheiro do plano, uma cadeia é uma dependência em relação ao nome de outra ação.
• Os nomes das ações devem ser únicos no respetivo grupo de implementação, porque uma cadeia faz referência a uma ação através do nome.
• Uma cadeia não pode fazer um ciclo sobre si própria. O sistema rejeita um ciclo de dependência ao guardar o plano.
• As ações são executadas uma de cada vez. As ações que não encadeias entre si continuam a não correr em paralelo.

Uma operação de implementação para na primeira falha, e o sistema não reverte quaisquer alterações. Para mais informações, veja Se uma operação falha.

Passar parâmetros para uma ação

Uma ação pode incluir parâmetros, que o plano passa ao item que a ação executa. Cada parâmetro tem um nome e um valor, e os nomes dos parâmetros devem ser únicos dentro de uma ação.

Um valor de parâmetro é ou um valor literal ou uma referência a uma variável numa biblioteca de variáveis. Uma referência variável permite que um único plano forneça valores diferentes por ambiente, em vez de codificar um valor correto apenas num espaço de trabalho.

Uma referência de variável que não corresponde a um tipo de variável conhecido é rejeitada quando o plano é guardado.

Como o plano transmite os valores ao item, forneça os parâmetros que o item espera. Para os parâmetros que um item aceita, consulte a documentação desse tipo de item.

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.

Conteúdo relacionado

• O que é um plano de implantação?
• Criar um plano de implementação
• Exemplos de planos de implantação
• Resolver problemas de planos de implementação
• Compreenda a vinculação de dependências na implementação entre espaços de trabalho
• Falhas de resolução de referência variável