Ausführen eines SSIS-Pakets mit der Aktivität „SSIS-Paket ausführen“ im Azure-Portal

GILT FÜR: Azure Data Factory Azure Synapse Analytics

In diesem Artikel wird das Ausführen eines SSIS-Pakets (SQL Server Integration Services) in einer Azure Data Factory-Pipeline mithilfe der Aktivität „SSIS-Paket ausführen“ im Azure Data Factory- und Synapse Pipelines-Portal beschrieben.

Voraussetzungen

Erstellen Sie eine Azure-SSIS Integration Runtime-Instanz (IR), falls Sie noch keine besitzen. Befolgen Sie dazu die ausführliche Anleitung unter Tutorial: Bereitstellen der Azure-SSIS Integration Runtime in Azure Data Factory.

Erstellen einer Pipeline mit einer Aktivität „SSIS-Paket ausführen“

In diesem Schritt erstellen Sie über die Data Factory-Benutzeroberfläche oder -App eine Pipeline. Sie fügen eine Aktivität „SSIS-Paket ausführen“ zur Pipeline hinzu und konfigurieren sie für die Ausführung des SSIS-Pakets.

1. Suchen Sie in der Aktivitäten-Toolbox nach SSIS. Ziehen Sie dann die Aktivität SSIS-Paket ausführen auf die Oberfläche des Pipeline-Designers.

   

   Wählen Sie das Aktivitätsobjekt „SSIS-Paket ausführen“ zum Konfigurieren der Registerkarten Allgemein, Einstellungen, SSIS-Parameter, Verbindungs-Manager und Eigenschaftenüberschreibungen aus.

Registerkarte "Allgemein"

Führen Sie auf der Registerkarte Allgemein der Aktivität „SSIS-Paket ausführen“ die folgenden Schritte aus.

1. Geben Sie unter Name den Namen Ihrer Aktivität „SSIS-Paket ausführen“ ein.

2. Geben Sie unter Beschreibung die Beschreibung Ihrer Aktivität „SSIS-Paket ausführen“ ein.

3. Geben Sie unter Zeitlimit den maximalen Zeitraum ein, in dem Ihre Aktivität „SSIS-Paket ausführen“ ausgeführt werden kann. Der Standardwert ist „7 Tage“; das Format lautet „T.HH:MM:SS“.

4. Geben Sie unter Wiederholung die maximale Anzahl von Wiederholungsversuchen für Ihre Aktivität „SSIS-Paket ausführen“ ein.

5. Geben Sie unter Wiederholungsintervall die Anzahl von Sekunden zwischen den einzelnen Wiederholungsversuchen für Ihre Aktivität „SSIS-Paket ausführen“ ein. Der Standardwert ist „30 Sekunden“.

6. Aktivieren Sie das Kontrollkästchen Sichere Ausgabe, um auszuwählen, dass Sie die Ausgabe Ihrer Aktivität „SSIS-Paket ausführen“ von der Protokollierung ausschließen möchten.

7. Aktivieren Sie das Kontrollkästchen Sichere Eingabe, um auszuwählen, dass Sie die Eingabe Ihrer Aktivität „SSIS-Paket ausführen“ von der Protokollierung ausschließen möchten.

Registerkarte "Einstellungen"

Führen Sie auf der Registerkarte Einstellungen der Aktivität „SSIS-Paket ausführen“ die folgenden Schritte aus.

1. Wählen Sie unter Azure-SSIS IR die festgelegte Azure-SSIS Integration Runtime-Instanz zur Ausführung Ihrer Aktivität „SSIS-Paket ausführen“ aus.

2. Geben Sie unter Beschreibung die Beschreibung Ihrer Aktivität „SSIS-Paket ausführen“ ein.

3. Aktivieren Sie das Kontrollkästchen Windows-Authentifizierung, um auszuwählen, dass Sie die Windows-Authentifizierung für den Zugriff auf Datenspeicher, z B. SQL-Server/lokale Dateifreigaben oder Azure Files, verwenden möchten.

   Wenn Sie dieses Kontrollkästchen aktivieren, geben Sie die Werte Ihrer Anmeldeinformationen für Paketausführung in den Feldern Domäne, Benutzername und Kennwort ein. Für den Zugriff beispielsweise auf Azure Files lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort <storage account key>.

   Alternativ können Sie in Ihrem Azure-Schlüsseltresor (Azure Key Vault) gespeicherte Geheimnisse als Werte verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben den Werten. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

4. Aktivieren Sie das Kontrollkästchen 32-Bit-Runtime, um auszuwählen, dass Ihr Paket die 32-Bit-Runtime zur Ausführung benötigt.

5. Wählen Sie unter Paketspeicherort eine der Optionen SSISDB, Dateisystem (Paket) , Dateisystem (Projekt) , Eingebettetes Paket oder Paketspeicher aus.

