Freigeben über


Problembehandlung in Azure Data Factory- und Synapse-Pipelines

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 gängige Methoden zur Problembehandlung für externe Steuerungsaktivitäten in Azure Data Factory- und Synapse-Pipelines beschrieben.

Connector und Kopieraktivität

Informationen zu Connector-Problemen, wie beispielsweise das Auftreten eines Fehlers bei der Kopieraktivität, finden Sie in dem Artikel Problembehandlung für Connectors.

Azure Databricks

Fehlercode: 3200

  • Meldung: Fehler 403.

  • Ursache: The Databricks access token has expired.

  • Empfehlung: Das Azure Databricks-Zugriffstoken ist standardmäßig 90 Tage lang gültig. Erstellen Sie ein neues Token, und aktualisieren Sie den verknüpften Dienst.

Fehlercode: 3201

  • Meldung: Missing required field: settings.task.notebook_task.notebook_path.

  • Ursache: Bad authoring: Notebook path not specified correctly.

  • Empfehlung: Geben Sie den Notebook-Pfad in der Databricks-Aktivität an.


  • Meldung: Cluster... does not exist.

  • Ursache: Authoring error: Databricks cluster does not exist or has been deleted.

  • Empfehlung: Überprüfen Sie, ob der Databricks-Cluster vorhanden ist.


  • Meldung: Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.

  • Ursache: Bad authoring.

  • Empfehlung: Geben Sie entweder absolute Pfade für die Adressierungsschemas der Arbeitsbereiche oder dbfs:/folder/subfolder/foo.py für im Databricks-Dateisystem (Databricks File System, DFS) gespeicherte Dateien an.


  • Meldung: {0} LinkedService should have domain and accessToken as required properties.

  • Ursache: Bad authoring.

  • Empfehlung: Überprüfen Sie die Definition des verknüpften Diensts.


  • Meldung: {0} LinkedService should specify either existing cluster ID or new cluster information for creation.

  • Ursache: Bad authoring.

  • Empfehlung: Überprüfen Sie die Definition des verknüpften Diensts.


  • Meldung: Node type Standard_D16S_v3 is not supported. Supported node types: Standard_DS3_v2, Standard_DS4_v2, Standard_DS5_v2, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D64s_v3, Standard_D3_v2, Standard_D8_v3, Standard_D16_v3, Standard_D32_v3, Standard_D64_v3, Standard_D12_v2, Standard_D13_v2, Standard_D14_v2, Standard_D15_v2, Standard_DS12_v2, Standard_DS13_v2, Standard_DS14_v2, Standard_DS15_v2, Standard_E8s_v3, Standard_E16s_v3, Standard_E32s_v3, Standard_E64s_v3, Standard_L4s, Standard_L8s, Standard_L16s, Standard_L32s, Standard_F4s, Standard_F8s, Standard_F16s, Standard_H16, Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_NC12, Standard_NC24, Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_L8s_v2, Standard_L16s_v2, Standard_L32s_v2, Standard_L64s_v2, Standard_L80s_v2.

  • Ursache: Bad authoring.

  • Empfehlung: Weitere Informationen erhalten Sie in der Fehlermeldung.


Fehlercode: 3202

  • Meldung: There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.

  • Ursache: Too many Databricks runs in an hour.

  • Empfehlung: Überprüfen Sie alle Pipelines, die diesen Databricks-Arbeitsbereich verwenden, auf ihre Auftragserstellungsrate. Wenn Pipelines insgesamt zu viele Databricks-Ausführungen gestartet haben, migrieren Sie einige Pipelines zu einem neuen Arbeitsbereich.


  • Meldung: Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.

  • Ursache: Authoring error: No value provided for the parameter.

  • Empfehlung: Überprüfen Sie den JSON-Code der Pipeline, und vergewissern Sie sich, dass für alle Parameter im Notebook „baseParameters“ ein nicht leerer Wert angegeben ist.


  • Meldung: User: 'SimpleUserContext{userId=..., name=user@company.com, orgId=...}' is not authorized to access cluster.

  • Ursache: Der Benutzer, der das Zugriffstoken generiert hat, ist nicht berechtigt, auf den im verknüpften Dienst angegebenen Databricks-Cluster zuzugreifen.

  • Empfehlung: Stellen Sie sicher, dass der Benutzer über die erforderlichen Berechtigungen im Arbeitsbereich verfügt.


  • Meldung: Job is not fully initialized yet. Please retry later.

  • Ursache: Der Auftrag wurde nicht initialisiert.

  • Empfehlung: Warten Sie, und versuchen Sie es später noch mal.

Fehlercode: 3203

  • Meldung: The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.

  • Ursache: Der Cluster wurde beendet. Bei interaktiven Clustern ist dieses Problem möglicherweise eine Racebedingung.

  • Empfehlung: Wenn Sie dieses Problem vermeiden möchten, verwenden Sie Auftragscluster.

Fehlercode: 3204

  • Meldung: Job execution failed.

  • Ursache: Fehlermeldungen weisen auf verschiedene Probleme hin, z. B. einen unerwarteten Clusterzustand oder eine bestimmte Aktivität. Oft wird keine Fehlermeldung angezeigt.

  • Empfehlung: –

Fehlercode: 3208

  • Meldung: An error occurred while sending the request.

  • Ursache: Die Netzwerkverbindung mit dem Databricks-Dienst wurde unterbrochen.

  • Empfehlung: Wenn Sie eine selbstgehostete Integration Runtime verwenden, stellen Sie sicher, dass die Netzwerkverbindung über die Integration Runtime-Knoten zuverlässig ist. Bei der Verwendung von Azure Integration Runtime funktioniert es in der Regel, den Vorgang zu wiederholen.

Die boolesche Ausführung wird als Zeichenfolge ausgegeben, nicht wie erwartet als ganzzahliger Wert.

  • Symptome: Die boolesche Ausführung wird als Zeichenfolge (z. B. "0" oder "1") anstelle des erwarteten ganzzahligen Werts (z. B. 0 oder 1) angezeigt.

    Screenshot der Databricks-Pipeline.

    Sie haben diese Änderung am 28. September 2021 um ca. 9:00 Uhr IST bemerkt, als in Ihrer Pipeline, die diese Ausgabe benötigt, ein Fehler auftrat. An der Pipeline wurden keine Änderungen vorgenommen, und die booleschen Ausgabedaten sind vor dem Fehler erwartungsgemäß eingegangen.

    Screenshot: Unterschied in der Ausgabe.

  • Ursache: Dieses Problem wird durch eine kürzlich durchgeführte, beabsichtigte Änderung verursacht. Nach dieser Änderung gilt: Wenn ein Ergebnis eine Zahl ist, die mit 0 beginnt, konvertiert Azure Data Factory die Zahl in den oktalen Wert, was ein Fehler ist. Diese Zahl ist immer 0 oder 1, was vor der Änderung nie zu Probleme führte. Um also die Konvertierung in einen Oktalwert zu verhindern, wird die Zeichenfolgenausgabe von der Notebook-Ausführung unverändert übergeben.

  • Empfehlung: Ändern Sie die if-Bedingung in etwas wie if(value=="0").

Azure Data Lake Analytics

Die folgende Tabelle gilt für U-SQL.

Fehlercode: 2709

  • Meldung: The access token is from the wrong tenant.

  • Ursache: Falscher Microsoft Entra-Mandant.

  • Empfehlung: Falscher Microsoft Entra-Mandant.


  • Meldung: We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.

  • Ursache: Dieser Fehler wird durch die Drosselung von Data Lake Analytics verursacht.

  • Empfehlung: Verringern Sie die Anzahl der an Data Lake Analytics übermittelten Aufträge. Ändern Sie entweder die Einstellungen „Auslöser“ und „Parallelitäten“ für Aktivitäten, oder erhöhen Sie die Grenzwerte für Data Lake Analytics.


  • Meldung: This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.

  • Ursache: Dieser Fehler wird durch die Drosselung von Data Lake Analytics verursacht.

  • Empfehlung: Verringern Sie die Anzahl der an Data Lake Analytics übermittelten Aufträge. Ändern Sie entweder die Einstellungen „Auslöser“ und „Parallelitäten“ für Aktivitäten, oder erhöhen Sie die Grenzwerte für Data Lake Analytics.

Fehlercode: 2705

  • Meldung: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • Ursache: Der angegebene Dienstprinzipal oder das angegebene Zertifikat hat keinen Zugriff auf die Datei im Speicher.

  • Empfehlung: Überprüfen Sie, ob der Dienstprinzipal oder das Zertifikat, das der Benutzer für Data Lake Analytics-Aufträge bereitstellt, Zugriff sowohl auf das Data Lake Analytics-Konto als auch die Data Lake Storage-Standardinstanz aus dem Stammordner hat.

