Canalizaciones declarativas

Las canalizaciones declarativas le permiten definir, configurar e implementar proyectos de canalización de datos de Qlik Talend Data Integration completamente en el código, utilizando archivos YAML. Puede editar los archivos en cualquier entorno de desarrollo integrado o sistema de control de versiones y, a continuación, implementarlos para crear o actualizar proyectos.

Cuándo utilizar las canalizaciones declarativas

Utilice las canalizaciones declarativas para promover la:

Colaboración
Integración continua / Entrega continua
Implementación repetible en diferentes entornos
Automatización basada en API

A continuación se presentan algunos casos de uso típicos:

Defina canalizaciones en código para la integración continua y la automatización del desarrollo.
Implemente configuraciones de canalización idénticas en múltiples entornos (desarrollo, verificación, producción).
Reutilice y comparta definiciones de canalizaciones entre proyectos o equipos.
Automate la creación de proyectos a gran escala sin trabajo manual.

Cómo funciona

Un proyecto de canalización se representa como un conjunto de archivos YAML organizados en una estructura de carpetas que refleja las tareas y los conjuntos de datos del proyecto. Los archivos YAML son más fáciles de leer, es más rápido ver las diferencias, leerlos, reutilizar compnentes y crear una automatización.

Puede exportar un proyecto existente como YAML, editar los archivos e importarlos de nuevo para aplicar los cambios. Si el proyecto está conectado al control de versiones, los archivos YAML están disponibles directamente en su repositorio de GitHub.

Para más información sobre la estructura del archivo YAML, vea Recuperación y edición de la configuración de una canalización.

Los archivos de vinculación (qtcp_bindings_definition.json y binding.json) permanecen en formato JSON para la compatibilidad con la API de vinculaciones. Para la exportación heredada o en proyectos de GitHub existentes, el archivo se llama bindingTemplate.json y no qtcp_bindings_definition.json.

Flujo de trabajo típico

Antes de comenzar, debe configurar su entorno de desarrollo y el control de versiones. Para más información, vea Introducción a las canalizaciones declarativas.

Un flujo de trabajo de canalización declarativa típico tiene este aspecto:

Recupere la configuración de la canalización

Puede exportar un proyecto existente como YAML, recuperarlo del control de versiones o comenzar desde una plantilla.

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

Modifique los archivos YAML en su entorno de desarrollo. Puede agregar tareas, cambiar las selecciones de origen y actualizar la configuración.

Guía del desarrollador: Canalizaciones declarativas
Valide la configuración de la canalización

Compruebe si hay errores de sintaxis y semántica en los archivos antes de implementar la canalización.

Validar la configuración de una canalización de datos
Implemente la configuración de la canalización

Importe los archivos para crear o actualizar el proyecto en Qlik Talend Data Integration.

También puede confirmar los archivos en el control de versiones y realizar la operación de aplicar desde el control de versiones en el proyecto en Qlik Talend Data Integration.

Implementar una configuración de canalización

Relación con el control de versiones

Cuando un proyecto está conectado al control de versiones, los archivos YAML se almacenan directamente en su repositorio de GitHub. Puede editar los archivos YAML en GitHub o en cualquier IDE y, a continuación, aplicar los cambios de nuevo al proyecto.

Para más información sobre cómo conectar un proyecto al control de versiones, consulte Administrar sus proyectos de canalización de datos con el control de versiones.

Si tiene un proyecto existente que está conectado al control de versiones y utiliza el formato JSON heredado, puede migrarlo a YAML. Para más información, vea Migrar un proyecto al formato YAML.

Uso de asistentes de IA para configurar canalizaciones

Utilice asistentes de IA (como GitHub Copilot o Anthropic Claude) para agilizar la creación y edición de configuraciones YAML. Para garantizar la exactitud y el cumplimiento de los estándares del proyecto, siga estas mejores prácticas:

Seleccione un modelo de alta capacidad — Utilice un modelo premium de contexto amplio (por ejemplo, Anthropic Claude Sonnet 4.6 o superior) en lugar de un modelo estándar o "auto" para la generación de YAML complejo y el cumplimiento de esquemas. Los modelos avanzados interpretan correctamente esquemas de canalización complejos y producen configuraciones más exactas.
Configure instrucciones de IA específicas del proyecto — Mejore la calidad de la configuración generada por IA proporcionando el contexto del proyecto al modelo. Cree un archivo de instrucciones en la raíz de su espacio de trabajo de VS Code. Escoja uno de los siguientes:
- CLAUDE.md (para la extensión Anthropic Claude Code)
- .github/copilot-instructions.md (para GitHub Copilot)
El contenido de su archivo de instrucciones debe ser el siguiente:
```
This is a Qlik Talend Cloud Pipeline (QTCP) project. Before any project advice or YAML edits, I MUST read the source of truth first:
https://raw.githubusercontent.com/qlik-oss/schemas/refs/heads/main/qtcp/ai-instructions.md
```

¿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