Uruchom pakiet usług SSIS za pomocą działania wykonaj pakiet SSIS w Azure Data FactoryRun an SSIS package with the Execute SSIS Package activity in Azure Data Factory

W tym artykule opisano sposób uruchamiania pakietu SQL Server Integration Services (SSIS) w potoku Azure Data Factory przy użyciu działania wykonaj pakiet SSIS.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.

Wymagania wstępnePrerequisites

Uwaga

Ten artykuł został zaktualizowany o korzystanie z nowego modułu Azure PowerShell Az.This article has been updated to use the new Azure PowerShell Az module. Nadal możesz używać modułu AzureRM, który będzie nadal otrzymywać poprawki błędów do co najmniej grudnia 2020 r.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Aby dowiedzieć się więcej na temat nowego modułu Az i zgodności z modułem AzureRM, zobacz Wprowadzenie do nowego modułu Az programu Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Aby uzyskać instrukcje dotyczące instalacji modułu Az, zobacz Instalowanie programu Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Utwórz środowisko Azure-SSIS Integration Runtime (IR), jeśli jeszcze go nie masz, postępując zgodnie z instrukcjami krok po kroku w samouczku: Inicjowanie obsługi 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.

Uruchom pakiet w Azure PortalRun a package in the Azure portal

W tej sekcji użyjesz interfejsu użytkownika Data Factory (UI) lub aplikacji do utworzenia potoku Data Factory za pomocą działania wykonaj pakiet SSIS, które uruchamia pakiet SSIS.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.

Tworzenie potoku za pomocą działania wykonywania pakietu SSISCreate a pipeline with an Execute SSIS Package activity

