Esportazione e importazione di pipeline di dati

È possibile esportare un progetto di pipeline di dati in un file che contiene tutto il necessario per ricostruire il progetto dati. Il file di esportazione può essere importato nello stesso tenant o in un altro tenant. È possibile utilizzare questa funzionalità, ad esempio, per spostare progetti da un tenant all'altro o per creare copie di backup dei progetti. È inoltre possibile aggiornare un progetto da un file di esportazione.

Esportazione di un progetto dati

Per esportare un progetto, è necessario disporre di almeno uno dei seguenti ruoli nello spazio in cui risiede il progetto:

• Può modificare

• Può visualizzare

• Può operare

Per esportare un progetto, effettuare una delle seguenti operazioni:

• In Integrazione dati > Progetti di pipeline, fare clic su sul progetto da esportare e selezionare Esporta.

• Aprire il progetto, fare clic su in alto a destra e selezionare Esporta.

Il progetto viene esportato in un file ZIP con un nome file composto dal nome del progetto, dalla piattaforma dati e da un timestamp.

Importazione di progetti

Questa sezione illustra l'importazione di progetti. È possibile importare un progetto di data warehouse cloud o un progetto Qlik Cloud (tramite Amazon S3).

È possibile modificare la piattaforma dati da utilizzare con le seguenti limitazioni:

• Non è possibile modificare la piattaforma dati da un data warehouse cloud a Qlik Cloud o viceversa.

• Non è possibile modificare un progetto Snowflake che utilizza il trasferimento nell'archiviazione file cloud in un'altra piattaforma dati o viceversa.

Prima di importare un progetto

Prima di iniziare a importare un progetto, considerare quanto segue:

• Creare tutte le nuove connessioni necessarie se si sta importando in un nuovo tenant o spazio.

• Se il progetto utilizza connessioni di applicazione SaaS che non esistono ancora, è necessario creare le connessioni e generare i metadati prima di iniziare l'importazione.

• Se si sta importando una pipeline tra progetti, è necessario importare prima i progetti a monte.

Importazione di un progetto di data warehouse cloud

È possibile importare un progetto di data warehouse cloud esportato nello stesso tenant da cui è stato esportato o in un altro tenant. Quando il progetto viene importato in un tenant diverso da quello del progetto dati originale, è necessario definire nuove connessioni per il progetto, l'area di staging e per tutte le sorgenti dati.

Se il progetto utilizza attività di altri progetti, è necessario mappare progetti e attività a meno che i nomi degli spazi e dei progetti non siano identici.

1. In Integrazione dati > Progetti di pipeline, fare clic su Crea nuovo e selezionare Importa progetto.

2. Aggiungere il file di esportazione. È possibile trascinarlo nella finestra di dialogo o sfogliare per selezionare il file.

   Fare clic su Avanti.

3. Impostare le Proprietà del progetto per il nuovo progetto.

   È necessario selezionare lo spazio a cui aggiungere il progetto in Spazio.

   In Piattaforma dati è possibile modificare la piattaforma dati del progetto e la connessione alla piattaforma dati.

   La modifica della Connessione è necessaria se si è importato un progetto da un altro tenant o se si è modificata la piattaforma dati nel passaggio precedente.

   È possibile modificare la connessione all'area di staging. Ciò è necessario se si è importato un progetto da un altro tenant o, in alcuni casi, se si è modificata la piattaforma dati nel passaggio precedente.

   Fare clic su Avanti.

4. Impostare le Impostazioni predefinite del progetto per il nuovo progetto.

   È possibile aggiungere un prefisso agli schemi di dati creati nel progetto in Prefisso per tutti gli schemi. Ciò è utile quando il progetto importato si trova nello stesso data warehouse cloud del progetto esportato.

   È inoltre possibile impostare un nome predefinito in Nome database. Per i progetti Snowflake è possibile impostare un Nome data warehouse predefinito e per i progetti Databricks è possibile impostare un Nome catalogo predefinito. È possibile utilizzare il nome predefinito del progetto per tutti i tipi di attività oppure impostare il nome su predefinito o su un nome personalizzato per ciascun tipo di attività.

   Fare clic su Avanti.

5. Impostare Connessioni e impostazioni attività.

   È possibile sostituire le connessioni di origine importate o le origini tra progetti con una connessione che utilizza lo stesso connettore. Ad esempio, se la connessione di origine importata è MySQL, anche la connessione sostitutiva deve essere MySQL. Ciò è necessario se si è importato un progetto da un altro tenant.

   In Impostazioni attività (Opzionale) è inoltre possibile modificare le impostazioni dell'attività che si desidera sovrascrivere nel progetto originale.

6. Quando si è pronti, fare clic su Importa.

Il progetto viene aggiunto alla home di Data Integration.

Importazione di un progetto con Qlik Cloud come piattaforma dati

È possibile importare un progetto Qlik Cloud (tramite Amazon S3) esportato nello stesso tenant da cui è stato esportato o in un altro tenant. Quando il progetto viene importato in un tenant diverso da quello del progetto dati originale, è necessario definire nuove connessioni per il progetto, l'area di staging e per tutte le sorgenti dati.

Non è possibile modificare la piattaforma dati da Qlik Cloud a un data warehouse cloud, come Snowflake.

1. In Integrazione dati > Progetti di pipeline, fare clic su Crea nuovo e selezionare Importa progetto.

2. Aggiungere il file di esportazione. È possibile trascinarlo nella finestra di dialogo o sfogliare per selezionare il file.

   Fare clic su Avanti.

3. Nome

   Modificare il nome del progetto. Il nome predefinito è il nome del progetto originale con il prefisso Imported_.

4. Spazio
   Selezionare lo spazio a cui aggiungere il progetto.

5. Descrizione
   Aggiungere o modificare la descrizione del progetto.

6. Archivia i file QVD in:

   Selezionare dove generare i file QVD.

   • Archiviazione gestita da Qlik

   • Archiviazione gestita dal cliente

     Archiviazione Amazon S3 gestita dall'utente.

7. Connessione dati

   Se si è selezionato Archiviazione gestita dal cliente, è possibile modificare la connessione all'area di archiviazione Amazon S3.

   Ciò è necessario se si è importato un progetto da un altro tenant.

8. Connessione all'area di staging

   È possibile modificare la connessione all'area di staging Amazon S3.

   Ciò è necessario se si è importato un progetto da un altro tenant o, in alcuni casi, se si è modificata la piattaforma dati nel passaggio precedente.

9. Fare clic su Avanti.

10. Imposta connessioni per le attività aggiunte nella versione originale
    È possibile sostituire le connessioni di origine importate con una connessione che utilizza lo stesso connettore. Ad esempio, se la connessione di origine importata è MySQL, anche la connessione sostitutiva deve essere MySQL.

    Ciò è necessario se si è importato un progetto da un altro tenant.

11. In Impostazioni attività (Opzionale) è possibile modificare le impostazioni dell'attività che si desidera sovrascrivere nel progetto originale.

12. Quando si è pronti, fare clic su Importa.

Il progetto viene aggiunto alla home di Data Integration.

Aggiornamento di un progetto

È possibile aggiornare un progetto da un file di esportazione. Questo sostituirà tutte le attività nella pipeline di dati, ma le connessioni e le impostazioni non verranno sostituite. Le attività sui dati che non sono incluse nel progetto importato verranno rimosse.

Ad esempio, è possibile importare un progetto esportato dallo spazio dati di sviluppo in un progetto nello spazio dati di produzione per aggiornare il progetto di produzione.

Prima di iniziare ad aggiornare il progetto:

• Se si desidera un backup del progetto prima dell'aggiornamento, esportarlo facendo clic su , quindi su Esporta.

• È necessario arrestare tutte le attività che verranno rimosse dalla pipeline di dati prima di aggiornare il progetto.

• Se il progetto utilizza connessioni di applicazione SaaS che non esistono ancora, è necessario creare le connessioni e generare i metadati prima di iniziare l'importazione.

• Assicurarsi che il progetto importato utilizzi la stessa piattaforma dati cloud, ad esempio Snowflake.

Per aggiornare un progetto:

1. Aprire il progetto che si desidera aggiornare.

2. Fare clic su , quindi fare clic su Importa.

3. Selezionare o trascinare il file che si desidera importare.

4. Apportare le modifiche necessarie per mappare le connessioni che sono diverse tra il progetto e il progetto importato.

   Ad esempio, il progetto importato potrebbe utilizzare una connessione di origine denominata SQL1, mentre questo progetto utilizza una connessione simile denominata SQL2. In questo caso, mappare la connessione importata a SQL2 in Imposta connessioni per le attività aggiunte nella versione originale.

   Nota informaticaQuando si seleziona una connessione da mappare, è possibile creare una nuova connessione al database, ma non una connessione di applicazione SaaS.

   Fare clic su Importa quando si è pronti.

Il progetto è ora aggiornato in base al file importato. Potrebbe essere necessario convalidare e sincronizzare le attività sui dati che sono state aggiornate tramite l'importazione.

Best practice

Di seguito sono riportate alcune best practice generali per l'importazione e l'esportazione di progetti.

• Evitare di aggiungere lo stesso set di dati a due progetti e di importare un progetto nell'altro progetto. Ciò può creare conflitti difficili da risolvere e può causare la ricreazione dei set di dati:

  Nota informaticaQuando un set di dati viene aggiunto a un'attività, ottiene un identificatore interno. Gli identificatori interni vengono utilizzati per consentire la ridenominazione senza interruzioni e altre operazioni sui metadati in una pipeline. Quando si crea lo stesso set di dati in un progetto o ramo separato, l'identificatore interno sarà diverso, causando conflitti durante l'importazione di un progetto nell'altro progetto. Ciò potrebbe far sì che il processo di preparazione elimini e ricrei un set di dati anche se ha lo stesso nome.

Limitazioni

• Le notifiche non sono incluse quando si esporta una pipeline. È necessario configurare nuove notifiche nella pipeline importata.

• Gli script SQL workbench salvati non sono inclusi quando si esporta un progetto.

  Se si importa il progetto come nuovo progetto, gli script SQL workbench salvati sono vuoti.

  Se si importa per aggiornare un progetto esistente, gli script SQL workbench salvati esistenti non vengono modificati.

• Il file zip per l'importazione deve contenere i file di progetto direttamente al suo interno e non in una sottocartella nidificata.

  Quando si crea un file zip in macOS, se si fa clic su una cartella e si sceglie di comprimerla, il file zip includerà una sottocartella nidificata contenente i file, il che significa che il file zip non può essere importato.

• Lo scenario seguente può creare conflitti difficili da risolvere:

  1. Apportare modifiche allo stesso set di dati in due progetti.

  2. Esportare il progetto 1.

  3. Importare il progetto 1 nel progetto 2.

• Non progettare pipeline che creano cicli o dipendenze reciproche tra i progetti. L'esportazione e l'importazione di tali progetti non sono supportate.

• Quando si importa un progetto precedente (prima dell'introduzione del supporto JSON) con dati registrati e attività di archiviazione, i campi JSON sull'origine venivano mappati a BLOB. Il tipo nativo veniva comunque mantenuto sui dati registrati, ad esempio Variant su Snowflake. Quando si importa dopo l'aggiunta del supporto JSON, il tipo logico potrebbe cambiare in JSON.