Een SSIS-pakket uitvoeren met de activiteit SSIS-pakket uitvoeren in de Azure Data Factory Studio-portal

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

In dit artikel wordt beschreven hoe u een SSIS-pakket (SQL Server Integration Services) uitvoert in een Azure Data Factory-pijplijn met behulp van de activiteit SSIS-pakket uitvoeren en de gebruikersinterface van de Azure Data Factory Studio-portal.

Vereisten

Maak een Azure-SSIS Integration Runtime (IR) als u er nog geen hebt door de stapsgewijs instructies te volgen in de Zelfstudie:Inrichting Azure-SSIS IR .

Een pijplijn maken met een activiteit SSIS-pakket uitvoeren

In deze stap gebruikt u de gebruikersinterface Data Factory app om een pijplijn te maken. U voegt een activiteit SSIS-pakket uitvoeren toe aan de pijplijn en configureert deze om uw SSIS-pakket uit te voeren.

1. Selecteer op Data Factory overzicht of startpagina van de Azure Portal de tegel Author & Monitor om de gebruikersinterface of app van Data Factory te starten op een afzonderlijk tabblad.

   

   Selecteer op de startpagina Orchestrate.

   

2. Vouw in de werkset Activiteiten de tekst Algemeen uit. Sleep vervolgens een activiteit SSIS-pakket uitvoeren naar het ontwerpoppervlak voor pijplijnen.

   

   Selecteer het activiteitsobject SSIS-pakket uitvoeren om de tabbladen Algemeen, Instellingen, SSIS-parameters, Verbindingsmanagers en Eigenschappen overschrijvingen te configureren.

Tabblad Algemeen

Voer op het tabblad Algemeen van de activiteit SSIS-pakket uitvoeren de volgende stappen uit.

1. Voer bij Naam de naam in van de activiteit SSIS-pakket uitvoeren.

2. Voer bij Beschrijving de beschrijving in van de activiteit SSIS-pakket uitvoeren.

3. Voer bij Time-out de maximale tijd in die de activiteit SSIS-pakket uitvoeren kan worden uitgevoerd. De standaardwaarde is 7 dagen. De indeling is D.HH:MM:SS.

4. Voer bij Opnieuw proberen het maximum aantal nieuwe pogingen in voor de activiteit SSIS-pakket uitvoeren.

5. Voer bij Interval voor opnieuw proberen het aantal seconden in tussen elke nieuwe poging voor de activiteit SSIS-pakket uitvoeren. De standaardwaarde is 30 seconden.

6. Schakel het selectievakje Beveiligde uitvoer in om te kiezen of u de uitvoer van de activiteit SSIS-pakket uitvoeren wilt uitsluiten van logboekregistratie.

7. Schakel het selectievakje Beveiligde invoer in om te kiezen of u de invoer van de activiteit Execute SSIS Package wilt uitsluiten van logboekregistratie.

Tabblad Instellingen

Voer op Instellingen tabblad SSIS-pakket uitvoeren de volgende stappen uit.

1. Voor Azure-SSIS IR selecteert u de aangewezen Azure-SSIS IR om uw activiteit SSIS-pakket uitvoeren uit te voeren.

2. Voer bij Beschrijving de beschrijving in van de activiteit SSIS-pakket uitvoeren.

3. Schakel het selectievakje Windows verificatie in om te kiezen of u Windows-verificatie wilt gebruiken voor toegang tot gegevensopslag, zoals SQL-servers/bestands shares on-premises of Azure Files.

   Als u dit selectievakje incheckt, voert u de waarden voor de uitvoeringsreferenties van het pakket in de vakken Domein, Gebruikersnaam en Wachtwoord in. Als u bijvoorbeeld toegang wilt Azure Files, is het domein , is de Azure gebruikersnaam en is het wachtwoord <storage account name> <storage account key> .

   U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

4. Schakel het selectievakje 32-bits runtime in om te kiezen of uw pakket 32-bits runtime nodig heeft om te worden uitgevoerd.

5. Bij Pakketlocatie selecteert u SSISDB, Bestandssysteem (pakket), Bestandssysteem (Project), Ingesloten pakket of Pakketopslag.

