Uruchamianie pakietu usług SSIS za pomocą działania Execute SSIS Package in Azure Portal

DOTYCZY: Azure Data Factory Azure Synapse Analytics (wersja zapoznawcza)

W tym artykule opisano sposób uruchamiania pakietu usług SQL Server Integration Services (SSIS) w potoku Azure Data Factory przy użyciu działania Execute SSIS Package in Azure Data Factory and Synapse Pipelines portal (Execute SSIS Package activity in Azure Data Factory and Synapse Pipelines portal).

Wymagania wstępne

Utwórz środowisko Azure-SSIS Integration Runtime (IR), jeśli jeszcze go nie masz, postępując zgodnie z instrukcjami krok po kroku w artykule Samouczek: aprowizowanie Azure-SSIS IR.

Tworzenie potoku za pomocą działania Execute SSIS Package (Wykonywanie pakietu SSIS)

W tym kroku użyjesz interfejsu użytkownika usługi Data Factory lub aplikacji do utworzenia potoku. Do potoku należy dodać działanie Execute SSIS Package (Wykonywanie pakietu SSIS) i skonfigurować je do uruchamiania pakietu usług SSIS.

  1. Na stronie przeglądu lub strony głównej usługi Data Factory w Azure Portal wybierz kafelek Author Monitor (Tworzenie & monitora), aby uruchomić interfejs użytkownika lub aplikację usługi Data Factory na osobnej karcie.

    Data Factory home page

    Na stronie głównej wybierz pozycję Orkiestruj.

    Screenshot that shows the ADF home page.

  1. W przyborniku Działania rozwiń węzeł Ogólne. Następnie przeciągnij działanie Execute SSIS Package (Wykonywanie pakietu SSIS ) na powierzchnię projektanta potoku.

    Drag an Execute SSIS Package activity to the designer surface

    Wybierz obiekt działania Wykonaj pakiet SSIS, aby skonfigurować karty Ogólne, Ustawienia, Parametry usług SSIS, Menedżerowie połączeń i Przesłonięcia właściwości.

Karta Ogólne

Na karcie Ogólne działania Wykonaj pakiet SSIS wykonaj następujące kroki.

Set properties on the General tab

  1. W polu Nazwa wprowadź nazwę działania Wykonaj pakiet SSIS.

  2. W polu Opis wprowadź opis działania Wykonaj pakiet SSIS.

  3. W polu Limit czasu wprowadź maksymalny czas, przez który można uruchomić działanie Wykonaj pakiet SSIS. Wartość domyślna to 7 dni, format to D.HH:MM:SS.

  4. W polu Ponów próbę wprowadź maksymalną liczbę ponownych prób wykonania działania pakietu SSIS.

  5. W polu Interwał ponawiania prób wprowadź liczbę sekund między kolejnymi próbami wykonania działania pakietu SSIS. Wartość domyślna to 30 sekund.

  6. Zaznacz pole wyboru Zabezpieczanie danych wyjściowych , aby wybrać, czy chcesz wykluczyć dane wyjściowe działania Execute SSIS Package z rejestrowania.

  7. Zaznacz pole wyboru Zabezpieczanie danych wejściowych , aby wybrać, czy chcesz wykluczyć dane wejściowe działania Execute SSIS Package z rejestrowania.

karta Ustawienia

Na karcie Ustawienia działania Wykonaj pakiet SSIS wykonaj następujące kroki.

Set properties on the Settings tab - Automatic

  1. W przypadku Azure-SSIS IR wybierz wyznaczony Azure-SSIS IR, aby uruchomić działanie Execute SSIS Package (Wykonywanie pakietu SSIS).

  2. W polu Opis wprowadź opis działania Wykonaj pakiet SSIS.

  3. Zaznacz pole wyboru uwierzytelniania Windows, aby wybrać, czy chcesz użyć uwierzytelniania Windows w celu uzyskania dostępu do magazynów danych, takich jak serwery SQL/udziały plików w środowisku lokalnym, czy Azure Files.

    Jeśli zaznaczysz to pole wyboru, wprowadź wartości poświadczeń wykonywania pakietu w polach Domena, Nazwa użytkownika i Hasło . Na przykład aby uzyskać dostęp do Azure Files, domena to Azure, nazwa użytkownika to <storage account name>, a hasło to <storage account key>.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok nich. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję dla swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Upewnij się, że udzielono tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

  4. Zaznacz pole wyboru 32-bitowe środowisko uruchomieniowe , aby wybrać, czy pakiet wymaga 32-bitowego środowiska uruchomieniowego.

  5. W polu Lokalizacja pakietu wybierz pozycję SSISDB, System plików (pakiet),System plików (Project), Pakiet osadzony lub Magazyn pakietów.

Lokalizacja pakietu: SSISDB

Baza danych SSISDB jako lokalizacja pakietu jest wybierana automatycznie, jeśli Azure-SSIS IR została aprowizowana przy użyciu katalogu usług SSIS (SSISDB) hostowanego przez serwer Azure SQL Database/wystąpienie zarządzane lub możesz wybrać go samodzielnie. Jeśli jest zaznaczona, wykonaj następujące kroki.

  1. Jeśli Azure-SSIS IR jest uruchomiona, a pole wyboru Ręczne wpisy jest wyczyszczone, przeglądaj i wybieraj istniejące foldery, projekty, pakiety i środowiska z bazy danych SSISDB. Wybierz pozycję Odśwież , aby pobrać nowo dodane foldery, projekty, pakiety lub środowiska z bazy danych SSISDB, aby były dostępne do przeglądania i wybierania. Aby przeglądać i wybierać środowiska dla wykonań pakietów, należy wcześniej skonfigurować projekty, aby dodać te środowiska jako odwołania z tych samych folderów w obszarze SSISDB. Aby uzyskać więcej informacji, zobacz Tworzenie i mapowania środowisk SSIS.

  2. W obszarze Poziom rejestrowania wybierz wstępnie zdefiniowany zakres rejestrowania na potrzeby wykonywania pakietu. Zaznacz pole wyboru Dostosowane , jeśli zamiast tego chcesz wprowadzić niestandardową nazwę rejestrowania.

  3. Jeśli Azure-SSIS IR nie jest uruchomiona lub jest zaznaczone pole wyboru Ręczne wpisy, wprowadź ścieżki pakietu i środowiska z bazy danych SSISDB bezpośrednio w następujących formatach: <folder name>/<project name>/<package name>.dtsx i <folder name>/<environment name>.

    Set properties on the Settings tab - Manual

Lokalizacja pakietu: System plików (pakiet)

System plików (pakiet) jako lokalizacja pakietu jest automatycznie wybierany, jeśli Azure-SSIS IR została aprowizowana bez bazy danych SSISDB lub możesz wybrać ją samodzielnie. Jeśli jest zaznaczona, wykonaj następujące kroki.

Set properties on the Settings tab - File System (Package)

  1. Określ pakiet do uruchomienia, podając ścieżkę Universal Naming Convention (UNC) do pliku pakietu (z .dtsx) w polu Ścieżka pakietu . Możesz przeglądać i wybierać pakiet, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź jego ścieżkę. Jeśli na przykład przechowujesz pakiet w Azure Files, jego ścieżka to \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

  2. W przypadku skonfigurowania pakietu w osobnym pliku należy również podać ścieżkę UNC do pliku konfiguracji (z .dtsConfig) w polu Ścieżka konfiguracji . Konfigurację możesz przeglądać i wybierać, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź jego ścieżkę. Jeśli na przykład konfiguracja jest przechowywana w Azure Files, jej ścieżka to \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

  3. Określ poświadczenia, aby uzyskać dostęp do plików pakietu i konfiguracji. Jeśli wcześniej wprowadzono wartości poświadczeń wykonywania pakietu (na potrzeby uwierzytelniania Windows), możesz użyć ich ponownie, zaznaczając pole wyboru Takie same jak poświadczenia wykonywania pakietu. W przeciwnym razie wprowadź wartości poświadczeń dostępu do pakietu w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład przechowujesz pakiet i konfigurację w Azure Files, domena to Azure, nazwa użytkownika to <storage account name>, a hasło to <storage account key>.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok nich. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję dla swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Upewnij się, że udzielono tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

    Te poświadczenia są również używane do uzyskiwania dostępu do pakietów podrzędnych w zadaniu wykonywania pakietu, do których odwołuje się ich własna ścieżka i inne konfiguracje określone w pakietach.

  4. Jeśli użyto poziomu ochrony EncryptAllWithPassword lub EncryptSensitiveWithPassword podczas tworzenia pakietu za pośrednictwem narzędzi SQL Server Data Tools (SSDT), wprowadź wartość hasła w polu Hasło szyfrowania. Alternatywnie możesz użyć wpisu tajnego przechowywanego w usłudze Azure Key Vault jako jego wartości (zobacz powyżej).

    Jeśli użyto poziomu ochrony EncryptSensitiveWithUserKey , wprowadź ponownie poufne wartości w plikach konfiguracji lub na kartach Parametry usług SSIS, Menedżerowie połączeń lub Przesłonięcia właściwości (patrz poniżej).

    Jeśli użyto poziomu ochrony EncryptAllWithUserKey , nie jest on obsługiwany. Należy ponownie skonfigurować pakiet, aby używać innego poziomu ochrony za pośrednictwem narzędzi SSDT lub dtutil wiersza polecenia.

  5. W obszarze Poziom rejestrowania wybierz wstępnie zdefiniowany zakres rejestrowania na potrzeby wykonywania pakietu. Zaznacz pole wyboru Dostosowane , jeśli zamiast tego chcesz wprowadzić niestandardową nazwę rejestrowania.

  6. Jeśli chcesz rejestrować wykonania pakietów poza użyciem standardowych dostawców dziennika, które można określić w pakiecie, określ folder dziennika, podając jego ścieżkę UNC w polu Ścieżka rejestrowania . Folder dziennika można przeglądać i wybierać, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź jego ścieżkę. Jeśli na przykład dzienniki są przechowywane w Azure Files, ścieżka rejestrowania to \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. Podfolder jest tworzony w tej ścieżce dla każdego przebiegu pojedynczego pakietu, nazwany na podstawie identyfikatora uruchomienia działania Wykonaj pakiet SSIS i w którym pliki dziennika są generowane co pięć minut.

  7. Określ poświadczenia, aby uzyskać dostęp do folderu dziennika. Jeśli wcześniej wprowadzono wartości poświadczeń dostępu do pakietu (zobacz powyżej), możesz użyć ich ponownie, zaznaczając pole wyboru Takie same jak poświadczenia dostępu do pakietu . W przeciwnym razie wprowadź wartości poświadczeń dostępu do rejestrowania w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład dzienniki są przechowywane w Azure Files, domena to Azure, nazwa użytkownika to <storage account name>, a hasło to <storage account key>. Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości (zobacz powyżej).

Dla wszystkich wcześniej wymienionych ścieżek UNC w pełni kwalifikowana nazwa pliku musi być mniejsza niż 260 znaków. Nazwa katalogu musi być mniejsza niż 248 znaków.

Lokalizacja pakietu: System plików (Project)

Jeśli wybierzesz pozycję System plików (Project) jako lokalizację pakietu, wykonaj następujące kroki.

Set properties on the Settings tab - File System (Project)

  1. Określ pakiet do uruchomienia, podając ścieżkę UNC do pliku projektu (z .ispac) w polu ścieżka Project i plik pakietu (z .dtsx) z projektu w polu Nazwa pakietu. Możesz przeglądać i wybierać projekt, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź ścieżkę. Jeśli na przykład przechowujesz projekt w Azure Files, jego ścieżka to \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

  2. Określ poświadczenia, aby uzyskać dostęp do projektu i plików pakietu. Jeśli wcześniej wprowadzono wartości poświadczeń wykonywania pakietu (w przypadku uwierzytelniania Windows), możesz użyć ich ponownie, wybierając pole wyboru Takie same jak poświadczenia wykonywania pakietu. W przeciwnym razie wprowadź wartości poświadczeń dostępu do pakietu w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład przechowujesz projekt i pakiet w Azure Files, domena to , nazwa użytkownika to Azure<storage account name>, a hasło to <storage account key>.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok nich. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Pamiętaj, aby udzielić tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

    Te poświadczenia są również używane do uzyskiwania dostępu do pakietów podrzędnych w zadaniu wykonywania pakietu, do którego odwołuje się ten sam projekt.

  3. Jeśli podczas tworzenia pakietu za pomocą narzędzia SSDT użyto poziomu ochrony EncryptAllWithPassword lub EncryptSensitiveWithPassword , wprowadź wartość hasła w polu Hasło szyfrowania . Alternatywnie możesz użyć wpisu tajnego przechowywanego w usłudze Azure Key Vault jako jego wartości (zobacz powyżej).

    Jeśli użyto poziomu ochrony EncryptSensitiveWithUserKey , wprowadź ponownie wartości poufne na kartach Parametry usług SSIS, Menedżerowie połączeń lub Przesłonięcia właściwości (zobacz poniżej).

    Jeśli użyto poziomu ochrony EncryptAllWithUserKey , nie jest on obsługiwany. Należy ponownie skonfigurować pakiet, aby użyć innego poziomu ochrony za pośrednictwem narzędzia SSDT lub dtutil wiersza polecenia.

  4. W obszarze Poziom rejestrowania wybierz wstępnie zdefiniowany zakres rejestrowania dla wykonywania pakietu. Zaznacz pole wyboru Dostosowane , jeśli zamiast tego chcesz wprowadzić niestandardową nazwę rejestrowania.

  5. Jeśli chcesz rejestrować wykonania pakietów poza użyciem standardowych dostawców dzienników, którzy mogą być określeni w pakiecie, określ folder dziennika, podając ścieżkę UNC w polu Ścieżka rejestrowania . Możesz przeglądać i wybierać folder dziennika, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź jego ścieżkę. Jeśli na przykład przechowujesz dzienniki w Azure Files, ścieżka rejestrowania to \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. Podfolder jest tworzony w tej ścieżce dla każdego pojedynczego przebiegu pakietu o nazwie po identyfikatorze uruchomienia działania Execute SSIS Package i w którym pliki dziennika są generowane co pięć minut.

  6. Określ poświadczenia, aby uzyskać dostęp do folderu dziennika. Jeśli wcześniej wprowadzono wartości poświadczeń dostępu do pakietu (zobacz powyżej), możesz użyć ich ponownie, wybierając pole wyboru Takie same jak poświadczenia dostępu do pakietu . W przeciwnym razie wprowadź wartości poświadczeń dostępu rejestrowania w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład przechowujesz dzienniki w Azure Files, domena to , nazwa użytkownika to Azure<storage account name>, a hasło to <storage account key>. Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości (zobacz powyżej).

Dla wszystkich wcześniej wymienionych ścieżek UNC w pełni kwalifikowana nazwa pliku musi być mniejsza niż 260 znaków. Nazwa katalogu musi być mniejsza niż 248 znaków.

Lokalizacja pakietu: Pakiet osadzony

Jeśli wybierzesz pozycję Pakiet osadzony jako lokalizację pakietu, wykonaj następujące kroki.

Set properties on the Settings tab - Embedded package

  1. Przeciągnij i upuść plik pakietu (z .dtsx) lub Upload go z folderu plików do podanego pola. Pakiet zostanie automatycznie skompresowany i osadzony w ładunku działania. Po osadzeniu możesz później pobrać pakiet do edycji. Możesz również sparametryzować pakiet osadzony, przypisując go do parametru potoku, który może być używany w wielu działaniach, dlatego optymalizując rozmiar ładunku potoku. Osadzanie plików projektu (z .ispacprogramem ) jest obecnie nieobsługiwane, więc nie można używać parametrów SSIS/menedżerów połączeń z zakresem na poziomie projektu w pakietach osadzonych.

  2. Jeśli pakiet osadzony nie jest zaszyfrowany i wykryjemy użycie zadania wykonania pakietu (EPT), pole wyboru Wykonaj zadanie pakietu zostanie automatycznie zaznaczone, a pakiety podrzędne, do których odwołują się ich ścieżki systemu plików, zostaną automatycznie dodane, aby można je było również osadzić.

    Jeśli nie można wykryć użycia protokołu EPT, musisz ręcznie zaznaczyć pole wyboru Wykonaj zadanie pakietu i dodać pakiety podrzędne, do których odwołują się ich ścieżki systemu plików jeden po drugim, aby można było je również osadzić. Jeśli pakiety podrzędne są przechowywane w bazie danych SQL Server (MSDB), nie można ich osadzić, dlatego należy upewnić się, że Azure-SSIS IR może uzyskać dostęp do witryny MSDB, aby pobrać je przy użyciu odwołań SQL Server. Osadzanie plików projektu (z .ispacprogramem ) jest obecnie nieobsługiwane, więc nie można używać odwołań opartych na projekcie dla pakietów podrzędnych.

  3. Jeśli podczas tworzenia pakietu za pomocą narzędzia SSDT użyto poziomu ochrony EncryptAllWithPassword lub EncryptSensitiveWithPassword , wprowadź wartość hasła w polu Hasło szyfrowania .

    Alternatywnie możesz użyć wpisu tajnego przechowywanego w usłudze Azure Key Vault jako jego wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok niego. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Pamiętaj, aby udzielić tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

    Jeśli użyto poziomu ochrony EncryptSensitiveWithUserKey , wprowadź ponownie poufne wartości w plikach konfiguracji lub na kartach Parametry usług SSIS, Menedżerowie połączeń lub Przesłonięcia właściwości (zobacz poniżej).

    Jeśli użyto poziomu ochrony EncryptAllWithUserKey , nie jest on obsługiwany. Należy ponownie skonfigurować pakiet, aby użyć innego poziomu ochrony za pośrednictwem narzędzia SSDT lub dtutil wiersza polecenia.

  4. W obszarze Poziom rejestrowania wybierz wstępnie zdefiniowany zakres rejestrowania dla wykonywania pakietu. Zaznacz pole wyboru Dostosowane , jeśli zamiast tego chcesz wprowadzić niestandardową nazwę rejestrowania.

  5. Jeśli chcesz rejestrować wykonania pakietów poza użyciem standardowych dostawców dzienników, którzy mogą być określeni w pakiecie, określ folder dziennika, podając ścieżkę UNC w polu Ścieżka rejestrowania . Możesz przeglądać i wybierać folder dziennika, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź jego ścieżkę. Jeśli na przykład przechowujesz dzienniki w Azure Files, ścieżka rejestrowania to \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. Podfolder jest tworzony w tej ścieżce dla każdego pojedynczego przebiegu pakietu o nazwie po identyfikatorze uruchomienia działania Execute SSIS Package i w którym pliki dziennika są generowane co pięć minut.

  6. Określ poświadczenia, aby uzyskać dostęp do folderu dziennika, wprowadzając ich wartości w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład przechowujesz dzienniki w Azure Files, domena to , nazwa użytkownika to Azure<storage account name>, a hasło to <storage account key>. Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości (zobacz powyżej).

Dla wszystkich wcześniej wymienionych ścieżek UNC w pełni kwalifikowana nazwa pliku musi być mniejsza niż 260 znaków. Nazwa katalogu musi być mniejsza niż 248 znaków.

Lokalizacja pakietu: Magazyn pakietów

Jeśli wybierzesz pozycję Magazyn pakietów jako lokalizację pakietu, wykonaj następujące kroki.

Set properties on the Settings tab - Package store

  1. W polu Nazwa magazynu pakietów wybierz istniejący magazyn pakietów dołączony do Azure-SSIS IR.

  2. Określ pakiet do uruchomienia, podając ścieżkę (bez .dtsx) z wybranego magazynu pakietów w polu Ścieżka pakietu . Jeśli wybrany magazyn pakietów znajduje się w górnej części systemu plików/Azure Files, możesz przeglądać i wybierać pakiet, wybierając pozycję Przeglądaj magazyn plików, w przeciwnym razie możesz wprowadzić jego ścieżkę w formacie <folder name>\<package name>. Możesz również zaimportować nowe pakiety do wybranego magazynu pakietów za pośrednictwem programu SQL Server Management Studio (SSMS) podobnego do starszego magazynu pakietów usług SSIS. Aby uzyskać więcej informacji, zobacz Manage SSIS packages with Azure-SSIS IR package stores (Zarządzanie pakietami usług SSIS za pomocą magazynów pakietów Azure-SSIS IR).

  3. W przypadku skonfigurowania pakietu w osobnym pliku należy podać ścieżkę UNC do pliku konfiguracji (z .dtsConfig) w polu Ścieżka konfiguracji . Konfigurację możesz przeglądać i wybierać, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź ścieżkę. Jeśli na przykład przechowujesz konfigurację w Azure Files, jego ścieżka to \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

  4. Zaznacz pole wyboru Poświadczenia dostępu do konfiguracji , aby wybrać, czy chcesz określić poświadczenia dostępu do pliku konfiguracji oddzielnie. Jest to konieczne, gdy wybrany magazyn pakietów znajduje się na podstawie bazy danych SQL Server (MSDB) hostowanej przez Azure SQL Managed Instance lub nie przechowuje również pliku konfiguracji.

    Jeśli wcześniej wprowadzono wartości poświadczeń wykonywania pakietu (w przypadku uwierzytelniania Windows), możesz użyć ich ponownie, wybierając pole wyboru Takie same jak poświadczenia wykonywania pakietu. W przeciwnym razie wprowadź wartości poświadczeń dostępu do konfiguracji w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład przechowujesz konfigurację w Azure Files, domena to , nazwa użytkownika to Azure<storage account name>, a hasło to <storage account key>.

    Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok nich. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Pamiętaj, aby udzielić tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

  5. Jeśli podczas tworzenia pakietu za pomocą narzędzia SSDT użyto poziomu ochrony EncryptAllWithPassword lub EncryptSensitiveWithPassword , wprowadź wartość hasła w polu Hasło szyfrowania . Alternatywnie możesz użyć wpisu tajnego przechowywanego w usłudze Azure Key Vault jako jego wartości (zobacz powyżej).

    Jeśli użyto poziomu ochrony EncryptSensitiveWithUserKey , wprowadź ponownie poufne wartości w plikach konfiguracji lub na kartach Parametry usług SSIS, Menedżerowie połączeń lub Przesłonięcia właściwości (zobacz poniżej).

    Jeśli użyto poziomu ochrony EncryptAllWithUserKey , nie jest on obsługiwany. Należy ponownie skonfigurować pakiet, aby użyć innego poziomu ochrony za pośrednictwem narzędzia SSDT lub dtutil wiersza polecenia.

  6. W obszarze Poziom rejestrowania wybierz wstępnie zdefiniowany zakres rejestrowania na potrzeby wykonywania pakietu. Zaznacz pole wyboru Dostosowane , jeśli zamiast tego chcesz wprowadzić niestandardową nazwę rejestrowania.

  7. Jeśli chcesz rejestrować wykonania pakietów poza użyciem standardowych dostawców dziennika, które można określić w pakiecie, określ folder dziennika, podając jego ścieżkę UNC w polu Ścieżka rejestrowania . Folder dziennika można przeglądać i wybierać, wybierając pozycję Przeglądaj magazyn plików lub ręcznie wprowadź jego ścieżkę. Jeśli na przykład dzienniki są przechowywane w Azure Files, ścieżka rejestrowania to \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. Podfolder jest tworzony w tej ścieżce dla każdego przebiegu pojedynczego pakietu, nazwany na podstawie identyfikatora uruchomienia działania Wykonaj pakiet SSIS i w którym pliki dziennika są generowane co pięć minut.

  8. Określ poświadczenia, aby uzyskać dostęp do folderu dziennika, wprowadzając wartości w polach Domena, Nazwa użytkownika i Hasło . Jeśli na przykład dzienniki są przechowywane w Azure Files, domena to Azure, nazwa użytkownika to <storage account name>, a hasło to <storage account key>. Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości (zobacz powyżej).

Dla wszystkich wcześniej wymienionych ścieżek UNC w pełni kwalifikowana nazwa pliku musi być mniejsza niż 260 znaków. Nazwa katalogu musi być mniejsza niż 248 znaków.

Karta Parametry usług SSIS

Na karcie Parametry usług SSIS działania Wykonaj pakiet usług SSIS wykonaj następujące kroki.

Set properties on the SSIS Parameters tab

  1. Jeśli Azure-SSIS IR jest uruchomiona, baza danych SSISDB jest wybrana jako lokalizacja pakietu, a pole wyboru Ręczne wpisy na karcie Ustawienia zostanie wyczyszczone, istniejące parametry usług SSIS w wybranym projekcie i pakiecie z bazy danych SSISDB zostaną wyświetlone, aby przypisać do nich wartości. W przeciwnym razie możesz wprowadzić je pojedynczo, aby przypisać do nich wartości ręcznie. Upewnij się, że istnieją i zostały poprawnie wprowadzone w celu pomyślnego wykonania pakietu.

  2. Jeśli podczas tworzenia pakietu użyto poziomu ochrony EncryptSensitiveWithUserKey za pośrednictwem narzędzi SSDT i systemu plików (pakietu),systemu plików (Project),pakietu osadzonego lub magazynu pakietów wybrano jako lokalizację pakietu, musisz również ponownie wprowadzić poufne parametry, aby przypisać im wartości na tej karcie.

Po przypisaniu wartości do parametrów można dodać zawartość dynamiczną przy użyciu wyrażeń, funkcji, zmiennych systemowych usługi Data Factory oraz parametrów lub zmiennych potoku usługi Data Factory.

Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok nich. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję dla swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Upewnij się, że udzielono tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

Karta Menedżerowie połączeń

Na karcie Menedżerowie połączeń działania Wykonaj pakiet usług SSIS wykonaj następujące kroki.

Set properties on the Connection Managers tab

  1. Jeśli Azure-SSIS IR jest uruchomiona, baza danych SSISDB jest wybrana jako lokalizacja pakietu, a pole wyboru Ręczne wpisy na karcie Ustawienia zostanie wyczyszczone, istniejące menedżery połączeń w wybranym projekcie i pakiecie z bazy danych SSISDB zostaną wyświetlone, aby przypisać wartości do ich właściwości. W przeciwnym razie możesz wprowadzić je pojedynczo, aby ręcznie przypisać wartości do ich właściwości. Upewnij się, że istnieją i zostały poprawnie wprowadzone w celu pomyślnego wykonania pakietu.

    Aby uzyskać poprawne nazwy ZAKRES, NAZWA i WŁAŚCIWOŚĆ dla dowolnego menedżera połączeń, można otworzyć pakiet zawierający go w programie SSDT. Po otwarciu pakietu wybierz odpowiedniego menedżera połączeń, aby wyświetlić nazwy i wartości wszystkich jego właściwości w oknie Właściwości narzędzia SSDT. Dzięki tym infom można zastąpić wartości dowolnych właściwości menedżera połączeń w czasie wykonywania.

    Get connection manager properties from SSDT

    Na przykład bez modyfikowania oryginalnego pakietu w programie SSDT można przekonwertować swoje przepływy danych lokalnych na lokalne uruchomione w SQL Server do przepływów danych lokalnych do chmury uruchomionych w środowisku SSIS IR w usłudze ADF, przesłaniając wartości właściwości ConnectByProxy, ConnectionString i ConnectUsingManagedIdentity w istniejących menedżerach połączeń w czasie wykonywania.

    Te przesłonięcia w czasie wykonywania mogą włączyć środowisko Self-Hosted IR (SHIR) jako serwer proxy dla środowiska SSIS IR podczas uzyskiwania dostępu do danych lokalnie, zobacz Konfigurowanie środowiska SHIR jako serwera proxy dla środowiska SSIS IR i Azure SQL Database/połączeń wystąpienia zarządzanego przy użyciu najnowszego sterownika MSOLEDBSQL, który z kolei włącza uwierzytelnianie Azure Active Directory (AAD) przy użyciu tożsamości zarządzanej usługi ADF, zobacz Konfigurowanie połączeń z usługą ADF AAD uwierzytelnianie za pomocą tożsamości zarządzanej usługi ADF dla połączeń OLEDB.

    Set properties from SSDT on the Connection Managers tab

  2. Jeśli podczas tworzenia pakietu użyto poziomu ochrony EncryptSensitiveWithUserKey za pośrednictwem narzędzi SSDT i systemu plików (pakietu),systemu plików (Project), pakietu osadzonego lub magazynu pakietów wybrano jako lokalizację pakietu, musisz również ponownie wprowadzić poufne właściwości menedżera połączeń, aby przypisać do nich wartości na tej karcie.

Po przypisaniu wartości do właściwości menedżera połączeń można dodać zawartość dynamiczną przy użyciu wyrażeń, funkcji, zmiennych systemowych usługi Data Factory oraz parametrów lub zmiennych potoku usługi Data Factory.

Alternatywnie możesz użyć wpisów tajnych przechowywanych w usłudze Azure Key Vault jako ich wartości. W tym celu zaznacz pole wyboru AZURE KEY VAULT obok nich. Wybierz lub edytuj istniejącą połączoną usługę magazynu kluczy lub utwórz nową. Następnie wybierz nazwę wpisu tajnego i wersję dla swojej wartości. Podczas tworzenia lub edytowania połączonej usługi magazynu kluczy możesz wybrać lub edytować istniejący magazyn kluczy lub utworzyć nowy. Upewnij się, że udzielono tożsamości zarządzanej usługi Data Factory dostępu do magazynu kluczy, jeśli jeszcze tego nie zrobiono. Wpis tajny można również wprowadzić bezpośrednio w następującym formacie: <key vault linked service name>/<secret name>/<secret version>.

Karta Przesłonięcia właściwości

Na karcie Przesłonięcia właściwości działania Wykonaj pakiet SSIS wykonaj następujące kroki.

Set properties on the Property Overrides tab

  1. Wprowadź ścieżki istniejących właściwości w wybranym pakiecie jeden po drugim, aby przypisać do nich wartości ręcznie. Upewnij się, że istnieją i zostały poprawnie wprowadzone w celu pomyślnego wykonania pakietu. Aby na przykład zastąpić wartość zmiennej użytkownika, wprowadź jej ścieżkę w następującym formacie: \Package.Variables[User::<variable name>].Value.

    Poprawną ścieżkę WŁAŚCIWOŚCI dla dowolnej właściwości pakietu można uzyskać, otwierając pakiet zawierający go w programie SSDT. Po otwarciu pakietu wybierz jego przepływ sterowania i właściwości Konfiguracje w oknie Właściwości narzędzia SSDT. Następnie wybierz przycisk wielokropka (...) obok właściwości Konfiguracje , aby otworzyć organizatora konfiguracji pakietów , który jest zwykle używany do tworzenia konfiguracji pakietów w modelu wdrażania pakietów.

    Get package properties from SSDT - Configurations property

    Na organizatora konfiguracji pakietów zaznacz pole wyboru Włącz konfiguracje pakietów i przycisk Dodaj... , aby otworzyć Kreatora konfiguracji pakietu.

    W Kreatorze konfiguracji pakietu wybierz element pliku konfiguracji XML w menu rozwijanym Typ konfiguracji i przycisk Określ ustawienia konfiguracji bezpośrednio , wprowadź nazwę pliku konfiguracji i wybierz przycisk Dalej > .

    Get package properties from SSDT - Configurations organizer

    Na koniec wybierz właściwości pakietu, których ścieżka ma być wybrana, i przycisk Dalej > . Teraz możesz zobaczyć, skopiować & żądane ścieżki właściwości pakietu i zapisać je w pliku konfiguracji. Dzięki tym infom można zastąpić wartości dowolnych właściwości pakietu w czasie wykonywania.

    Get package properties from SSDT - Configuration wizard

  2. W przypadku użycia poziomu ochrony EncryptSensitiveWithUserKey podczas tworzenia pakietu za pośrednictwem narzędzi SSDT i systemu plików (pakietu), systemu plików (Project),pakietu osadzonego lub magazynu pakietów wybrano jako lokalizację pakietu, należy również ponownie wprowadzić poufne właściwości pakietu, aby przypisać do nich wartości na tej karcie.

Po przypisaniu wartości do właściwości pakietu można dodać zawartość dynamiczną przy użyciu wyrażeń, funkcji, zmiennych systemowych usługi Data Factory oraz parametrów lub zmiennych potoku usługi Data Factory.

Wartości przypisane w plikach konfiguracji i na karcie Parametry usług SSIS można zastąpić za pomocą kart Menedżerowie połączeń lub Przesłonięcia właściwości . Wartości przypisane na karcie Menedżerowie połączeń można również zastąpić za pomocą karty Przesłonięcia właściwości .

Aby zweryfikować konfigurację potoku, wybierz pozycję Weryfikuj na pasku narzędzi. Aby zamknąć raport weryfikacji potoku, wybierz pozycję >>.

Aby opublikować potok w usłudze Data Factory, wybierz pozycję Opublikuj wszystko.

Uruchamianie potoku

W tym kroku wyzwolisz uruchomienie potoku.

  1. Aby wyzwolić przebieg potoku, wybierz pozycję Wyzwól na pasku narzędzi, a następnie wybierz pozycję Wyzwól teraz.

    Trigger now

  2. W oknie Uruchomienie potoku wybierz pozycję Zakończ.

Monitorowanie potoku

  1. Przejdź do karty Monitorowanie po lewej stronie. Zobaczysz przebieg potoku i jego stan wraz z innymi informacjami, takimi jak czas uruchomienia . Aby odświeżyć widok, wybierz pozycję Odśwież.

    Pipeline runs

  2. Wybierz link Wyświetl uruchomienia działania w kolumnie Akcje. Zobaczysz tylko jedno uruchomienie działania, ponieważ potok ma tylko jedno działanie. Jest to działanie Execute SSIS Package (Wykonywanie pakietu SSIS).

    Activity runs

  3. Uruchom następujące zapytanie względem bazy danych SSISDB na serwerze SQL, aby sprawdzić, czy pakiet został wykonany.

    select * from catalog.executions
    

    Verify package executions

  4. Identyfikator wykonania bazy danych SSISDB można również uzyskać 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.

    Get the execution ID.

Planowanie potoku za pomocą wyzwalacza

Możesz również utworzyć zaplanowany wyzwalacz dla potoku, aby potok był uruchamiany zgodnie z harmonogramem, na przykład co godzinę lub codziennie. Przykład można znaleźć w temacie Create a data factory - Data Factory UI (Tworzenie fabryki danych — interfejs użytkownika usługi Data Factory).

Następne kroki