SSIS-pakketten uitvoeren met behulp van Azure SQL Managed Instance Agent

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u een SSIS-pakket (SQL Server Integration Services) uitvoert met behulp van Azure SQL Managed Instance Agent. Deze functie biedt gedrag dat vergelijkbaar is met wanneer u SSIS-pakketten plant met behulp van SQL Server Agent in uw on-premises omgeving.

Met deze functie kunt u SSIS-pakketten uitvoeren die zijn opgeslagen in SSISDB in een SQL Managed Instance, een bestandssysteem zoals Azure Files of een Azure-SSIS Integration Runtime-pakketarchief.

Vereisten

Als u deze functie wilt gebruiken, downloadt en installeert u de nieuwste SQL Server Management Studio (SSMS). Details van versieondersteuning, zoals hieronder:

• Als u pakketten wilt uitvoeren in SSISDB of bestandssysteem, installeert u SSMS versie 18.5 of hoger.
• Installeer SSMS versie 18.6 of hoger om pakketten uit te voeren in het pakketarchief.

U moet ook een Azure-SSIS-integratieruntime inrichten in Azure Data Factory. Er wordt een sql Managed Instance gebruikt als eindpuntserver.

Een SSIS-pakket uitvoeren in SSISDB

In deze procedure gebruikt u SQL Managed Instance Agent om een SSIS-pakket aan te roepen dat is opgeslagen in SSISDB.

1. Maak in de nieuwste versie van SSMS verbinding met een met SQL beheerd exemplaar.

2. Maak een nieuwe agenttaak en een nieuwe taakstap. Klik onder SQL Server Agent met de rechtermuisknop op de map Taken en selecteer Vervolgens Nieuwe taak.

   

3. Selecteer op de pagina Nieuwe taakstap het SQL Server Integration Services-pakket als het type.

   

4. Selecteer op het tabblad Pakket de SSIS-catalogus als pakketlocatie.

5. Omdat SSISDB zich in een met SQL beheerd exemplaar bevindt, hoeft u geen verificatie op te geven.

6. Geef een SSIS-pakket op uit SSISDB.

   

7. Op het tabblad Configuratie kunt u het volgende doen:

   • Geef parameterwaarden op onder Parameters.
   • Waarden negeren onder Verbindingsbeheer s.
   • Overschrijf de eigenschap en kies het niveau van de logboekregistratie onder Geavanceerd.

   

8. Selecteer OK om de configuratie van de agenttaak op te slaan.

9. Start de agenttaak om het SSIS-pakket uit te voeren.

Een SSIS-pakket uitvoeren in het bestandssysteem

In deze procedure gebruikt u SQL Managed Instance Agent om een SSIS-pakket uit te voeren dat is opgeslagen in het bestandssysteem.

1. Maak in de nieuwste versie van SSMS verbinding met een met SQL beheerd exemplaar.

2. Maak een nieuwe agenttaak en een nieuwe taakstap. Klik onder SQL Server Agent met de rechtermuisknop op de map Taken en selecteer Vervolgens Nieuwe taak.

   

3. Selecteer op de pagina Nieuwe taakstap het SQL Server Integration Services-pakket als het type.

   

4. Op het tabblad Pakket :

   1. Selecteer Bestandssysteem voor pakketlocatie.

   2. Voor bestandstype:

      • Als uw pakket is geüpload naar Azure Files, selecteert u de Azure-bestandsshare.

        

        Het pakketpad is \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

        Voer onder Referentie voor toegang tot pakketbestanden de naam van het Azure-bestandsaccount en de accountsleutel in om toegang te krijgen tot het Azure-bestand. Het domein is ingesteld als Azure.

      • Als uw pakket is geüpload naar een netwerkshare, selecteert u Netwerkshare.

        Het pakketpad is het UNC-pad van uw pakketbestand met de extensie .dtsx.

        Voer het bijbehorende domein, de gebruikersnaam en het wachtwoord in voor toegang tot het pakketbestand voor de netwerkshare.

   3. Als uw pakketbestand is versleuteld met een wachtwoord, selecteert u Versleutelingswachtwoord en voert u het wachtwoord in.

5. Voer op het tabblad Configuraties het pad naar het configuratiebestand in als u een configuratiebestand nodig hebt om het SSIS-pakket uit te voeren. Als u uw configuratie opslaat in Azure Files, is \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfighet configuratiepad.

6. Op het tabblad Uitvoeringsopties kunt u kiezen of u Windows-verificatie of 32-bits runtime wilt gebruiken om het SSIS-pakket uit te voeren.

7. Op het tabblad Logboekregistratie kunt u het logboekpad en de bijbehorende referenties voor logboektoegang kiezen om de logboekbestanden op te slaan. Het pad voor logboekregistratie is standaard hetzelfde als het pad naar de pakketmap en de referentie voor logboekregistratietoegang is hetzelfde als de referentie voor pakkettoegang. Als u uw logboeken opslaat in Azure Files, is \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>het logboekregistratiepad.

8. Op het tabblad Waarden instellen kunt u het eigenschapspad en de waarde invoeren om de pakketeigenschappen te overschrijven.

   Als u bijvoorbeeld de waarde van de gebruikersvariabele wilt overschrijven, voert u het pad in de volgende indeling in: \Package.Variables[User::<variable name>].Value.

9. Selecteer OK om de configuratie van de agenttaak op te slaan.

10. Start de agenttaak om het SSIS-pakket uit te voeren.

Een SSIS-pakket uitvoeren in het pakketarchief

Notitie

Pakketarchief wordt niet ondersteund in Azure-SSIS IR in Azure Synapse.

In deze procedure gebruikt u SQL Managed Instance Agent om een SSIS-pakket uit te voeren dat is opgeslagen in het Azure-SSIS IR-pakketarchief.

1. Maak in de nieuwste versie van SSMS verbinding met een met SQL beheerd exemplaar.

2. Maak een nieuwe agenttaak en een nieuwe taakstap. Klik onder SQL Server Agent met de rechtermuisknop op de map Taken en selecteer Vervolgens Nieuwe taak.

   

3. Selecteer op de pagina Nieuwe taakstap het SQL Server Integration Services-pakket als het type.

   

4. Op het tabblad Pakket :

   1. Selecteer Package Store voor pakketlocatie.

   2. Voor pakketpad:

      Het pakketpad is <package store name>\<folder name>\<package name>.

      

   3. Als uw pakketbestand is versleuteld met een wachtwoord, selecteert u Versleutelingswachtwoord en voert u het wachtwoord in.

5. Voer op het tabblad Configuraties het pad naar het configuratiebestand in als u een configuratiebestand nodig hebt om het SSIS-pakket uit te voeren. Als u uw configuratie opslaat in Azure Files, is \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfighet configuratiepad.

6. Op het tabblad Uitvoeringsopties kunt u kiezen of u Windows-verificatie of 32-bits runtime wilt gebruiken om het SSIS-pakket uit te voeren.

7. Op het tabblad Logboekregistratie kunt u het logboekpad en de bijbehorende referenties voor logboektoegang kiezen om de logboekbestanden op te slaan. Het pad voor logboekregistratie is standaard hetzelfde als het pad naar de pakketmap en de referentie voor logboekregistratietoegang is hetzelfde als de referentie voor pakkettoegang. Als u uw logboeken opslaat in Azure Files, is \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>het logboekregistratiepad.

8. Op het tabblad Waarden instellen kunt u het eigenschapspad en de waarde invoeren om de pakketeigenschappen te overschrijven.

   Als u bijvoorbeeld de waarde van de gebruikersvariabele wilt overschrijven, voert u het pad in de volgende indeling in: \Package.Variables[User::<variable name>].Value.

9. Selecteer OK om de configuratie van de agenttaak op te slaan.

10. Start de agenttaak om het SSIS-pakket uit te voeren.

Uitvoering van SSIS-pakket annuleren

Als u pakketuitvoering wilt annuleren vanuit een SQL Managed Instance Agent-taak, voert u de volgende stappen uit in plaats van de agenttaak rechtstreeks te stoppen:

1. Zoek uw SQL-agent jobId uit msdb.dbo.sysjobs.

2. Zoek de bijbehorende SSIS executionId op basis van de taak-id met behulp van deze query:

   select * from '{table for job execution}' where  parameter_value = 'SQL_Agent_Job_{jobId}' order by execution_id desc
   

   Als uw SSIS-pakketten zich in SSISDB bevinden, gebruikt u ssisdb.internal.execution_parameter_values als tabel voor taakuitvoering. Als uw SSIS-pakketten zich in het bestandssysteem bevinden, gebruikt u ssisdb.internal.execution_parameter_values_noncatalog.

3. Klik met de rechtermuisknop op de SSISDB-catalogus en selecteer Vervolgens Actieve bewerkingen.

   

4. Stop de bijbehorende bewerking op basis van executionId.

Gerelateerde inhoud

U kunt ook SSIS-pakketten plannen met behulp van Azure Data Factory. Zie de azure Data Factory-gebeurtenistrigger voor stapsgewijze instructies.