W tym kroku użyjesz interfejsu użytkownika Data Factory lub aplikacji w celu utworzenia potoku.In this step, you use the Data Factory UI or app to create a pipeline. Dodaj do potoku działanie wykonaj pakiet SSIS i skonfiguruj je do uruchamiania pakietu usług SSIS.You add an Execute SSIS Package activity to the pipeline and configure it to run your SSIS package.

  1. Na stronie Przegląd Data Factory lub Strona główna w Azure Portal wybierz kafelek Tworzenie monitora & , aby uruchomić Data Factory interfejs użytkownika lub aplikację na osobnej karcie.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.

    Strona główna Data Factory

    Na stronie Zaczynajmy wybierz pozycję Utwórz potok.On the Let's get started page, select Create pipeline.

    Strona Wprowadzenie

  2. W przyborniku działania rozwiń pozycję Ogólne.In the Activities toolbox, expand General. Następnie przeciągnij działanie Wykonaj pakiet SSIS do powierzchni projektanta potoku.Then drag an Execute SSIS Package activity to the pipeline designer surface.

    Przeciągnij działanie wykonaj pakiet SSIS na powierzchnię projektanta

  3. Na karcie Ogólne dla działania wykonaj pakiet SSIS Podaj nazwę i opis działania.On the General tab for the Execute SSIS Package activity, provide a name and description for the activity. Ustaw opcjonalny limit czasu i Ponów wartości.Set optional Timeout and Retry values.

    Ustawianie właściwości na karcie Ogólne

  4. Na karcie Ustawienia dla działania wykonaj pakiet SSIS wybierz Azure-SSIS IR, w którym chcesz uruchomić pakiet.On the Settings tab for the Execute SSIS Package activity, select an Azure-SSIS IR where you want to run your package. Jeśli pakiet używa uwierzytelniania systemu Windows w celu uzyskania dostępu do magazynów danych (na przykład serwerów SQL lub udziałów plików lokalnych lub Azure Files), zaznacz pole wyboru uwierzytelnianie systemu Windows .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. Wprowadź wartości w polach domena, Nazwa użytkownikai hasło .Enter the values for your package execution credentials in the Domain, Username, and Password boxes.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w magazynie kluczy platformy Azure jako ich wartości.Alternatively, you can use secrets stored in your Azure key vault as their values. Aby to zrobić, zaznacz pole wyboru Magazyn kluczy Azure obok odpowiedniego poświadczenia.To do so, select the AZURE KEY VAULT check box next to the relevant credential. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub Utwórz nową.Select or edit your existing key vault linked service or create a new one. Następnie wybierz nazwę lub wersję wpisu tajnego dla wartości poświadczenia.Then select the secret name or version for your credential value.

    Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy.When you create or edit your key vault linked service, you can select or edit your existing key vault or create a new one. Upewnij się, że Data Factory zarządzana tożsamość do magazynu kluczy, jeśli jeszcze tego nie zrobiono.Make sure to grant Data Factory managed identity access to your key vault if you haven't done so already. Możesz również wprowadzić wpisy tajne bezpośrednio w następującym formacie: <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>. Jeśli pakiet wymaga 32-bitowego środowiska uruchomieniowego do uruchomienia, zaznacz pole wyboru 32-bitowe środowisko uruchomieniowe .If your package needs 32-bit runtime to run, select the 32-Bit runtime check box.

    W obszarze Lokalizacja pakietuwybierz pozycję SSISDB, system plików (pakiet) , system plików (projekt) lub pakiet osadzony.For Package location, select SSISDB, File System (Package), File System (Project), or Embedded package. W przypadku wybrania opcji SSISDB jako lokalizacji pakietu, która jest automatycznie wybierana, jeśli Azure-SSIS IR została zainicjowana przy użyciu wykazu usług SSIS (SSISDB) hostowanego przez serwer Azure SQL Database lub wystąpienie zarządzane, określ pakiet do uruchomienia, który został wdrożony w 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.

    Jeśli Azure-SSIS IR jest uruchomiona, a pole wyboru wpisy ręczne jest wyczyszczone, Przeglądaj i wybierz istniejące foldery, projekty, pakiety lub środowiska z 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. Wybierz pozycję Odśwież , aby pobrać nowo dodane foldery, projekty, pakiety lub środowiska z SSISDB, aby były dostępne do przeglądania i wyboru.Select Refresh to fetch your newly added folders, projects, packages, or environments from SSISDB so that they're available for browsing and selection. Aby przeglądać lub wybierać środowiska na potrzeby wykonywania pakietów, musisz wcześniej skonfigurować projekty, aby dodać te środowiska jako odwołania z tych samych folderów w obszarze 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. Aby uzyskać więcej informacji, zobacz Tworzenie i mapowanie środowisk SSIS.For more information, see Create and map SSIS environments.

    W obszarze poziom rejestrowaniaWybierz wstępnie zdefiniowany zakres rejestrowania dla wykonywania pakietu.For Logging level, select a predefined scope of logging for your package execution. Zaznacz pole wyboru dostosowany , jeśli chcesz wprowadzić zamiast niej dostosowanej nazwy rejestrowania.Select the Customized check box if you want to enter your customized logging name instead.

    Ustawianie właściwości na karcie Ustawienia — automatyczne

    Jeśli Azure-SSIS IR nie jest uruchomiona lub jest zaznaczone pole wyboru wpisy ręczne , wprowadź swoje ścieżki pakietu i środowiska z SSISDB bezpośrednio w następujących formatach: <folder name>/<project name>/<package name>.dtsx i <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>.

    Ustawianie właściwości na karcie Ustawienia — ręczne

    Jeśli wybierzesz opcję system plików (pakiet) jako lokalizację pakietu, która jest automatycznie wybierana, jeśli Azure-SSIS IR została zainicjowana bez SSISDB, określ pakiet do uruchomienia, podając ścieżkę Universal NAMING Convention (UNC) do pliku pakietu (.dtsx) w polu ścieżka pakietu .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. Jeśli na przykład przechowujesz swój pakiet w Azure Files, jego ścieżka pakietu jest \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.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.

    W przypadku skonfigurowania pakietu w osobnym pliku należy również podać ścieżkę UNC do pliku konfiguracji (.dtsConfig) w polu ścieżka konfiguracji .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. Jeśli na przykład przechowujesz konfigurację w Azure Files, jej Ścieżka konfiguracyjna jest \\<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.

    Ustawianie właściwości na karcie Ustawienia — ręczne

    W przypadku wybrania opcji system plików (projekt) jako lokalizacji pakietu Określ pakiet do uruchomienia, podając ścieżkę UNC do pliku projektu (.ispac) w polu ścieżka projektu i plik pakietu (.dtsx) z projektu w polu Nazwa pakietu .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. Na przykład jeśli projekt jest przechowywany w Azure Files, jego ścieżka projektu jest \\<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.

    Ustawianie właściwości na karcie Ustawienia — ręczne

    Następnie określ poświadczenia, aby uzyskać dostęp do plików projektu, pakietu lub konfiguracji.Next, specify the credentials to access your project, package, or configuration files. Jeśli wcześniej wprowadzono wartości poświadczeń wykonywania pakietu (zobacz poprzedni), możesz użyć ich ponownie, zaznaczając pole wyboru poświadczenia wykonywania pakietu .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. W przeciwnym razie wprowadź wartości poświadczeń dostępu do pakietu w polach domena, Nazwa użytkownikai hasło .Otherwise, enter the values for your package access credentials in the Domain, Username, and Password boxes. Na przykład w przypadku przechowywania projektu, pakietu lub konfiguracji w Azure Files domena jest Azure, nazwa użytkownika jest <storage account name>, a hasło jest <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>.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w magazynie kluczy jako ich wartości (zobacz poprzedni).Alternatively, you can use secrets stored in your key vault as their values (see previous). Te poświadczenia są używane do uzyskiwania dostępu do pakietu i pakietów podrzędnych w zadaniu pakietu, wszystkie z własnej ścieżki lub tego samego projektu, a także konfiguracje, które obejmują te określone w pakietach.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.

    Jeśli wybierzesz opcję pakiet osadzony jako lokalizację pakietu, przeciągnij i upuść swój pakiet, aby uruchomić lub przekazać go z folderu plików do dostępnego pola.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. Pakiet zostanie automatycznie skompresowany i osadzony w ładunku aktywności.Your package will be automatically compressed and embedded in the activity payload. Po osadzeniu można pobrać pakiet później do edycji.Once embedded, you can Download your package later for editing. Możesz również Sparametryzuj osadzony pakiet, przypisując go do parametru potoku, który może być używany w wielu działaniach, a tym samym zoptymalizować rozmiar ładunku potoku.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. Jeśli osadzony pakiet nie jest szyfrowany i wykryjesz w nim zadanie wykonaj pakiet, zostanie zaznaczone pole wyboru Wykonaj zadanie wykonania pakietu , a odpowiednie pakiety podrzędne z odwołaniami do systemu plików zostaną automatycznie dodane.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. Jeśli nie można wykryć użycia zadania wykonaj pakiet, musisz ręcznie zaznaczyć pole wyboru Wykonaj zadanie pakietu i dodać odpowiednie pakiety podrzędne wraz z ich systemem plików, do których można je również osadzić.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. Jeśli pakiety podrzędne używają odwołań SQL Server, upewnij się, że SQL Server jest dostępny w Azure-SSIS IR.If the child packages use SQL Server references, please ensure that the SQL Server is accessible by your Azure-SSIS IR. Użycie odwołań projektu dla pakietów podrzędnych nie jest obecnie obsługiwane.The use of project references for child packages is currently unsupported.

    Ustawianie właściwości na karcie Ustawienia — ręczne

    Jeśli używasz poziomu ochrony EncryptAllWithPassword lub EncryptSensitiveWithPassword podczas tworzenia pakietu za pomocą narzędzi SQL Server Data Tools, wprowadź wartość hasła w polu hasło szyfrowania .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. Alternatywnie możesz użyć wpisu tajnego przechowywanego w magazynie kluczy jako jego wartości (zobacz poprzedni).Alternatively, you can use a secret stored in your key vault as its value (see previous). W przypadku użycia poziomu ochrony EncryptSensitiveWithUserKey należy ponownie wprowadzić wartości poufne w plikach konfiguracyjnych lub na kartach Parametry usług SSIS, menedżerów połączeńlub zastąpień właściwości (zobacz nowsze).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).

    Jeśli użyto poziomu ochrony EncryptAllWithUserKey , jest on nieobsługiwany.If you used the EncryptAllWithUserKey protection level, it's unsupported. Należy ponownie skonfigurować pakiet, aby użyć innego poziomu ochrony za pośrednictwem narzędzi SQL Server Data Tools lub narzędzia wiersza polecenia dtutil.You need to reconfigure your package to use another protection level via SQL Server Data Tools or the dtutil command-line utility.

    W obszarze poziom rejestrowaniaWybierz wstępnie zdefiniowany zakres rejestrowania dla wykonywania pakietu.For Logging level, select a predefined scope of logging for your package execution. Zaznacz pole wyboru dostosowany , jeśli chcesz wprowadzić zamiast niej dostosowanej nazwy rejestrowania.Select the Customized check box if you want to enter your customized logging name instead. Jeśli chcesz rejestrować wykonywanie pakietów poza przy użyciu standardowych dostawców dzienników, które można określić w pakiecie, określ folder dziennika, podając jego ścieżkę UNC w polu ścieżka rejestrowania .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. Jeśli na przykład przechowujesz dzienniki w Azure Files, ścieżka rejestrowania jest \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>.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>. W tej ścieżce zostanie utworzony podfolder dla każdego pojedynczego pakietu, który jest uruchamiany po IDENTYFIKATORze uruchomienia działania pakietu SSIS, w którym pliki dziennika są generowane co pięć 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.

    Na koniec określ poświadczenia, aby uzyskać dostęp do folderu dziennika.Finally, specify the credentials to access your log folder. Jeśli wcześniej wprowadzono wartości poświadczeń dostępu do pakietu (zobacz poprzedni), możesz użyć ich ponownie, zaznaczając pole wyboru poświadczenia dostępu do pakietu .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. W przeciwnym razie wprowadź wartości poświadczeń dostępu do rejestrowania w polach domena, Nazwa użytkownikai hasło .Otherwise, enter the values for your logging access credentials in the Domain, Username, and Password boxes. Na przykład w przypadku przechowywania dzienników w Azure Files domena jest Azure, nazwa użytkownika jest <storage account name>, a hasło jest <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>.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w magazynie kluczy jako ich wartości (zobacz poprzedni).Alternatively, you can use secrets stored in your key vault as their values (see previous). Te poświadczenia są używane do przechowywania dzienników.These credentials are used to store your logs.

    We wszystkich wyżej wymienionych ścieżkach UNC w pełni kwalifikowana nazwa pliku musi być krótsza niż 260 znaków.For all UNC paths previously mentioned, the fully qualified file name must be fewer than 260 characters. Nazwa katalogu musi być krótsza niż 248 znaków.The directory name must be fewer than 248 characters.

  5. Na karcie parametry programu SSIS dla działania wykonywania pakietu SSIS, jeśli Azure-SSIS IR jest uruchomiona, SSISDB jest wybrane jako lokalizacja pakietu, a pole wyboru wpisy ręczne na karcie Ustawienia jest wyczyszczone, istniejące parametry usług SSIS w wybranym projekcie lub pakiecie z SSISDB są wyświetlane, aby przypisać do nich wartości.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. W przeciwnym razie możesz wprowadzić je pojedynczo, aby przypisać do nich wartości ręcznie.Otherwise, you can enter them one by one to assign values to them manually. Upewnij się, że istnieją i zostały poprawnie wprowadzone w celu pomyślnego wykonania pakietu.Make sure that they exist and are correctly entered for your package execution to succeed.

    Jeśli podczas tworzenia pakietu użyto poziomu ochrony EncryptSensitiveWithUserKey za pomocą narzędzi SQL Server Data Tools i system plików (pakiet) lub system plików (projekt) jest wybrany jako lokalizacja pakietu, należy również ponownie wprowadzić poufne parametry, aby przypisać do nich wartości w plikach konfiguracyjnych lub na tej karcie.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.

    W przypadku przypisywania wartości do parametrów można dodać zawartość dynamiczną przy użyciu wyrażeń, funkcji, Data Factory zmiennych systemowych Data Factory i parametrów potoku lub zmiennych.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. Alternatywnie możesz użyć wpisów tajnych przechowywanych w magazynie kluczy jako ich wartości (zobacz poprzedni).Alternatively, you can use secrets stored in your key vault as their values (see previous).

    Ustawianie właściwości na karcie Parametry SSIS

  6. Na karcie menedżerowie połączeń dla działania wykonaj pakiet SSIS, jeśli Azure-SSIS IR jest uruchomiona, SSISDB jest wybrane jako lokalizacja pakietu, a pole wyboru wpisy ręczne na karcie Ustawienia zostanie wyczyszczone, istniejące Menedżery połączeń w wybranym projekcie lub pakiecie z SSISDB są wyświetlane, aby przypisać wartości do ich właściwości.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. W przeciwnym razie możesz wprowadzić je pojedynczo, aby przypisać wartości do swoich właściwości ręcznie.Otherwise, you can enter them one by one to assign values to their properties manually. Upewnij się, że istnieją i zostały poprawnie wprowadzone w celu pomyślnego wykonania pakietu.Make sure that they exist and are correctly entered for your package execution to succeed.

    Jeśli podczas tworzenia pakietu użyto poziomu ochrony EncryptSensitiveWithUserKey za pomocą narzędzi SQL Server Data Tools i system plików (pakiet) lub system plików (projekt) jest wybrany jako lokalizacja pakietu, należy również ponownie wprowadzić poufne właściwości Menedżera połączeń, aby przypisać do nich wartości w plikach konfiguracyjnych lub na tej karcie.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.

    W przypadku przypisywania wartości do właściwości Menedżera połączeń można dodać zawartość dynamiczną przy użyciu wyrażeń, funkcji, Data Factory zmiennych systemowych Data Factory i parametrów potoku lub zmiennych.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. Alternatywnie możesz użyć wpisów tajnych przechowywanych w magazynie kluczy jako ich wartości (zobacz poprzedni).Alternatively, you can use secrets stored in your key vault as their values (see previous).

    Ustawianie właściwości na karcie menedżerów połączeń

  7. Na karcie Zastępowanie właściwości dla działania wykonaj pakiet SSIS wprowadź ścieżki istniejących właściwości w wybranym pakiecie po jednym, aby przypisać do nich wartości ręcznie.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. Upewnij się, że istnieją i zostały poprawnie wprowadzone w celu pomyślnego wykonania pakietu.Make sure that they exist and are correctly entered for your package execution to succeed. Na przykład aby zastąpić wartość zmiennej użytkownika, wprowadź jej ścieżkę w następującym formacie: \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.

    Jeśli podczas tworzenia pakietu użyto poziomu ochrony EncryptSensitiveWithUserKey za pomocą narzędzi SQL Server Data Tools i system plików (pakiet) lub system plików (projekt) jest wybrany jako lokalizacja pakietu, należy również ponownie wprowadzić poufne właściwości, aby przypisać do nich wartości w plikach konfiguracyjnych lub na tej karcie.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.

    W przypadku przypisywania wartości do właściwości można dodać zawartość dynamiczną przy użyciu wyrażeń, funkcji, Data Factory zmiennych systemowych Data Factory i parametrów potoku lub zmiennych.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.

    Ustawianie właściwości na karcie Zastępowanie właściwości

    Wartości przypisane do plików konfiguracji i na karcie Parametry usług SSIS można zastąpić przy użyciu kart menedżerów połączeń lub zastąpień właściwości .The values assigned in configuration files and on the SSIS Parameters tab can be overridden by using the Connection Managers or Property Overrides tabs. Wartości przypisane na karcie menedżerów połączeń mogą być również zastępowane przy użyciu karty zastąpień właściwości .The values assigned on the Connection Managers tab can also be overridden by using the Property Overrides tab.

  8. Aby sprawdzić poprawność konfiguracji potoku, wybierz pozycję Weryfikuj na pasku narzędzi.To validate the pipeline configuration, select Validate on the toolbar. Aby zamknąć raport weryfikacji potoku, wybierz pozycję >> .To close the Pipeline Validation Report, select >>.

  9. Aby opublikować potok do Data Factory, wybierz pozycję Opublikuj wszystko.To publish the pipeline to Data Factory, select Publish All.

