Acciones del plan de despliegue (vista previa)

Una acción es la ejecución de un elemento del espacio de trabajo que un despliegue realiza antes o después del despliegue de otro elemento. Las acciones permiten que un plan de despliegue realice tareas que la implementación por sí sola de los metadatos de los elementos no puede realizar, como cargar datos en una tabla de lakehouse antes de implementar una vista de almacén que la consulte.

Una acción pertenece a un grupo de despliegue, y un grupo despliega exactamente un elemento. Las acciones del grupo giran en torno al despliegue de ese ítem.

Acciones previas y posteriores al despliegue

Cada grupo de despliegue lleva a cabo dos conjuntos de acciones:

• Las acciones previas al despliegue se ejecutan antes de que se despliegue el ítem del grupo.
• Las acciones posteriores al despliegue se ejecutan después de que el ítem del grupo se despliegue.

Una acción pre-despliegue no puede ejecutar el mismo elemento que despliega su propio grupo, porque ese elemento aún no se ha desplegado cuando se ejecuta la acción.

Tipos de objetos que puedes usar como acción

Los siguientes tipos de elementos pueden ejecutarse como acciones del plan de despliegue:

Para la estructura de definición y las propiedades del trabajo, véase Definición del plan de despliegue.

Cada acción ejecuta el elemento. El ítem define qué hace la acción y qué parámetros acepta, no el plan.

Ningún otro tipo de objeto puede ejecutarse como acción. Para los tipos de objetos que están en consideración pero no están soportados, consulta Consideraciones y limitaciones.

Ordenar acciones dentro de un grupo de despliegue

Acciones en cadena para controlar el orden en que se ejecutan. Cuando encadenas una acción a otra, el despliegue las ejecuta en esa secuencia, así que puedes ordenar una acción que cargue datos antes que la acción que los valida.

En la imagen anterior, la cadena del grupo de lakehouse se ejecuta Refresh_Sales antes de Validate_Sales. El siguiente grupo de almacenes ejecuta Notify antes de implementar el almacén.

Se aplican las reglas siguientes:

• Puedes encadenar una acción a otras acciones en el mismo grupo de despliegue. En el archivo del plan, una cadena depende del nombre de otra acción.
• Los nombres de las acciones deben ser únicos dentro de su grupo de despliegue, porque una cadena se refiere a una acción por su nombre.
• Una cadena no puede volver a enrollarse sobre sí misma. El sistema rechaza un ciclo de dependencias cuando guardas el plan.
• Las acciones se ejecutan una a una. Las acciones que no encadenas entre sí tampoco se ejecutan en paralelo.

Una operación de despliegue se detiene en el primer fallo y el sistema no revierte ningún cambio. Para más información, consulta Si una operación falla.

Pasar parámetros a una acción

Una acción puede incluir parámetros, que el plan transmite al elemento sobre el que se ejecuta la acción. Cada parámetro tiene un nombre y un valor, y los nombres de los parámetros deben ser únicos dentro de una acción.

Un valor de parámetro es o bien un valor literal o una referencia a una variable en una biblioteca de variables. Una referencia variable permite que un solo plan suministre valores diferentes por entorno, en lugar de codificar un valor correcto en un solo espacio de trabajo.

Una referencia de variable que no se resuelve en un tipo de variable conocido se rechaza al guardar el plan.

Como el plan transmite los valores al artículo, proporciona los parámetros que el elemento espera. Para los parámetros que acepta un elemento, consulta la documentación de ese tipo de elemento.

Consideraciones y limitaciones

Limitaciones del plan general de despliegue

• No puedes usar un solo plan para desplegar en más de un espacio de trabajo en una sola ejecución.
• Solo puedes adjuntar un plan de despliegue a una operación de despliegue.

Limitaciones para adjuntar un plan

• Un anexo de plano solo se aplica a la operación actual. No puedes configurar un plan como estándar para futuros despliegues ni programar el plan en sí. Si una herramienta de despliegue programa una operación, la operación debe adjuntar el plan cada vez que se ejecuta.
• No puedes adjuntar un plan a una operación de importación de un solo artículo.
• La fabric-cicd biblioteca no soporta planes de despliegue.

Limitaciones durante un despliegue

• No puedes desplegar grupos de despliegue independientes en paralelo.
• Un despliegue fallido no se revierte. Los elementos que ya se han desplegado permanecen en el espacio de trabajo objetivo, y los posteriores no se despliegan.

Limitaciones para las acciones del plan

• Solo las combinaciones compatibles de elemento y tipo de tarea pueden ejecutarse como acciones previas o posteriores al despliegue. Consulta Tipos de objetos que puedes ejecutar como acción.
• No puedes usar el mismo elemento de Dataflow Gen2 en más de una acción de un plan. Su tarea de actualización no puede ejecutarse en más de una instancia simultáneamente, así que el lienzo le avisa cuando añade la segunda instancia, y esta se bloquea durante la implementación.
• No puedes devolver más de 512 KB en una acción de función de datos de usuario. La producción mayor se trunca. La acción sigue teniendo éxito.
• No puedes hacer que una acción espere a que los servicios a los que suministra datos se pongan al día. Una acción se completa cuando la acción en sí termina, por lo que la siguiente acción puede comenzar antes de que los datos que generó puedan consultarse.
• No puedes usar un plan de despliegue para cambiar el conjunto de valores activos de una Biblioteca de Variables durante el despliegue. Las referencias a variables se resuelven según el conjunto de valores que ya está activo en el espacio de trabajo de destino. En un espacio de trabajo objetivo recién creado, el valor predeterminado está activo hasta que selecciones y guardes otro conjunto de valores. Para más información, consulte CI/CD de la biblioteca de variables.

Limitaciones para la creación de planes

• No puedes añadir más de un elemento a un grupo de despliegue.
• El lienzo solo soporta diseño automático.

Límites de tamaño del plan de despliegue

Un plan que supere cualquiera de estos límites se rechaza al guardarlo. Los límites se aplican siempre que se guarda un plan, por lo que se aplican tanto al canvas, a la API REST, a una consulta de Git como a herramientas externas.

Contenido relacionado

• ¿Qué es un plan de despliegue?
• Crear un plan de implementación
• Ejemplos de planes de despliegue
• Planes de despliegue para solucionar problemas
• Comprender la vinculación de dependencias en el despliegue entre espacios de trabajo
• Fallas de resolución de referencia variable