Pipeline dichiarative

Ultimo aggiornamento: 15/09/2026

Le pipeline dichiarative consentono di definire, configurare e distribuire Qlik Talend Data Integration progetti di pipeline interamente nel codice utilizzando file YAML. Modifichi i file in qualsiasi ambiente di sviluppo integrato o sistema di controllo della versione, quindi li distribuisci per creare o aggiornare progetti.

Quando usare pipeline dichiarative

Usa pipeline dichiarative per promuovere:

• Collaborazione

• Integrazione Continua / Consegna Continua

• Ripetibile distribuzione a diversi ambienti

• Automazione basata su API

Di seguito sono riportati alcuni casi d'uso tipici:

• Definisci pipeline nel codice per l'integrazione continua e l'automazione dello sviluppo.

• Implementa configurazioni di pipeline identiche su più ambienti (sviluppo, verifica, produzione).

• Riutilizza e condividi definizioni di pipeline tra progetti o team.

• Automate la creazione di progetti su larga scala senza lavoro manuale.

Funzionamento

Un progetto pipeline è rappresentato come un insieme di file YAML organizzato in una struttura di cartelle che rispecchia le attività e i set di dati del progetto. I file YAML sono più facili da leggere, vedere le differenze, revisionare, riutilizzare e creare automazione.

È possibile esportare un progetto esistente come YAML, modificare i file e importarli nuovamente per applicare le modifiche. Se il progetto è connesso al controllo della versione, i file YAML sono direttamente disponibili nel tuo repository GitHub.

Per maggiori informazioni sulla struttura del file YAML, vedere Recuperare e modificare una configurazione di pipeline.

Flusso di lavoro tipico

Prima di iniziare, devi configurare il tuo ambiente di sviluppo e il controllo della versione. Per ulteriori informazioni, vedere Introduzione alle pipeline dichiarative.

Un tipico flusso di lavoro di pipeline dichiarativa è il seguente:

1. Recupera la configurazione della pipeline

   È possibile esportare un progetto esistente come YAML, recuperarlo dal controllo della versione o iniziare da un modello.

   Recuperare e modificare una configurazione di pipeline

2. Modifica la configurazione della pipeline

   Modifica i file YAML nel tuo ambiente di sviluppo. È possibile aggiungere attività, modificare le selezioni di origine e aggiornare le impostazioni.

   Guida per gli sviluppatori: pipeline assertive

3. Convalida la configurazione della pipeline

   Controlla i file per errori di sintassi e semantici prima di distribuire la pipeline.

   Validazione di una configurazione di pipeline

4. Distribuisci la configurazione della pipeline

   Importa i file per creare o aggiornare il progetto in Qlik Talend Data Integration.

   Puoi anche eseguire il commit dei file al controllo della versione e applicare dal controllo della versione nel progetto in Qlik Talend Data Integration.

   Distribuzione di una configurazione di pipeline

Rapporto con il controllo versioni

Quando un progetto è connesso al controllo della versione, i file YAML vengono archiviati direttamente nel tuo repository GitHub. È possibile modificare i file YAML in GitHub o in qualsiasi IDE, quindi applicare le modifiche al progetto.

Per informazioni sulla connessione di un progetto al controllo della versione, vedere Gestione dei progetti pipeline con il controllo della versione.

Utilizzo di assistenti AI per configurare pipeline

Usa gli assistenti AI (come GitHub Copilot o Anthropic Claude) per semplificare la creazione e la modifica della configurazione YAML. Per garantire accuratezza e l'aderenza agli standard di progetto, segui queste migliori pratiche:

1. Seleziona un modello ad alta capacità — Utilizza un modello premium con contesto ampio (ad esempio, Anthropic Claude Sonnet 4.6 o superiore) piuttosto che un modello standard o "automatico" per la generazione complessa di YAML e l'aderenza allo schema. Modelli avanzati interpretano correttamente schemi di pipeline complessi e producono configurazioni più accurate.

2. Configura istruzioni AI specifiche per il progetto — Migliora la qualità della configurazione generata dall'IA fornendo il contesto del progetto al modello. Crea un file di istruzioni nella radice della tua area di lavoro di VS Code. scegliere una delle seguenti opzioni elencate di seguito.

   • CLAUDE.md (per l'estensione del codice Anthropic Claude)

   • .github/copilot-instructions.md (per GitHub Copilot)

   Il contenuto del tuo file di istruzioni dovrebbe essere il seguente:

   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

Utilizzo degli assistenti AI con Qlik strumenti MCP

Quando distribuisci un Qlik server MCP nel tuo tenant, gli assistenti AI possono utilizzare strumenti MCP dedicati per aiutare a gestire i progetti di pipeline in modo programmatico.

Prerequisiti

• Qlik Il server MCP è distribuito nel tuo tenant

• Disponi del Qlik MCP: Consentito permesso assegnato tramite un ruolo personalizzato

• Hai le autorizzazioni per creare o modificare progetti pipeline

• Un client AI con supporto MCP (come VS Code con GitHub Copilot) è configurato per utilizzare il Qlik server MCP

Disponibili funzionalità MCP per pipeline di dati

Gli assistenti AI possono utilizzare le seguenti funzionalità per configurare e gestire progetti pipeline:

• Cerca spazi — Ottieni un elenco di spazi disponibili.

• Cerca connessioni — Ottieni un elenco delle connessioni dati disponibili.

• Cerca progetti — Ottieni un elenco di progetti pipeline esistenti.

• Ricerca di oggetti di connessione — Scopri tabelle e viste disponibili da una sorgente dati.

• Ottieni i dettagli del progetto pipeline — Recupera i valori di associazione del progetto.

Risorse correlate

• Per distribuire il server MCP, vedere Qlik MCP server

• Per la documentazione dettagliata degli strumenti MCP, consultare Qlik strumenti MCP

• Per i requisiti di autorizzazione, vedere Qlik accesso e autorizzazioni del server MCP