Kör ett SSIS-paket med aktiviteten kör SSIS-paket i Azure Data FactoryRun an SSIS package with the Execute SSIS Package activity in Azure Data Factory

Den här artikeln beskriver hur du kör ett SQL Server Integration Services-paket (SSIS) i en Azure Data Factory-pipeline med hjälp av aktiviteten kör SSIS-paket.This article describes how to run a SQL Server Integration Services (SSIS) package in an Azure Data Factory pipeline by using the Execute SSIS Package activity.

KravPrerequisites

Anteckning

Den här artikeln har uppdaterats till att använda den nya Azure PowerShell Az-modulen.This article has been updated to use the new Azure PowerShell Az module. Du kan fortfarande använda modulen AzureRM som kommer att fortsätta att ta emot felkorrigeringar fram till december 2020 eller längre.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Mer information om den nya Az-modulen och AzureRM-kompatibilitet finns i Introduktion till den nya Azure PowerShell Az-modulen.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Instruktioner för installation av Az-modulen finns i Installera Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Skapa en Azure-SSIS integration Runtime (IR) om du inte redan har en genom att följa de stegvisa anvisningarna i självstudien: etablering Azure-SSIS IR.Create an Azure-SSIS integration runtime (IR) if you don't have one already by following the step-by-step instructions in the Tutorial: Provisioning Azure-SSIS IR.

Kör ett paket i Azure PortalRun a package in the Azure portal

I det här avsnittet använder du Data Factory användar gränssnitt (UI) eller appen för att skapa en Data Factory-pipeline med en kör SSIS-paket-aktivitet som kör ditt SSIS-paket.In this section, you use the Data Factory user interface (UI) or app to create a Data Factory pipeline with an Execute SSIS Package activity that runs your SSIS package.

Skapa en pipeline med en EXECUTE SSIS-paket-aktivitetCreate a pipeline with an Execute SSIS Package activity

I det här steget använder du Data Factory gränssnittet eller appen för att skapa en pipeline.In this step, you use the Data Factory UI or app to create a pipeline. Du lägger till en aktivitet för att köra SSIS-paket i pipelinen och konfigurerar den att köra ditt SSIS-paket.You add an Execute SSIS Package activity to the pipeline and configure it to run your SSIS package.

  1. På Data Factory översikt eller start sida på Azure Portal väljer du panelen författare & övervakare för att starta Data Factory användar gränssnitt eller app på en separat flik.On your Data Factory overview or home page in the Azure portal, select the Author & Monitor tile to start the Data Factory UI or app in a separate tab.

    Data Factory start sida

    På sidan Nu sätter vi igång väljer du Skapa pipeline.On the Let's get started page, select Create pipeline.

    Sidan Kom igång

  2. Expandera Allmänti aktivitets verktygs lådan.In the Activities toolbox, expand General. Dra sedan en aktivitet för att köra SSIS-paket till pipelinens designer-yta.Then drag an Execute SSIS Package activity to the pipeline designer surface.

    Dra en aktivitet för att köra SSIS-paket till design ytan

  3. Ange ett namn och en beskrivning för aktiviteten på fliken Allmänt för AKTIVITETEN kör SSIS-paket.On the General tab for the Execute SSIS Package activity, provide a name and description for the activity. Ange valfria värden för timeout och försök .Set optional Timeout and Retry values.

    Ange egenskaper på fliken Allmänt

  4. På fliken Inställningar för AKTIVITETEN kör SSIS-paket väljer du en Azure-SSIS IR där du vill köra paketet.On the Settings tab for the Execute SSIS Package activity, select an Azure-SSIS IR where you want to run your package. Om ditt paket använder Windows-autentisering för att komma åt data lager (till exempel SQL-servrar eller fil resurser lokalt eller Azure Files), markerar du kryss rutan Windows-autentisering .If your package uses Windows authentication to access data stores (for example, SQL servers or file shares on-premises or Azure Files), select the Windows authentication check box. Ange värdena för dina paket körnings uppgifter i rutorna domän, användar namnoch lösen ord .Enter the values for your package execution credentials in the Domain, Username, and Password boxes.

    Du kan också använda hemligheter som lagras i ditt Azure Key Vault som deras värden.Alternatively, you can use secrets stored in your Azure key vault as their values. Det gör du genom att markera kryss rutan Azure Key Vault bredvid relevanta autentiseringsuppgifter.To do so, select the AZURE KEY VAULT check box next to the relevant credential. Välj eller redigera din befintliga Key Vault-länkade tjänst eller skapa en ny.Select or edit your existing key vault linked service or create a new one. Välj sedan det hemliga namnet eller versionen för ditt Credential-värde.Then select the secret name or version for your credential value.

    När du skapar eller redigerar en länkad nyckel valvs tjänst kan du välja eller redigera ditt befintliga nyckel valv eller skapa ett nytt.When you create or edit your key vault linked service, you can select or edit your existing key vault or create a new one. Se till att bevilja Data Factory hanterad identitets åtkomst till ditt nyckel valv om du inte redan har gjort det.Make sure to grant Data Factory managed identity access to your key vault if you haven't done so already. Du kan också ange dina hemligheter direkt i följande format: <Key vault linked service name>/<secret name>/<secret version>.You can also enter your secrets directly in the following format: <Key vault linked service name>/<secret name>/<secret version>. Om ditt paket behöver 32-bitars körning för att köra, markerar du kryss rutan 32-bit runtime .If your package needs 32-bit runtime to run, select the 32-Bit runtime check box.

    För paket platsväljer du SSISDB, fil system (paket) , fil system (projekt) eller inbäddat paket.For Package location, select SSISDB, File System (Package), File System (Project), or Embedded package. Om du väljer SSISDB som paket plats, som väljs automatiskt om din Azure-SSIS IR etablerades med SSIS-katalogen (SSISDB) som hanteras av en Azure SQL Database-Server eller en hanterad instans, anger du det paket som har distribuerats till SSISDB.If you select SSISDB as your package location, which is automatically selected if your Azure-SSIS IR was provisioned with the SSIS catalog (SSISDB) hosted by an Azure SQL Database server or managed instance, specify your package to run that was deployed into SSISDB.

    Om din Azure-SSIS IR körs och kryss rutan manuella poster är avmarkerad bläddrar du och väljer dina befintliga mappar, projekt, paket eller miljöer från SSISDB.If your Azure-SSIS IR is running and the Manual entries check box is cleared, browse and select your existing folders, projects, packages, or environments from SSISDB. Välj Uppdatera för att hämta nyligen tillagda mappar, projekt, paket eller miljöer från SSISDB så att de är tillgängliga för bläddring och val.Select Refresh to fetch your newly added folders, projects, packages, or environments from SSISDB so that they're available for browsing and selection. Om du vill bläddra i eller välja miljöer för dina paket körningar måste du konfigurera dina projekt i förväg för att lägga till dessa miljöer som referenser från samma mappar under SSISDB.To browse or select the environments for your package executions, you must configure your projects beforehand to add those environments as references from the same folders under SSISDB. Mer information finns i skapa och MAPPA SSIS miljöer.For more information, see Create and map SSIS environments.

    För loggnings nivåväljer du ett fördefinierat loggnings område för paket körningen.For Logging level, select a predefined scope of logging for your package execution. Markera kryss rutan anpassad om du vill ange ett anpassat loggnings namn i stället.Select the Customized check box if you want to enter your customized logging name instead.

    Ange egenskaper på fliken Inställningar-automatisk

    Om din Azure-SSIS IR inte körs eller om kryss rutan manuella poster är markerad, anger du dina paket-och miljö Sök vägar från SSISDB direkt i följande format: <folder name>/<project name>/<package name>.dtsx och <folder name>/<environment name>.If your Azure-SSIS IR isn't running or the Manual entries check box is selected, enter your package and environment paths from SSISDB directly in the following formats: <folder name>/<project name>/<package name>.dtsx and <folder name>/<environment name>.

    Ange egenskaper på fliken Inställningar – manuell

    Om du väljer fil system (paket) som paket plats, som väljs automatiskt om din Azure-SSIS IR etablerades utan SSISDB, anger du att paketet ska köras genom att ange en Universal Naming Convention UNC-sökväg till paket filen (.dtsx) i rutan paket Sök väg .If you select File System (Package) as your package location, which is automatically selected if your Azure-SSIS IR was provisioned without SSISDB, specify your package to run by providing a Universal Naming Convention (UNC) path to your package file (.dtsx) in the Package path box. Om du till exempel lagrar ditt paket i Azure Files \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsxden paket Sök vägen.For example, if you store your package in Azure Files, its package path is \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

    Om du konfigurerar ditt paket i en separat fil måste du också ange en UNC-sökväg till konfigurations filen (.dtsConfig) i rutan konfigurations Sök väg .If you configure your package in a separate file, you also need to provide a UNC path to your configuration file (.dtsConfig) in the Configuration path box. Om du till exempel lagrar konfigurationen i Azure Files, är dess konfigurations Sök väg \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.For example, if you store your configuration in Azure Files, its configuration path is \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

    Ange egenskaper på fliken Inställningar – manuell

    Om du väljer fil system (projekt) som paket plats anger du ditt paket som ska köras genom att ange en UNC-sökväg till projekt filen (.ispac) i rutan projekt Sök väg och en paketfil (.dtsx) från projektet i rutan paket namn .If you select File System (Project) as your package location, specify your package to run by providing a UNC path to your project file (.ispac) in the Project path box and a package file (.dtsx) from your project in the Package name box. Om du till exempel lagrar projektet i Azure Files, är dess projekt Sök väg \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.For example, if you store your project in Azure Files, its project path is \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

    Ange egenskaper på fliken Inställningar – manuell

    Ange sedan autentiseringsuppgifterna för att komma åt ditt projekt, paket eller konfigurationsfiler.Next, specify the credentials to access your project, package, or configuration files. Om du tidigare har angett värdena för paketets körnings uppgifter (se föregående) kan du återanvända dem genom att markera kryss rutan samma som för paket körnings uppgifter .If you previously entered the values for your package execution credentials (see previous), you can reuse them by selecting the Same as package execution credentials check box. Annars anger du värdena för dina paket åtkomst uppgifter i rutorna domän, användar namnoch lösen ord .Otherwise, enter the values for your package access credentials in the Domain, Username, and Password boxes. Om du till exempel lagrar projektet, paketet eller konfigurationen i Azure Files, är domänen Azure, användar namnet är <storage account name>och lösen ordet är <storage account key>.For example, if you store your project, package, or configuration in Azure Files, the domain is Azure, the username is <storage account name>, and the password is <storage account key>.

    Du kan också använda hemligheter som lagras i nyckel valvet som värden (se föregående).Alternatively, you can use secrets stored in your key vault as their values (see previous). Dessa autentiseringsuppgifter används för att komma åt ditt paket och underordnade paket i åtgärden kör paket, allt från sin egen sökväg eller samma projekt, samt konfigurationer som innehåller de som anges i dina paket.These credentials are used to access your package and child packages in Execute Package Task, all from their own path or the same project, as well as configurations, which include those specified in your packages.

    Om du väljer inbäddat paket som paket plats, drar du och släpper ditt paket för att köra eller Ladda upp det från en filmapp i rutan som visas.If you select Embedded package as your package location, drag and drop your package to run or Upload it from a file folder into the box provided. Paketet komprimeras och bäddas in automatiskt i aktivitetens nytto Last.Your package will be automatically compressed and embedded in the activity payload. När du har bäddat in paketet kan du Ladda ned det senare för redigering.Once embedded, you can Download your package later for editing. Du kan också Parameterisera ditt inbäddade paket genom att tilldela det till en pipeline-parameter som kan användas i flera aktiviteter och därmed optimera storleken på din pipeline-nyttolast.You can also Parameterize your embedded package by assigning it to a pipeline parameter that can be used in multiple activities, hence optimizing the size of your pipeline payload. Om det inbäddade paketet inte är krypterat och vi identifierar användningen av kör paket-uppgiften i den, markeras kryss rutan Kör paket uppgift automatiskt och relevanta underordnade paket med deras fil system referenser läggs till automatiskt så att du även kan bädda in dem.If your embedded package is not all encrypted and we detect the use of Execute Package Task in it, the Execute Package Task check box will be automatically selected and the relevant child packages with their file system references will be automatically added for you to also embed them. Om vi inte kan identifiera användningen av kör paket uppgift måste du markera kryss rutan Kör paket uppgift manuellt och lägga till relevanta underordnade paket med sina fil system referenser en i taget så att du kan bädda in dem.If we can't detect the use of Execute Package Task, you'll have to manually select the Execute Package Task check box and add the relevant child packages with their file system references one by one for you to also embed them. Om de underordnade paketen använder SQL Server referenser kontrollerar du att SQL Server kan nås av din Azure-SSIS IR.If the child packages use SQL Server references, please ensure that the SQL Server is accessible by your Azure-SSIS IR. Det finns för närvarande inte stöd för att använda projekt referenser för underordnade paket.The use of project references for child packages is currently unsupported.

    Ange egenskaper på fliken Inställningar – manuell

    Om du använde skydds nivån EncryptAllWithPassword eller EncryptSensitiveWithPassword när du skapade paketet via SQL Server Data Tools anger du värdet för lösen ordet i rutan krypterings lösen ord .If you used the EncryptAllWithPassword or EncryptSensitiveWithPassword protection level when you created your package via SQL Server Data Tools, enter the value for your password in the Encryption password box. Du kan också använda en hemlighet som lagrats i nyckel valvet som dess värde (se föregående).Alternatively, you can use a secret stored in your key vault as its value (see previous). Om du har använt skydds nivån EncryptSensitiveWithUserKey , ange dina känsliga värden i konfigurationsfiler igen eller på fliken SSIS-parametrar, anslutnings hanterareeller egenskaps åsidosättningar (se senare).If you used the EncryptSensitiveWithUserKey protection level, reenter your sensitive values in configuration files or on the SSIS Parameters, Connection Managers, or Property Overrides tabs (see later).

    Om du har använt skydds nivån EncryptAllWithUserKey stöds den inte.If you used the EncryptAllWithUserKey protection level, it's unsupported. Du måste konfigurera om ditt paket så att det använder en annan skydds nivå via SQL Server Data Tools eller kommando rads verktyget dtutil.You need to reconfigure your package to use another protection level via SQL Server Data Tools or the dtutil command-line utility.

    För loggnings nivåväljer du ett fördefinierat loggnings område för paket körningen.For Logging level, select a predefined scope of logging for your package execution. Markera kryss rutan anpassad om du vill ange ett anpassat loggnings namn i stället.Select the Customized check box if you want to enter your customized logging name instead. Om du vill logga dina paket körningar utöver att använda de standard logg leverantörer som kan anges i ditt paket, anger du loggmappen genom att ange dess UNC-sökväg i rutan loggnings Sök väg .If you want to log your package executions beyond using the standard log providers that can be specified in your package, specify your log folder by providing its UNC path in the Logging path box. Om du till exempel lagrar loggarna i Azure Files \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>s loggnings Sök vägen.For example, if you store your logs in Azure Files, your logging path is \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. En undermapp skapas i den här sökvägen för varje enskilt paket som har körts och som har namngetts efter körnings-ID: t för aktiviteten kör SSIS-paket, där loggfilerna genereras var femte minut.A subfolder is created in this path for each individual package run and named after the Execute SSIS Package activity run ID, in which log files are generated every five minutes.

    Slutligen anger du de autentiseringsuppgifter som ska användas för att komma åt loggmappen.Finally, specify the credentials to access your log folder. Om du tidigare har angett värdena för dina paket åtkomst uppgifter (se föregående) kan du återanvända dem genom att markera kryss rutan samma som paket åtkomst autentiseringsuppgifter .If you previously entered the values for your package access credentials (see previous), you can reuse them by selecting the Same as package access credentials check box. Annars anger du värdena för inloggnings uppgifterna för inloggning i rutorna domän, användar namnoch lösen ord .Otherwise, enter the values for your logging access credentials in the Domain, Username, and Password boxes. Om du till exempel lagrar loggarna i Azure Files Azuredomänen, användar namnet är <storage account name>och lösen ordet är <storage account key>.For example, if you store your logs in Azure Files, the domain is Azure, the username is <storage account name>, and the password is <storage account key>.

    Du kan också använda hemligheter som lagras i nyckel valvet som värden (se föregående).Alternatively, you can use secrets stored in your key vault as their values (see previous). Dessa autentiseringsuppgifter används för att lagra loggarna.These credentials are used to store your logs.

    För alla UNC-sökvägar som tidigare nämnts måste det fullständigt kvalificerade fil namnet innehålla färre än 260 tecken.For all UNC paths previously mentioned, the fully qualified file name must be fewer than 260 characters. Katalog namnet måste innehålla färre än 248 tecken.The directory name must be fewer than 248 characters.

  5. På fliken SSIS parametrar för AKTIVITETEN kör SSIS-paket, om din Azure-SSIS IR körs, har SSISDB valts som paket plats, och kryss rutan manuella poster på fliken Inställningar är avmarkerad, de befintliga SSIS-PARAMETRARNA i det valda projektet eller paketet från SSISDB visas så att du kan tilldela dem värden.On the SSIS Parameters tab for the Execute SSIS Package activity, if your Azure-SSIS IR is running, SSISDB is selected as your package location, and the Manual entries check box on the Settings tab is cleared, the existing SSIS parameters in your selected project or package from SSISDB are displayed for you to assign values to them. Annars kan du ange dem en i taget för att tilldela dem värden manuellt.Otherwise, you can enter them one by one to assign values to them manually. Kontrol lera att de finns och att de har angetts korrekt för att paket körningen ska lyckas.Make sure that they exist and are correctly entered for your package execution to succeed.

    Om du använde EncryptSensitiveWithUserKey skydds nivå när du skapade paketet via SQL Server Data Tools och fil system (paket) eller fil system (projekt) har valts som paket plats, måste du också ange dina känsliga parametrar igen för att tilldela värden till dem i konfigurationsfiler eller på den här fliken.If you used the EncryptSensitiveWithUserKey protection level when you created your package via SQL Server Data Tools and File System (Package) or File System (Project) is selected as your package location, you also need to reenter your sensitive parameters to assign values to them in configuration files or on this tab.

    När du tilldelar värden till parametrarna kan du lägga till dynamiskt innehåll med hjälp av uttryck, funktioner, Data Factory systemvariabler och Data Factory-pipeline-parametrar eller variabler.When you assign values to your parameters, you can add dynamic content by using expressions, functions, Data Factory system variables, and Data Factory pipeline parameters or variables. Du kan också använda hemligheter som lagras i nyckel valvet som värden (se föregående).Alternatively, you can use secrets stored in your key vault as their values (see previous).

    Ange egenskaper på fliken SSIS-parametrar

  6. På fliken anslutnings hanterare för AKTIVITETEN kör SSIS-paket, om din Azure-SSIS IR körs, har SSISDB valts som paket plats och kryss rutan manuella poster på fliken Inställningar är avmarkerad, så visas befintliga anslutnings hanterare i det valda projektet eller paketet från SSISDB så att du kan tilldela värden till deras egenskaper.On the Connection Managers tab for the Execute SSIS Package activity, if your Azure-SSIS IR is running, SSISDB is selected as your package location, and the Manual entries check box on the Settings tab is cleared, the existing connection managers in your selected project or package from SSISDB are displayed for you to assign values to their properties. Annars kan du ange dem en i taget för att tilldela värdena till egenskaperna manuellt.Otherwise, you can enter them one by one to assign values to their properties manually. Kontrol lera att de finns och att de har angetts korrekt för att paket körningen ska lyckas.Make sure that they exist and are correctly entered for your package execution to succeed.

    Om du använde EncryptSensitiveWithUserKey skydds nivå när du skapade paketet via SQL Server Data Tools och fil system (paket) eller fil system (projekt) har marker ATS som din paket plats, måste du också ange egenskaperna för den känsliga anslutnings hanteraren igen för att tilldela värden till dem i konfigurationsfiler eller på den här fliken.If you used the EncryptSensitiveWithUserKey protection level when you created your package via SQL Server Data Tools and File System (Package) or File System (Project) is selected as your package location, you also need to reenter your sensitive connection manager properties to assign values to them in configuration files or on this tab.

    När du tilldelar värden till egenskaperna för anslutnings hanteraren kan du lägga till dynamiskt innehåll med hjälp av uttryck, funktioner, Data Factory systemvariabler och Data Factory pipeline-parametrar eller variabler.When you assign values to your connection manager properties, you can add dynamic content by using expressions, functions, Data Factory system variables, and Data Factory pipeline parameters or variables. Du kan också använda hemligheter som lagras i nyckel valvet som värden (se föregående).Alternatively, you can use secrets stored in your key vault as their values (see previous).

    Ange egenskaper på fliken anslutnings hanterare

  7. På fliken åsidosättningar för egenskaper för AKTIVITETEN kör SSIS-paket anger du Sök vägarna för de befintliga egenskaperna i det valda paketet ett i taget för att tilldela dem värden manuellt.On the Property Overrides tab for the Execute SSIS Package activity, enter the paths of existing properties in your selected package one by one to assign values to them manually. Kontrol lera att de finns och att de har angetts korrekt för att paket körningen ska lyckas.Make sure that they exist and are correctly entered for your package execution to succeed. Om du till exempel vill åsidosätta värdet för användar variabeln anger du dess sökväg i följande format: \Package.Variables[User::<variable name>].Value.For example, to override the value of your user variable, enter its path in the following format: \Package.Variables[User::<variable name>].Value.

    Om du använde EncryptSensitiveWithUserKey skydds nivå när du skapade paketet via SQL Server Data Tools och fil system (paket) eller fil system (projekt) har marker ATS som paket plats, måste du också ange dina känsliga egenskaper igen för att tilldela värden till dem i konfigurationsfiler eller på den här fliken.If you used the EncryptSensitiveWithUserKey protection level when you created your package via SQL Server Data Tools and File System (Package) or File System (Project) is selected as your package location, you also need to reenter your sensitive properties to assign values to them in configuration files or on this tab.

    När du tilldelar värden till dina egenskaper kan du lägga till dynamiskt innehåll med hjälp av uttryck, funktioner, Data Factory systemvariabler och Data Factory pipeline-parametrar eller variabler.When you assign values to your properties, you can add dynamic content by using expressions, functions, Data Factory system variables, and Data Factory pipeline parameters or variables.

    Ange egenskaper på fliken åsidosättningar för egenskap

    Värdena som tilldelas i konfigurationsfiler och på fliken SSIS Parameters kan åsidosättas med hjälp av flikarna anslutnings hanterare eller Property Overrides .The values assigned in configuration files and on the SSIS Parameters tab can be overridden by using the Connection Managers or Property Overrides tabs. De värden som tilldelas på fliken anslutnings hanterare kan också åsidosättas med hjälp av fliken åsidosättningar för egenskaper .The values assigned on the Connection Managers tab can also be overridden by using the Property Overrides tab.

  8. Verifiera pipeline-konfigurationen genom att välja Verifiera i verktygsfältet.To validate the pipeline configuration, select Validate on the toolbar. Om du vill stänga verifierings rapporten för pipelineväljer du >> .To close the Pipeline Validation Report, select >>.

  9. Om du vill publicera pipelinen till Data Factory väljer du publicera alla.To publish the pipeline to Data Factory, select Publish All.

