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

  • Artikel

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!

Dieser Artikel enthält Vorschläge zur Behandlung 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;

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

  • 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 Informationen zu den erweiterten Optionen des Befehls anzuzeigen.

    • Falls nur vom REST-Connector eine unerwartete Antwort zurückgegeben wird, wenden Sie sich für die weitere Problembehandlung an den Microsoft-Support.

    • 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: Unterstützt nur das Dienstprinzipalzertifikat in Base64-Zeichenfolge für die Zertifikatauthentifizierung des REST-Connectordienstprinzipals.
  • Empfehlung: Befolgen Sie diesen Abschnitt, um das Dienstprinzipalzertifikat in Azure Key Vault richtig zu speichern.

Zugehöriger Inhalt

Weitere Informationen zur Problembehandlung finden Sie in diesen Ressourcen: