Modificare le pipeline

Questa pagina descrive come modificare le pipeline batch di cui è stato eseguito il deployment in Cloud Data Fusion.

La modifica di una pipeline ti consente di:

  • Aggiungi funzionalità in modo incrementale a una pipeline di cui è stato eseguito il deployment senza creare duplicati. Ad esempio, puoi aggiungere, rimuovere o modificare i plug-in, quindi eseguire nuovamente il deployment della pipeline. La modifica di una pipeline crea una nuova versione della stessa, il che impedisce la proliferazione delle pipeline e consente una migliore organizzazione. La duplicazione di una pipeline crea una nuova pipeline con un nome diverso.
  • Mantieni una cronologia delle versioni modificate.
  • Visualizza e ripristina le versioni precedenti di una pipeline.
  • Modifica qualsiasi parte della pipeline, ad esempio la struttura, la configurazione, i metadati, le preferenze e i commenti.
  • Esporta un file JSON modificato per una pipeline di cui è stato eseguito il deployment.

Quando modifichi la pipeline, Cloud Data Fusion crea una nuova bozza, che diventa la versione più recente. Il nome della pipeline rimane invariato. Puoi sviluppare la pipeline in modo iterativo, senza creare pipeline duplicate con nomi univoci. La versione più recente conserva gli trigger, le configurazioni della pipeline, gli argomenti di runtime, i metadati, i commenti e le pianificazioni della versione precedente. La versione più recente è la versione attiva della pipeline: può essere eseguita o pianificata.

Prima di iniziare

  • Cloud Data Fusion supporta la modifica delle pipeline batch di cui è stato eseguito il deployment nella versione 6.9.1 e successive. Per eseguire l'upgrade alla versione più recente, consulta Eseguire l'upgrade dell'ambiente Cloud Data Fusion.
  • Cloud Data Fusion non supporta la modifica delle pipeline in tempo reale o dei job di replica di cui è stato eseguito il deployment.

Modificare la pipeline

Per modificare una pipeline batch di cui è stato eseguito il deployment in Cloud Data Fusion:

  1. Vai all'istanza:

    1. Nella console Google Cloud, vai alla pagina Cloud Data Fusion.

    2. Per aprire l'istanza in Cloud Data Fusion Studio, fai clic su Istanze e poi su Visualizza istanza.

      Vai a Istanze

  2. Fai clic su Elenco > Implementato.

  3. Vai alla pipeline che vuoi modificare e fai clic su Altro > Modifica.

    Nella pagina Studio viene visualizzata una nuova bozza della pipeline.

  4. Modifica la pipeline. Ad esempio, aggiungi un nuovo nodo di analisi o modifica le proprietà di un'origine.

  5. (Facoltativo) Per completare la modifica della pipeline in un secondo momento, fai clic su Salva.

  6. Al termine della modifica della pipeline, fai clic su Esegui il deployment.

  7. Nella finestra di dialogo Inserisci il riepilogo delle modifiche, inserisci una descrizione delle modifiche apportate alla pipeline e fai clic su Esegui il deployment. La pipeline di cui è stato eseguito il deployment si apre nella pagina Pipeline.

Visualizza o ripristina una versione precedente della pipeline

Per visualizzare o implementare una versione precedente di una pipeline batch:

  1. Apri l'istanza nell'interfaccia di Cloud Data Fusion.
  2. Fai clic su Elenco > Implementato.
  3. Seleziona una pipeline. La pipeline viene visualizzata nella pagina Pipeline.

  4. Fai clic su Cronologia.

    Viene visualizzato un elenco della cronologia delle versioni.

  5. (Facoltativo) Per visualizzare una versione precedente di una pipeline, fai clic su Visualizza.

  6. (Facoltativo) Per ripristinare una versione precedente della pipeline alla versione più recente, fai clic su Ripristina.

    Cloud Data Fusion crea una nuova versione della pipeline e la apre nella pagina Pipeline. Ora è l'ultima versione.

Esportare una versione modificata di una pipeline di cui è stato eseguito il deployment

Puoi esportare la versione modificata di una pipeline di cui è stato eseguito il deployment come file JSON per condividerla con altri sviluppatori, aggiungerla al controllo delle versioni o spostarla da un ambiente di sviluppo a un ambiente di test o di produzione. Ad esempio, dopo aver modificato una pipeline durante le fasi di sviluppo e debug, esporta il file JSON, quindi importalo ed esegui il deployment in un ambiente di produzione.

Esportare la versione più recente

Per esportare la versione più recente della pipeline:

  1. Apri l'istanza nell'interfaccia di Cloud Data Fusion.
  2. Fai clic su Elenco > Implementato.

  3. Seleziona la pipeline da esportare e fai clic su Altro > Esporta.

    Un file JSON con le configurazioni della pipeline della versione più recente viene salvato localmente.

Esportare una versione precedente

Per esportare le versioni precedenti della pipeline:

  1. Apri l'istanza nell'interfaccia di Cloud Data Fusion.
  2. Fai clic su Elenco > Implementato.
  3. Seleziona la pipeline. La versione più recente si apre nella pagina Pipeline.
  4. Fai clic su Cronologia.
  5. Seleziona la versione della pipeline che vuoi esportare e fai clic su Visualizza > Azioni > Esporta.

Importa una versione modificata di una pipeline di cui è stato eseguito il deployment

Tutte le pipeline vengono esportate nello stato Draft. Anche le versioni modificate di una pipeline di cui è stato eseguito il deployment vengono importate nello stato Draft. Per ulteriori informazioni, consulta Importare una pipeline.

Eliminare una versione modificata di una pipeline

Quando elimini la versione più recente di una pipeline di cui è stato eseguito il deployment, vengono eliminate tutte le versioni della pipeline di cui è stato eseguito il deployment. Le bozze delle versioni non vengono eliminate.

La versione della pipeline di bozza ha invece lo stato Orphaned (Orfano). Per risolvere questo stato, esegui il deployment della pipeline di bozza. Cloud Data Fusion crea una nuova pipeline, ovvero la versione più recente.

Stati delle pipeline modificate

Quando modifichi le pipeline, nella pagina Bozze pipeline potrebbero essere visualizzati i seguenti stati.

Stato Descrizione
In corso Hai salvato le modifiche alla pipeline.
Orfani La versione più recente della pipeline è stata eliminata e le bozze associate non appartengono più a una pipeline esistente. Potresti visualizzare questo stato se qualcuno elimina la pipeline con il seguente endpoint: DELETE/v3/namespaces/NAMESPACE_ID/apps/APP_ID .
Obsolete È stata implementata una versione più recente mentre erano in corso le modifiche. Potresti visualizzare questo stato se un altro sviluppatore esegue il deployment della pipeline prima del completamento della modifica. Si tratta dello stesso stato Bozza non aggiornata visualizzato nella pagina Pipeline.

Quando modifichi le pipeline, nella pagina Studio possono essere visualizzati i seguenti stati.

Stato Descrizione
Modifica in corso Stai modificando la bozza di una pipeline.
Bozza orfana Qualcuno ha implementato una versione più recente mentre stavi modificando la pipeline.

Passaggi successivi