Gegevenspijplijnen exporteren en importeren

U kunt een gegevenspijplijnproject exporteren naar een bestand dat alles bevat wat nodig is om het gegevensproject te reconstrueren. Het exportbestand kan worden geïmporteerd naar dezelfde tenant of naar een andere tenant. U kunt dit bijvoorbeeld gebruiken om projecten van de ene tenant naar de andere te verplaatsen, of om back-upkopieën van projecten te maken. U kunt ook een project bijwerken vanuit een exportbestand.

Een gegevensproject exporteren

U hebt ten minste een van de volgende rollen nodig in de ruimte waar het project zich bevindt om een project te exporteren:

• Kan bewerken

• Kan weergeven

• Kan bedienen

Doe een van de volgende dingen om een project te exporteren:

• Klik in Gegevensintegratie > Pijplijnprojecten op bij het project dat u wilt exporteren en selecteer Exporteren.

• Open het project, klik op in de rechterbovenhoek en selecteer Exporteren.

Het project wordt geëxporteerd naar een ZIP-bestand met een bestandsnaam die bestaat uit de projectnaam, het gegevensplatform en een tijdstempel.

Projecten importeren

Deze sectie behandelt het importeren van projecten. U kunt een clouddatawarehouse-project of een Qlik Cloud-project (via Amazon S3) importeren.

U kunt wijzigen welk gegevensplatform u wilt gebruiken, met de volgende beperkingen:

• Het is niet mogelijk om het gegevensplatform te wijzigen van een clouddatawarehouse naar Qlik Cloud, of andersom.

• Het is niet mogelijk om een Snowflake-project dat gebruikmaakt van tussenopslag naar cloudbestandsopslag te wijzigen naar een ander gegevensplatform, of andersom.

Voordat u een project importeert

Voordat u begint met het importeren van een project, moet u rekening houden met het volgende:

• Maak alle nieuwe verbindingen die u nodig hebt als u importeert naar een nieuwe tenant of ruimte.

• Als het project SaaS-applicatieverbindingen gebruikt die nog niet bestaan, moet u de verbindingen maken en metagegevens genereren voordat u begint met importeren.

• Als u een projectoverschrijdende pijplijn importeert, moet u eerst de stroomopwaartse projecten importeren.

Een clouddatawarehouse-project importeren

U kunt een geëxporteerd clouddatawarehouse-project importeren naar dezelfde tenant waaruit het is geëxporteerd, of naar een andere tenant. Wanneer het project wordt geïmporteerd in een andere tenant dan de tenant van het oorspronkelijke gegevensproject, moet u nieuwe verbindingen definiëren voor het project, het staginggebied en voor alle gegevensbronnen.

Als het project taken uit andere projecten verbruikt, moet u projecten en taken toewijzen, tenzij de namen voor ruimtes en projecten identiek zijn.

1. Klik in Gegevensintegratie > Pijplijnprojecten op Nieuwe maken en selecteer Project importeren.

2. Voeg het exportbestand toe. U kunt het in het dialoogvenster slepen of bladeren om het bestand te selecteren.

   Klik op Volgende.

3. Stel Projecteigenschappen in voor het nieuwe project.

   U moet in Ruimte selecteren aan welke ruimte u het project wilt toevoegen.

   In Gegevensplatform kunt u het gegevensplatform van het project en de verbinding met het gegevensplatform wijzigen.

   Het wijzigen van de Verbinding is vereist als u een project van een andere tenant hebt geïmporteerd, of als u het gegevensplatform in de vorige stap hebt gewijzigd.

   U kunt de verbinding met het staginggebied wijzigen. Dit is vereist als u een project van een andere tenant hebt geïmporteerd, of in sommige gevallen als u het gegevensplatform in de vorige stap hebt gewijzigd.

   Klik op Volgende.

4. Stel Standaard projectinstellingen in voor het nieuwe project.

   U kunt een voorvoegsel toevoegen aan de gegevensschema's die in het project worden gemaakt in Voorvoegsel voor alle schema's. Dit is handig wanneer het geïmporteerde project zich in hetzelfde clouddatawarehouse bevindt als het geëxporteerde project.

   U kunt ook een standaardnaam instellen in Databasenaam. Voor Snowflake-projecten kunt u een standaard Datawarehouse-naam instellen en voor Databricks-projecten kunt u een standaard Catalogusnaam instellen. U kunt de standaardnaam van het project gebruiken voor alle taaktypen, of de naam instellen op standaard of een aangepaste naam voor elk taaktype.

   Klik op Volgende.

5. Stel Verbindingen en taakinstellingen in.

   U kunt de geïmporteerde bronverbindingen of projectoverschrijdende bronnen vervangen door een verbinding die dezelfde connector gebruikt. Als de geïmporteerde bronverbinding bijvoorbeeld MySQL is, moet de vervangende verbinding ook MySQL zijn. Dit is vereist als u een project van een andere tenant hebt geïmporteerd.

   In Taakinstellingen (optioneel) kunt u ook taakinstellingen wijzigen die u in het oorspronkelijke project wilt overschrijven.

6. Wanneer u klaar bent, klikt u op Importeren.

Het project wordt toegevoegd aan de startpagina van Gegevensintegratie.

Een project importeren met Qlik Cloud als gegevensplatform

U kunt een geëxporteerd Qlik Cloud-project (via Amazon S3) importeren naar dezelfde tenant waaruit het is geëxporteerd, of naar een andere tenant. Wanneer het project wordt geïmporteerd in een andere tenant dan de tenant van het oorspronkelijke gegevensproject, moet u nieuwe verbindingen definiëren voor het project, het staginggebied en voor alle gegevensbronnen.

Het is niet mogelijk om het gegevensplatform te wijzigen van Qlik Cloud naar een clouddatawarehouse, zoals Snowflake.

1. Klik in Gegevensintegratie > Pijplijnprojecten op Nieuwe maken en selecteer Project importeren.

2. Voeg het exportbestand toe. U kunt het in het dialoogvenster slepen of bladeren om het bestand te selecteren.

   Klik op Volgende.

3. Naam

   Wijzig de naam van het project. De standaardnaam is de oorspronkelijke projectnaam met het voorvoegsel Imported_.

4. Ruimte
   Selecteer aan welke ruimte u het project wilt toevoegen.

5. Beschrijving
   Voeg de beschrijving van het project toe of bewerk deze.

6. QVD-bestanden opslaan in:

   Selecteer waar u QVD-bestanden wilt genereren.

   • Door Qlik beheerde opslag

   • Door klant beheerde opslag

     Amazon S3-opslag die door u wordt beheerd.

7. Gegevensverbinding

   Als u Door klant beheerde opslag hebt geselecteerd, kunt u de verbinding met het Amazon S3-opslaggebied wijzigen.

   Dit is vereist als u een project van een andere tenant hebt geïmporteerd.

8. Verbinding met staginggebied

   U kunt de verbinding met het Amazon S3-staginggebied wijzigen.

   Dit is vereist als u een project van een andere tenant hebt geïmporteerd, of in sommige gevallen als u het gegevensplatform in de vorige stap hebt gewijzigd.

9. Klik op Volgende.

10. Verbindingen instellen voor de taken die in de oorspronkelijke versie zijn toegevoegd
    U kunt de geïmporteerde bronverbindingen vervangen door een verbinding die dezelfde connector gebruikt. Als de geïmporteerde bronverbinding bijvoorbeeld MySQL is, moet de vervangende verbinding ook MySQL zijn.

    Dit is vereist als u een project van een andere tenant hebt geïmporteerd.

11. In Taakinstellingen (optioneel) kunt u taakinstellingen wijzigen die u in het oorspronkelijke project wilt overschrijven.

12. Wanneer u klaar bent, klikt u op Importeren.

Het project wordt toegevoegd aan de startpagina van Gegevensintegratie.

Een project bijwerken

U kunt een project bijwerken vanuit een exportbestand. Hiermee worden alle taken in de gegevenspijplijn vervangen, maar verbindingen en instellingen worden niet vervangen. Gegevenstaken die niet in het geïmporteerde project zijn opgenomen, worden verwijderd.

U kunt bijvoorbeeld een project dat is geëxporteerd uit de ontwikkelingsgegevensruimte importeren in een project in de productiegegevensruimte om het productieproject bij te werken.

Voordat u begint met het bijwerken van het project:

• Als u een back-up van het project wilt voordat u het bijwerkt, exporteert u het door op te klikken en vervolgens op Exporteren.

• U moet alle taken stoppen die uit de gegevenspijplijn worden verwijderd voordat u het project bijwerkt.

• Als het project SaaS-applicatieverbindingen gebruikt die nog niet bestaan, moet u de verbindingen maken en metagegevens genereren voordat u begint met importeren.

• Zorg ervoor dat het geïmporteerde project hetzelfde cloudgegevensplatform gebruikt, bijvoorbeeld Snowflake.

Een project bijwerken:

1. Open het project dat u wilt bijwerken.

2. Klik op en klik vervolgens op Importeren.

3. Selecteer of sleep het bestand dat u wilt importeren.

4. Breng de vereiste wijzigingen aan voor het toewijzen van verbindingen die verschillen tussen het project en het geïmporteerde project.

   Het geïmporteerde project kan bijvoorbeeld een bronverbinding met de naam SQL1 gebruiken, terwijl dit project een vergelijkbare verbinding met de naam SQL2 gebruikt. Wijs in dit geval de geïmporteerde verbinding toe aan SQL2 in Verbindingen instellen voor de taken die in de oorspronkelijke versie zijn toegevoegd.

   InformatieWanneer u een verbinding selecteert om toe te wijzen, kunt u een nieuwe databaseverbinding maken, maar geen SaaS-applicatieverbinding.

   Klik op Importeren wanneer u klaar bent.

Het project is nu bijgewerkt volgens het geïmporteerde bestand. Mogelijk moet u gegevenstaken valideren en synchroniseren die via de import zijn bijgewerkt.

Best practices

Hier zijn enkele algemene best practices bij het importeren en exporteren van projecten.

• Vermijd het toevoegen van dezelfde gegevensset aan twee projecten en het importeren van het ene project in het andere project. Dit kan conflicten veroorzaken die moeilijk op te lossen zijn en kan leiden tot het opnieuw maken van gegevenssets:

  InformatieWanneer een gegevensset aan een taak wordt toegevoegd, krijgt deze een interne identificatie. Interne identificaties worden gebruikt om naadloos hernoemen en andere metagegevensbewerkingen in een pijplijn mogelijk te maken. Bij het maken van dezelfde gegevensset in een afzonderlijk project of afzonderlijke vertakking, zal de interne identificatie anders zijn, wat conflicten veroorzaakt bij het importeren van een project in het andere project. Dit kan ertoe leiden dat het voorbereidingsproces een gegevensset verwijdert en opnieuw maakt, zelfs als deze dezelfde naam heeft.

Beperkingen

• Meldingen worden niet opgenomen wanneer u een pijplijn exporteert. U moet nieuwe meldingen instellen in de geïmporteerde pijplijn.

• Opgeslagen SQL-workbench-scripts worden niet opgenomen wanneer u een project exporteert.

  Als u het project als een nieuw project importeert, zijn opgeslagen SQL-workbench-scripts leeg.

  Als u importeert om een bestaand project bij te werken, worden bestaande opgeslagen SQL-workbench-scripts niet gewijzigd.

• Het zip-bestand voor import moet de projectbestanden rechtstreeks bevatten en niet in een geneste submap.

  Wanneer u een zip-bestand maakt in macOS en u op een map klikt en ervoor kiest om deze te zippen, bevat het zip-bestand een geneste submap met de bestanden, wat betekent dat het zip-bestand niet kan worden geïmporteerd.

• Het volgende scenario kan conflicten veroorzaken die moeilijk op te lossen zijn:

  1. Breng wijzigingen aan in dezelfde gegevensset in twee projecten.

  2. Exporteer project 1.

  3. Importeer project 1 in project 2.

• Ontwerp geen pijplijnen die lussen of wederzijdse afhankelijkheden tussen projecten creëren. Het exporteren en importeren van dergelijke projecten wordt niet ondersteund.

• Bij het importeren van een ouder project (voordat JSON-ondersteuning werd geïntroduceerd) met Geregistreerde gegevens en Opslag-taken, werden JSON-velden op de bron toegewezen aan BLOB. Het oorspronkelijke type werd nog steeds behouden op Geregistreerde gegevens, bijvoorbeeld Variant op Snowflake. Bij het importeren nadat JSON-ondersteuning is toegevoegd, kan het logische type veranderen in JSON.