Delen via


Problemen met de REST-connector in Azure Data Factory en Azure Synapse oplossen

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Dit artikel bevat suggesties voor het oplossen van veelvoorkomende problemen met de REST-connector in Azure Data Factory en Azure Synapse.

Foutcode: RestSinkCallFailed

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

  • Oorzaak: Deze fout treedt op wanneer een data factory of Synapse-pijplijn met het REST-eindpunt praat via het HTTP-protocol en de aanvraagbewerking mislukt.

  • Aanbeveling: Controleer de HTTP-statuscode of het bericht in het foutbericht en los het probleem met de externe server op.

Foutcode: RestSourceCallFailed

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

  • Oorzaak: Deze fout treedt op wanneer Azure Data Factory met het REST-eindpunt praat via het HTTP-protocol en de aanvraagbewerking mislukt.

  • Aanbeveling: Controleer de HTTP-statuscode of de aanvraag-URL of de nettolading van het antwoord in het foutbericht en los het probleem met de externe server op.

Foutcode: RestSinkUNSupportedCompressionType

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

  • Aanbeveling: Controleer de ondersteunde compressietypen voor de REST-sink.

Onverwacht netwerkantwoord van de REST-connector

  • Symptomen: het eindpunt ontvangt soms een onverwacht antwoord (400, 401, 403, 500) van de REST-connector.

  • Oorzaak: de REST-bronconnector gebruikt de URL en de HTTP-methode/header/hoofdtekst van de gekoppelde service/gegevensset/kopiebron als parameters wanneer er een HTTP-aanvraag wordt gemaakt. Het probleem wordt waarschijnlijk veroorzaakt door enkele fouten in een of meer opgegeven parameters.

  • Oplossing:

    • Gebruik curl in een opdrachtpromptvenster om te zien of de parameter de oorzaak is (accepteren en headers van de gebruikersagent moeten altijd worden opgenomen):

      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>

      Als de opdracht hetzelfde onverwachte antwoord retourneert, herstelt u de voorgaande parameters met 'curl' totdat het verwachte antwoord wordt geretourneerd.

      U kunt ook 'curl--help' gebruiken voor meer geavanceerd gebruik van de opdracht.

    • Als alleen de REST-connector een onverwacht antwoord retourneert, neemt u contact op met Microsoft Ondersteuning voor verdere probleemoplossing.

    • Houd er rekening mee dat curl mogelijk niet geschikt is om een ssl-certificaatvalidatieprobleem te reproduceren. In sommige scenario's is de opdracht 'curl' uitgevoerd zonder dat er problemen zijn met validatie van SSL-certificaten. Maar wanneer dezelfde URL wordt uitgevoerd in een browser, wordt er geen SSL-certificaat daadwerkelijk geretourneerd voor de client om een vertrouwensrelatie met de server tot stand te brengen.

      Hulpprogramma's zoals Fiddler worden aanbevolen voor het voorgaande geval.

Het certificaat van de service-principal in Azure Key Vault is niet juist

  • Bericht: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • Oorzaak: Alleen ondersteuning voor het certificaat van de base64-tekenreeksservice-principal voor rest connector-certificaatverificatie.
  • Aanbeveling: Volg deze sectie om het certificaat van de service-principal correct op te slaan in Azure Key Vault.

Voor meer hulp bij het oplossen van problemen kunt u de volgende bronnen proberen: