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

Uma ação é a execução de um item do espaço de trabalho que uma implantação executa durante a implantação de outro item. As ações são a forma como um plano de implantação executa tarefas que a implantação apenas dos metadados dos itens não consegue realizar, como preencher uma tabela do lakehouse antes da implantação de uma exibição do warehouse que a lê.

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

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

Cada grupo de implantação contém dois conjuntos de ações:

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

Uma ação pré-implantação não pode rodar o mesmo item que seu próprio grupo implanta, porque esse item ainda não foi implantado quando a ação é executada.

Tipos de itens que você pode 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 implantação.

Cada ação executa um item. O item define o que a ação faz e quais parâmetros ela 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 as ações dentro de um grupo de implantação

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

Na imagem anterior, a cadeia no grupo das casas do lago passa Refresh_Sales antes Validate_Salesde . O grupo de armazém a seguir executa Notify antes de implantar o armazém.

As seguintes regras se aplicam:

• Você pode encadear uma ação com outras ações no mesmo grupo de implantação. No arquivo de plano, uma cadeia é uma dependência do nome de outra ação.
• Os nomes das ações devem ser únicos dentro do grupo de implantação, pois uma cadeia se refere a uma ação pelo nome.
• Uma cadeia não pode formar um loop sobre si mesma. O sistema rejeita um ciclo de dependência quando você salva o plano.
• As ações acontecem uma de cada vez. Ações que você não encadeia umas às outras ainda não são executadas em paralelo.

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

Passar parâmetros para uma ação

Uma ação pode carregar parâmetros, que o plano passa para o 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 em uma 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 em apenas um espaço de trabalho.

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

Como o plano passa os valores para o item, forneça os parâmetros que o item espera. Para quais parâmetros um item aceita, veja a documentação desse tipo de item.

Considerações e limitações

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

• Você não pode usar um plano para implantar em mais de um workspace em uma única execução.
• Você pode anexar apenas 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. Você não pode configurar um plano como padrão para implantações futuras ou agendar o plano em si. Se uma ferramenta de implantação agenda uma operação, a operação deve anexar o plano toda vez que é executada.
• Você não pode anexar um plano a uma operação de importação de item único.
• A fabric-cicd biblioteca não suporta planos de implantação.

Limitações durante uma implantação

• Você não pode implantar grupos de implantação independentes em paralelo.
• Uma implantação fracassada não é revertida. Itens que já foram implantados permanecem no workspace de destino, e itens posteriores não são implantados.

Limitações para ações do plano

• Apenas combinações suportadas de itens e tipos de trabalho podem ser executadas como ações pré-implantação ou pós-implantação. Veja Tipos de itens que você pode usar como uma ação.
• Você não pode usar o mesmo item Dataflow Gen2 em mais de uma ação de um plano. O trabalho de atualização não pode ser executado mais de uma vez ao mesmo tempo, portanto a tela avisa você quando adiciona a segunda ocorrência, e essa segunda ocorrência é bloqueada durante a implantação.
• Você não pode retornar mais de 512 KB de uma ação da função de dados do usuário. Saídas maiores são truncadas. A ação ainda assim é bem sucedida.
• Você não pode fazer com que uma ação espere até que os serviços que ela alimenta a acompanhem. Uma ação é concluída quando a ação termina, então a próxima ação pode começar antes que os dados produzidos possam ser consultados.
• Você não pode usar um plano de implantação para alterar o conjunto de valores ativos de uma Biblioteca de Variáveis durante a implantaçã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. Em um workspace de destino recém-criado, Default permanece ativo até que você selecione e salve outro conjunto de valores. Para mais informações, veja Biblioteca de variáveis CI/CD.

Limitações para a autoria de planos

• Você não pode adicionar mais de um item a um grupo de implantação.
• A tela suporta apenas layout automático.

Limites de tamanho do plano de implantação

Um plano que ultrapassa qualquer um desses limites é rejeitado ao ser salvo. Os limites são aplicados sempre que um plano é salvo, então eles se aplicam ao canvas, à API REST, a uma chamada 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
• Solucionar problemas de planos de implantação
• Entenda a vinculação de dependências na implantação entre espaços de trabalho
• Falhas de resolução de referência variável