Köra en pipelineRun the pipeline

I det här steget utlöser du en pipeline-körning.In this step, you trigger a pipeline run.

  1. Om du vill utlösa en pipeline-körning väljer du Utlös i verktygsfältet och väljer Utlös nu.To trigger a pipeline run, select Trigger on the toolbar, and select Trigger now.

    Utlös nu

  2. I fönstret Pipeline Run (Pipelinekörning) väljer du Slutför.In the Pipeline Run window, select Finish.

Övervaka pipelineMonitor the pipeline

  1. Växla till fliken Övervaka till vänster.Switch to the Monitor tab on the left. Du ser pipeline-körningen och dess status tillsammans med annan information, till exempel körnings start tiden.You see the pipeline run and its status along with other information, such as the Run Start time. Välj Uppdatera för att uppdatera vyn.To refresh the view, select Refresh.

    Pipelinekörningar

  2. Välj länken View Activity Runs (Visa aktivitetskörningar) i kolumnen Actions (Åtgärder).Select the View Activity Runs link in the Actions column. Du kan bara se en aktivitets körning eftersom pipelinen bara har en aktivitet.You see only one activity run because the pipeline has only one activity. Det är aktiviteten kör SSIS-paket.It's the Execute SSIS Package activity.

    Aktivitetskörningar

  3. Kör följande fråga mot SSISDB-databasen på SQL-servern för att kontrol lera att paketet körs.Run the following query against the SSISDB database in your SQL server to verify that the package executed.

    select * from catalog.executions
    

    Verifiera paket körningar

  4. Du kan också få körnings-ID: t för SSISDB från utdata från pipeline-aktiviteten och använda ID: t för att kontrol lera utförliga körnings loggar och fel meddelanden i SQL Server Management Studio.You can also get the SSISDB execution ID from the output of the pipeline activity run and use the ID to check more comprehensive execution logs and error messages in SQL Server Management Studio.

    Hämta körnings-ID: t.

Schemalägg pipelinen med en utlösareSchedule the pipeline with a trigger

Du kan också skapa en schemalagd utlösare för din pipeline så att pipelinen körs enligt ett schema, till exempel varje timme eller varje dag.You can also create a scheduled trigger for your pipeline so that the pipeline runs on a schedule, such as hourly or daily. Ett exempel finns i skapa en data fabrik – Data Factory användar gränssnitt.For an example, see Create a data factory - Data Factory UI.

Köra ett paket med PowerShellRun a package with PowerShell

I det här avsnittet använder du Azure PowerShell för att skapa en Data Factory-pipeline med en kör SSIS-paket-aktivitet som kör ditt SSIS-paket.In this section, you use Azure PowerShell to create a Data Factory pipeline with an Execute SSIS Package activity that runs your SSIS package.

Installera de senaste Azure PowerShell modulerna genom att följa de stegvisa anvisningarna i så här installerar och konfigurerar du Azure PowerShell.Install the latest Azure PowerShell modules by following the step-by-step instructions in How to install and configure Azure PowerShell.

Skapa en data fabrik med Azure-SSIS IRCreate a data factory with Azure-SSIS IR

Du kan antingen använda en befintlig data fabrik som redan Azure-SSIS IR etablerad eller skapa en ny data fabrik med Azure-SSIS IR.You can either use an existing data factory that already has Azure-SSIS IR provisioned or create a new data factory with Azure-SSIS IR. Följ de stegvisa anvisningarna i självstudien: Distribuera SSIS-paket till Azure via PowerShell.Follow the step-by-step instructions in the Tutorial: Deploy SSIS packages to Azure via PowerShell.

