Behandeln von Problemen bei der Paketausführung in der SSIS Integration Runtime

2024-05-15

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel werden die häufigsten Fehler behandelt, die beim Ausführen von SQL Server Integration Services-Paketen (SSIS) in der SSIS Integration Runtime auftreten können. Beschrieben werden die möglichen Ursachen und Maßnahmen zur Behebung der Fehler.

Allgemein

Speicherorte von Protokollen zur Problembehandlung

Verwenden Sie das Azure Data Factory-Portal, um die Ausgabe der SSIS-Paketausführungsaktivität zu überprüfen. Die Ausgabe enthält das Ausführungsergebnis, Fehlermeldungen und die Vorgangs-ID. Weitere Informationen finden Sie unter Überwachen der Pipeline.

Verwenden Sie den SSIS-Katalog (SSISDB), um die Detailprotokolle zur Ausführung zu überprüfen. Weitere Informationen finden Sie unter Überwachen von ausgeführten Paketen und anderen Vorgängen.

Häufige Fehler, Ursachen und Lösungen

Fehlermeldung: „Verbindungstimeout überschritten“ oder „Der Dienst bei der Verarbeitung Ihrer Anforderung ist auf einen Fehler gestoßen. Versuchen Sie es erneut. "

Hier sind mögliche Ursachen und empfohlenen Maßnahmen:

Die Datenquelle oder das Ziel ist überlastet. Überprüfen Sie die Auslastung Ihrer Datenquelle oder Ihres Ziels, und prüfen Sie, ob diese über genügend Kapazität verfügen. Wenn Sie beispielsweise Azure SQL-Datenbank verwendet haben, erwägen Sie eine zentrale Hochskalierung, wenn bei der Datenbank wahrscheinlich ein Timeout auftreten wird.
Das Netzwerk zwischen der SSIS Integration Runtime und der Datenquelle oder dem Ziel ist instabil, insbesondere wenn die Verbindung regionsübergreifend oder zwischen lokalen Standorten und Azure besteht. Wenden Sie das Wiederholungsmuster im SSIS-Paket an, indem Sie diese Schritte ausführen:
- Stellen Sie sicher, dass Ihre SSIS-Pakete bei einem Ausfall ohne Nebenwirkungen (z. B. Datenverlust oder -duplizierung) erneut ausgeführt werden können.
- Konfigurieren Sie Wiederholen und Wiederholungsintervall der Aktivität SSIS-Paket ausführen auf der Registerkarte Allgemein.
- Legen Sie im Verbindungs-Manager im SSIS-Paket oder in der SSIS-Aktivität für eine ADO.NET- und OLE DB-Quell- oder Zielkomponente ConnectRetryCount und ConnectRetryInterval fest.

Dieses Problem bedeutet in der Regel, dass Datenquelle oder -ziel von der SSIS Integration Runtime aus nicht erreichbar ist. Die Gründe können variieren. Probieren Sie diese Maßnahmen:

Stellen Sie sicher, dass Sie die Datenquelle oder den Zielnamen/die IP-Adresse ordnungsgemäß übergeben.
Stellen Sie sicher, dass die Firewall ordnungsgemäß eingerichtet ist.
Stellen Sie sicher, dass das virtuelle Netzwerk ordnungsgemäß konfiguriert ist, wenn die Datenquelle oder das Ziel lokal ist:
- Sie können überprüfen, ob das Problem durch die Konfiguration eines virtuellen Netzwerks verursacht wurde, indem Sie eine Azure-VM im selben virtuellen Netzwerk bereitstellen. Überprüfen Sie dann, ob auf die Datenquelle oder das Ziel von der Azure VM aus zugegriffen werden kann.
- Weitere Details zur Verwendung eines virtuellen Netzwerks mit einer SSIS Integration Runtime finden Sie unter Verbinden einer Azure-SSIS Integration Runtime mit einem virtuellen Netzwerk.

Fehlermeldung: „Fehler beim Abrufen der ‚…‘-Verbindung durch die ADO.NET-Quelle“ mit „Ein verwalteter Verbindungs-Manager konnte nicht erstellt werden.“ "

Die mögliche Ursache ist, dass der im Paket verwendete ADO.NET-Anbieter nicht in der SSIS Integration Runtime installiert ist. Sie können den Anbieter über ein benutzerdefiniertes Setup installieren. Ausführlichere Informationen zum benutzerdefinierten Setup finden Sie unter Anpassen des Setups für Azure-SSIS Integration Runtime.

Fehlermeldung: „Die Verbindung ‚…‘ wurde nicht gefunden.“

Ein bekanntes Problem in älteren Versionen von SQL Server Management Studio (SSMS) kann diesen Fehler verursachen. Wenn das Paket eine benutzerdefinierte Komponente enthält (z. B. SSIS Azure Feature Pack oder Partnerkomponenten), die nicht auf dem Computer installiert ist, auf dem SSMS zur Durchführung der Bereitstellung verwendet wird, entfernt SSMS die Komponente und verursacht den Fehler. Aktualisieren Sie SSMS auf die neueste Version, für die das Problem behoben wurde.

Fehlermeldung: „SSIS-Executor-Exitcode: -1073741819. "

Mögliche Ursache und empfohlene Maßnahme:
- Dieser Fehler wird möglicherweise durch die Beschränkung der Excel-Quellen und -Ziele verursacht, wenn mehrere Excel-Quellen oder -Ziele gleichzeitig in mehreren Threads ausgeführt werden. Sie können diese Beschränkung umgehen, indem Sie festlegen, dass die Excel-Komponenten nacheinander ausgeführt werden, oder sie in unterschiedliche Pakete aufteilen und „Task ‚Paket ausführen‘“ anwenden, wobei die Eigenschaft „ExecuteOutOfProcess“ auf „True“ festgelegt ist.

Fehlermeldung: „Es ist nicht genügend Speicherplatz auf dem Datenträger vorhanden.“

Dieser Fehler bedeutet, dass der lokale Datenträger auf dem Knoten mit SSIS Integration Runtime vollständig belegt ist. Prüfen Sie, ob Ihr Paket oder Ihr benutzerdefiniertes Setup viel Datenträgerspeicher belegt:

Wenn der Datenträger von Ihrem Paket belegt wird, wird Speicherplatz nach Abschluss der Paketausführung freigegeben.
Wenn der Datenträger von Ihrem benutzerdefinierten Setup belegt wird, müssen Sie die SSIS Integration Runtime beenden, Ihr Skript ändern und die Integration Runtime erneut starten. Der gesamte Azure-Blobcontainer, den Sie für das benutzerdefinierte Setup angegeben haben, wird auf den Knoten mit der SSIS Integration Runtime kopiert. Überprüfen Sie daher, ob sich unter diesem Container unnötige Inhalte befinden.

Fehlermeldung: „Fehler beim Abrufen der Ressource aus dem Master. Microsoft.SqlServer.IntegrationServices.Scale.ScaleoutContract.Common.MasterResponseFailedException: Code: 300004. Beschreibung: Fehler beim Laden der Datei "***". "

Mögliche Ursache und empfohlene Maßnahme:
- Wenn die SSIS-Aktivität ein Paket aus dem Dateisystem (Paketdatei oder Projektdatei) ausführt und dieser Fehler auftritt, kann mit den Anmeldeinformationen für den Paketzugriff, die Sie in der SSIS-Aktivität angegeben haben, nicht auf die Projekt-, Paket- oder Konfigurationsdatei zugegriffen werden.
  - Wenn Sie eine Azure-Datei verwenden:
    - Der Dateipfad sollte mit \\<Speicherkontoname>.file.core.windows.net\<Dateifreigabepfad> beginnen.
    - Die Domäne muss „Azure“ lauten.
    - Der Benutzername muss der <Name des Speicherkontos> sein.
    - Das Kennwort muss der <Speicherzugriffsschlüssel> sein.
  - Wenn Sie eine lokale Datei verwenden, überprüfen Sie, ob VNet sowie die Anmeldeinformationen und Berechtigungen für den Paketzugriff ordnungsgemäß konfiguriert wurden, damit die Azure-SSIS Integration Runtime auf Ihre lokale Dateifreigabe zugreifen kann.

Fehlermeldung: „Der in der Verbindung angegebene Dateiname '...' war ungültig.“

Mögliche Ursache und empfohlene Maßnahme:
- Es wurde ein ungültiger Dateiname angegeben.
- Stellen Sie sicher, dass Sie im Verbindungs-Manager anstelle der Kurzform einen vollqualifizierten Domänennamen (FQDN) verwenden.

Fehlermeldung: „Datei '...' kann nicht geöffnet werden.“

Dieser Fehler tritt auf, wenn die Paketausführung in der SSIS Integration Runtime keine Datei auf dem lokalen Datenträger finden kann. Probieren Sie diese Maßnahmen:

Verwenden Sie nicht den absoluten Pfad im Paket, das in der SSIS Integration Runtime ausgeführt wird. Verwenden Sie stattdessen das aktuelle Arbeitsverzeichnis (.) oder den temporären Ordner (%TEMP%).
Wenn Sie einige Dateien auf Knoten mit der SSIS Integration Runtime dauerhaft speichern müssen, bereiten Sie die Dateien wie unter Anpassen des Setups beschrieben vor. Alle Dateien im Arbeitsverzeichnis werden nach Abschluss der Ausführung bereinigt.
Verwenden Sie Azure Files, anstatt die Datei auf dem Knoten mit SSIS Integration Runtime zu speichern. Weitere Informationen finden Sie unter Verwenden von Azure-Dateifreigaben.

Fehlermeldung: „Das Größenkontingent der SSISDB-Datenbank wurde erreicht“

Eine mögliche Ursache ist, dass die in Azure SQL-Datenbank oder in der verwalteten SQL-Instanz erstellte SSISDB-Datenbank ihr Kontingent erreicht hat. Probieren Sie diese Maßnahmen:

Erwägen Sie das Vergrößern der DTU Ihrer Datenbank. Ausführliche Informationen finden Sie unter Grenzwerte für SQL-Datenbank für einen logischen Server.
Überprüfen Sie, ob Ihre Paket ggf. zu viele Protokolle generiert. Falls ja, können Sie zum Bereinigen dieser Protokolle einen elastischen Auftrag konfigurieren. Weitere Informationen finden Sie unter Bereinigen von SSISDB-Protokollen mit Aufträgen für die elastische Azure-Datenbank.

Fehlermeldung: „Die Anforderungsgrenze für die Datenbank beträgt … und wurde erreicht. "

Wenn in der SSIS Integration Runtime viele Pakete parallel ausgeführt werden, kann dieser Fehler auftreten, weil SSISDB die Anforderungsgrenze erreicht hat. Erwägen Sie, den DTU-Wert der SSISDB zu erhöhen, um dieses Problem zu beheben. Ausführliche Informationen finden Sie unter Grenzwerte für SQL-Datenbank für einen logischen Server.

Fehlermeldung: „SSIS-Vorgang mit unerwartetem Vorgangsstatus fehlgeschlagen: ...“

Der Fehler wird hauptsächlich durch ein vorübergehendes Problem verursacht. Wiederholen Sie die Paketausführung. Wenden Sie das Wiederholungsmuster im SSIS-Paket an, indem Sie diese Schritte ausführen:

Stellen Sie sicher, dass Ihre SSIS-Pakete bei einem Ausfall ohne Nebenwirkungen (z. B. Datenverlust oder -duplizierung) erneut ausgeführt werden können.
Konfigurieren Sie Wiederholen und Wiederholungsintervall der Aktivität SSIS-Paket ausführen auf der Registerkarte Allgemein.
Legen Sie im Verbindungs-Manager im SSIS-Paket oder in der SSIS-Aktivität für eine ADO.NET- und OLE DB-Quell- oder Zielkomponente ConnectRetryCount und ConnectRetryInterval fest.

Fehlermeldung: „Es ist kein aktiver Worker vorhanden. "

Dieser Fehler bedeutet in der Regel, dass die SSIS Integration Runtime einen fehlerhaften Status hat. Überprüfen Sie das Azure-Portal auf den Status und detaillierte Fehler. Weitere Informationen finden Sie unter Azure-SSIS Integration Runtime .

Fehlermeldung: „Ihre Integration Runtime kann nicht aktualisiert werden und wird irgendwann nicht mehr funktionieren, da wir nicht auf den Azure-Blobcontainer zugreifen können, den Sie für das benutzerdefinierte Setup bereitgestellt haben. "

Dieser Fehler tritt auf, wenn die SSIS Integration Runtime nicht auf den für das benutzerdefinierte Setup konfigurierten Speicher zugreifen kann. Überprüfen Sie, ob der von Ihnen angegebene URI für die Shared Access Signature (SAS) gültig und noch nicht abgelaufen ist.

Fehlermeldung: „Microsoft OLE DB-Anbieter für Analysis Services. 'Hresult: 0 x 80004005 Beschreibung:' COM-Fehler: COM-Fehler: mscorlib; Ein Aufrufziel hat einen Ausnahmefehler verursacht“

Eine mögliche Ursache ist, dass der Benutzername oder das Kennwort mit aktivierter Microsoft Entra-Multi-Faktor-Authentifizierung für Azure Analysis Services konfiguriert ist. Diese Authentifizierung wird in der SSIS Integration Runtime nicht unterstützt. Versuchen Sie, ein Dienstprinzipal für die Authentifizierung bei Azure Analysis Services zu verwenden:

Bereiten Sie ein Dienstprinzipal vor, wie in Automatisierung mit Dienstprinzipalen beschrieben.
Konfigurieren Sie im Connection Manager Bestimmten Benutzernamen und bestimmtes Kennwort verwenden: Legen Sie fest App:<AppID>@<TenantID> als Benutzername und clientSecret als Passwort. Hier sehen Sie ein Beispiel für einen ordnungsgemäß formatierten Benutzernamen:

app:12345678-9012-3456-789a-bcdef012345678@9abcdef0-1234-5678-9abc-def0123456789abc
Konfigurieren Sie im Connection Manager die Option SQL-Server-Authentifizierung verwenden. Legen Sie AppIDals Benutzernamen und clientSecret als Kennwort fest.

Stellen Sie sicher, dass Sie die Authentifizierungsmethode von Connection Manager nicht als Active Directory-Kennwortauthentifizierung konfigurieren, wenn der Parameter ConnectUsingManagedIdentity auf True festgelegt ist. Sie können stattdessen die Konfiguration SQL-Authentifizierung verwenden, die ignoriert wird, wenn ConnectUsingManagedIdentity festgelegt ist.

Fehlermeldung: „0xC020801F an ..., OData Source [...]: Eine verwaltete Verbindung kann aus dem Laufzeitverbindungs-Manager nicht abgerufen werden“

Eine mögliche Ursache ist, dass TLS (Transport Layer Security) in SSIS Integration Runtime nicht aktiviert und für Ihre OData-Quelle erforderlich ist. Sie können TLS in SSIS Integration Runtime durch Anpassen des Setups aktivieren. Weitere Informationen finden Sie unter Sie können keine Verbindung mit Project Online OData von SSIS herstellen und Anpassen des Setups für Azure-SSIS Integration Runtime.

Fehlermeldung: „Fehler beim Anfordern der Stagingaufgabe mit Vorgangs-GUID ... aufgrund des Fehlers: Fehler beim Verteilen des Stagingvorgangs mit der folgenden Fehlermeldung: Microsoft.SqlServer.IntegrationServices.AisAgentCore.AisAgentException: Fehler beim Laden des Datenproxys. "

Stellen Sie sicher, dass Ihre Azure-SSIS Integration Runtime mit selbstgehosteter Integration Runtime konfiguriert ist. Weitere Details finden Sie unter Konfigurieren einer selbstgehosteten IR als Proxy für Azure-SSIS IR in ADF.

Fehlermeldung: „Status der Stagingaufgabe: Fehler. Fehler bei Stagingaufgabe: ErrorCode: 2010, ErrorMessage: Die selbstgehostete Integration Runtime ... ist offline“

Stellen Sie sicher, dass Ihre selbstgehostete Integration Runtime installiert ist und gestartet wurde. Weitere Informationen finden Sie unter Erstellen und Konfigurieren einer selbstgehosteten Integration Runtime.

Fehlermeldung: „Fehler bei Stagingaufgabe: ErrorCode: 2906, ErrorMessage: Fehler bei der Paketausführung. Ausgabe: {"OperationErrorMessages": „Fehler: Der angeforderte OLE DB-Anbieter ... ist nicht registriert. Wenn der 64-Bit-Treiber nicht installiert ist, führen Sie das Paket im 32-Bit-Modus aus...“

Stellen Sie sicher, dass der entsprechende Anbieter, der von Ihren OLE DB-Connectors in Ihrem Paket verwendet wird, auf dem Computer mit der selbstgehosteten Integration Runtime ordnungsgemäß installiert ist. Weitere Details finden Sie unter Konfigurieren einer selbstgehosteten IR als Proxy für Azure-SSIS IR in ADF.

Fehlermeldung: „Fehler bei Stagingaufgabe: ErrorCode: 2906, ErrorMessage: Fehler bei der Paketausführung. Ausgabe: {"OperationErrorMessages": "Error: System.IO.FileLoadException: Fehler beim Laden der Datei oder Assembly 'Microsoft.WindowsAzure.Storage, Version=..., Culture=neutral, PublicKeyToken=31bf3856ad364e35' bzw. einer ihrer Abhängigkeiten. Die Manifestdefinition der gefundenen Assembly stimmt nicht mit dem Assemblyverweis ‚...‘ überein.“

Eine mögliche Ursache ist, dass Ihre selbstgehosteter Integration Runtime nicht ordnungsgemäß installiert oder aktualisiert wurde. Laden Sie die neueste selbstgehostete Integration Runtime herunter, und installieren Sie sie erneut. Weitere Informationen finden Sie unter Erstellen und Konfigurieren einer selbstgehosteten Integration Runtime.

Fehlermeldung: „Fehler bei der Stagingaufgabe. TaskStatus: Fehler, ErrorCode: 2906, ErrorMessage: Fehler bei der Paketausführung. Wählen Sie zur Anzeige weiterer Details die Ausgabe der Aktivitätsausführung in derselben Zeile aus. Ausgabe: {"OperationErrorMessages": "4/14/2021 7:10:35 AM +00:00 : = Fehler beim Starten des Named Pipe-Proxys...“

Überprüfen Sie, ob die Sicherheitsrichtlinien dem Konto, auf dem der selbstgehostete IR-Dienst ausgeführt wird, ordnungsgemäß zugewiesen sind. Wenn für die Aktivität „SSIS-Paket ausführen“ die Windows-Authentifizierung verwendet wird oder die Anmeldeinformationen für die Ausführung im SSIS-Katalog (SSISDB) festgelegt sind, müssen dem verwendeten Windows-Konto dieselben Sicherheitsrichtlinien zugewiesen werden. Weitere Details finden Sie unter Konfigurieren einer selbstgehosteten IR als Proxy für Azure-SSIS IR in ADF.

Mögliche Ursache und empfohlene Maßnahme:
- Wenn im Ausführungsprotokoll auch die Warnmeldung „Die Komponente unterstützt die Verwendung des Verbindungs-Managers nicht, wenn ConnectByProxy auf TRUE festgelegt ist“ enthalten ist, bedeutet dies, dass ein Verbindungs-Manager für eine Komponente verwendet wird, die „ConnectByProxy“ noch nicht unterstützt. Die unterstützten Komponenten finden Sie unter Konfigurieren einer selbstgehosteten IR als Proxy für Azure-SSIS IR in ADF.
- Das Ausführungsprotokoll befindet sich im SSMS-Bericht oder in dem Protokollordner, den Sie in der SSIS-Paketausführungsaktivität angegeben haben.
- Alternativ kann ein VNet für den Zugriff auf lokale Daten verwendet werden. Weitere Informationen finden Sie unter Verknüpfen einer Azure-SSIS Integration Runtime mit einem virtuellen Netzwerk.

Fehlermeldung: „Status der Stagingaufgabe: Fehler. „Fehler bei Stagingaufgabe: ErrorCode: 2906, ErrorMessage: Fehler bei der Paketausführung. Ausgabe: {"OperationErrorMessages": "SSIS Executor exit code: -1.\n", "LogLocation": "...\SSISTelemetry\ExecutionLog\...", "effectiveIntegrationRuntime": "...", "executionDuration": ..., "durationInQueue": { "integrationRuntimeQueue": ... }} "

Stellen Sie sicher, dass die Visual C++-Runtime auf dem selbstgehosteten Integration Runtime-Computer installiert ist. Weitere Details finden Sie unter Konfigurieren einer selbstgehosteten IR als Proxy für Azure-SSIS IR in ADF.

Fehlermeldung: „Timeout beim Lesen aus dem Staging-Blob“

Dieser Fehler tritt auf, wenn SSIS-IR mit SHIR als Datenproxy keine Daten aus dem Staging-Blob erfolgreich lesen kann. Dies ist in der Regel darauf zurückzuführen, dass SHIR keine lokalen Daten an den Staging-Blob übertragen hat. Dann tritt beim Versuch der SSIS-IR, Stagingdaten zu lesen, ein Timeoutfehler auf. Sie müssen die SHIR-Protokolle im Ordner „C:\ProgramData\SSISTelemetry (Laufzeitprotokolle) und „C:\ProgramData\SSISTelemetry\ExecutionLog“ (Ausführungsprotokolle) überprüfen, um genauer zu untersuchen, warum Daten nicht erfolgreich von SHIR in den Staging-Blob hochgeladen wurden.

Unerwartetes Auslösen der Ausführung mehrerer Pakete

Mögliche Ursache und empfohlene Maßnahme:
- Eine Aktivität in einer gespeicherten ADF-Prozedur oder eine Nachschlageaktivität wird verwendet, um die Ausführung von SSIS-Paketen auszulösen. Der t-sql-Befehl kann auf ein vorübergehendes Problem stoßen und die Wiederholung auslösen, was zu einer Ausführung mehrerer Pakete führen kann.
- Verwenden Sie stattdessen die Aktivität ExecuteSSISPackage, mit der sichergestellt wird, dass die Paketausführung nicht erneut erfolgt, es sei denn, der Benutzer hat in der Aktivität die Anzahl der Wiederholungen festgelegt. Ausführlichere Informationen finden Sie unter Ausführen eines SSIS-Pakets mit der Aktivität „SSIS-Paket ausführen“.
- Optimieren Sie Ihren t-sql-Befehl, um ihn erneut ausführen zu können, indem Sie prüfen, ob eine Ausführung bereits ausgelöst wurde.

Paketausführung dauert zu lange