Uruchamianie potokuRun the pipeline

W tym kroku zostanie wyzwolone uruchomienie potoku.In this step, you trigger a pipeline run.

  1. Aby wyzwolić uruchomienie potoku, wybierz pozycję Wyzwól na pasku narzędzi, a następnie wybierz pozycję Wyzwól teraz.To trigger a pipeline run, select Trigger on the toolbar, and select Trigger now.

    Wyzwól teraz

  2. W oknie Uruchomienie potoku wybierz pozycję Zakończ.In the Pipeline Run window, select Finish.

Monitorowanie potokuMonitor the pipeline

  1. Przejdź do karty Monitorowanie po lewej stronie.Switch to the Monitor tab on the left. Zobaczysz uruchomienie potoku i jego stan wraz z innymi informacjami, takimi jak godzina rozpoczęcia przebiegu .You see the pipeline run and its status along with other information, such as the Run Start time. Aby odświeżyć widok, wybierz pozycję Odśwież.To refresh the view, select Refresh.

    Uruchomienia potoków

  2. Wybierz link Wyświetl uruchomienia działania w kolumnie Akcje.Select the View Activity Runs link in the Actions column. Zobaczysz tylko jedno uruchomienie działania, ponieważ potok ma tylko jedno działanie.You see only one activity run because the pipeline has only one activity. To działanie wykonywania pakietu SSIS.It's the Execute SSIS Package activity.

    Uruchomienia działania

  3. Uruchom następujące zapytanie względem bazy danych SSISDB w programie SQL Server, aby sprawdzić, czy pakiet został uruchomiony.Run the following query against the SSISDB database in your SQL server to verify that the package executed.

    select * from catalog.executions
    

    Weryfikuj wykonania pakietu

  4. Możesz również uzyskać identyfikator wykonywania SSISDB z danych wyjściowych uruchomienia działania potoku i użyć identyfikatora, aby sprawdzić bardziej kompleksowe dzienniki wykonywania i komunikaty o błędach w 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.

    Pobierz identyfikator wykonania.

Planowanie potoku przy użyciu wyzwalaczaSchedule the pipeline with a trigger

Możesz również utworzyć zaplanowany wyzwalacz dla potoku, aby potok działał zgodnie z harmonogramem, na przykład co godzinę lub codziennie.You can also create a scheduled trigger for your pipeline so that the pipeline runs on a schedule, such as hourly or daily. Aby zapoznać się z przykładem, zobacz temat Tworzenie fabryki danych — Data Factory interfejsu użytkownika.For an example, see Create a data factory - Data Factory UI.

Uruchamianie pakietu przy użyciu programu PowerShellRun a package with PowerShell

W tej sekcji użyjesz Azure PowerShell, aby utworzyć potok Data Factory za pomocą działania wykonywania pakietu SSIS uruchamiającego pakiet usług SSIS.In this section, you use Azure PowerShell to create a Data Factory pipeline with an Execute SSIS Package activity that runs your SSIS package.

Zainstaluj najnowsze moduły Azure PowerShell, postępując zgodnie z instrukcjami krok po kroku w temacie jak zainstalować i skonfigurować Azure PowerShell.Install the latest Azure PowerShell modules by following the step-by-step instructions in How to install and configure Azure PowerShell.

Tworzenie fabryki danych przy użyciu Azure-SSIS IRCreate a data factory with Azure-SSIS IR

Możesz użyć istniejącej fabryki danych, która ma już zainicjowaną Azure-SSIS IR, lub utworzyć nową fabrykę danych z 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. Postępuj zgodnie z instrukcjami krok po kroku w samouczku: Wdrażanie pakietów usług SSIS na platformie Azure za pośrednictwem programu PowerShell.Follow the step-by-step instructions in the Tutorial: Deploy SSIS packages to Azure via PowerShell.

Tworzenie potoku za pomocą działania wykonywania pakietu SSISCreate a pipeline with an Execute SSIS Package activity

W tym kroku utworzysz potok z działaniem wykonaj pakiet SSIS.In this step, you create a pipeline with an Execute SSIS Package activity. Działanie uruchamia pakiet SSIS.The activity runs your SSIS package.

  1. Utwórz plik JSON o nazwie RunSSISPackagePipeline. JSON w folderze C:\ADF\RunSSISPackage o zawartości podobnej do poniższego przykładu.Create a JSON file named RunSSISPackagePipeline.json in the C:\ADF\RunSSISPackage folder with content similar to the following example.

    Ważne

    Przed zapisaniem pliku Zastąp nazwy obiektów, opisy i ścieżki, wartości właściwości lub parametrów, hasła i inne wartości zmiennych.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
                }
            }]
        }
    }
    

    Aby wykonać pakiety przechowywane w systemach plików, w udziałach plików lub Azure Files, wprowadź wartości właściwości pakietu i lokalizacji dziennika w następujący sposób: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"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    

    Aby wykonać pakiety w ramach projektów przechowywanych w systemach plików, udziałach plików lub Azure Files, wprowadź wartości dla właściwości lokalizacja pakietu w następujący sposób: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"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    

    Aby wykonać pakiety osadzone, wprowadź wartości właściwości lokalizacja pakietu w następujący sposób: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. W Azure PowerShell przejdź do folderu C:\ADF\RunSSISPackage .In Azure PowerShell, switch to the C:\ADF\RunSSISPackage folder.

  3. Aby utworzyć potok RunSSISPackagePipeline, uruchom polecenie cmdlet 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"
    

    Oto przykładowe dane wyjściowe: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]}
    