Pakketlocatie: SSISDB

SSISDB als uw pakketlocatie wordt automatisch geselecteerd als uw Azure-SSIS IR is ingericht met een SSIS-catalogus (SSISDB) die wordt gehost door Azure SQL Database-server/beheerd exemplaar of als u deze zelf kunt selecteren. Als deze optie is geselecteerd, moet u de volgende stappen voltooien.

1. Als uw Azure-SSIS IR wordt uitgevoerd en het selectievakje Handmatige vermeldingen is gewist, bladert en selecteert u uw bestaande mappen, projecten, pakketten en omgevingen van SSISDB. Selecteer Vernieuwen om de zojuist toegevoegde mappen, projecten, pakketten of omgevingen op te halen uit SSISDB, zodat deze beschikbaar zijn om te bladeren en te selecteren. Als u door de omgevingen voor uw pakketuitvoeringen wilt bladeren en deze wilt selecteren, moet u uw projecten vooraf configureren om deze omgevingen toe te voegen als verwijzingen uit dezelfde mappen onder SSISDB. Zie SSIS-omgevingen maken en in kaart brengen voor meer informatie.

2. Selecteer bij Logboekregistratieniveau een vooraf gedefinieerd bereik van logboekregistratie voor de uitvoering van uw pakket. Schakel het selectievakje Aangepast in als u in plaats daarvan de naam van uw aangepaste logboekregistratie wilt invoeren.

3. Als uw Azure-SSIS IR niet wordt uitgevoerd of het selectievakje Handmatige vermeldingen is ingeschakeld, voert u uw pakket- en omgevingspaden van SSISDB rechtstreeks in de volgende indelingen in: <folder name>/<project name>/<package name>.dtsx en <folder name>/<environment name> .

   

Pakketlocatie: Bestandssysteem (pakket)

Bestandssysteem (pakket) als pakketlocatie wordt automatisch geselecteerd als uw Azure-SSIS IR is ingericht zonder SSISDB of als u deze zelf kunt selecteren. Als deze optie is geselecteerd, moet u de volgende stappen voltooien.

1. Geef het pakket op dat moet worden uitgevoerd door een UNC-pad (Universal Naming Convention) naar uw pakketbestand (met ) in het vak .dtsx Pakketpad op te geven. U kunt door uw pakket bladeren en dit selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw pakket bijvoorbeeld op een Azure Files, is het pad \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx .

2. Als u uw pakket in een afzonderlijk bestand configureert, moet u ook een UNC-pad naar uw configuratiebestand (met ) in het vak .dtsConfig Configuratiepad geven. U kunt door uw configuratie bladeren en deze selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw configuratie bijvoorbeeld op een Azure Files, is het pad \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig .

3. Geef de referenties op voor toegang tot uw pakket- en configuratiebestanden. Als u eerder de waarden voor de uitvoeringsreferenties van uw pakket hebt ingevoerd (voor Windows-verificatie), kunt u deze opnieuw gebruiken door het selectievakje Hetzelfde als referenties voor pakketuitvoering in te schakelen. Voer anders de waarden voor uw pakkettoegangsreferenties in de vakken Domein, Gebruikersnaam en Wachtwoord in. Als u bijvoorbeeld uw pakket en configuratie in Azure Files opgeslagen, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> .

   U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

   Deze referenties worden ook gebruikt voor toegang tot uw onderliggende pakketten in Pakkettaak uitvoeren waarnaar wordt verwezen door hun eigen pad en andere configuraties die zijn opgegeven in uw pakketten.

4. Als u het beveiligingsniveau EncryptAllWithPassword of EncryptSensitiveWithPassword hebt gebruikt bij het maken van uw pakket via SQL Server Data Tools (SSDT), voert u de waarde voor uw wachtwoord in het vak Versleutelingswachtwoord in. U kunt ook een geheim dat is opgeslagen in uw Azure Key Vault als waarde gebruiken (zie hierboven).

   Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt, moet u uw gevoelige waarden opnieuw invoeren in configuratiebestanden of op de tabbladen SSIS-parameters, verbindingsmanagers of eigenschapsonderschrijvingen (zie hieronder).

   Als u het beveiligingsniveau EncryptAllWithUserKey hebt gebruikt, wordt dit niet ondersteund. U moet uw pakket opnieuw configureren om een ander beveiligingsniveau te gebruiken via SSDT of het dtutil opdrachtregelprogramma.

5. Selecteer bij Logboekregistratieniveau een vooraf gedefinieerd bereik van logboekregistratie voor de uitvoering van uw pakket. Schakel het selectievakje Aangepast in als u in plaats daarvan de naam van uw aangepaste logboekregistratie wilt invoeren.

6. Als u de uitvoeringen van uw pakket wilt vastleggen naast het gebruik van de standaardlogboekproviders die in uw pakket kunnen worden opgegeven, geeft u de logboekmap op door het UNC-pad op te geven in het vak Logboekregistratiepad. U kunt door uw logboekmap bladeren en deze selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw logboeken bijvoorbeeld op een Azure Files, is uw logboekregistratiepad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name> . In dit pad wordt een submap gemaakt voor elke afzonderlijke pakketuitleiding, met de naam van de run-id van de activiteit SSIS-pakket uitvoeren, en waarin elke vijf minuten logboekbestanden worden gegenereerd.

7. Geef de referenties op voor toegang tot de logboekmap. Als u eerder de waarden voor uw pakkettoegangsreferenties hebt ingevoerd (zie hierboven), kunt u deze opnieuw gebruiken door het selectievakje Hetzelfde als referenties voor pakkettoegang in te selecteren. Voer anders de waarden voor uw aanmeldingsreferenties voor logboekregistratie in de vakken Domein, Gebruikersnaam en Wachtwoord in. Als u uw logboeken bijvoorbeeld op een Azure Files, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> . U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken (zie hierboven).

Voor alle EERDER genoemde UNC-paden moet de volledig gekwalificeerde bestandsnaam uit minder dan 260 tekens bestaan. De mapnaam moet uit minder dan 248 tekens bestaan.

Pakketlocatie: Bestandssysteem (Project)

Als u Bestandssysteem (Project) als uw pakketlocatie selecteert, moet u de volgende stappen voltooien.

1. Geef het uit te voeren pakket op door een UNC-pad naar uw projectbestand (met ) op te geven in het .ispac vak Project-pad en een pakketbestand (met ) van uw project in het vak .dtsx Pakketnaam. U kunt door uw project bladeren en dit selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw project bijvoorbeeld op een Azure Files, is het pad \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac .

2. Geef de referenties op voor toegang tot uw project en pakketbestanden. Als u eerder de waarden voor de uitvoeringsreferenties van uw pakket hebt ingevoerd (voor Windows-verificatie), kunt u deze opnieuw gebruiken door het selectievakje Hetzelfde als referenties voor pakketuitvoering in te schakelen. Voer anders de waarden voor uw pakkettoegangsreferenties in de vakken Domein, Gebruikersnaam en Wachtwoord in. Als u uw project en pakket bijvoorbeeld op een Azure Files, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> .

   U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

   Deze referenties worden ook gebruikt voor toegang tot uw onderliggende pakketten in Pakkettaak uitvoeren waarnaar wordt verwezen vanuit hetzelfde project.

3. Als u het beveiligingsniveau EncryptAllWithPassword of EncryptSensitiveWithPassword hebt gebruikt bij het maken van uw pakket via SSDT, voert u de waarde voor uw wachtwoord in het vak Versleutelingswachtwoord in. U kunt ook een geheim dat is opgeslagen in uw Azure Key Vault als waarde gebruiken (zie hierboven).

   Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt, moet u uw gevoelige waarden opnieuw invoeren op de tabbladen SSIS-parameters, Verbindingsmanagers of Overschrijvingen van eigenschappen (zie hieronder).

   Als u het beveiligingsniveau EncryptAllWithUserKey hebt gebruikt, wordt dit niet ondersteund. U moet uw pakket opnieuw configureren om een ander beveiligingsniveau te gebruiken via SSDT of het dtutil opdrachtregelprogramma.

4. Selecteer bij Logboekregistratieniveau een vooraf gedefinieerd bereik van logboekregistratie voor de uitvoering van uw pakket. Schakel het selectievakje Aangepast in als u in plaats daarvan de naam van uw aangepaste logboekregistratie wilt invoeren.

5. Als u de uitvoeringen van uw pakket wilt vastleggen naast het gebruik van de standaardlogboekproviders die in uw pakket kunnen worden opgegeven, geeft u de logboekmap op door het UNC-pad op te geven in het vak Logboekregistratiepad. U kunt door uw logboekmap bladeren en deze selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw logboeken bijvoorbeeld op een Azure Files, is uw logboekregistratiepad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name> . In dit pad wordt een submap gemaakt voor elke afzonderlijke pakketuitleiding, met de naam van de run-id van de activiteit SSIS-pakket uitvoeren, en waarin elke vijf minuten logboekbestanden worden gegenereerd.

6. Geef de referenties op voor toegang tot uw logboekmap. Als u eerder de waarden voor uw pakkettoegangsreferenties hebt ingevoerd (zie hierboven), kunt u deze opnieuw gebruiken door het selectievakje Hetzelfde als referenties voor pakkettoegang in te selecteren. Voer anders de waarden voor uw aanmeldingsreferenties voor logboekregistratie in de vakken Domein, Gebruikersnaam en Wachtwoord in. Als u uw logboeken bijvoorbeeld op een Azure Files, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> . U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken (zie hierboven).

Voor alle EERDER genoemde UNC-paden moet de volledig gekwalificeerde bestandsnaam uit minder dan 260 tekens bestaan. De mapnaam moet uit minder dan 248 tekens bestaan.

Pakketlocatie: Ingesloten pakket

Als u Embedded-pakket als pakketlocatie selecteert, moet u de volgende stappen voltooien.

1. Sleep het pakketbestand (met ) of .dtsx Upload uit een bestandsmap naar het opgegeven vak. Uw pakket wordt automatisch gecomprimeerd en ingesloten in de nettolading van de activiteit. Nadat het pakket is ingesloten, kunt u het pakket later downloaden voor bewerking. U kunt uw ingesloten pakket ook parameteriseren door het toe te wijzen aan een pijplijnparameter die kan worden gebruikt in meerdere activiteiten, waardoor de grootte van de nettolading van de pijplijn wordt geoptimaliseerd. Het insluiten van projectbestanden (met ) wordt momenteel niet ondersteund, dus u kunt geen SSIS-parameters/verbindingsmanagers met een bereik op projectniveau gebruiken in uw .ispac ingesloten pakketten.

2. Als uw ingesloten pakket niet allemaal is versleuteld en we het gebruik van Execute Package Task (EPT) detecteren, wordt het selectievakje Pakkettaak uitvoeren automatisch geselecteerd en worden uw onderliggende pakketten waarnaar wordt verwezen door het bestandssysteempad automatisch toegevoegd, zodat u ze ook kunt insluiten.

   Als het gebruik van EPT niet kan worden gedetecteerd, moet u handmatig het selectievakje Pakkettaak uitvoeren in- en toevoegen van uw onderliggende pakketten waarnaar wordt verwezen door het pad van het bestandssysteem, één voor één, zodat u ze ook kunt insluiten. Als uw onderliggende pakketten zijn opgeslagen in SQL Server-database (MSDB), kunt u ze niet insluiten. Daarom moet u ervoor zorgen dat uw Azure-SSIS IR toegang heeft tot MSDB om ze op te halen met behulp van hun SQL Server-verwijzingen. Het insluiten van projectbestanden (met ) wordt momenteel niet ondersteund, dus u kunt geen op projecten gebaseerde verwijzingen .ispac gebruiken voor uw onderliggende pakketten.

3. Als u het beveiligingsniveau EncryptAllWithPassword of EncryptSensitiveWithPassword hebt gebruikt bij het maken van uw pakket via SSDT, voert u de waarde voor uw wachtwoord in het vak Versleutelingswachtwoord in.

   U kunt ook een geheim dat is opgeslagen in uw Azure Key Vault als waarde gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

   Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt, moet u uw gevoelige waarden opnieuw invoeren in configuratiebestanden of op de tabbladen SSIS-parameters, verbindingsmanagers of eigenschapsonderschrijvingen (zie hieronder).

   Als u het beveiligingsniveau EncryptAllWithUserKey hebt gebruikt, wordt dit niet ondersteund. U moet uw pakket opnieuw configureren om een ander beveiligingsniveau te gebruiken via SSDT of het dtutil opdrachtregelprogramma.

4. Selecteer bij Logboekregistratieniveau een vooraf gedefinieerd bereik van logboekregistratie voor de uitvoering van uw pakket. Schakel het selectievakje Aangepast in als u in plaats daarvan de naam van uw aangepaste logboekregistratie wilt invoeren.

5. Als u de uitvoeringen van uw pakket wilt vastleggen naast het gebruik van de standaardlogboekproviders die in uw pakket kunnen worden opgegeven, geeft u de logboekmap op door het UNC-pad op te geven in het vak Logboekregistratiepad. U kunt door uw logboekmap bladeren en deze selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw logboeken bijvoorbeeld op een Azure Files, is uw logboekregistratiepad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name> . In dit pad wordt een submap gemaakt voor elke afzonderlijke pakketuitleiding, met de naam van de run-id van de activiteit SSIS-pakket uitvoeren, en waarin elke vijf minuten logboekbestanden worden gegenereerd.

6. Geef de referenties op voor toegang tot de logboekmap door de waarden in te voeren in de vakken Domein, Gebruikersnaam en Wachtwoord. Als u uw logboeken bijvoorbeeld op een Azure Files, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> . U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken (zie hierboven).

Voor alle EERDER genoemde UNC-paden moet de volledig gekwalificeerde bestandsnaam uit minder dan 260 tekens bestaan. De mapnaam moet uit minder dan 248 tekens bestaan.

Pakketlocatie: Pakketopslag

Als u Pakketopslag als pakketlocatie selecteert, moet u de volgende stappen voltooien.

1. Selecteer bij Naam pakketopslag een bestaand pakketopslag dat is gekoppeld aan uw Azure-SSIS IR.

2. Geef het uit te voeren pakket op door het pad (zonder ) van het geselecteerde pakketopslag op te geven .dtsx in het vak Pakketpad. Als het geselecteerde pakketopslag zich boven op het bestandssysteem/Azure Files, kunt u uw pakket bladeren en selecteren door Bladeren in bestandsopslag te selecteren, anders kunt u het pad invoeren in de indeling <folder name>\<package name> . U kunt ook nieuwe pakketten importeren in het geselecteerde pakketopslag via SQL Server Management Studio (SSMS) dat vergelijkbaar is met het oudere SSIS-pakketopslag. Zie SSIS-pakketten beheren met pakketarchieven van Azure-SSIS IR voor meer informatie.

3. Als u uw pakket in een afzonderlijk bestand configureert, moet u een UNC-pad naar uw configuratiebestand (met ) in het .dtsConfig vak Configuratiepad geven. U kunt door uw configuratie bladeren en deze selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw configuratie bijvoorbeeld op een Azure Files, is het pad \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig .

4. Schakel het selectievakje Referenties voor configuratietoegang in om te kiezen of u de referenties wilt opgeven voor afzonderlijk toegang tot uw configuratiebestand. Dit is nodig wanneer het geselecteerde pakketopslag zich boven op de SQL SERVER-database (MSDB) die wordt gehost door uw Azure SQL Managed Instance of als uw configuratiebestand niet wordt opgeslagen.

   Als u eerder de waarden voor de uitvoeringsreferenties van uw pakket hebt ingevoerd (voor Windows-verificatie), kunt u deze opnieuw gebruiken door het selectievakje Hetzelfde als referenties voor pakketuitvoering in te schakelen. Voer anders de waarden voor uw configuratietoegangsreferenties in de vakken Domein, Gebruikersnaam en Wachtwoord in. Als u uw configuratie bijvoorbeeld op een Azure Files, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> .

   U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

5. Als u het beveiligingsniveau EncryptAllWithPassword of EncryptSensitiveWithPassword hebt gebruikt bij het maken van uw pakket via SSDT, voert u de waarde voor uw wachtwoord in het vak Versleutelingswachtwoord in. U kunt ook een geheim dat is opgeslagen in uw Azure Key Vault als waarde gebruiken (zie hierboven).

   Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt, moet u uw gevoelige waarden opnieuw invoeren in configuratiebestanden of op de tabbladen SSIS-parameters, verbindingsmanagers of eigenschapsonderschrijvingen (zie hieronder).

   Als u het beveiligingsniveau EncryptAllWithUserKey hebt gebruikt, wordt dit niet ondersteund. U moet uw pakket opnieuw configureren om een ander beveiligingsniveau te gebruiken via SSDT of het dtutil opdrachtregelprogramma.

6. Selecteer bij Logboekregistratieniveau een vooraf gedefinieerd bereik van logboekregistratie voor de uitvoering van uw pakket. Schakel het selectievakje Aangepast in als u in plaats daarvan de naam van uw aangepaste logboekregistratie wilt invoeren.

7. Als u de uitvoeringen van uw pakket wilt vastleggen naast het gebruik van de standaardlogboekproviders die in uw pakket kunnen worden opgegeven, geeft u de logboekmap op door het UNC-pad op te geven in het vak Logboekregistratiepad. U kunt door uw logboekmap bladeren en deze selecteren door Bladeren in bestandsopslag te selecteren of het pad handmatig in te voeren. Als u uw logboeken bijvoorbeeld op een Azure Files, is uw logboekregistratiepad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name> . In dit pad wordt een submap gemaakt voor elke afzonderlijke pakketuitleiding, met de naam van de run-id van de activiteit SSIS-pakket uitvoeren, en waarin elke vijf minuten logboekbestanden worden gegenereerd.

8. Geef de referenties op voor toegang tot de logboekmap door de waarden in te voeren in de vakken Domein, Gebruikersnaam en Wachtwoord. Als u uw logboeken bijvoorbeeld op een Azure Files, is het domein , is de gebruikersnaam Azure en is het wachtwoord <storage account name> <storage account key> . U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault gebruiken als hun waarden (zie hierboven).

Voor alle EERDER genoemde UNC-paden moet de volledig gekwalificeerde bestandsnaam uit minder dan 260 tekens bestaan. De mapnaam moet uit minder dan 248 tekens bestaan.

Tabblad SSIS-parameters

Voer op het tabblad SSIS-parameters van de activiteit SSIS-pakket uitvoeren de volgende stappen uit.

1. Als uw Azure-SSIS IR wordt uitgevoerd, wordt SSISDB geselecteerd als uw pakketlocatie en wordt het selectievakje Handmatige vermeldingen op het tabblad Instellingen gewist. De bestaande SSIS-parameters in het geselecteerde project en pakket van SSISDB worden voor u weergegeven om er waarden aan toe te wijzen. Anders kunt u ze één voor één invoeren om er handmatig waarden aan toe te wijzen. Zorg ervoor dat ze bestaan en correct zijn ingevoerd om de pakketuitvoering te laten slagen.

2. Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt bij het maken van uw pakket via SSDT en Bestandssysteem (pakket), bestandssysteem (Project), ingesloten pakket of pakketopslag is geselecteerd als uw pakketlocatie, moet u uw gevoelige parameters ook opnieuw invoeren om waarden aan deze parameters toe te wijzen op dit tabblad.

Wanneer u waarden aan uw parameters toewijst, kunt u dynamische inhoud toevoegen met behulp van expressies, functies, Data Factory systeemvariabelen en Data Factory pijplijnparameters of variabelen.

U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

Tabblad Verbindingsmanagers

Voer op het tabblad Verbindingsmanagers van de activiteit SSIS-pakket uitvoeren de volgende stappen uit.

1. Als uw Azure-SSIS IR wordt uitgevoerd, wordt SSISDB geselecteerd als uw pakketlocatie en wordt het selectievakje Handmatige vermeldingen op het tabblad Instellingen gewist. De bestaande verbindingsmanagers in het geselecteerde project en pakket van SSISDB worden voor u weergegeven om waarden aan hun eigenschappen toe te wijzen. Anders kunt u ze één voor één invoeren om waarden handmatig toe te wijzen aan hun eigenschappen. Zorg ervoor dat ze bestaan en correct zijn ingevoerd om de pakketuitvoering te laten slagen.

   U kunt de juiste namen voor SCOPE, NAME en PROPERTY voor elk verbindingsbeheer verkrijgen door het pakket te openen dat het bevat op SSDT. Nadat het pakket is geopend, selecteert u het relevante verbindingsbeheer om de namen en waarden voor alle eigenschappen ervan weer te geven in het venster Eigenschappen van SSDT. Met deze informatie kunt u de waarden van eigenschappen van verbindingsbeheer tijdens run-time overschrijven.

   

   Zonder bijvoorbeeld uw oorspronkelijke pakket op SSDT te wijzigen, kunt u de on-premises naar on-premises gegevensstromen die worden uitgevoerd op SQL Server, converteren naar on-premises gegevensstromen naar de cloud die worden uitgevoerd op SSIS IR in ADF door de waarden van ConnectByProxy, ConnectionString en ConnectUsingManagedIdentity-eigenschappen in bestaande verbindingsmanagers tijdens run-time te overschrijven.

   Deze run-time-overschrijvingen kunnen Self-Hosted IR (SHIR) inschakelen als proxy voor SSIS IR bij het openen van gegevens on-premises. Zie Configuring SHIR as a proxy for SSIS IR (SHIR configurerenals proxy voor SSIS IR) en Azure SQL Database/Managed Instance connections using the latest MSOLEDBSQL driver that op zijn beurt enable Azure Active Directory (AAD) authentication with ADF managed identity (Configuring) (Configureren) AAD verificatie met beheerde ADF-identiteit voor OLEDB-verbindingen.

   

2. Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt bij het maken van uw pakket via SSDT en Bestandssysteem (pakket), bestandssysteem (Project), ingesloten pakket of pakketopslag is geselecteerd als uw pakketlocatie, moet u ook de eigenschappen van uw gevoelige verbindingsbeheer opnieuw instellen om waarden aan hen toe te wijzen op dit tabblad.

Wanneer u waarden toewijst aan de eigenschappen van uw verbindingsbeheer, kunt u dynamische inhoud toevoegen met behulp van expressies, functies, Data Factory systeemvariabelen en Data Factory pijplijnparameters of -variabelen.

U kunt ook geheimen die zijn opgeslagen in uw Azure Key Vault als hun waarden gebruiken. Schakel het selectievakje AZURE KEY VAULT er naast in om dit te doen. Selecteer of bewerk uw bestaande gekoppelde sleutelkluisservice of maak een nieuwe. Selecteer vervolgens de geheime naam en versie voor uw waarde. Wanneer u de gekoppelde sleutelkluisservice maakt of bewerkt, kunt u uw bestaande sleutelkluis selecteren of bewerken of een nieuwe maken. Zorg ervoor dat u Data Factory identiteit toegang verleent tot uw sleutelkluis als u dit nog niet hebt gedaan. U kunt uw geheim ook rechtstreeks in de volgende indeling invoeren: <key vault linked service name>/<secret name>/<secret version> .

Tabblad Overschrijvingen van eigenschappen

Voer op het tabblad Eigenschappen overschrijvingen van de activiteit SSIS-pakket uitvoeren de volgende stappen uit.

1. Voer de paden van bestaande eigenschappen in het geselecteerde pakket één voor één in om er handmatig waarden aan toe te wijzen. Zorg ervoor dat ze bestaan en correct zijn ingevoerd om de pakketuitvoering te laten slagen. Als u bijvoorbeeld de waarde van uw gebruikersvariabele wilt overschrijven, voert u het pad in de volgende indeling in: \Package.Variables[User::<variable name>].Value .

   U kunt het juiste EIGENSCHAPSPAD verkrijgen voor elke pakket-eigenschap door het pakket te openen dat het bevat op SSDT. Nadat het pakket is geopend, selecteert u de controlestroom en de eigenschap Configuraties in het venster Eigenschappen van SSDT. Selecteer vervolgens de knop met het beletselteken (...) naast de eigenschap Configurations om de Package Configurations Organizer te openen die normaal gesproken wordt gebruikt voor het maken van pakketconfiguraties in Package Deployment Model.

   

   Schakel in de package configurations Organizer het selectievakje Pakketconfiguraties inschakelen en de knop Toevoegen... in om de wizard Pakketconfiguratie te openen.

   Selecteer in de wizard Pakketconfiguratie het xml-configuratiebestanditem in de vervolgkeuzelijst Configuratietype en de knop Configuratie-instellingen rechtstreeks opgeven, voer de naam van het configuratiebestand in en selecteer de knop Volgende > selecteren.

   

   Selecteer ten slotte de pakketeigenschappen waarvan u het pad naar keuze en de knop > selecteren. U kunt nu de paden van de pakket-& kopiëren en opslaan in uw configuratiebestand. Met deze informatie kunt u de waarden van alle pakketeigenschappen tijdens run time overschrijven.

   

2. Als u het beveiligingsniveau EncryptSensitiveWithUserKey hebt gebruikt bij het maken van uw pakket via SSDT en Bestandssysteem (pakket), bestandssysteem (Project), ingesloten pakket of pakketopslag is geselecteerd als uw pakketlocatie, moet u ook de eigenschappen van uw gevoelige pakket opnieuw in om waarden aan deze pakketten toe te wijzen op dit tabblad.

Wanneer u waarden toewijst aan uw pakketeigenschappen, kunt u dynamische inhoud toevoegen met behulp van expressies, functies, Data Factory systeemvariabelen en Data Factory pijplijnparameters of variabelen.

De waarden die zijn toegewezen in configuratiebestanden en op het tabblad SSIS-parameters kunnen worden overschrijven met behulp van de tabbladen Verbindingsmanagers of Eigenschappen overschrijvingen. De waarden die zijn toegewezen op het tabblad Verbindingsmanagers kunnen ook worden overschrijven met behulp van het tabblad Overschrijvingen van eigenschappen.

Als u de configuratie van de pijplijn wilt valideren, selecteert u Valideren op de werkbalk. Selecteer om het pijplijnvalidatierapport te >> sluiten.

Als u de pijplijn wilt publiceren Data Factory, selecteert u Alles publiceren.

De pijplijn uitvoeren

In deze stap activeert u een pijplijnuitvoering.

1. Als u een pijplijn-run wilt activeren, selecteert u Activeren op de werkbalk en selecteert u Nu activeren.

   

2. Selecteer in het venster Pijplijnuitvoering de optie Voltooien.

De pijplijn bewaken

1. Ga naar het tabblad Controleren aan de linkerkant. U ziet de pijplijn-run en de status ervan, samen met andere informatie, zoals de begintijd van de run. Selecteer Vernieuwen om de weergave te vernieuwen.

   

2. Selecteer de koppeling Uitvoeringen van activiteit weergeven in de kolom Acties. U ziet slechts één activiteit die wordt uitgevoerd omdat de pijplijn slechts één activiteit heeft. Dit is de activiteit SSIS-pakket uitvoeren.

   

3. Voer de volgende query uit op de SSISDB-database in SQL server om te controleren of het pakket is uitgevoerd.

   select * from catalog.executions
   

   

4. U kunt ook de uitvoerings-id van de SSISDB op halen uit de uitvoer van de uitvoering van de pijplijnactiviteit en de id gebruiken om uitgebreidere uitvoeringslogboeken en foutberichten in de SQL Server Management Studio.

   

De pijplijn plannen met een trigger

U kunt ook een geplande trigger voor uw pijplijn maken, zodat de pijplijn volgens een schema wordt uitgevoerd, zoals elk uur of dagelijks. Zie Create a data factory - Data Factory UI voor een voorbeeld.

Volgende stappen

• Een SSIS-pakket uitvoeren met de activiteit SSIS-pakket uitvoeren in Azure Data Factory met PowerShell
• Uw ETL-/ELT-werkstromen moderniseren en uitbreiden met SSIS-activiteiten in Azure Data Factory pijplijnen