Usa activadores

En esta página, se describe cómo crear y usar un activador para tu canalización de Cloud Data Fusion. Debes crear un activador en una canalización de datos, llamada canalización downstream, para que se ejecute cuando finalice otra canalización, llamada canalización ascendente. Cuando creas un activador, debes elegir cuándo se ejecutará la canalización descendente, cuándo la ejecución de la canalización ascendente se ejecuta de forma correcta, falla, se detiene o cualquier combinación de estas.

Los activadores son útiles para las siguientes tareas:

  • Limpiar tus datos una vez y hacer que estén disponibles para varias canalizaciones descendentes.
  • Compartir información, como argumentos de entorno de ejecución y configuraciones de complementos, entre canalizaciones. Esto se llama configuración de carga útil.
  • Tener un conjunto de canalizaciones dinámicas que se puedan ejecutar mediante los datos de la hora, el día, la semana o el mes, en lugar de una canalización estática que se debe actualizar para cada ejecución.

Antes de comenzar

En Pipeline Studio, implementa las canalizaciones que son las canalizaciones ascendentes y descendentes.

Opcional: Configura argumentos de entorno de ejecución para tu canalización ascendente

Si deseas pasar la configuración de la carga útil como argumentos del entorno de ejecución, configura los argumentos del entorno de ejecución para tu canalización ascendente:

  1. Ve a la página Lista. En la pestaña Implementados, haz clic en el nombre de la canalización ascendente. Aparecerá la vista Deploy de esa canalización.

  2. Haz clic en la flecha a la derecha del botón Run.

  3. Haz clic en el botón + y completa la Clave y el Valor de tu argumento de entorno de ejecución.

  4. Haz clic en Guardar.

Crea un activador de entrada en una canalización descendente

Crea un activador en la canalización descendente para que se ejecute cuando se complete la canalización ascendente.

  1. Ve a la página Lista. En la pestaña Implementado, haz clic en el nombre de la canalización descendente. Aparecerá la vista Deploy de esa canalización.

  2. En el medio izquierdo de la página, haz clic en Activadores de entrada. Aparecerá una lista de las canalizaciones disponibles.

  3. Haz clic en la canalización ascendente. Selecciona uno o más de los estados de finalización de la canalización ascendente (Sin errores, Con errores o Detenciones) como la condición para cuando se debe ejecutar la canalización descendente.

  4. Si deseas que la canalización ascendente comparta información (llamada configuración de carga útil) con la canalización descendente, haz clic en Configuración del activador y, luego, sigue los pasos para Pasar la configuración de la carga útil como argumentos del entorno de ejecución. De lo contrario, haz clic en Habilitar activador.

Pasa la configuración de la carga útil como argumentos del entorno de ejecución

La configuración de carga útil permite compartir información de la canalización ascendente a la canalización descendente. Esta información puede ser, por ejemplo, el directorio de salida, el formato de datos o el día en que se ejecutó la canalización. Luego, la canalización descendente usa esta información para tomar decisiones como determinar el conjunto de datos correcto para leer.

Para pasar información de la canalización ascendente a la canalización descendente, configura los argumentos del entorno de ejecución de la canalización descendente con los valores de los argumentos del entorno de ejecución o la configuración de cualquier complemento de la canalización ascendente.

Cada vez que se ejecuta la canalización descendente (se activa), la configuración de la carga útil se establece mediante los argumentos del entorno de ejecución de la ejecución particular de la canalización ascendente que activó la canalización descendente.

Para pasar la configuración de la carga útil como argumentos del entorno de ejecución, haz lo siguiente:

  1. En la sección Crea un activador entrante desde donde lo dejaste, después de hacer clic en Configuración del activador, aparecerán todos los argumentos del entorno de ejecución que configuraste antes para tu canalización ascendente. Selecciona los argumentos del entorno de ejecución que deseas pasar de la canalización ascendente a la canalización descendente cuando se ejecuta este activador.

  2. Haz clic en la pestaña Configuración de complementos para ver una lista de lo que se pasará de tu canalización ascendente a la canalización descendente cuando se active.

  3. Haz clic en Configurar y habilitar el activador.

Prueba tu activador de canalización descendente

Para probar tu activador, sigue estos pasos:

  1. Ve a la página Lista. En la pestaña Implementados, haz clic en el nombre de la canalización ascendente. Aparecerá la vista Deploy de esa canalización.

  2. Haz clic en Ejecutar.

  3. Espera a que se complete la ejecución de la canalización ascendente. Desde la vista Lista, navega a la canalización descendente. Como resultado del activador que creaste, deberías verlo en ejecución.