Fehlercode: 2711

  • Meldung: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • Ursache: Der angegebene Dienstprinzipal oder das angegebene Zertifikat hat keinen Zugriff auf die Datei im Speicher.

  • Empfehlung: Überprüfen Sie, ob der Dienstprinzipal oder das Zertifikat, das der Benutzer für Data Lake Analytics-Aufträge bereitstellt, Zugriff sowohl auf das Data Lake Analytics-Konto als auch die Data Lake Storage-Standardinstanz aus dem Stammordner hat.


  • Meldung: Cannot find the 'Azure Data Lake Store' file or folder.

  • Ursache: Der Pfad zur U-SQL-Datei ist falsch, oder die Anmeldeinformationen des verknüpften Diensts haben keinen Zugriff.

  • Empfehlung: Überprüfen Sie den Pfad und die im verknüpften Dienst angegebenen Anmeldeinformationen.

Fehlercode: 2704

  • Meldung: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • Ursache: Der angegebene Dienstprinzipal oder das angegebene Zertifikat hat keinen Zugriff auf die Datei im Speicher.

  • Empfehlung: Überprüfen Sie, ob der Dienstprinzipal oder das Zertifikat, das der Benutzer für Data Lake Analytics-Aufträge bereitstellt, Zugriff sowohl auf das Data Lake Analytics-Konto als auch die Data Lake Storage-Standardinstanz aus dem Stammordner hat.

Fehlercode: 2707

  • Meldung: Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.

  • Ursache: Das Data Lake Analytics-Konto im verlinkten Dienst ist falsch.

  • Empfehlung: Stellen Sie sicher, dass das richtige Konto angegeben wurde.

Fehlercode: 2703

  • Meldung: Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").

  • Ursache: Dieser Fehler stammt aus Data Lake Analytics.

  • Empfehlung: Der Auftrag wurde an Data Lake Analytics übermittelt, und das Skript konnte nicht ausgeführt werden. Untersuchen Sie dies in Data Lake Analytics. Wechseln Sie im Portal zum Data Lake Analytics-Konto, und suchen Sie unter Angabe der Aktivitätsausführungs-ID von Data Factory (nicht der Pipelineausführungs-ID) nach dem Auftrag. Unter diesem Auftrag finden Sie weitere Informationen zum Fehler und zur entsprechenden Problembehandlung.

    Wenn die Lösung nicht klar ist, wenden Sie sich an das Data Lake Analytics-Supportteam, und geben Sie die Auftrags-URL (Uniform Resource Locator) mit Ihrem Kontonamen und der Auftrags-ID an.

Azure-Funktionen

Fehlercode: 3602

  • Meldung: Invalid HttpMethod: '%method;'.

  • Ursache: Die in der Aktivitätsnutzlast angegebene HTTP-Methode wird von der Aktivität der Azure-Funktion nicht unterstützt.

  • Empfehlung: Die folgenden Http-Methoden werden unterstützt: PUT, POST, GET, DELETE, OPTIONS, HEAD und TRACE.

Fehlercode: 3603

  • Meldung: Response Content is not a valid JObject.

  • Ursache: Die aufgerufene Azure-Funktion hat keine JSON-Nutzlast in der Antwort zurückgegeben. Die Azure Data Factory und Synapse-Pipeline Azure-Funktionsaktivitäten unterstützen nur JSON-Antwortinhalte.

  • Empfehlung: Aktualisieren Sie die Azure-Funktion, um eine gültige JSON-Nutzlast zurückzugeben, so wie eine C#-Funktion (ActionResult)new OkObjectResult("{\"Id\":\"123\"}"); zurückgeben kann.

Fehlercode: 3606

  • Meldung: Azure function activity missing function key. (In der Aktivität der Azure-Funktion fehlt der Funktionsschlüssel.)

  • Ursache: Die Definition für die Aktivität der Azure-Funktion ist nicht vollständig.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Eingabeaktivität der Azure-Funktion die Eigenschaft functionKey enthält.

Fehlercode: 3607

  • Meldung: Azure function activity missing function name.

  • Ursache: Die Definition für die Aktivität der Azure-Funktion ist nicht vollständig.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Eingabeaktivität der Azure-Funktion die Eigenschaft functionName enthält.

Fehlercode: 3608

  • Meldung: Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.

  • Ursache: Die Details der Azure-Funktion in der Aktivitätsdefinition sind möglicherweise falsch.

  • Empfehlung: Korrigieren Sie die Details der Azure-Funktion, und versuchen Sie es erneut.

Fehlercode: 3609

  • Meldung: Azure function activity missing functionAppUrl.

  • Ursache: Die Definition für die Aktivität der Azure-Funktion ist nicht vollständig.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Eingabeaktivität der Azure-Funktion die Eigenschaft functionAppUrl enthält.

Fehlercode: 3610

  • Meldung: There was an error while calling endpoint.

  • Ursache: Die Funktions-URL ist möglicherweise falsch.

  • Empfehlung: Überprüfen Sie, ob der Wert für functionAppUrl in der JSON-Aktivität richtig ist, und versuchen Sie es erneut.

Fehlercode: 3611

  • Meldung: Azure function activity missing Method in JSON.

  • Ursache: Die Definition für die Aktivität der Azure-Funktion ist nicht vollständig.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Eingabeaktivität der Azure-Funktion die Eigenschaft method enthält.

Fehlercode: 3612

  • Meldung: Azure function activity missing LinkedService definition in JSON.

  • Ursache: Die Definition für die Aktivität der Azure-Funktion ist nicht vollständig.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Eingabeaktivität der Azure-Funktion verknüpfte Dienstdetails enthält.

Azure Machine Learning

Fehlercode: 4101

  • Meldung: AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.

  • Ursache: Ungültiges Format oder fehlende Definition der Eigenschaft %propertyName;.

  • Empfehlung: Überprüfen Sie, ob die Eigenschaft %propertyName; für die Aktivität %activityName; mit den richtigen Daten definiert wurde.

Fehlercode: 4110

  • Meldung: AzureMLExecutePipeline activity missing LinkedService definition in JSON.

  • Ursache: Die Definition für die Aktivität „AzureMLExecutePipeline“ ist unvollständig.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Aktivität „AzureMLExecutePipeline“ korrekt verknüpfte Dienstdetails enthält.

Fehlercode: 4111

  • Meldung: AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.

  • Ursache: Falsche Aktivitätsdefinition.

  • Empfehlung: Überprüfen Sie, ob die JSON-Definition für die Aktivität „AzureMLExecutePipeline“ korrekt verknüpfte Dienstdetails enthält.

Fehlercode: 4112

  • Meldung: AzureMLService linked service has invalid value for property '%propertyName;'.

  • Ursache: Ungültiges Format oder fehlende Definition der Eigenschaft „%propertyName;“

  • Empfehlung: Überprüfen Sie, ob die Eigenschaft %propertyName; für den verknüpften Dienst mit den richtigen Daten definiert wurde.

Fehlercode: 4121

  • Meldung: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Ursache: Die für den Zugriff auf Azure Machine Learning verwendeten Anmeldeinformationen sind abgelaufen.

  • Empfehlung: Überprüfen Sie, ob die Anmeldeinformationen gültig sind, und versuchen Sie es erneut.

Fehlercode: 4122

  • Meldung: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Ursache: Die im verknüpften Dienst für Azure Machine Learning angegebenen Anmeldeinformationen sind ungültig oder haben keine Berechtigung für diesen Vorgang.

  • Empfehlung: Überprüfen Sie, ob die Anmeldeinformationen im verknüpften Dienst gültig und Berechtigungen für den Zugriff auf Azure Machine Learning vorhanden sind.

Fehlercode: 4123

  • Meldung: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Ursache: Die Eigenschaften der Aktivität, z. B. pipelineParameters, sind bei der Azure Machine Learning (ML)-Pipeline ungültig.

  • Empfehlung: Überprüfen Sie, ob der Wert der Aktivitätseigenschaften mit der erwarteten Nutzlast der veröffentlichten Azure Machine Learning-Pipeline übereinstimmt, die im verknüpften Dienst angegeben ist.

Fehlercode: 4124

  • Meldung: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Ursache: Der veröffentlichte Azure Machine Learning-Pipelineendpunkt ist nicht vorhanden.

  • Empfehlung: Überprüfen Sie, ob der veröffentlichte Azure ML-Pipelineendpunkt, der im verknüpften Dienst angegeben wird, in Azure Machine Learning vorhanden ist.

