Problembehandlung für den REST-Connector in Azure Data Factory und Azure Synapse

Gilt für: Azure Data Factory Azure Synapse Analytics

Tipp

Data Factory in Microsoft Fabric ist die nächste Generation von Azure Data Factory mit einer einfacheren Architektur, integrierter KI und neuen Features. Wenn Sie mit der Datenintegration noch nicht vertraut sind, beginnen Sie mit Fabric Data Factory. Vorhandene ADF-Workloads können auf Fabric aktualisiert werden, um auf neue Funktionen in der Datenwissenschaft, Echtzeitanalysen und Berichterstellung zuzugreifen.

Dieser Artikel enthält Vorschläge zur Problembehandlung häufiger Probleme mit dem REST-Connector in Azure Data Factory und Azure Synapse.

Fehlercode: RestSinkCallFailed

  • Meldung: Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • Ursache: Dieser Fehler tritt auf, wenn eine Data Factory- oder Synapse-Pipeline mit dem REST-Endpunkt über das HTTP-Protokoll kommuniziert und beim Anforderungsvorgang ein Fehler auftritt.

  • Empfehlung: Überprüfen Sie den HTTP-Statuscode bzw. die HTTP-Statusnachricht in der Fehlermeldung, und beheben Sie das Problem mit dem Remoteserver.

Fehlercode: RestSourceCallFailed

  • Meldung: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • Cause: Dieser Fehler tritt auf, wenn Azure Data Factory mit dem REST-Endpunkt über HTTP-Protokoll spricht und der Anforderungsvorgang fehlschlägt.

  • Empfehlung: Überprüfen Sie den HTTP-Statuscode bzw. die Anforderungs-URL oder Antwortpayload in der Fehlermeldung, und beheben Sie das Problem mit dem Remoteserver.

Fehlercode: RestSinkUNSupportedCompressionType

  • Meldung: User Configured CompressionType is Not Supported By Azure Data Factory：%message;

  • Empfehlung: Überprüfen Sie die unterstützten Komprimierungstypen für die REST-Senke.

Unerwartete Netzwerkantwort vom REST-Connector

  • Symptome: Der Endpunkt empfängt manchmal eine unerwartete Antwort (400/401/403/500) vom REST-Connector.

  • Ursache: Für den REST-Quellenconnector werden beim Erstellen einer HTTP-Anforderung die URL und die HTTP-Methode (mit Header und Text) des verknüpften Diensts, des Datasets oder der Kopierquelle als Parameter verwendet. Der wahrscheinlichste Grund für das Problem sind einige Fehler in mindestens einem der angegebenen Parameter.

  • Lösung:

    • Verwenden Sie „curl“ in einem Eingabeaufforderungsfenster, um zu überprüfen, ob der Parameter die Ursache ist (die Header Accept und User-Agent sollten immer vorhanden sein):

      curl -i -X <HTTP method> -H <HTTP header1> -H <HTTP header2> -H "Accept: application/json" -H "User-Agent: azure-data-factory/2.0" -d '<HTTP body>' <URL>

      Wenn für diesen Befehl die gleiche unerwartete Antwort zurückgegeben wird, korrigieren Sie die Parameter oben mit „curl“, bis die erwartete Antwort zurückgegeben wird.

      Sie können auch „curl --help“ verwenden, um die erweiterten Verwendungszwecke des Befehls anzuzeigen.

    • Wenn nur der REST-Connector eine unerwartete Antwort zurückgibt, wenden Sie sich an Microsoft Support für weitere Problembehandlung.

    • Beachten Sie, dass „curl“ ggf. nicht geeignet ist, um ein Problem bei der Überprüfung des SSL-Zertifikats zu reproduzieren. In einigen Szenarien war die Ausführung des Befehls „curl“ erfolgreich, ohne dass Probleme bei der Überprüfung des SSL-Zertifikats aufgetreten sind. Wenn dieselbe URL dann im Browser ausgeführt wird, wird für den Client aber kein SSL-Zertifikat zurückgegeben, mit dem eine Vertrauensstellung mit dem Server eingerichtet werden kann.

      Für den obigen Fall wird die Verwendung von Tools wie Fiddler empfohlen.

Das Dienstprinzipalzertifikat in Azure Key Vault ist nicht korrekt.

  • Meldung: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • Ursache: Es wird nur das base64-codierte Dienstprinzipalzertifikat für die Dienstprinzipal-Zertifikatauthentifizierung des REST‑Connectors unterstützt.
  • Recommendation: Folgen Sie diesem section, um das Dienstprinzipalzertifikat in Azure Key Vault ordnungsgemäß zu speichern.

Zugehöriger Inhalt

Weitere Informationen zur Problembehandlung finden Sie in diesen Ressourcen:

  • Last updated on