Distribuzione di una configurazione di pipeline
È possibile distribuire una configurazione di pipeline importando un file ZIP contenente i file di configurazione YAML. È possibile utilizzare l'interfaccia utente o l'API di importazione per creare nuovi progetti o aggiornare quelli esistenti. Entrambi accettano YAML minimizzato e il formato JSON legacy.
Quando si utilizza il controllo versione, è possibile eseguire il commit delle modifiche e Applica da remoto per inserirle in Qlik Talend Data Integration.
Prima di iniziare
Prima di importare:
-
Verificare che tutte le connessioni a cui si fa riferimento nei file YAML esistano nello spazio di destinazione. I nomi delle connessioni nel file YAML devono corrispondere esattamente.
-
Se la pipeline include riferimenti tra progetti, ad esempio, un'attività della pipeline che legge da un'attività di trasferimento in un altro progetto, importare prima il progetto a monte.
-
Convalidare i file di configurazione per verificare che non ci siano errori. Vedere Validazione di una configurazione di pipeline.
Importazione dall'interfaccia utente
Creazione di un nuovo progetto
Per creare un nuovo progetto da un file di configurazione:
-
In Integrazione dati > Progetti pipeline, fare clic su Crea nuovo.
-
Selezionare Importa progetto.
-
Selezionare lo spazio di destinazione.
-
Caricare il file ZIP contenente la configurazione.
-
Fare clic su Importa.
Se l'importazione riesce, il progetto si apre. Se ci sono errori, viene visualizzato un elenco di messaggi di convalida. Correggere gli errori nei file di configurazione e riprovare.
Aggiornamento di un progetto esistente
Per aggiornare un progetto esistente con una nuova configurazione:
-
In Integrazione dati > Progetti pipeline, fare clic
sul progetto e selezionare Importa. -
Caricare il file ZIP contenente la configurazione aggiornata.
-
Fare clic su Importa.
Importazione tramite l'API
L'API di importazione accetta un file ZIP e l'ID dello spazio di destinazione. Restituisce il progetto aggiornato in caso di successo, o un elenco di errori se la convalida fallisce.
L'API di importazione supporta sia le esportazioni YAML (minimizzate o complete) che quelle JSON legacy. Non è necessario convertire le esportazioni JSON esistenti prima dell'importazione.
Applicazione delle modifiche dal controllo versione
Se il progetto è connesso a un repository di controllo della versione, è possibile applicare le modifiche remote direttamente dal progetto. Quando si applicano le modifiche, Qlik Talend Data Integration legge i file YAML correnti dal ramo connesso e li importa.
La convalida viene eseguita prima che le modifiche vengano applicate. In caso di errori, si ricevono gli stessi messaggi di errore di un'importazione manuale.
Per i dettagli sulla configurazione del controllo della versione, vedere Gestione dei progetti pipeline con il controllo della versione.
Gestione degli errori di importazione
Quando l'importazione fallisce, Qlik Talend Data Integration restituisce un elenco di errori di convalida. Ogni errore include il tipo di errore e il percorso del file o della proprietà dove è stato riscontrato il problema.
Fino a 50 errori vengono restituiti per tentativo di importazione. Correggere gli errori segnalati e reimportare per verificare la presenza di ulteriori problemi.
Per una descrizione di ogni tipo di errore e come risolverlo, vedere Validazione di una configurazione di pipeline.