Paketspeicherort: SSISDB

SSIS als Ihr Paketspeicherort ist automatisch ausgewählt, wenn Ihre Azure-SSIS Integration Runtime-Instanz mit einem SSIS-Katalog (SSISDB) bereitgestellt wurde, der von Azure SQL-Datenbank-Server/Verwalteter Instanz gehostet wird, oder Sie können diese Option selbst auswählen. Wenn sie ausgewählt ist, führen Sie die folgenden Schritte aus.

1. Wenn Ihre Azure-SSIS Integration Runtime-Instanz ausgeführt wird und das Kontrollkästchen Manuelle Einträge deaktiviert ist, können Sie Ihre vorhandenen Ordner, Projekte, Pakete und Umgebungen aus SSISDB durchsuchen und auswählen. Wählen Sie Aktualisieren aus, um Ihre neu hinzugefügten Ordner, Projekte, Pakete oder Umgebungen aus SSISDB abzurufen, sodass sie zum Durchsuchen und Auswählen verfügbar sind. Wenn Sie die Umgebungen für Ihre Paketausführungen durchsuchen und auswählen möchten, müssen Sie Ihre Projekte zuvor so konfigurieren, dass diese Umgebungen als Verweise aus denselben Ordnern unter SSISDB hinzugefügt werden. Weitere Informationen finden Sie unter Erstellen und Zuordnen einer Serverumgebung.

2. Wählen Sie für Protokolliergrad einen vordefinierten Bereich für die Protokollierung Ihrer Paketausführung. Aktivieren Sie das Kontrollkästchen Angepasst, wenn Sie stattdessen einen angepassten Namen für die Protokollierung eingeben möchten.

3. Wenn Ihre Azure-SSIS Integration Runtime-Instanz nicht ausgeführt wird oder das Kontrollkästchen Manuelle Einträge aktiviert ist, geben Sie Ihre Paket- und Umgebungspfade aus SSISDB direkt in den folgenden Formaten ein: <folder name>/<project name>/<package name>.dtsx und <folder name>/<environment name>.

   

Paketspeicherort: Dateisystem (Paket)

Dateisystem (Paket) als Ihr Speicherort ist automatisch ausgewählt, wenn Ihre Azure-SSIS Integration Runtime-Instanz ohne SSISDB bereitgestellt wurde, oder Sie können diese Option selbst auswählen. Wenn sie ausgewählt ist, führen Sie die folgenden Schritte aus.

1. Geben Sie das auszuführende Paket an, indem Sie im Feld Paketpfad einen UNC-Pfad (Universal Naming Convention) zu Ihrer Paketdatei (mit .dtsx) eingeben. Sie können Ihr Paket durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihr Paket also beispielsweise in Azure Files speichern, lautet der Pfad \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

2. Wenn Sie Ihr Paket in einer separaten Datei konfigurieren, müssen Sie außerdem im Feld Konfigurationspfad einen UNC-Pfad zu Ihrer Konfigurationsdatei (mit .dtsConfig) angeben. Sie können Ihre Konfiguration durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihre Konfiguration also beispielsweise in Azure Files speichern, lautet der Pfad \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

3. Geben Sie die Anmeldeinformationen für den Zugriff auf Ihre Paket- und Konfigurationsdateien an. Wenn Sie die Werte Ihrer Anmeldeinformationen für Paketausführung (für die Windows-Authentifizierung) zuvor eingegeben haben, können Sie diese Werte wiederverwenden, indem Sie das Kontrollkästchen Wie Anmeldeinformationen für Paketausführung aktivieren. Geben Sie andernfalls die Werte Ihrer Anmeldeinformationen für den Paketzugriff in die Felder Domäne, Benutzername und Kennwort ein. Wenn Sie Ihr Projekt und Ihre Konfiguration also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>.

   Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben den Werten. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

   Diese Anmeldeinformationen werden auch für den Zugriff auf Ihre untergeordneten Pakete im Task „Paket ausführen“ verwendet, auf die durch deren eigenen Pfad und andere in Ihren Paketen angegebene Konfigurationen verwiesen wird.

4. Wenn Sie bei der Paketerstellung über SQL Server Data Tools (SSDT) die Schutzebene EncryptAllWithPassword oder EncryptSensitiveWithPassword verwendet haben, müssen Sie unter Verschlüsselungskennwort den Wert für Ihr Kennwort eingeben. Alternativ können Sie ein in Ihrem Azure-Schlüsseltresor gespeichertes Geheimnis als Wert verwenden (siehe oben).

   Wenn Sie die Schutzebene EncryptSensitiveWithUserKey verwendet haben, geben Sie Ihre vertraulichen Werte in Konfigurationsdateien oder aber auf den Registerkarten SSIS-Parameter, Verbindungs-Manager oder Eigenschaftenüberschreibungen erneut ein (siehe unten).

   Die Verwendung der Schutzebene EncryptAllWithUserKey wird nicht unterstützt. Sie müssen Ihr Paket über SSDT oder das Befehlszeilen-Hilfsprogramm dtutil für die Verwendung einer anderen Schutzebene neu konfigurieren.

5. Wählen Sie für Protokolliergrad einen vordefinierten Bereich für die Protokollierung Ihrer Paketausführung. Aktivieren Sie das Kontrollkästchen Angepasst, wenn Sie stattdessen einen angepassten Namen für die Protokollierung eingeben möchten.

6. Wenn Sie für Ihre Paketausführungen eine Protokollierung verwenden möchten, die über die Standardprotokollanbieter hinausgeht, die in Ihrem Paket angegeben werden können, geben Sie im Feld Protokollierungspfad den UNC-Pfad Ihres Protokollordners an. Sie können Ihren Protokollordner durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lautet Ihr Protokollierungspfad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. In diesem Pfad wird für jedes ausgeführte Einzelpaket ein Unterordner erstellt und mit der Aktivitätsausführungs-ID von „SSIS-Paket ausführen“ benannt. In diesem Unterordner werden alle fünf Minuten Protokolldateien generiert.

7. Geben Sie die Anmeldeinformationen für den Zugriff auf Ihren Protokollordner an. Wenn Sie die Werte Ihrer Anmeldeinformationen für den Paketzugriff (siehe oben) zuvor eingegeben haben, können Sie diese Werte wiederverwenden, indem Sie das Kontrollkästchen Wie Anmeldeinformationen für Paketzugriff aktivieren. Geben Sie andernfalls die Werte Ihrer Anmeldeinformationen für den Protokollierungszugriff in die Felder Domäne, Benutzername und Kennwort ein. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>. Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden (siehe oben).

Für alle zuvor erwähnten UNC-Pfade muss der vollqualifizierte Dateiname weniger als 260 Zeichen umfassen. Der Verzeichnisname muss weniger als 248 Zeichen umfassen.

Paketspeicherort: Dateisystem (Projekt)

Wenn Sie Dateisystem (Projekt) als Ihren Paketspeicherort auswählen, führen Sie die folgenden Schritte aus.

1. Geben Sie das auszuführende Paket an, indem Sie im Feld Paketpfad einen UNC-Pfad zu Ihrer Projektdatei (mit .ispac) und im Feld Paketname eine Paketdatei (mit .dtsx) aus Ihrem Projekt eingeben. Sie können Ihr Projekt durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihr Projekt also beispielsweise in Azure Files speichern, lautet der Pfad \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

2. Geben Sie die Anmeldeinformationen für den Zugriff auf Ihre Projekt- und Paketdateien an. Wenn Sie die Werte Ihrer Anmeldeinformationen für Paketausführung (für die Windows-Authentifizierung) zuvor eingegeben haben, können Sie diese Werte wiederverwenden, indem Sie das Kontrollkästchen Wie Anmeldeinformationen für Paketausführung aktivieren. Geben Sie andernfalls die Werte Ihrer Anmeldeinformationen für den Paketzugriff in die Felder Domäne, Benutzername und Kennwort ein. Wenn Sie Ihr Projekt und Ihr Paket also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>.

   Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben den Werten. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

   Diese Anmeldeinformationen werden auch für den Zugriff auf Ihre untergeordneten Pakete im Task „Paket ausführen“ verwendet, auf die aus demselben Projekt verwiesen wird.

3. Wenn Sie bei der Paketerstellung über SSDT die Schutzebene EncryptAllWithPassword oder EncryptSensitiveWithPassword verwendet haben, müssen Sie im Feld Verschlüsselungskennwort den Wert für Ihr Kennwort eingeben. Alternativ können Sie ein in Ihrem Azure-Schlüsseltresor gespeichertes Geheimnis als Wert verwenden (siehe oben).

   Wenn Sie die Schutzebene EncryptSensitiveWithUserKey verwendet haben, geben Sie Ihre vertraulichen Werte auf den Registerkarten SSIS-Parameter, Verbindungs-Manager oder Eigenschaftenüberschreibungen erneut ein (siehe unten).

   Die Verwendung der Schutzebene EncryptAllWithUserKey wird nicht unterstützt. Sie müssen Ihr Paket über SSDT oder das Befehlszeilen-Hilfsprogramm dtutil für die Verwendung einer anderen Schutzebene neu konfigurieren.

4. Wählen Sie für Protokolliergrad einen vordefinierten Bereich für die Protokollierung Ihrer Paketausführung. Aktivieren Sie das Kontrollkästchen Angepasst, wenn Sie stattdessen einen angepassten Namen für die Protokollierung eingeben möchten.

5. Wenn Sie für Ihre Paketausführungen eine Protokollierung verwenden möchten, die über die Standardprotokollanbieter hinausgeht, die in Ihrem Paket angegeben werden können, geben Sie im Feld Protokollierungspfad den UNC-Pfad Ihres Protokollordners an. Sie können Ihren Protokollordner durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lautet Ihr Protokollierungspfad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. In diesem Pfad wird für jedes ausgeführte Einzelpaket ein Unterordner erstellt und mit der Aktivitätsausführungs-ID von „SSIS-Paket ausführen“ benannt. In diesem Unterordner werden alle fünf Minuten Protokolldateien generiert.

6. Geben Sie die Anmeldeinformationen für den Zugriff auf Ihren Protokollordner an. Wenn Sie die Werte Ihrer Anmeldeinformationen für den Paketzugriff (siehe oben) zuvor eingegeben haben, können Sie diese Werte wiederverwenden, indem Sie das Kontrollkästchen Wie Anmeldeinformationen für Paketzugriff aktivieren. Geben Sie andernfalls die Werte Ihrer Anmeldeinformationen für den Protokollierungszugriff in die Felder Domäne, Benutzername und Kennwort ein. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>. Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden (siehe oben).

Für alle zuvor erwähnten UNC-Pfade muss der vollqualifizierte Dateiname weniger als 260 Zeichen umfassen. Der Verzeichnisname muss weniger als 248 Zeichen umfassen.

Paketspeicherort: Eingebettetes Paket

Wenn Sie Eingebettetes Paket als Ihren Paketspeicherort auswählen, führen Sie die folgenden Schritte aus.

1. Verschieben Sie Ihre Paketdatei (.dtsx) per Drag & Drop in das bereitgestellte Feld, oder laden Sie sie aus einem Dateiordner hoch. Ihr Paket wird automatisch komprimiert und in die Nutzlast für die Aktivität eingebettet. Nachdem das Paket eingebettet wurde, können Sie es zum späteren Bearbeiten herunterladen. Sie können Ihr eingebettetes Paket auch Parametrisieren, indem Sie es einem Pipelineparameter zuweisen, der in mehreren Aktivitäten verwendet werden kann. Auf diese Weise wird die Größe Ihrer Pipelinenutzlast optimiert. Das Einbetten von Projektdateien (.ispac) wird derzeit nicht unterstützt. Daher können in Ihren eingebetteten Paketen keine SSIS-Parameter/Verbindungs-Manager auf der Projektebene verwendet werden.

2. Wenn Ihr eingebettetes Paket nicht vollständig verschlüsselt wurde und darin die Verwendung des Tasks „Paket ausführen“ (Execute Package Task, EPT) erkannt wird, wird das Kontrollkästchen Task „Paket ausführen“ automatisch aktiviert, und Ihre untergeordneten Pakete, auf die anhand ihres Dateisystempfads verwiesen wird, werden automatisch hinzugefügt, damit Sie sie ebenfalls einbetten können.

   Wenn die Verwendung von EPT nicht erkannt werden kann, müssen Sie das Kontrollkästchen Task „Paket ausführen“ manuell aktivieren und Ihre untergeordneten Pakete, auf die anhand ihres Dateisystempfads verwiesen wird, einzeln hinzufügen, um sie ebenfalls einbetten zu können. Wenn Ihre untergeordneten Pakete in SQL Server-Datenbank (MSDB) gespeichert sind, können sie nicht eingebettet werden. Achten Sie daher darauf, dass Ihre Azure-SSIS IR auf MSDB zugreifen kann, um sie unter Verwendung ihrer SQL Server-Verweise abzurufen. Das Einbetten von Projektdateien (.ispac) wird derzeit nicht unterstützt. Daher können für Ihre untergeordneten Pakete keine projektbasierten Verweise verwendet werden.

3. Wenn Sie bei der Paketerstellung über SSDT die Schutzebene EncryptAllWithPassword oder EncryptSensitiveWithPassword verwendet haben, müssen Sie im Feld Verschlüsselungskennwort den Wert für Ihr Kennwort eingeben.

   Alternativ können Sie ein in Ihrem Azure Key Vault gespeichertes Geheimnis als Wert verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben dem Wert. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

   Wenn Sie die Schutzebene EncryptSensitiveWithUserKey verwendet haben, geben Sie Ihre vertraulichen Werte in Konfigurationsdateien oder aber auf den Registerkarten SSIS-Parameter, Verbindungs-Manager oder Eigenschaftenüberschreibungen erneut ein (siehe unten).

   Die Verwendung der Schutzebene EncryptAllWithUserKey wird nicht unterstützt. Sie müssen Ihr Paket über SSDT oder das Befehlszeilen-Hilfsprogramm dtutil für die Verwendung einer anderen Schutzebene neu konfigurieren.

4. Wählen Sie für Protokolliergrad einen vordefinierten Bereich für die Protokollierung Ihrer Paketausführung. Aktivieren Sie das Kontrollkästchen Angepasst, wenn Sie stattdessen einen angepassten Namen für die Protokollierung eingeben möchten.

5. Wenn Sie für Ihre Paketausführungen eine Protokollierung verwenden möchten, die über die Standardprotokollanbieter hinausgeht, die in Ihrem Paket angegeben werden können, geben Sie im Feld Protokollierungspfad den UNC-Pfad Ihres Protokollordners an. Sie können Ihren Protokollordner durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lautet Ihr Protokollierungspfad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. In diesem Pfad wird für jedes ausgeführte Einzelpaket ein Unterordner erstellt und mit der Aktivitätsausführungs-ID von „SSIS-Paket ausführen“ benannt. In diesem Unterordner werden alle fünf Minuten Protokolldateien generiert.

6. Geben Sie die Anmeldeinformationen für den Zugriff auf Ihren Protokollordner an, indem Sie deren Werte in den Feldern Domäne, Benutzername und Kennwort eingeben. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>. Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden (siehe oben).

Für alle zuvor erwähnten UNC-Pfade muss der vollqualifizierte Dateiname weniger als 260 Zeichen umfassen. Der Verzeichnisname muss weniger als 248 Zeichen umfassen.

Paketspeicherort: Paketspeicher

Wenn Sie Paketspeicher als Ihren Paketspeicherort auswählen, führen Sie die folgenden Schritte aus.

1. Wählen Sie unter Name des Paketspeichers einen vorhandenen Paketspeicher aus, der an Ihre Azure-SSIS Integration Runtime-Instanz angefügt ist.

2. Geben Sie Ihr auszuführendes Paket an, indem Sie im Feld Paketpfad dessen Pfad (ohne .dtsx) aus dem ausgewählten Paketspeicher eingeben. Wenn der ausgewählte Paketspeicher auf Dateisystem/Azure Files basiert, können Sie Ihr Paket durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen. Andernfalls können Sie den Speicherpfad im Format <folder name>\<package name> eingeben. Sie können neue Pakete auch über SQL Server Management Studio (SSMS) in den ausgewählten Paketspeicher importieren, ähnlich wie beim Legacy-SSIS-Paketspeicher. Weitere Informationen finden Sie unter Verwalten von SSIS-Paketen mit Azure-SSIS IR-Paketspeichern.

3. Wenn Sie Ihr Paket in einer separaten Datei konfigurieren, müssen Sie im Feld Konfigurationspfad einen UNC-Pfad zu Ihrer Konfigurationsdatei (mit .dtsConfig) angeben. Sie können Ihre Konfiguration durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihre Konfiguration also beispielsweise in Azure Files speichern, lautet der Pfad \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

4. Aktivieren Sie das Kontrollkästchen Anmeldeinformationen für den Konfigurationszugriff, um auszuwählen, dass Sie die Anmeldeinformationen für den Zugriff auf Ihre Konfigurationsdatei separat eingeben möchten. Dies ist erforderlich, wenn der ausgewählte Paketspeicher auf SQL Server Datenbank (MSDB) basiert, die von Ihrer verwalteten Azure SQL-Instanz gehostet wird, oder wenn er außerdem Ihre Konfigurationsdatei nicht speichert.

   Wenn Sie die Werte Ihrer Anmeldeinformationen für Paketausführung (für die Windows-Authentifizierung) zuvor eingegeben haben, können Sie diese Werte wiederverwenden, indem Sie das Kontrollkästchen Wie Anmeldeinformationen für Paketausführung aktivieren. Geben Sie andernfalls die Werte Ihrer Anmeldeinformationen für den Konfigurationszugriff in den Feldern Domäne, Benutzername und Kennwort ein. Wenn Sie Ihre Konfiguration also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>.

   Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben den Werten. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

5. Wenn Sie bei der Paketerstellung über SSDT die Schutzebene EncryptAllWithPassword oder EncryptSensitiveWithPassword verwendet haben, müssen Sie im Feld Verschlüsselungskennwort den Wert für Ihr Kennwort eingeben. Alternativ können Sie ein in Ihrem Azure-Schlüsseltresor gespeichertes Geheimnis als Wert verwenden (siehe oben).

   Wenn Sie die Schutzebene EncryptSensitiveWithUserKey verwendet haben, geben Sie Ihre vertraulichen Werte in Konfigurationsdateien oder aber auf den Registerkarten SSIS-Parameter, Verbindungs-Manager oder Eigenschaftenüberschreibungen erneut ein (siehe unten).

   Die Verwendung der Schutzebene EncryptAllWithUserKey wird nicht unterstützt. Sie müssen Ihr Paket über SSDT oder das Befehlszeilen-Hilfsprogramm dtutil für die Verwendung einer anderen Schutzebene neu konfigurieren.

6. Wählen Sie für Protokolliergrad einen vordefinierten Bereich für die Protokollierung Ihrer Paketausführung. Aktivieren Sie das Kontrollkästchen Angepasst, wenn Sie stattdessen einen angepassten Namen für die Protokollierung eingeben möchten.

7. Wenn Sie für Ihre Paketausführungen eine Protokollierung verwenden möchten, die über die Standardprotokollanbieter hinausgeht, die in Ihrem Paket angegeben werden können, geben Sie im Feld Protokollierungspfad den UNC-Pfad Ihres Protokollordners an. Sie können Ihren Protokollordner durchsuchen und auswählen, indem Sie Dateispeicher durchsuchen auswählen oder den Pfad manuell eingeben. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lautet Ihr Protokollierungspfad \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. In diesem Pfad wird für jedes ausgeführte Einzelpaket ein Unterordner erstellt und mit der Aktivitätsausführungs-ID von „SSIS-Paket ausführen“ benannt. In diesem Unterordner werden alle fünf Minuten Protokolldateien generiert.

8. Geben Sie die Anmeldeinformationen für den Zugriff auf Ihren Protokollordner an, indem Sie deren Werte in den Feldern Domäne, Benutzername und Kennwort eingeben. Wenn Sie Ihre Protokolle also beispielsweise in Azure Files speichern, lauten die Werte wie folgt: Domäne: Azure; Benutzername: <storage account name>; Kennwort: <storage account key>. Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden (siehe oben).

Für alle zuvor erwähnten UNC-Pfade muss der vollqualifizierte Dateiname weniger als 260 Zeichen umfassen. Der Verzeichnisname muss weniger als 248 Zeichen umfassen.

Registerkarte „SSIS-Parameter“

Führen Sie auf der Registerkarte SSIS-Parameter der Aktivität „SSIS-Paket ausführen“ die folgenden Schritte aus.

1. Wenn Ihre Azure-SSIS Integration Runtime-Instanz ausgeführt wird, die Option SSISDB als Ihr Paketspeicherort ausgewählt ist und auf der Registerkarte Einstellungen das Kontrollkästchen Manuelle Einträge deaktiviert ist, werden die vorhandenen SSIS-Parameter in Ihrem ausgewählten Projekt oder Paket aus SSISDB angezeigt, damit Sie ihnen Werte zuweisen können. Andernfalls können Sie sie einzeln eingeben, um ihnen manuell Werte zuzuweisen. Vergewissern Sie sich, dass sie vorhanden sind und korrekt eingegeben wurden, damit Ihre Paketausführung erfolgreich ist.

2. Wenn Sie bei der Paketerstellung über SSDT die Schutzebene EncryptSensitiveWithUserKey verwendet haben und Dateisystem (Paket) , Dateisystem (Projekt) , Eingebettetes Paket oder Paketspeicher als Ihr Paketspeicherort ausgewählt ist, müssen Sie Ihre vertraulichen Parameter erneut eingeben, um ihnen auf dieser Registerkarte Werte zuzuweisen.

Beim Zuweisen von Werten für Ihre Parameter können Sie Ausdrücke, Funktionen, Data Factory-Systemvariablen und Data Factory-Pipelineparameter oder -Variablen verwenden, um dynamische Inhalte hinzuzufügen.

Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben den Werten. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

Registerkarte „Verbindungs-Manager“

Führen Sie auf der Registerkarte Verbindungs-Manager der Aktivität „SSIS-Paket ausführen“ die folgenden Schritte aus.

1. Wenn Ihre Azure-SSIS Integration Runtime-Instanz ausgeführt wird, die Option SSISDB als Ihr Paketspeicherort ausgewählt ist und auf der Registerkarte Einstellungen das Kontrollkästchen Manuelle Einträge deaktiviert ist, werden Ihnen die vorhandenen Verbindungs-Manager in Ihrem ausgewählten Projekt und Paket aus SSISDB angezeigt, damit Sie deren Eigenschaften Werte zuweisen können. Andernfalls können Sie sie einzeln eingeben, um ihren Eigenschaften manuell Werte zuzuweisen. Vergewissern Sie sich, dass sie vorhanden sind und korrekt eingegeben wurden, damit Ihre Paketausführung erfolgreich ist.

   Sie können die korrekten Werte für SCOPE, NAME und PROPERTY für einen beliebigen Verbindungs-Manager abrufen, indem Sie das enthaltende Paket in SSDT öffnen. Wählen Sie nach dem Öffnen des Pakets den relevanten Verbindungs-Manager aus, um die Namen und Werte für alle zugehörigen Eigenschaften im Fenster Eigenschaften von SSDT anzuzeigen. Mit diesen Informationen können Sie die Werte aller Verbindungs-Manager-Eigenschaften zur Laufzeit überschreiben.

   

   So können Sie beispielsweise die lokalen Datenflüsse Ihres Originalpakets, die in SQL Server ausgeführt werden, in Datenflüsse von der lokalen Umgebung zur Cloud konvertieren, die in SSIS IR in ADF ausgeführt werden, ohne Ihr Originalpaket in SSDT ändern zu müssen. Überschreiben Sie hierzu zur Laufzeit die Werte der Eigenschaften ConnectByProxy, ConnectionString und ConnectUsingManagedIdentity in vorhandenen Verbindungs-Managern.

   Diese Überschreibungen zur Laufzeit können die Verwendung von selbstgehosteter IR (Self-Hosted IR, SHIR) als Proxy für SSIS IR ermöglichen, wenn auf lokale Daten zugegriffen wird (siehe Konfigurieren von SHIR als Proxy für SSIS IR), sowie Verbindungen mit Azure SQL-Datenbank/verwalteten Instanzen unter Verwendung des aktuellen MSOLEDBSQL-Treibers ermöglichen, der wiederum die Microsoft Entra-Authentifizierung mit verwalteter ADF-Identität ermöglicht (siehe Konfigurieren der Microsoft Entra-Authentifizierung mit verwalteten ADF-Identitäten für OLEDB-Verbindungen).

   

2. Wenn Sie bei der Paketerstellung über SSDT die Schutzebene EncryptSensitiveWithUserKey verwendet haben und Dateisystem (Paket) , Dateisystem (Projekt) , Eingebettetes Paket oder Paketspeicher als Ihr Paketspeicherort ausgewählt ist, müssen Sie auch Ihre vertraulichen Verbindungs-Manager-Eigenschaften erneut eingeben, um ihnen auf dieser Registerkarte Werte zuzuweisen.

Beim Zuweisen von Werten für Ihre Verbindungs-Manager-Eigenschaften können Sie Ausdrücke, Funktionen, Data Factory-Systemvariablen und Data Factory-Pipelineparameter oder -Variablen verwenden, um dynamische Inhalte hinzuzufügen.

Alternativ können Sie in Ihrem Azure-Schlüsseltresor gespeicherte Geheimnisse als Werte verwenden. Aktivieren Sie dazu das Kontrollkästchen AZURE KEY VAULT neben den Werten. Sie können einen vorhandenen verknüpften Dienst für den Schlüsseltresor auswählen oder bearbeiten oder einen neuen Dienst erstellen. Wählen Sie dann den Namen und die Version des Geheimnisses als Ihren Wert aus. Wenn Sie Ihren verknüpften Dienst für den Schlüsseltresor erstellen oder bearbeiten, können Sie den vorhandenen Schlüsseltresor auswählen und bearbeiten oder einen neuen erstellen. Stellen Sie sicher, dass die verwaltete Data Factory-Identität Zugriff auf Ihren Schlüsseltresor hat, sofern dies noch nicht der Fall ist. Sie können Ihr Geheimnis auch direkt im folgenden Format eingeben: <key vault linked service name>/<secret name>/<secret version>.

Registerkarte „Eigenschaftenüberschreibungen“

Führen Sie auf der Registerkarte Eigenschaftenüberschreibungen der Aktivität „SSIS-Paket ausführen“ die folgenden Schritte aus.

1. Geben Sie nacheinander die Pfade vorhandener Eigenschaften in Ihrem ausgewählten Paket ein, um ihnen Werte manuell zuzuweisen. Vergewissern Sie sich, dass sie vorhanden sind und korrekt eingegeben wurden, damit Ihre Paketausführung erfolgreich ist. Geben Sie also beispielsweise zum Überschreiben des Werts Ihrer Benutzervariablen den zugehörigen Pfad im folgenden Format ein: \Package.Variables[User::<variable name>].Value.

   Sie können den korrekten Wert für PROPERTY PATH für eine beliebige Paketeigenschaft abrufen, indem Sie das enthaltende Paket in SSDT öffnen. Wählen Sie nach dem Öffnen des Pakets die zugehörige Ablaufsteuerung und die Eigenschaft Konfigurationen im Fenster Eigenschaften von SSDT aus. Wählen Sie anschließend neben der Eigenschaft Konfigurationen die Schaltfläche mit den Auslassungspunkten ( ... ) aus, um den Paketkonfigurationsplaner zu öffnen, der normalerweise zum Erstellen von Paketkonfigurationen im Paketbereitstellungsmodell verwendet wird.

   

   Aktivieren Sie im Paketkonfigurationsplaner das Kontrollkästchen Paketkonfigurationen aktivieren, und wählen Sie die Schaltfläche Hinzufügen... aus, um den Paketkonfigurations-Assistenten zu öffnen.

   Wählen Sie im Paketkonfigurations-Assistenten im Dropdownmenü Konfigurationstyp das Element XML-Konfigurationsdatei aus. Wählen Sie anschließend die Schaltfläche Konfigurationseinstellungen direkt angeben aus, geben Sie den Namen Ihrer Konfigurationsdatei ein, und wählen Sie die Schaltfläche Weiter > aus.

   

   Wählen Sie abschließend die Paketeigenschaften aus, deren Pfad Sie benötigen, und wählen Sie die Schaltfläche Weiter > aus. Nun können Sie die gewünschten Paketeigenschaftspfade anzeigen, kopieren, einfügen und in Ihrer Konfigurationsdatei speichern. Mit diesen Informationen können Sie die Werte aller Paketeigenschaften zur Laufzeit überschreiben.

   

2. Wenn Sie bei der Paketerstellung über SSDT die Schutzebene EncryptSensitiveWithUserKey verwendet haben und Dateisystem (Paket) , Dateisystem (Projekt) , Eingebettetes Paket oder Paketspeicher als Ihr Paketspeicherort ausgewählt ist, müssen Sie auch Ihre vertraulichen Paketeigenschaften erneut eingeben, um ihnen auf dieser Registerkarte Werte zuzuweisen.

Beim Zuweisen von Werten zu Ihren Paketeigenschaften können Sie dynamische Inhalte mithilfe von Ausdrücken, Funktionen, Data Factory-Systemvariablen und Data Factory-Pipelineparametern oder -variablen hinzufügen.

Die in den Konfigurationsdateien und auf der Registerkarte SSIS-Parameter zugewiesenen Werte können mithilfe der Registerkarten Verbindungs-Manager oder Eigenschaftenüberschreibungen überschrieben werden. Die auf der Registerkarte Verbindungs-Manager zugewiesenen Werte können ebenfalls auf der Registerkarte Eigenschaftenüberschreibungen überschrieben werden.

Wählen Sie zum Überprüfen der Pipelinekonfiguration auf der Symbolleiste die Option Überprüfen aus. Wählen Sie zum Schließen des Pipelineüberprüfungsberichts die Option >> aus.

Veröffentlichen Sie die Pipeline in Data Factory, indem Sie die Schaltfläche Alle veröffentlichen auswählen.

Führen Sie die Pipeline aus.

In diesem Schritt lösen Sie eine Pipelineausführung aus.

1. Wählen Sie zum Auslösen einer Pipelineausführung auf der Symbolleiste die Option Trigger (Auslösen) und dann Trigger now (Jetzt auslösen) aus.

   

2. Wählen Sie im Fenster Pipelineausführung die Option Fertig stellen aus.

Überwachen der Pipeline

1. Wechseln Sie im linken Bereich zur Registerkarte Überwachen. Die Pipelineausführung, der zugehörige Status sowie weitere Informationen (z. B. Startzeit der Ausführung) werden angezeigt. Klicken Sie zum Aktualisieren der Ansicht auf Aktualisieren.

   

2. Klicken Sie in der Spalte Aktionen auf den Link View Activity Runs (Aktivitätsausführungen anzeigen). Sie sehen nur eine Aktivitätsausführung, da die Pipeline nur eine Aktivität enthält. Dabei handelt es sich um die Aktivität „SSIS-Paket ausführen“.

   

3. Führen Sie auf Ihrem SQL-Server die folgende Abfrage für die SSISDB-Datenbank ausführen, um zu überprüfen, ob das Paket ausgeführt wurde.

   select * from catalog.executions
   

   

4. Sie können auch die SSISDB-Ausführungs-ID aus der Ausgabe der Pipelineaktivitätsausführung abrufen und anhand der ID umfangreichere Ausführungsprotokolle und Fehlermeldungen in SQL Server Management Studio überprüfen.

   

Planen der Pipeline mit einem Trigger

Sie können auch einen geplanten Trigger für die Pipeline erstellen, damit die Pipeline basierend auf einem Zeitplan (etwa stündlich oder täglich) ausgeführt wird. Ein Beispiel finden Sie unter Erstellen einer Data Factory über die Azure Data Factory-Benutzeroberfläche.

Zugehöriger Inhalt

• Ausführen eines SSIS-Pakets mit der Aktivität „SSIS-Paket ausführen“ in Azure Data Factory mit PowerShell
• Modernisieren und Erweitern von ETL/ELT-Workflows mit SSIS-Aktivitäten in Azure Data Factory-Pipelines