Uruchamianie potokuRun the pipeline

Użyj polecenia cmdlet Invoke-AzDataFactoryV2Pipeline , aby uruchomić potok.Use the Invoke-AzDataFactoryV2Pipeline cmdlet to run the pipeline. Polecenie cmdlet zwraca identyfikator uruchomienia potoku w celu monitorowania w przyszłości.The cmdlet returns the pipeline run ID for future monitoring.

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

Monitorowanie potokuMonitor the pipeline

Uruchom następujący skrypt programu PowerShell, aby stale sprawdzać stan uruchomienia potoku do momentu zakończenia kopiowania danych.Run the following PowerShell script to continuously check the pipeline run status until it finishes copying the data. Skopiuj lub wklej następujący skrypt w oknie programu PowerShell, a następnie wybierz klawisz ENTER.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
}   

Potok można również monitorować przy użyciu Azure Portal.You can also monitor the pipeline by using the Azure portal. Instrukcje krok po kroku znajdują się w sekcji monitorowanie potoku.For step-by-step instructions, see Monitor the pipeline.

Planowanie potoku przy użyciu wyzwalaczaSchedule the pipeline with a trigger

W poprzednim kroku uruchomiono potok na żądanie.In the previous step, you ran the pipeline on demand. Możesz również utworzyć wyzwalacz harmonogramu, aby uruchomić potok zgodnie z harmonogramem, na przykład co godzinę lub codziennie.You can also create a schedule trigger to run the pipeline on a schedule, such as hourly or daily.

  1. Utwórz plik JSON o nazwie C:\ADF\RunSSISPackage . JSON w folderze o następującej zawartości: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. W Azure PowerShell przejdź do folderu C:\ADF\RunSSISPackage .In Azure PowerShell, switch to the C:\ADF\RunSSISPackage folder.

  3. Uruchom polecenie cmdlet Set-AzDataFactoryV2Trigger , które tworzy wyzwalacz.Run the Set-AzDataFactoryV2Trigger cmdlet, which creates the trigger.

    Set-AzDataFactoryV2Trigger -ResourceGroupName $ResGrp.ResourceGroupName `
                                    -DataFactoryName $DataFactory.DataFactoryName `
                                    -Name "MyTrigger" -DefinitionFile ".\MyTrigger.json"
    
  4. Domyślnie wyzwalacz jest w stanie zatrzymanym.By default, the trigger is in stopped state. Uruchom wyzwalacz, uruchamiając polecenie cmdlet Start-AzDataFactoryV2Trigger .Start the trigger by running the Start-AzDataFactoryV2Trigger cmdlet.

    Start-AzDataFactoryV2Trigger -ResourceGroupName $ResGrp.ResourceGroupName `
                                      -DataFactoryName $DataFactory.DataFactoryName `
                                      -Name "MyTrigger" 
    
  5. Upewnij się, że wyzwalacz został uruchomiony, uruchamiając polecenie cmdlet Get-AzDataFactoryV2Trigger .Confirm that the trigger is started by running the Get-AzDataFactoryV2Trigger cmdlet.

    Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName `
                                    -DataFactoryName $DataFactoryName `
                                    -Name "MyTrigger"     
    
  6. Uruchom następujące polecenie po następnej godzinie.Run the following command after the next hour. Na przykład, jeśli bieżący czas to 3:25 PM UTC, uruchom polecenie o godzinie 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"
    

    Uruchom następujące zapytanie względem bazy danych SSISDB w programie SQL Server, aby sprawdzić, czy pakiet został uruchomiony.Run the following query against the SSISDB database in your SQL server to verify that the package executed.

    select * from catalog.executions
    

Następne krokiNext steps

Zobacz następujący wpis w blogu:See the following blog post: