Recuperación y edición de la configuración de una canalización

Puede recuperar los archivos de configuración YAML de una canalización exportando el proyecto o recuperándolo desde el control de versiones. A continuación, puede editar los archivos YAML en su entorno de desarrollo para realizar cambios.

Tiene tres opciones para comenzar:

Exportar un proyecto como YAML

Exportar un proyecto genera un archivo ZIP que contiene los archivos YAML de todas las tareas, conjuntos de datos y configuraciones del proyecto. Para más información, vea Exportar e importar canalizaciones de datos.

Nota de sugerenciaExporte primero en formato minimizado. Los archivos minimizados muestran solo lo que difiere de los valores predeterminados, lo que facilita su lectura y su replicación en otros proyectos. Al importar un archivo minimizado, Qlik Talend Data Integration aplica los valores especificados y utiliza los valores predeterminados para todo lo demás. Si necesita ver la lista completa de propiedades disponibles y sus valores predeterminados, exporte el mismo proyecto en formato completo como referencia.
Importar un proyecto desde el control de versiones

Para más información, vea Importar un proyecto desde el control de versiones.
También puede crear una configuración de canalización desde cero escribiendo archivos YAML que coincidan con la estructura de carpetas requerida, pero le recomendamos que comience a partir de una plantilla existente.

Migrar un proyecto al formato YAML

Los proyectos creados antes de que se introdujera la gestión de canalizaciones de datos declarativas se almacenan en el control de versiones mediante archivos JSON heredados.

El formato JSON heredado seguirá siendo compatible hasta finales de junio de 2027, lo que le dará tiempo para planificar y migrar sus proyectos sin problemas.

Puede migrar estos proyectos a la estructura basada en YAML para aprovechar los archivos minimizados y el flujo de trabajo de la canalización declarativa.

Esta acción solo está disponible para proyectos almacenados en el formato JSON heredado. Los proyectos que ya utilizan archivos YAML no muestran esta opción.

Para migrar un proyecto al formato YAML:

Abra el proyecto y abra el menú de control de versiones.
Haga clic en Migrar al formato YAML.
Revise el mensaje de confirmación y haga clic en Migrar.

Nota informativaEl proceso de migración realiza una confirmación (commit) y un envío (push) del estado actual del proyecto como JSON, luego convierte los archivos a la nueva estructura YAML y vuelve a realizar una confirmación (commit). Debido a que la estructura de carpetas y los nombres de archivos cambian durante la conversión, es posible que el historial de versiones anterior a la migración no sea directamente comparable con el historial posterior a la migración.

Una vez completada la migración, el proyecto se almacena en formato YAML en la rama actual. Otras ramas que aún contengan archivos JSON mostrarán la opción de migración la próxima vez que cambie a ellas.

Migre todas las ramas de entorno en secuencia —comenzando por desarrollo— para mantener una estructura coherente entre las ramas antes de abrir solicitudes de extracción entre ellas.

Comprender la estructura de archivos

La carpeta extraída contiene los siguientes archivos. El contenido de los archivos es el mismo para todos los tipos de tareas.

qtcp_project.yaml qtcp_tasks/ <task-name>/ task.yaml sourceSelection.yaml schedule.yaml (only if a schedule is configured) model.yaml (only if relationships are defined) transformationRules.yaml (only if task-level rules are defined) datasets/ <dataset-name>.yaml newTaskDefaults.yaml (only if custom task defaults are defined)

qtcp_project.yaml

qtcp_project.yaml contiene definiciones a nivel de proyecto y contiene propiedades como el nombre, la plataforma y la gestión de esquemas predeterminada.

task.yaml

task.yaml contiene definiciones a nivel de tarea y contiene propiedades como el nombre de la tarea, el tipo, las conexiones y el comportamiento de Carga completa y captura de cambios.

sourceSelection.yaml

sourceSelection.yaml define las tablas de origen seleccionadas para la tarea. Cada entrada especifica el patrón de selección de esquemas y tablas.

La selección de origen difiere entre las tareas de aterrizaje y otros tipos de tareas.

Archivos de conjuntos de datos

Cada conjunto de datos tiene un archivo YAML con el mismo nombre que el conjunto de datos, ubicado directamente en la carpeta datasets/. El archivo combina la definición del conjunto de datos y las reglas de transformación explícitas.

El archivo de conjunto de datos es obligatorio para todas las tareas, excepto para las tareas de aterrizaje, y debe contener el ID del conjunto de datos si desea hacer referencia al conjunto de datos desde otras tareas.

schedule.yaml

schedule.yaml define cuándo se ejecuta la tarea. El archivo contiene una matriz scheduling con la configuración de la programación. Este archivo solo se incluye si se ha establecido una programación para el proyecto.

model.yaml

model.yaml define las relaciones del modelo de datos para la tarea. El archivo contiene una matriz relationships.

transformationRules.yaml

transformationRules.yaml contiene todas las reglas de transformación a nivel de tarea en una matriz.

Edición de archivos de configuración

Abra la carpeta extraída en su IDE y edite los archivos YAML según sea necesario. Entre las ediciones comunes se incluyen:

Cambiar los nombres de conexión para apuntar a un entorno diferente.
Añadir o eliminar tablas de origen en sourceSelection.yaml.
Actualizar la configuración de la tarea, como el tipo de carga o la gestión de esquemas.
Añadir reglas de transformación a un archivo de conjunto de datos.
Añadir una programación a una tarea.

Haga referencia a los nombres de conexión exactamente como están definidos en el espacio de destino. Un nombre de conexión que no coincida provocará un error de importación.

ID de objeto en archivos YAML

Para los objetos referenciados —como un ID de tarea referenciado en la definición de origen de otra tarea—, debe definir un ID único y usarlo de manera coherente en todos los archivos.

Temas relacionados

¿Esta página le ha sido útil?

Si encuentra algún problema con esta página o su contenido (errores tipográficos, pasos que faltan o errores técnicos), no dude en ponerse en contacto con nosotros.

Deje aquí sus comentarios