Skapa en pipeline med en EXECUTE SSIS-paket-aktivitetCreate a pipeline with an Execute SSIS Package activity

I det här steget skapar du en pipeline med en aktivitet för att köra SSIS-paket.In this step, you create a pipeline with an Execute SSIS Package activity. Aktiviteten Kör ditt SSIS-paket.The activity runs your SSIS package.

  1. Skapa en JSON-fil med namnet RunSSISPackagePipeline. JSON i mappen C:\ADF\RunSSISPackage med innehåll som liknar följande exempel.Create a JSON file named RunSSISPackagePipeline.json in the C:\ADF\RunSSISPackage folder with content similar to the following example.

    Viktigt

    Ersätt objekt namn, beskrivningar och sökvägar, egenskaper, parameter värden, lösen ord och andra variabel värden innan du sparar filen.Replace object names, descriptions, and paths, property or parameter values, passwords, and other variable values before you save the file.

    {
        "name": "RunSSISPackagePipeline",
        "properties": {
            "activities": [{
                "name": "MySSISActivity",
                "description": "My SSIS package/activity description",
                "type": "ExecuteSSISPackage",
                "typeProperties": {
                    "connectVia": {
                        "referenceName": "MyAzureSSISIR",
                        "type": "IntegrationRuntimeReference"
                    },
                    "executionCredential": {
                        "domain": "MyExecutionDomain",
                        "username": "MyExecutionUsername",
                        "password": {
                            "type": "SecureString",
                            "value": "MyExecutionPassword"
                        }
                    },
                    "runtime": "x64",
                    "loggingLevel": "Basic",
                    "packageLocation": {
                        "packagePath": "MyFolder/MyProject/MyPackage.dtsx",
                        "type": "SSISDB"
                    },
                    "environmentPath": "MyFolder/MyEnvironment",
                    "projectParameters": {
                        "project_param_1": {
                            "value": "123"
                        },
                        "project_param_2": {
                            "value": {
                                "value": "@pipeline().parameters.MyProjectParameter",
                                "type": "Expression"
                            }
                        }
                    },
                    "packageParameters": {
                        "package_param_1": {
                            "value": "345"
                        },
                        "package_param_2": {
                            "value": {
                                "type": "AzureKeyVaultSecret",
                                "store": {
                                    "referenceName": "myAKV",
                                    "type": "LinkedServiceReference"
                                },
                                "secretName": "MyPackageParameter"
                            }
                        }
                    },
                    "projectConnectionManagers": {
                        "MyAdonetCM": {
                            "username": {
                                "value": "MyConnectionUsername"
                            },
                            "password": {
                                "value": {
                                    "type": "SecureString",
                                    "value": "MyConnectionPassword"
                                }
                            }
                        }
                    },
                    "packageConnectionManagers": {
                        "MyOledbCM": {
                            "username": {
                                "value": {
                                    "value": "@pipeline().parameters.MyConnectionUsername",
                                    "type": "Expression"
                                }
                            },
                            "password": {
                                "value": {
                                    "type": "AzureKeyVaultSecret",
                                    "store": {
                                        "referenceName": "myAKV",
                                        "type": "LinkedServiceReference"
                                    },
                                    "secretName": "MyConnectionPassword",
                                    "secretVersion": "MyConnectionPasswordVersion"
                                }
                            }
                        }
                    },
                    "propertyOverrides": {
                        "\\Package.MaxConcurrentExecutables": {
                            "value": 8,
                            "isSensitive": false
                        }
                    }
                },
                "policy": {
                    "timeout": "0.01:00:00",
                    "retry": 0,
                    "retryIntervalInSeconds": 30
                }
            }]
        }
    }
    

    Om du vill köra paket som lagras i fil system, fil resurser eller Azure Files anger du värdena för egenskaperna för ditt paket och logg plats enligt följande:To execute packages stored in file systems, file shares, or Azure Files, enter the values for your package and log location properties as follows:

    {
        {
            {
                {
                    "packageLocation": {
                        "packagePath": "//MyStorageAccount.file.core.windows.net/MyFileShare/MyPackage.dtsx",
                        "type": "File",
                        "typeProperties": {
                            "packagePassword": {
                                "type": "SecureString",
                                "value": "MyEncryptionPassword"
                            },
                            "accessCredential": {
                                "domain": "Azure",
                                "username": "MyStorageAccount",
                                "password": {
                                    "type": "SecureString",
                                    "value": "MyAccountKey"
                                }
                            }
                        }
                    },
                    "logLocation": {
                        "logPath": "//MyStorageAccount.file.core.windows.net/MyFileShare/MyLogFolder",
                        "type": "File",
                        "typeProperties": {
                            "accessCredential": {
                                "domain": "Azure",
                                "username": "MyStorageAccount",
                                "password": {
                                    "type": "AzureKeyVaultSecret",
                                    "store": {
                                        "referenceName": "myAKV",
                                        "type": "LinkedServiceReference"
                            },
                                    "secretName": "MyAccountKey"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    

    Om du vill köra paket i projekt som lagras i fil system, fil resurser eller Azure Files anger du värdena för egenskapen för paket platsen enligt följande:To execute packages within projects stored in file systems, file shares, or Azure Files, enter the values for your package location property as follows:

    {
        {
            {
                {
                    "packageLocation": {
                        "packagePath": "//MyStorageAccount.file.core.windows.net/MyFileShare/MyProject.ispac:MyPackage.dtsx",
                        "type": "File",
                        "typeProperties": {
                            "packagePassword": {
                                "type": "SecureString",
                                "value": "MyEncryptionPassword"
                            },
                            "accessCredential": {
                                "domain": "Azure",
                                "userName": "MyStorageAccount",
                                "password": {
                                    "type": "SecureString",
                                    "value": "MyAccountKey"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    

    Om du vill köra inbäddade paket anger du värdena för egenskapen för paket platsen enligt följande:To execute embedded packages, enter the values for your package location property as follows:

    {
        {
            {
                {
                    "packageLocation": {
                        "type": "InlinePackage",
                        "typeProperties": {
                            "packagePassword": {
                                "type": "SecureString",
                                "value": "MyEncryptionPassword"
                            },
                            "packageName": "MyPackage.dtsx",
                            "packageContent":"My compressed/uncompressed package content",
                            "packageLastModifiedDate": "YYYY-MM-DDTHH:MM:SSZ UTC-/+HH:MM"
                        }
                    }
                }
            }
        }
    }
    
  2. I Azure PowerShell växlar du till mappen C:\ADF\RunSSISPackageIn Azure PowerShell, switch to the C:\ADF\RunSSISPackage folder.

  3. Om du vill skapa pipelinen RunSSISPackagePipelinekör du cmdleten set-AzDataFactoryV2Pipeline .To create the pipeline RunSSISPackagePipeline, run the Set-AzDataFactoryV2Pipeline cmdlet.

    $DFPipeLine = Set-AzDataFactoryV2Pipeline -DataFactoryName $DataFactory.DataFactoryName `
                                                   -ResourceGroupName $ResGrp.ResourceGroupName `
                                                   -Name "RunSSISPackagePipeline"
                                                   -DefinitionFile ".\RunSSISPackagePipeline.json"
    

    Här är exempel på utdata:Here's the sample output:

    PipelineName      : Adfv2QuickStartPipeline
    ResourceGroupName : <resourceGroupName>
    DataFactoryName   : <dataFactoryName>
    Activities        : {CopyFromBlobToBlob}
    Parameters        : {[inputPath, Microsoft.Azure.Management.DataFactory.Models.ParameterSpecification], [outputPath, Microsoft.Azure.Management.DataFactory.Models.ParameterSpecification]}
    

Köra en pipelineRun the pipeline

Använd cmdleten Invoke-AzDataFactoryV2Pipeline för att köra pipelinen.Use the Invoke-AzDataFactoryV2Pipeline cmdlet to run the pipeline. Cmdleten samlar även in pipelinekörningens ID för kommande övervakning.The cmdlet returns the pipeline run ID for future monitoring.

$RunId = Invoke-AzDataFactoryV2Pipeline -DataFactoryName $DataFactory.DataFactoryName `
                                             -ResourceGroupName $ResGrp.ResourceGroupName `
                                             -PipelineName $DFPipeLine.Name

Övervaka pipelineMonitor the pipeline

Kör följande PowerShell-skript för att kontinuerligt kontrollera pipelinekörningens status tills kopieringen av data är klar.Run the following PowerShell script to continuously check the pipeline run status until it finishes copying the data. Kopiera eller klistra in följande skript i PowerShell-fönstret och välj RETUR.Copy or paste the following script in the PowerShell window, and select Enter.

while ($True) {
    $Run = Get-AzDataFactoryV2PipelineRun -ResourceGroupName $ResGrp.ResourceGroupName `
                                               -DataFactoryName $DataFactory.DataFactoryName `
                                               -PipelineRunId $RunId

    if ($Run) {
        if ($run.Status -ne 'InProgress') {
            Write-Output ("Pipeline run finished. The status is: " +  $Run.Status)
            $Run
            break
        }
        Write-Output  "Pipeline is running...status: InProgress"
    }

    Start-Sleep -Seconds 10
}   

Du kan också övervaka pipelinen med hjälp av Azure Portal.You can also monitor the pipeline by using the Azure portal. Stegvisa instruktioner finns i övervaka pipelinen.For step-by-step instructions, see Monitor the pipeline.

Schemalägg pipelinen med en utlösareSchedule the pipeline with a trigger

I föregående steg körde du pipelinen på begäran.In the previous step, you ran the pipeline on demand. Du kan också skapa en schema utlösare för att köra pipelinen enligt ett schema, till exempel varje timme eller varje dag.You can also create a schedule trigger to run the pipeline on a schedule, such as hourly or daily.

  1. Skapa en JSON-fil med namnet untrigger. JSON i mappen C:\ADF\RunSSISPackage med följande innehåll:Create a JSON file named MyTrigger.json in the C:\ADF\RunSSISPackage folder with the following content:

    {
        "properties": {
            "name": "MyTrigger",
            "type": "ScheduleTrigger",
            "typeProperties": {
                "recurrence": {
                    "frequency": "Hour",
                    "interval": 1,
                    "startTime": "2017-12-07T00:00:00-08:00",
                    "endTime": "2017-12-08T00:00:00-08:00"
                }
            },
            "pipelines": [{
                "pipelineReference": {
                    "type": "PipelineReference",
                    "referenceName": "RunSSISPackagePipeline"
                },
                "parameters": {}
            }]
        }
    }    
    
  2. I Azure PowerShell växlar du till mappen C:\ADF\RunSSISPackageIn Azure PowerShell, switch to the C:\ADF\RunSSISPackage folder.

  3. Kör cmdleten set-AzDataFactoryV2Trigger som skapar utlösaren.Run the Set-AzDataFactoryV2Trigger cmdlet, which creates the trigger.

    Set-AzDataFactoryV2Trigger -ResourceGroupName $ResGrp.ResourceGroupName `
                                    -DataFactoryName $DataFactory.DataFactoryName `
                                    -Name "MyTrigger" -DefinitionFile ".\MyTrigger.json"
    
  4. Som standard är utlösaren i stoppat läge.By default, the trigger is in stopped state. Starta utlösaren genom att köra cmdleten Start-AzDataFactoryV2Trigger .Start the trigger by running the Start-AzDataFactoryV2Trigger cmdlet.

    Start-AzDataFactoryV2Trigger -ResourceGroupName $ResGrp.ResourceGroupName `
                                      -DataFactoryName $DataFactory.DataFactoryName `
                                      -Name "MyTrigger" 
    
  5. Bekräfta att utlösaren har startats genom att köra cmdleten Get-AzDataFactoryV2Trigger .Confirm that the trigger is started by running the Get-AzDataFactoryV2Trigger cmdlet.

    Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName `
                                    -DataFactoryName $DataFactoryName `
                                    -Name "MyTrigger"     
    
  6. Kör följande kommando efter nästa timma.Run the following command after the next hour. Om den aktuella tiden till exempel är 3:25 PM, kör du kommandot på 4 PM UTC.For example, if the current time is 3:25 PM UTC, run the command at 4 PM UTC.

    Get-AzDataFactoryV2TriggerRun -ResourceGroupName $ResourceGroupName `
                                       -DataFactoryName $DataFactoryName `
                                       -TriggerName "MyTrigger" `
                                       -TriggerRunStartedAfter "2017-12-06" `
                                       -TriggerRunStartedBefore "2017-12-09"
    

    Kör följande fråga mot SSISDB-databasen på SQL-servern för att kontrol lera att paketet körs.Run the following query against the SSISDB database in your SQL server to verify that the package executed.

    select * from catalog.executions
    

Nästa stegNext steps

Se följande blogg inlägg:See the following blog post: