Partager via


Dépanner le connecteur REST dans Azure Data Factory et Azure Synapse

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !

Cet article fournit des suggestions pour résoudre les problèmes courants liés au connecteur REST dans Azure Data Factory et Azure Synapse.

Code d’erreur : RestSinkCallFailed

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

  • Cause : Cette erreur se produit quand une fabrique de données ou un pipeline Synapse communique avec le point de terminaison REST via le protocole HTTP et que l’opération de requête échoue.

  • Recommandation : Vérifiez le code d’état HTTP ou le message dans le message d’erreur et corriger le problème du serveur distant.

Code d’erreur : RestSourceCallFailed

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

  • Cause : Cette erreur se produit quand Azure Data Factory communique avec le point de terminaison REST via le protocole HTTP et que l’opération de requête échoue.

  • Recommandation : Vérifiez le code d’état HTTP, l’URL de la requête ou la charge utile de la réponse dans le message d’erreur et corrigez le problème du serveur distant.

Code d’erreur : RestSinkUNSupportedCompressionType

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

  • Recommandation : Vérifiez les types de compression pris en charge pour le récepteur REST.

Réponse réseau inattendue du connecteur REST

  • Symptômes : Le point de terminaison reçoit parfois une réponse inattendue (400, 401, 403, 500) du connecteur REST.

  • Cause : Le connecteur source REST utilise l’URL et la méthode/l’en-tête/le corps HTTP du service/du jeu de données/de la copie source comme paramètres lors de la construction d’une requête HTTP. Le problème est probablement dû à des erreurs dans un ou plusieurs paramètres spécifiés.

  • Résolution :

    • Utilisez 'curl' dans une fenêtre d’invite de commandes pour vérifier si le paramètre est la cause ou non (les en-têtes Accept et User-Agent doivent toujours être inclus) :

      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>

      Si la commande retourne la même réponse inattendue, corrigez les paramètres ci-dessus en utilisant 'curl' jusqu’à obtenir la réponse attendue.

      Vous pouvez également utiliser 'curl--help' pour exécuter des options plus avancées de la commande.

    • Si seul le connecteur REST retourne une réponse inattendue, contactez le support technique de Microsoft pour poursuivre la résolution des problèmes.

    • Notez que 'curl' peut ne pas convenir pour reproduire le problème de validation du certificat SSL. Dans certains scénarios, la commande 'curl' a été exécutée avec succès sans rencontrer de problème de validation du certificat SSL. Toutefois, lorsque la même URL est exécutée dans un navigateur, aucun certificat SSL n’est réellement retourné pour permettre au client d’établir une relation de confiance avec le serveur.

      Les outils comme Fiddler sont recommandés dans le cas précédent.

Le certificat de principal de service dans Azure Key Vault n’est pas correct

  • Message : "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • Cause : prend uniquement en charge le certificat de principal de service de chaîne base64 pour l’authentification du principal de service du connecteur REST.
  • Recommandation : suivez cette section pour enregistrer correctement le certificat de principal de service dans Azure Key Vault.

Si vous avez besoin d’une aide supplémentaire, essayez les ressources suivantes :