Fehlercode: 4125

  • Meldung: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Ursache: Es gibt einen Serverfehler bei Azure Machine Learning.

  • Empfehlung: Wiederholen Sie den Vorgang zu einem späteren Zeitpunkt. Sollte das Problem weiterhin auftreten, wenden Sie sich an das Azure Machine Learning-Team.

Fehlercode: 4126

  • Meldung: Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Azure Machine Learning for more error logs.

  • Ursache: Bei der Azure Machine Learning-Pipelineausführung ist ein Fehler aufgetreten.

  • Empfehlung: Überprüfen Sie Azure Machine Learning, ob es weitere Fehlerprotokolle gibt. Korrigieren Sie dann die ML-Pipeline.

Azure Synapse Analytics

Fehlercode: 3250

  • Meldung: There are not enough resources available in the workspace, details: '%errorMessage;'

  • Ursache: Unzureichende Ressourcen

  • Empfehlung: Versuchen Sie, den ausgeführten Auftrag im Arbeitsbereich zu beenden, die Anzahl der angeforderten virtuellen Kerne zu verringern, das Arbeitsbereichskontingent zu erhöhen oder einen anderen Arbeitsbereich zu verwenden.

Fehlercode: 3251

  • Meldung: There are not enough resources available in the pool, details: '%errorMessage;'

  • Ursache: Unzureichende Ressourcen

  • Empfehlung: Versuchen Sie, den ausgeführten Auftrag im Pool zu beenden, die Anzahl der angeforderten virtuellen Kerne zu verringern, die maximale Pool-Größe zu erhöhen oder einen anderen Pool zu verwenden.

Fehlercode: 3252

  • Meldung: There are not enough vcores available for your spark job, details: '%errorMessage;'

  • Ursache: Unzureichende virtuelle Kerne

  • Empfehlung: Versuchen Sie, die Anzahl der angeforderten virtuellen Kerne zu reduzieren oder Ihr Kontingent an virtuellen Kernen zu vergrößern. Weitere Informationen finden Sie unter Apache Spark-Kernkonzepte.

Fehlercode: 3253

  • Meldung: There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.

  • Ursache: Drosselungsschwellenwert wurde erreicht.

  • Empfehlung: Wiederholen Sie die Anforderung nach eine Wartezeit.

Fehlercode: 3254

  • Meldung: AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.

  • Ursache: Ungültiges Format oder fehlende Definition der Eigenschaft „%propertyName;“

  • Empfehlung: Überprüfen Sie, ob für den verknüpften Dienst die Eigenschaft “%propertyName“ mit den richtigen Daten definiert wurde.

Allgemein

Fehlercode: 2103

  • Meldung: Please provide value for the required property '%propertyName;'.

  • Ursache: Der erforderliche Wert für die-Eigenschaft wurde nicht angegeben.

  • Empfehlung: Geben Sie den Wert aus der Meldung an, und versuchen Sie es noch mal.

Fehlercode: 2104

  • Meldung: The type of the property '%propertyName;' is incorrect.

  • Ursache: Der angegebene Eigenschaftentyp ist falsch.

  • Empfehlung: Korrigieren Sie den Typ der Eigenschaft, und versuchen Sie es erneut.

Fehlercode: 2105

  • Meldung: An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.

  • Ursache: Der Wert für die Eigenschaft ist ungültig oder hat nicht das erwartete Format.

  • Empfehlung: Lesen Sie die Dokumentation zur Eigenschaft, und überprüfen Sie, ob der angegebene Wert das richtige Format und den richtigen Typ enthält.

Fehlercode: 2106

  • Meldung: The storage connection string is invalid. %errorMessage;

  • Ursache: Die Verbindungszeichenfolge für den Speicher ist ungültig oder hat ein falsches Format.

  • Empfehlung: Wechseln Sie zum Azure-Portal, und suchen Sie Ihren Speicher. Kopieren Sie dann die Verbindungszeichenfolge, und fügen Sie sie in Ihren verknüpften Dienst ein. Wiederholen Sie anschließend den Vorgang.

Fehlercode: 2110

  • Meldung: The linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.

  • Ursache: Der in der Aktivität angegebene verknüpfte Dienst ist falsch.

  • Empfehlung: Überprüfen Sie, ob einer der unterstützten Typen für die Aktivität als Typ für den verknüpften Dienst verwendet wird. So kann beispielsweise der Typ für den verknüpften Dienst für HDI-Aktivitäten „HDInsight“ oder „HDInsightOnDemand“ sein.

Fehlercode: 2111

  • Meldung: The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.

  • Ursache: Der Typ der angegebenen Eigenschaft ist falsch.

  • Empfehlung: Korrigieren Sie den Eigenschaftentyp, und versuchen Sie es erneut.

Fehlercode: 2112

  • Meldung: The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.

  • Ursache: Der Cloudtyp wird nicht unterstützt oder konnte für den Speicher aus dem Wert für „EndpointSuffix“ nicht ermittelt werden.

  • Empfehlung: Verwenden Sie einen Speicher in einer anderen Cloud, und versuchen Sie es erneut.

Benutzerdefiniert

Die folgende Tabelle gilt für Azure Batch.

Fehlercode: 2500

  • Meldung: Hit unexpected exception and execution failed.

  • Ursache: Can't launch command, or the program returned an error code.

  • Empfehlung: Stellen Sie sicher, dass die ausführbare Datei vorhanden ist. Wenn das Programm gestartet wurde, überprüfen Sie, ob die Dateien stdout.txt und stderr.txt in das Speicherkonto hochgeladen wurden. Es empfiehlt sich, in den Code zum Debuggen Protokolle einzubeziehen.

Fehlercode: 2501

  • Meldung: Cannot access user batch account; please check batch account settings.

  • Ursache: Falscher Batch-Zugriffsschlüssel oder Poolname.

  • Empfehlung: Überprüfen Sie den Poolnamen und den Batch-Zugriffsschlüssel im verknüpften Dienst.

Fehlercode: 2502

  • Meldung: Cannot access user storage account; please check storage account settings.

  • Ursache: Falscher Speicherkontoname oder Zugriffsschlüssel.

  • Empfehlung: Überprüfen Sie den Speicherkontonamen und den Zugriffsschlüssel im verknüpften Dienst.

Fehlercode: 2504

  • Meldung: Operation returned an invalid status code 'BadRequest'.

  • Ursache: Zu viele Dateien in folderPath der benutzerdefinierten Aktivität. Die Gesamtgröße von resourceFiles darf maximal 32.768 Zeichen betragen.

  • Empfehlung: Entfernen Sie unnötige Dateien, oder zippen Sie sie. Fügen Sie dann einen „unzip“-Befehl hinzu, um sie zu extrahieren.

    Verwenden Sie beispielsweise powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe.

Fehlercode: 2505

  • Meldung: Cannot create Shared Access Signature unless Account Key credentials are used.

  • Ursache: Benutzerdefinierte Aktivitäten unterstützen nur Speicherkonten, die einen Zugriffsschlüssel verwenden.

  • Empfehlung: Weitere Informationen erhalten Sie in der Fehlerbeschreibung.

Fehlercode: 2507

  • Meldung: The folder path does not exist or is empty: ...

  • Ursache: Unter dem angegebenen Pfad sind im Speicherkonto keine Dateien vorhanden.

  • Empfehlung: „folderPath“ muss die ausführbaren Dateien enthalten, die Sie ausführen möchten.

Fehlercode: 2508

  • Meldung: There are duplicate files in the resource folder.

  • Ursache: Mehrere Dateien mit dem gleichen Namen sind in verschiedenen Unterordnern von folderPath vorhanden.

  • Empfehlung: Benutzerdefinierte Aktivitäten vereinfachen die Ordnerstruktur unter „folderPath“. Wenn Sie die Ordnerstruktur beibehalten möchten, zippen Sie die Dateien, und extrahieren Sie sie in Azure Batch mit einem Befehl zum Entzippen.

    Verwenden Sie beispielsweise powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe.

Fehlercode: 2509

  • Meldung: Batch url ... is invalid; it must be in Uri format.

  • Ursache: Batch-URLs müssen https://mybatchaccount.eastus.batch.azure.com ähneln.

  • Empfehlung: Weitere Informationen erhalten Sie in der Fehlerbeschreibung.

Fehlercode: 2510

  • Meldung: An error occurred while sending the request.

  • Ursache: Die Batch-URL ist ungültig.

  • Empfehlung: Überprüfen Sie die Batch-URL.

HDInsight

Fehlercode: 206

  • Meldung: The batch ID for Spark job is invalid. Please retry your job.

  • Ursache: Ein internes Problem mit dem Dienst hat diesen Fehler verursacht.

  • Empfehlung: Dies könnte ein vorübergehendes Problem sein. Wiederholen Sie den Auftrag nach einiger Zeit.

Fehlercode: 207

  • Meldung: Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.

  • Ursache: Beim Ermitteln der Region aus dem primären Speicherkonto ist ein interner Fehler aufgetreten.

  • Empfehlung: Versuchen Sie es mit einem anderen Speicher.

Fehlercode: 208

  • Meldung: Service Principal or the MSI authenticator are not instantiated. Please consider providing a Service Principal in the HDI on demand linked service which has permissions to create an HDInsight cluster in the provided subscription and try again.

  • Ursache: Beim Lesen des Dienstprinzipals bzw. beim Instanziieren der MSI-Authentifizierung ist ein interner Fehler aufgetreten.

  • Empfehlung: Erwägen Sie die Angabe eines Dienstprinzipals, der Berechtigungen zum Erstellen eines HDInsight-Clusters im angegebenen Abonnement hat, und versuchen Sie es erneut. Überprüfen Sie, ob die verwalteten Identitäten ordnungsgemäß eingerichtet wurden.

Fehlercode: 2300

  • Meldung: Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.

  • Ursache: Die Fehlermeldung enthält einen ähnlichen Text wie The remote name could not be resolved.. Der angegebene Cluster-URI ist möglicherweise ungültig.

  • Empfehlung: Vergewissern Sie sich, dass der Cluster nicht gelöscht wurde und der angegebene URI richtig ist. Wenn Sie den URI in einem Browser öffnen, sollte die Ambari-Benutzeroberfläche angezeigt werden. Wenn sich der Cluster in einem virtuellen Netzwerk befindet, sollte der URI der private URI sein. Um es zu öffnen, verwenden Sie einen virtuellen Computer (VM), der zu diesem virtuellen Netzwerk gehört.

    Weitere Informationen finden Sie unter Herstellen einer direkten Verbindung mit Apache Hadoop-Diensten.


  • Ursache: Wenn die Fehlermeldung einen ähnlichen Text wie A task was canceled. enthält, war die Auftragserteilung zeitlich begrenzt.

  • Empfehlung: Das Problem kann entweder ein allgemeines HDInsight-Verbindungsproblem oder ein Netzwerkverbindungsproblem sein. Vergewissern Sie sich zunächst, ob die HDInsight Ambari-Benutzeroberfläche in jedem Browser verfügbar ist. Überprüfen Sie anschließend, ob Ihre Anmeldeinformationen noch gültig sind.

    Wenn Sie eine selbstgehostete Integration Runtime (IR) verwenden, führen Sie diesen Schritt auf der VM oder dem Computer aus, auf der bzw. dem die selbstgehostete IR installiert wurde. Versuche Sie dann, den Auftrag erneut zu übermitteln.

    Weitere Informationen finden Sie unter Ambari-Webbenutzeroberfläche.


  • Ursache: Wenn die Fehlermeldung einen ähnlichen Text wie User admin is locked out in Ambari oder Unauthorized: Ambari user name or password is incorrect enthält, sind die Anmeldeinformationen für HDInsight falsch oder abgelaufen.

  • Empfehlung: Korrigieren Sie die Anmeldeinformation, und stellen Sie den verknüpften Dienst erneut bereit. Überprüfen Sie zunächst, ob die Anmeldeinformationen in HDInsight funktionieren. Öffnen Sie dazu den Cluster-URI in einem beliebigen Browser, und versuchen Sie, sich anzumelden. Wenn die Anmeldeinformationen nicht funktionieren, können Sie sie im Azure-Portal zurücksetzen.

    Setzen Sie das Kennwort beim ESP-Cluster über die Self-Service-Kennwortzurücksetzung zurück.


  • Ursache: Wenn die Fehlermeldung einen ähnlichen Text wie 502 - Web server received an invalid response while acting as a gateway or proxy server enthält, wird dieser Fehler vom HDInsight-Dienst zurückgegeben.

  • Empfehlung: Ein Fehler 502 tritt oft auf, wenn Ihr Ambari-Server-Prozess heruntergefahren wurde. Sie können die Ambari-Dienste neu starten, indem Sie den Hauptknoten neu starten.

    1. Stellen Sie mithilfe von SSH eine Verbindung mit einem Ihrer Knoten auf HDInsight her.

    2. Identifizieren Sie den Host Ihres aktiven Hauptknotens durch Ausführung von ping headnodehost.

    3. Stellen Sie eine Verbindung mit Ihrem aktiven Hauptknoten per SSH her, da der Ambari-Server sich auf dem Hauptknoten befindet.

    4. Starten Sie den aktiven Hauptknoten neu.

      Weitere Informationen finden Sie in der Dokumentation zur Problembehandlung bei Azure HDInsight. Beispiel:


  • Ursache: Wenn die Fehlermeldung einen ähnlichen Text wie Unable to service the submit job request as templeton service is busy with too many submit job requests oder Queue root.joblauncher already has 500 applications, cannot accept submission of application enthält, werden zu viele Aufträge gleichzeitig an HDInsight übermittelt.

  • Empfehlung: Begrenzen Sie die Anzahl der gleichzeitigen Aufträge, die an HDInsight übermittelt werden. Wenn die Aufträge über die gleiche Aktivität übermittelt werden, helfen Ihnen die entsprechenden Informationen in der Aktivität für Parallelitäten weiter. Ändern Sie die Trigger so, dass die gleichzeitigen Pipelineausführungen über die Zeit verteilt werden.

    Weitere Informationen zum wie im Fehler angegebenen Anpassen von templeton.parallellism.job.submit finden Sie in der HDInsight-Dokumentation.

Fehlercode: 2301

  • Meldung: Could not get the status of the application '%physicalJobId;' from the HDInsight service. Received the following error: %message;. Please refer to HDInsight troubleshooting documentation or contact their support for further assistance.

  • Ursache: Beim HDInsight-Cluster oder -Dienst treten Probleme auf.

  • Empfehlung: Dieser Fehler tritt auf, wenn der Dienst beim Versuch, den Status des ausgeführten Auftrags anzufordern, keine Antwort vom HDInsight-Cluster erhält. Dieses Problem könnte im Cluster selbst vorliegen, oder der HDInsight-Dienst ist möglicherweise ausgefallen.

    Informationen finden Sie in der Dokumentation zur HDInsight-Problembehandlung, oder wenden Sie sich an den Microsoft Support, um weitere Unterstützung zu erhalten.

Fehlercode: 2302

  • Meldung: Hadoop job failed with exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Contact HDInsight team for further support.

  • Ursache: Der Auftrag wurde an den HDI-Cluster übermittelt, und dort ist ein Fehler aufgetreten.

  • Empfehlung:

  1. Überprüfen Sie die Ambari-Benutzeroberfläche mit folgenden Schritten:
    1. Vergewissern Sie sich, dass alle Dienste weiterhin ausgeführt werden.
    2. Überprüfen Sie auf der Ambari-Benutzeroberfläche den Abschnitt „Warnung“ in Ihrem Dashboard.
      1. Weitere Informationen zu Warnungen und den entsprechenden Lösungen finden Sie unter Verwalten und Überwachen eines Clusters.
    3. Überprüfen Sie Ihren YARN-Arbeitsspeicher. Wenn eine hohe Auslastung des YARN-Arbeitsspeichers vorliegt, wird die Verarbeitung Ihrer Aufträge möglicherweise verzögert. Führen Sie für den Cluster das Hochskalieren durch, um sicherzustellen, dass er über genügend Arbeitsspeicher und Kerne verfügt, falls nicht ausreichend Ressourcen für Ihre Spark-Anwendung bzw. die Aufträge vorhanden sind.
  2. Führen Sie einen Beispieltestauftrag aus.
    1. Wenn Sie denselben Auftrag im HDInsight-Backend ausführen, überprüfen Sie, ob er erfolgreich war. Beispiele für Beispielausführungen finden Sie unter Ausführen von MapReduce-Beispielen in HDInsight.
  3. Wenn der Auftrag in HDInsight weiterhin fehlgeschlagen ist, überprüfen Sie die Anwendungsprotokolle und Informationen, die dem Support bereitgestellt werden müssen:
    1. Überprüfen Sie, ob der Auftrag an YARN übermittelt wurde. Wurde er nicht an YARN übermittelt, verwenden Sie --master yarn.
    2. Wenn die Anwendung die Ausführung beendet hat, erfassen Sie die Start- und Endzeit der YARN-Anwendung. Hat sie die Ausführung nicht beendet, erfassen Sie „Startzeit/Startzeit“.
    3. Überprüfen und erfassen Sie das Anwendungsprotokoll mit yarn logs -applicationId <Insert_Your_Application_ID>.
    4. Überprüfen und erfassen Sie die Yarn Resource Manager-Protokolle im Verzeichnis /var/log/hadoop-yarn/yarn.
    5. Wenn diese Schritte zur Lösung des Problems nicht ausreichen, wenden Sie sich an das Azure HDInsight-Team, um Unterstützung zu erhalten. Geben Sie dabei die vorstehenden Protokolle und Zeitstempel an.

Fehlercode: 2303

  • Meldung: Hadoop job failed with transient exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Try again or contact HDInsight team for further support.

  • Ursache: Der Auftrag wurde an den HDI-Cluster übermittelt, und dort ist ein Fehler aufgetreten.

  • Empfehlung:

  1. Überprüfen Sie die Ambari-Benutzeroberfläche mit folgenden Schritten:
    1. Vergewissern Sie sich, dass alle Dienste weiterhin ausgeführt werden.
    2. Überprüfen Sie auf der Ambari-Benutzeroberfläche den Abschnitt „Warnung“ in Ihrem Dashboard.
      1. Weitere Informationen zu Warnungen und den entsprechenden Lösungen finden Sie unter Verwalten und Überwachen eines Clusters.
    3. Überprüfen Sie Ihren YARN-Arbeitsspeicher. Wenn eine hohe Auslastung des YARN-Arbeitsspeichers vorliegt, wird die Verarbeitung Ihrer Aufträge möglicherweise verzögert. Führen Sie für den Cluster das Hochskalieren durch, um sicherzustellen, dass er über genügend Arbeitsspeicher und Kerne verfügt, falls nicht ausreichend Ressourcen für Ihre Spark-Anwendung bzw. die Aufträge vorhanden sind.
  2. Führen Sie einen Beispieltestauftrag aus.
    1. Wenn Sie denselben Auftrag im HDInsight-Backend ausführen, überprüfen Sie, ob er erfolgreich war. Beispiele für Beispielausführungen finden Sie unter Ausführen von MapReduce-Beispielen in HDInsight.
  3. Wenn der Auftrag in HDInsight weiterhin fehlgeschlagen ist, überprüfen Sie die Anwendungsprotokolle und Informationen, die dem Support bereitgestellt werden müssen:
    1. Überprüfen Sie, ob der Auftrag an YARN übermittelt wurde. Wurde er nicht an YARN übermittelt, verwenden Sie --master yarn.
    2. Wenn die Anwendung die Ausführung beendet hat, erfassen Sie die Start- und Endzeit der YARN-Anwendung. Hat sie die Ausführung nicht beendet, erfassen Sie „Startzeit/Startzeit“.
    3. Überprüfen und erfassen Sie das Anwendungsprotokoll mit yarn logs -applicationId <Insert_Your_Application_ID>.
    4. Überprüfen und erfassen Sie die Yarn Resource Manager-Protokolle im Verzeichnis /var/log/hadoop-yarn/yarn.
    5. Wenn diese Schritte zur Lösung des Problems nicht ausreichen, wenden Sie sich an das Azure HDInsight-Team, um Unterstützung zu erhalten. Geben Sie dabei die vorstehenden Protokolle und Zeitstempel an.

Fehlercode: 2304

  • Meldung: MSI authentication is not supported on storages for HDI activities.

  • Ursache: Die mit Storage verknüpften Dienste, die im verknüpften HDInsight (HDI)-Dienst oder in der HDI verwendet werden, wurden mit einer nicht unterstützten MSI-Authentifizierung konfiguriert.

  • Empfehlung: Geben Sie vollständige Verbindungszeichenfolgen für Speicherkonten an, die im verknüpften HDI-Dienst oder in der HDI-Aktivität verwendet werden.

Fehlercode: 2305

  • Meldung: Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'

  • Ursache: Die Verbindungsinformationen für den HDI-Cluster sind falsch, der angegebene Benutzer hat keine Berechtigungen zum Ausführen der erforderlichen Aktion, oder beim HDInsight-Dienst gibt es Probleme bei der Reaktion auf Anforderungen von dem Dienst.

  • Empfehlung: Überprüfen Sie, ob die Benutzerinformationen korrekt sind und ob die Ambari-Benutzeroberfläche für den HDI-Cluster in einem Browser auf der VM, auf der die IR installiert ist (bei einer selbstgehosteten IR), oder auf einem beliebigen Computer (bei Azure IR) geöffnet werden kann.

Fehlercode: 2306

  • Meldung: An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'

  • Ursache: Der für die Skriptaktion angegebene JSON-Code ist ungültig.

  • Empfehlung: Sie sollten das Problem mithilfe der Fehlermeldung identifizieren können. Korrigieren Sie die JSON-Konfiguration, und versuchen Sie es erneut.

    Weitere Informationen finden Sie unter Bedarfsgesteuerter verknüpfter Azure HDInsight-Dienst.

Fehlercode: 2310

  • Meldung: Failed to submit Spark job. Error: '%message;'

  • Ursache: Der Dienst hat versucht, mithilfe der Livy-API (Livy/Batch) einen Batch auf einem Spark-Cluster zu erstellen, es ist jedoch ein Fehler aufgetreten.

  • Empfehlung: Beheben Sie das Problem anhand der Fehlermeldung. Wenn die Informationen zur Lösung des Problems nicht ausreichen, wenden Sie sich an das HDI-Team, und geben Sie die Batch-ID und die Auftrags-ID an. Sie finden sie auf der Seite zur Dienstüberwachung in der Ausgabe der Aktivitätsausführung. Sollte eine weitere Problembehandlung erforderlich sein, erfassen Sie das vollständige Protokoll des Batchauftrags.

    Weitere Informationen zum Erfassen des vollständigen Protokolls finden Sie unter Abrufen des vollständigen Protokolls eines Batch-Auftrags.

Fehlercode: 2312

  • Meldung: Spark job failed, batch id:%batchId;. Please follow the links in the activity run Output from the service Monitoring page to troubleshoot the run on HDInsight Spark cluster. Please contact HDInsight support team for further assistance.

  • Ursache: Der Auftrag konnte auf dem HDInsight Spark-Cluster nicht ausgeführt werden.

  • Empfehlung: Verwenden Sie die Links in der Ausgabe der Aktivitätsausführung auf der Seite zur Dienstüberwachung, um Probleme mit der Ausführung auf dem HDInsight Spark-Cluster zu beheben. Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an das HDInsight-Supportteam.

    Weitere Informationen zum Erfassen des vollständigen Protokolls finden Sie unter Abrufen des vollständigen Protokolls eines Batch-Auftrags.

Fehlercode: 2313

  • Meldung: The batch with ID '%batchId;' was not found on Spark cluster. Open the Spark History UI and try to find it there. Contact HDInsight support for further assistance.

  • Ursache: Der Batch wurde auf dem HDInsight Spark-Cluster gelöscht.

  • Empfehlung: Beheben Sie Probleme mit Batches auf dem HDInsight Spark-Cluster. Wenden Sie sich an den HDInsight-Support, um weitere Unterstützung zu erhalten.

    Weitere Informationen zum Erfassen des vollständigen Protokolls finden Sie unter Abrufen des vollständigen Protokolls eines Batch-Auftrags. Geben Sie das vollständige Protokoll für den HDInsight-Support frei, um weitere Unterstützung zu erhalten.

Fehlercode: 2328

  • Meldung: Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • Ursache: Die Fehlermeldung sollte Einzelheiten zum Fehler enthalten.

  • Empfehlung: Sie sollten das Problem mithilfe der Fehlermeldung beheben können.

Fehlercode: 2329

  • Meldung: Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • Ursache: Die Fehlermeldung sollte Einzelheiten zum Fehler enthalten.

  • Empfehlung: Sie sollten das Problem mithilfe der Fehlermeldung beheben können.

Fehlercode: 2331

  • Meldung: The file path should not be null or empty.

  • Ursache: Der angegebene Dateipfad ist leer.

  • Empfehlung: Geben Sie einen Pfad für eine vorhandene Datei an.

Fehlercode: 2340

  • Meldung: HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.

  • Ursache: Der verknüpfte HDInsightOnDemand-Dienst unterstützt nicht die Ausführung über eine selbstgehostete IR.

  • Empfehlung: Wählen Sie eine Azure IR-Instanz aus, und versuchen Sie es erneut.

Fehlercode: 2341

  • Meldung: HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.

  • Ursache: Die angegebene URL hat nicht das richtige Format.

  • Empfehlung: Korrigieren Sie die Cluster-URL, und versuchen Sie es erneut.

Fehlercode: 2342

  • Meldung: Failed to connect to HDInsight cluster: '%errorMessage;'.

  • Ursache: Entweder sind die angegebenen Anmeldeinformationen für den Cluster falsch, oder es gibt ein Problem mit der Netzwerkkonfiguration oder -verbindung, oder aber die IR kann keine Verbindung mit dem Cluster herstellen.

  • Empfehlung:

    1. Überprüfen Sie, ob die Anmeldeinformationen richtig sind, indem Sie die Ambari-Benutzeroberfläche des HDInsight-Clusters in einem Browser öffnen.

    2. Wenn sich der Cluster im Virtual Network (VNET) befindet und eine selbstgehostete IR verwendet wird, muss die HDI-URL die private URL in VNets sein und -int sollte nach dem Clusternamen aufgeführt werden.

      Ändern Sie beispielsweise https://mycluster.azurehdinsight.net/ in https://mycluster-int.azurehdinsight.net/. Beachten Sie das -int nach mycluster, aber vor .azurehdinsight.net.

    3. Wenn sich der Cluster im VNET befindet, die selbstgehostete IR verwendet wird und die private URL verwendet wurde, die Verbindung aber trotzdem nicht erfolgreich hergestellt wurde, konnte die VM mit der installierten IR keine Verbindung mit dem HDI-Cluster herstellen.

      Stellen Sie eine Verbindung mit der VM her, auf der die IR installiert wurde, und öffnen Sie die Ambari-Benutzeroberfläche in einem Browser. Verwenden Sie die private URL für den Cluster. Diese Verbindung sollte im Browser funktionieren. Ist dies nicht der Fall, wenden Sie sich an das HDInsight-Supportteam, um weitere Unterstützung zu erhalten.

    4. Wenn keine selbstgehostete IR verwendet wird, sollte der HDI-Cluster öffentlich zugänglich sein. Öffnen Sie die Ambari-Benutzeroberfläche in einem Browser, und überprüfen Sie, ob sie tatsächlich angezeigt wird. Sollten Probleme mit dem Cluster oder mit den Diensten auf dem Cluster auftreten, wenden sie sich an das HDInsight-Supportteam.

      Die im verknüpften Dienst verwendete HDI-Cluster-URL muss für die IR (selbstgehostet oder Azure) zugänglich sein, damit die Testverbindung und Ausführungen erfolgreich sind. Dieser Status kann überprüft werden, indem Sie die URL in einem Browser entweder auf einer VM oder einem beliebigen öffentlichen Computer öffnen.

Fehlercode: 2343

  • Meldung: User name and password cannot be null or empty to connect to the HDInsight cluster.

  • Ursache: Entweder der Benutzername oder das Kennwort ist leer.

  • Empfehlung: Geben Sie die korrekten Anmeldeinformationen für die Verbindung mit HDI an, und versuchen Sie es erneut.

Fehlercode: 2345

  • Meldung: Failed to read the content of the hive script. Error: '%message;'

  • Ursache: Die Skriptdatei ist nicht vorhanden, oder der Dienst konnte keine Verbindung mit dem Speicherort des Skripts herstellen.

  • Empfehlung: Überprüfen Sie, ob das Skript vorhanden ist und ob der zugehörige verknüpfte Dienst die richtigen Anmeldeinformationen für eine Verbindung hat.

Fehlercode: 2346

  • Meldung: Failed to create ODBC connection to the HDI cluster with error message '%message;'.

  • Ursache: Der Service hat versucht, eine Open Database Connectivity (ODBC)-Verbindung mit dem HDI-Cluster her. zustellen. Dabei ist ein Fehler aufgetreten.

  • Empfehlung:

    1. Vergewissern Sie sich, dass Sie Ihre ODBC-/Java Database Connectivity (JDBC)-Verbindung ordnungsgemäß eingerichtet haben.
      1. Wenn Sie dasselbe virtuelle Netzwerk verwenden, können Sie diese Verbindung für JDBC abrufen von:
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. Informationen zur Sicherstellung, dass Sie JDBC korrekt eingerichtet haben, finden Sie unter Abfragen von Apache Hive über den JDBC-Treiber in HDInsight.
      3. Lesen Sie für Open Database (ODB) Tutorial: Abfragen von Apache Hive mit ODBC und PowerShell, um sicherzustellen, dass Sie es korrekt eingerichtet haben.
    2. Überprüfen Sie, ob „Hiveserver2“, „Hive-Metastore“ und „Hiveserver2 Interactive“ aktiv sind und funktionieren.
    3. Überprüfen Sie die Ambari-Benutzeroberfläche (User Interface, UI):
      1. Vergewissern Sie sich, dass alle Dienste weiterhin ausgeführt werden.
      2. Überprüfen Sie auf der Ambari-Benutzeroberfläche den Abschnitt „Warnung“ in Ihrem Dashboard.
        1. Weitere Informationen zu Warnungen und den entsprechenden Lösungen finden Sie unter Verwalten und Überwachen eines Clusters.
    4. Wenn diese Schritte zur Lösung des Problems nicht ausreichen, wenden Sie sich an das Azure HDInsight-Team.

Fehlercode: 2347

  • Meldung: Hive execution through ODBC failed with error message '%message;'.

  • Ursache: Der Service hat das Hive-Skript über eine ODBC-Verbindung zur Ausführung an den HDI-Cluster gesendet, und beim Skript ist auf dem Cluster ein Fehler aufgetreten.

  • Empfehlung:

    1. Vergewissern Sie sich, dass Sie Ihre ODBC-/Java Database Connectivity (JDBC)-Verbindung ordnungsgemäß eingerichtet haben.
      1. Wenn Sie dasselbe virtuelle Netzwerk verwenden, können Sie diese Verbindung für JDBC abrufen von:
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. Informationen zur Sicherstellung, dass Sie JDBC korrekt eingerichtet haben, finden Sie unter Abfragen von Apache Hive über den JDBC-Treiber in HDInsight.
      3. Lesen Sie für Open Database (ODB) Tutorial: Abfragen von Apache Hive mit ODBC und PowerShell, um sicherzustellen, dass Sie es korrekt eingerichtet haben.
    2. Überprüfen Sie, ob „Hiveserver2“, „Hive-Metastore“ und „Hiveserver2 Interactive“ aktiv sind und funktionieren.
    3. Überprüfen Sie die Ambari-Benutzeroberfläche (User Interface, UI):
      1. Vergewissern Sie sich, dass alle Dienste weiterhin ausgeführt werden.
      2. Überprüfen Sie auf der Ambari-Benutzeroberfläche den Abschnitt „Warnung“ in Ihrem Dashboard.
        1. Weitere Informationen zu Warnungen und den entsprechenden Lösungen finden Sie unter Verwalten und Überwachen eines Clusters.
    4. Wenn diese Schritte zur Lösung des Problems nicht ausreichen, wenden Sie sich an das Azure HDInsight-Team.

Fehlercode: 2348

  • Meldung: The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.

  • Ursache: Die Eigenschaften des verknüpften Speicherdiensts sind nicht richtig festgelegt.

  • Empfehlung: Im verknüpften Hauptspeicherdienst für HDI-Aktivitäten werden nur vollständige Verbindungszeichenfolgen unterstützt. Vergewissern Sie sich, dass Sie keine MSI-Autorisierungen oder -Anwendungen verwenden.

Fehlercode: 2350

  • Meldung: Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'

  • Ursache: Die Anmeldeinformationen, die zum Herstellen einer Verbindung mit dem Speicher angegeben wurden, in dem sich die Dateien befinden sollten, sind falsch, oder die Dateien sind dort nicht vorhanden.

  • Empfehlung: Dieser Fehler tritt auf, wenn der Service die HDI-Aktivitäten vorbereitet und versucht, Dateien vor Übermittlung des Auftrags an HDI in den Hauptspeicher zu kopieren. Überprüfen Sie, ob die Dateien am angegebenen Speicherort vorhanden sind und ob die Speicherverbindung korrekt ist. Die HDI-Aktivitäten unterstützen die MSI-Authentifizierung für Speicherkonten, die mit HDI-Aktivitäten im Zusammenhang stehen nicht. Überprüfen Sie deshalb, ob diese verknüpften Dienste über vollständige Schlüssel verfügen oder Azure Key Vault verwenden.

Fehlercode: 2351

  • Meldung: Could not open the file '%filePath;' in container/fileSystem '%container;'.

  • Ursache: Die Datei ist im angegebenen Pfad nicht vorhanden.

  • Empfehlung: Überprüfen Sie, ob die Datei tatsächlich vorhanden ist und ob der verknüpfte Dienst mit Verbindungsinformationen, die auf diese Datei verweisen, die richtigen Anmeldeinformationen enthält.

Fehlercode: 2352

  • Meldung: The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.

  • Ursache: Die Eigenschaften des verknüpften Dateispeicherdiensts sind nicht richtig festgelegt.

  • Empfehlung: Überprüfen Sie, ob die Eigenschaften des verknüpften Dateispeicherdiensts ordnungsgemäß konfiguriert wurden.

Fehlercode: 2353

  • Meldung: The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.

  • Ursache: Die Eigenschaften des verknüpften Skriptspeicherdiensts sind nicht richtig festgelegt.

  • Empfehlung: Überprüfen Sie, ob die Eigenschaften des verknüpften Skriptspeicherdiensts ordnungsgemäß konfiguriert wurden.

Fehlercode: 2354

  • Meldung: The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.

  • Ursache: Der Typ des verknüpften Speicherdiensts wird von der Aktivität nicht unterstützt.

  • Empfehlung: Überprüfen Sie, ob beim ausgewählten verknüpften Dienst einer der unterstützten Typen für die Aktivität verwendet wird. HDI-Aktivitäten unterstützen die verknüpften Dienste „AzureBlobStorage“ und „AzureBlobFSStorage“.

    Weitere Informationen finden Sie unter Vergleich der Speicheroptionen für die Verwendung mit Azure HDInsight-Clustern.

Fehlercode: 2355

  • Meldung: The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.

  • Ursache: Der angegebene Wert für commandEnvironment ist falsch.

  • Empfehlung: Überprüfen Sie, ob der angegebene Wert ähnlich wie der folgende ist:

    \"variableName=variableValue\"
    ]
    

    Überprüfen Sie außerdem, ob jede Variable in der Liste nur einmal angezeigt wird.

Fehlercode: 2356

  • Meldung: The commandEnvironment already contains a variable named '%variableName;'.

  • Ursache: Der angegebene Wert für commandEnvironment ist falsch.

  • Empfehlung: Überprüfen Sie, ob der angegebene Wert ähnlich wie der folgende ist:

    \"variableName=variableValue\"
    ]
    

    Überprüfen Sie außerdem, ob jede Variable in der Liste nur einmal angezeigt wird.

Fehlercode: 2357

  • Meldung: The certificate or password is wrong for ADLS Gen 1 storage.

  • Ursache: Die bereitgestellten Anmeldeinformationen sind falsch.

  • Empfehlung: Überprüfen Sie, ob die Verbindungsinformationen in ADLS Gen 1 mit dem Dienst verknüpft sind und ob die Testverbindung erfolgreich ist.

Fehlercode: 2358

  • Meldung: The value '%value;' for the required property 'TimeToLive' in the on demand HDInsight linked service '%linkedServiceName;' has invalid format. It should be a timespan between '00:05:00' and '24:00:00'.

  • Ursache: Der angegebene Wert für die erforderliche Eigenschaft TimeToLive hat ein ungültiges Format.

  • Empfehlung: Aktualisieren Sie den Wert auf den vorgeschlagenen Bereich, und versuchen Sie es erneut.

Fehlercode: 2359

  • Meldung: The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.

  • Ursache: Der angegebene Wert für die Eigenschaft roles ist ungültig.

  • Empfehlung: Ersetzen Sie den Wert durch einen der vorgeschlagenen Werte, und versuchen Sie es erneut.

Fehlercode: 2360

  • Meldung: The connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

  • Ursache: Die angegebene Verbindungszeichenfolge für den HCatalogLinkedService ist ungültig.

  • Empfehlung: Ersetzen Sie den Wert durch eine korrekte Azure SQL-Verbindungszeichenfolge, und versuchen Sie es erneut.

Fehlercode: 2361

  • Meldung: Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.

  • Ursache: Die Clustererstellung war nicht erfolgreich, und vom HDInsight-Dienst wurde kein Fehler an den Dienst ausgegeben.

  • Empfehlung: Öffnen Sie das Azure-Portal, suchen Sie die HDI-Ressource mit dem angegebenen Namen, und überprüfen Sie dann den Bereitstellungsstatus. Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an das HDInsight-Supportteam.

Fehlercode: 2362

  • Meldung: Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.

  • Ursache: Der bereitgestellte zusätzliche Speicher war kein Azure-Blobspeicher.

  • Empfehlung: Geben Sie ein Azure-Blobspeicherkonto als zusätzlichen Speicher für den bedarfsgesteuerten verknüpften HDInsight-Dienst an.

SSL-Fehler bei Verwendung des HDInsight ESP-Clusters durch den verknüpften Dienst

  • Meldung: Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'

  • Ursache: Das Problem ist wahrscheinlich auf den Vertrauensspeicher des Systems zurückzuführen.

  • Lösung: Navigieren Sie zum Pfad Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib, und öffnen Sie „DriverConfiguration64.exe“, um die Einstellung zu ändern.

    Deaktivieren von „Systemvertrauensspeicher verwenden“

HDI-Aktivität bei der Vorbereitung des Clusters hängen geblieben

Wenn die HDI-Aktivität bei der Clustervorbereitung hängen bleibt, befolgen Sie die folgenden Anleitungen:

  1. Stellen Sie sicher, dass das Timeout größer ist als im Folgenden beschrieben, warten Sie, bis die Ausführung abgeschlossen ist oder bis ein Timeout auftritt, und warten Sie auf die Gültigkeitsdauer (Time To Live, TTL), bevor Sie neue Aufträge übermitteln.

    Die maximale Standardzeit, die zum Starten eines Clusters benötigt wird, beträgt 2 Stunden, und wenn Sie über ein Init-Skript verfügen, addieren Sie bis zu 2 weitere Stunden.

  2. Stellen Sie sicher, dass Speicher und HDI in derselben Region bereitgestellt werden.

  3. Stellen Sie sicher, dass der Dienstprinzipal, der für den Zugriff auf den HDI-Cluster verwendet wird, gültig ist.

  4. Wenn das Problem weiterhin besteht, löschen Sie als Problemumgehung den verknüpften HDI-Dienst, und erstellen Sie ihn mit einem neuen Namen neu.

Webaktivität

Fehlercode: 2001

Fehlercode: 2002

  • Meldung: The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

  • Ursache: Die Nutzdaten, die Sie senden möchten, sind zu umfangreich.

  • Empfehlung: Siehe Nutzdaten sind zu umfangreich.

Fehlercode: 2003

  • Meldung: There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.

  • Ursache: Zu viele Aktivitäten werden gleichzeitig ausgeführt. Dies kann passieren, wenn zu viele Pipelines gleichzeitig ausgelöst werden.

  • Empfehlung: Reduzieren Sie die Pipelineparallelität. Möglicherweise müssen Sie die Triggerzeit Ihrer Pipelines verteilen.

Fehlercode: 2010

  • Meldung: The Self-hosted Integration Runtime ‘<SHIR name>’ is offline

  • Ursache: Die selbst gehostete Integration Runtime ist offline oder die Azure Integration Runtime ist abgelaufen oder nicht registriert.

  • Empfehlung: Stellen Sie sicher, dass Ihre selbst gehostete Integration Runtime betriebsbereit ist und ausgeführt wird. Weitere Informationen finden Sie unter Problembehandlung bei der selbstgehosteten Integration Runtime.

Fehlercode: 2105

  • Meldung: The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'

  • Ursache: Die im Ausdruck für dynamischen Inhalt generierten Daten stimmen nicht mit dem Schlüssel überein und verursachen einen Fehler bei der JSON-Analyse.

  • Empfehlung: Sehen Sie sich das Feld „Schlüssel“ an, und beheben Sie die Definition für dynamischen Inhalt.

Fehlercode: 2108

  • Meldung: Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url: <URL>. Please verify Url or integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime'

  • Ursache: Die bereitgestellte URL konnte nicht erreicht werden. Dies kann auftreten, wenn es ein Problem mit der Netzwerkverbindung gab, die URL nicht aufgelöst wurde oder eine Localhost-URL in einer Azure Integration Runtime Integrationslaufzeit verwendet wurde.

  • Empfehlung: Überprüfen Sie, ob auf die angegebene URL zugegriffen werden kann.


  • Meldung: Error calling the endpoint '%url;'. Response status code: '%code;'

  • Ursache: Die Anforderung war aufgrund eines Problems (z. B Netzwerkkonnektivität, ein DNS-Fehler, eine Überprüfung des Serverzertifikats oder ein Timeout) nicht erfolgreich.

  • Empfehlung: Verwenden Sie Fiddler/Netmon/Wireshark, um die Anforderung zu überprüfen.

    Verwenden von Fiddler

    Verwenden Sie Fiddler zum Erstellen einer HTTP-Sitzung der überwachten Webanwendung:

    1. Laden Sie Fiddler herunter, und installieren und öffnen Sie die Anwendung.

    2. Wenn Ihre Webanwendung HTTPS verwendet, wechseln Sie zu Tools>Fiddler-Optionen>HTTPS.

      1. Wählen Sie auf der Registerkarte „HTTPS“ Capture HTTPS CONNECTs (HTTPS CONNECTs erfassen) und Decrypt HTTPS Traffic (HTTPS-Datenverkehr entschlüsseln) aus.

        Fiddler-Optionen

    3. Wenn in der Anwendung TLS/SSL-Zertifikate verwendet werden, fügen Sie das Fiddler-Zertifikat Ihrem Gerät hinzu.

      Wechseln Sie zu: Tools>Fiddler-Optionen>HTTPS>Aktionen>Stammzertifikat auf Desktop exportieren.

    4. Deaktivieren Sie die Erfassung, indem Sie zu Datei>Datenverkehr erfassen wechseln. Oder drücken Sie F12.

    5. Löschen Sie den Browsercache, sodass alle zwischengespeicherten Elemente gelöscht werden und erneut heruntergeladen werden müssen.

    6. Erstellen Sie eine Anforderung:

    7. Wählen Sie die Registerkarte Composer aus.

      1. Legen Sie die HTTP-Methode und die HTTP-URL fest.

      2. Fügen Sie bei Bedarf Header und einen Anforderungstext hinzu.

      3. Wählen Sie Execute(Ausführen).

    8. Starten Sie die Erfassung des Datenverkehrs wieder, und schließen Sie die entsprechende Transaktion auf Ihrer Seite ab.

    9. Wechseln Sie zu: Datei>Speichern>Alle Sitzungen.

    Weitere Informationen finden Sie unter Erste Schritte mit Fiddler.

Fehlercode: 2113

  • Meldung: ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination

  • Ursache: Es kann kein Zertifikat aus der Base64-Zeichenfolge/-Kennwortkombination generiert werden.

  • Empfehlung: Überprüfen Sie, ob die von Ihnen verwendete Base64-kodierte PFX-Zertifikat- und Kennwortkombination ordnungsgemäß eingegeben wurde.

Fehlercode: 2403

  • Meldung: Get access token from MSI failed for Datafactory <DF name>, region <region code>. Please verify resource url is valid and retry.

  • Ursache: Es konnte kein Zugriffstoken aus der angegebenen Ressourcen-URL abgerufen werden.

  • Empfehlung: Überprüfen Sie, ob Sie die richtige Ressourcen-URL für Ihre verwaltete Identität angegeben haben.

Allgemein

REST-Fortsetzungstoken: NULL-Fehler

Fehlermeldung: {"token":null,"range":{"min":..}

Ursache: Beim Abfragen über mehrere Partitionen/Seiten hinweg gibt der Back-End-Dienst Fortsetzungstoken im JObject-Format mit drei Eigenschaften zurück: Token, min. und max. Schlüsselbereiche, z. B. {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}). Abhängig von den Quelldaten kann die Abfrage zu 0 führen, was auf ein fehlendes Token hinweist, obwohl mehr Daten abgerufen werden müssen.

Empfehlung: Wenn das Fortsetzungstoken ungleich NULL ist, als Zeichenfolge {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}", muss die queryActivityRuns-API erneut mit dem Fortsetzungstoken aus der vorherigen Antwort aufgerufen werden. Sie müssen die vollständige Zeichenfolge für die Abfrage-API erneut übergeben. Die Aktivitäten werden auf den nachfolgenden Seiten für das Abfrageergebnis zurückgegeben. Sie sollten ignorieren, dass auf dieser Seite ein leeres Array vorhanden ist. Solange der vollständige continuationToken-Wert != NULL ist, müssen Sie die Abfrage fortsetzen. Weitere Informationen finden Sie unter REST-API für Pipelineausführungs-Abfragen.

Problem mit hängen gebliebener Aktivität

Wenn Sie beobachten, dass die Aktivität viel länger läuft als gewöhnlich und kaum vorankommt, ist sie möglicherweise hängen geblieben. Sie können versuchen, die Aktivität abzubrechen und zu wiederholen, um zu sehen, ob das hilft. Wenn es sich dabei um eine Kopieraktivität handelt, können Sie sich unter Problembehandlung für die Leistung der Kopieraktivität über die Leistungsüberwachung und Problembehandlung informieren. Wenn es sich um einen Datenfluss handelt, informieren Sie sich unter Leistung von Zuordnungsdatenflüssen und im Leitfaden für die Optimierung.

Nutzdaten sind zu umfangreich

Fehlermeldung: The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

Ursache: Die Nutzdaten für jede Aktivitätsausführung enthalten die Aktivitätskonfiguration, die Konfigurationen der zugeordneten Datasets und verknüpften Dienste (sofern vorhanden) sowie einen kleinen Teil der pro Aktivitätstyp generierten Systemeigenschaften. Der Grenzwert für diese Nutzlastgröße beträgt 896 KB, wie in der Dokumentation zu Azure-Grenzwerten für Data Factory und Azure Synapse Analytics. erwähnt.

Empfehlung: Sie erreichen dieses Limit wahrscheinlich, weil Sie einen oder mehrere große Parameterwerte übergeben, die entweder aus der vorgelagerten Aktivitätsausgabe stammen oder externen Ursprungs sind, insbesondere, wenn Sie tatsächliche Daten über Aktivitäten in der Ablaufsteuerung hinweg übergeben. Überprüfen Sie, ob Sie die Größe großer Parameterwerte reduzieren können, oder optimieren Sie Ihre Pipelinelogik, um zu vermeiden, dass diese Werte zwischen Aktivitäten übergeben werden, und verarbeiten Sie sie stattdessen in der Aktivität.

Nicht unterstützte Komprimierung führt zu beschädigten Dateien

Symptome: Sie versuchen, eine in einem Blobcontainer gespeicherte Datei zu entpacken. Eine einzelne Kopieraktivität in einer Pipeline weist eine Quelle auf, deren Komprimierungstyp auf „deflate64“ (oder einen anderen nicht unterstützten Typ) festgelegt ist. Diese Aktivität wird erfolgreich ausgeführt und erzeugt die Textdatei, die in der ZIP-Datei enthalten ist. Es liegt jedoch ein Problem mit dem Text in der Datei vor, und die Datei scheint beschädigt zu sein. Wenn diese Datei lokal entpackt wird, ist alles in Ordnung.

Ursache: Die ZIP-Datei wird mit dem Algorithmus „deflate64“ komprimiert, die interne ZIP-Bibliothek von Azure Data Factory unterstützt aber nur „deflate“. Wenn die ZIP-Datei vom Windows-System komprimiert wird und die Datei eine bestimmte Gesamtgröße überschreitet, verwendet Windows standardmäßig „deflate64“. Dies wird in Azure Data Factory nicht unterstützt. Wenn die Datei hingegen kleiner ist oder Sie ZIP-Tools von Drittanbietern verwenden, die die Angabe des Komprimierungsalgorithmus unterstützen, verwendet Windows standardmäßig „deflate“.

Tipp

Tatsächlich wird sowohl in Das Binärformat in Azure Data Factory und Synapse Analytics als auch in Das Textformat mit Trennzeichen in Azure Data Factory and Azure Synapse Analytics eindeutig angegeben, dass das Format „deflate64“ in Azure Data Factory nicht unterstützt wird.

Die Execute Pipeline-Aktivität übergibt einen Array-Parameter als Zeichenfolge an die untergeordnete Pipeline.

Fehlermeldung: Operation on target ForEach1 failed: The execution of template action 'MainForEach1' failed: the result of the evaluation of 'foreach' expression '@pipeline().parameters.<parameterName>' is of type 'String'. The result must be a valid array.

Ursache: In der Pipeline tritt auch dann ein Fehler auf, wenn Sie in der Execute Pipeline-Aktivität den Parameter vom Typ „Array“ erstellen (siehe folgende Abbildung).

Screenshot: Parameter der Execute Pipeline-Aktivität.

Dies liegt daran, dass die Nutzdaten von der übergeordneten Pipeline als Zeichenfolge an die untergeordnete Pipeline übergeben werden. Sie können dies sehen, wenn Sie die an die untergeordnete Pipeline übergebene Eingabe überprüfen.

Screenshot: Eingabetyp „String“.

Empfehlung: Sie können die createArray-Funktion nutzen, um das Problem zu beheben (siehe folgende Abbildung).

Screenshot: Verwendung der createArray-Funktion.

Die Pipeline wird dann erfolgreich ausgeführt. Im Eingabefeld sehen Sie, dass der übergebene Parameter ein Array ist.

Screenshot: Eingabetyp „Array“.

Weitere Informationen zur Problembehandlung finden Sie in diesen Ressourcen: