Implementar una configuración de canalización
Puede implementar una configuración de canalización importando un archivo ZIP que contiene los archivos de configuración YAML. Puede utilizar la interfaz de usuario o la API de importación para crear nuevos proyectos o actualizar los existentes. Ambos aceptan YAML minimizado y el formato JSON heredado.
Al utilizar el control de versiones, puede confirmar sus cambios y realizar Aplicar desde remoto para incorporarlos a Qlik Talend Data Integration.
Antes de comenzar
Antes de importar:
-
Verifique que todas las conexiones a las que se hace referencia en los archivos YAML existan en el espacio de destino. Los nombres de las conexiones en el archivo YAML deben coincidir exactamente.
-
Si la canalización incluye referencias entre proyectos, por ejemplo, una tarea de canalización que lee de una tarea de aterrizaje en otro proyecto, importe primero el proyecto ascendente.
-
Valide los archivos de configuración para confirmar que no hay errores. Vea Validar la configuración de una canalización de datos.
Importación desde la interfaz de usuario
Crear un nuevo proyecto
Para crear un nuevo proyecto a partir de un archivo de configuración:
-
En Integración de datos > Proyectos de canalización, haga clic en Crear nuevo.
-
Seleccione Importar proyecto.
-
Seleccione el espacio de destino.
-
Suba el archivo ZIP que contiene la configuración.
-
Haga clic en Importar.
Si la importación se realiza correctamente, se abre el proyecto. Si hay errores, se muestra una lista de mensajes de validación. Corrija los errores en sus archivos de configuración e inténtelo de nuevo.
Actualizar un proyecto existente
Para actualizar un proyecto existente con una nueva configuración:
-
En Integración de datos > Proyectos de canalización, haga clic
en el proyecto y seleccione Importar. -
Cargue el archivo ZIP que contiene la configuración actualizada.
-
Haga clic en Importar.
Importación mediante la API
La API de importación acepta un archivo ZIP y el ID del espacio de destino. Devuelve el proyecto actualizado si se realiza correctamente, o una lista de errores si falla la validación.
La API de importación admite tanto YAML (minimizado o completo) como exportaciones JSON heredadas. No es necesario convertir las exportaciones JSON existentes antes de importar.
Aplicar los cambios desde el control de versiones
Si el proyecto está conectado a un repositorio de control de versiones, puede aplicar los cambios remotos directamente desde el proyecto. Al aplicar los cambios, Qlik Talend Data Integration lee los archivos YAML actuales de la rama conectada y los importa.
La validación se ejecuta antes de que se apliquen los cambios. Si hay errores, recibirá los mismos mensajes de error que en una importación manual.
Para obtener detalles sobre la configuración del control de versiones, consulte Administrar sus proyectos de canalización de datos con el control de versiones.
Manejo de errores de importación
Cuando la importación falla, Qlik Talend Data Integration devuelve una lista de errores de validación. Cada error incluye el tipo de error y la ruta al archivo o propiedad donde se encontró el problema.
Se devuelven hasta 50 errores por intento de importación. Corrija los errores notificados y vuelva a importar para comprobar si hay problemas adicionales.
Para obtener una descripción de cada tipo de error y cómo resolverlo, consulte Validar la configuración de una canalización de datos.