مشاركة عبر

استكشاف أخطاء موصل REST وإصلاحها في مصنع بيانات Azure وAzure Synapse

  • مقالة

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

توفر هذه المقالة اقتراحات لاستكشاف المشكلات الشائعة المتعلقة بموصل REST في مصنع بيانات Azure وAzure Synapse وإصلاحها.

رمز الخطأ: RestSinkCallFailed

  • الرسالة: Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • السبب: يحدث هذا الخطأ عندما يتحدث مصنع بيانات أو مسار Synapse إلى نقطة نهاية REST عبر بروتوكول HTTP، وتفشل عملية الطلب.

  • التوصية: تحقق من رمز حالة HTTP أو الرسالة في رسالة الخطأ وأصلح مشكلة الخادم البعيد.

رمز الخطأ: RestSourceCallFailed

  • الرسالة: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • السبب: يحدث هذا الخطأ عندما يتحدث Azure Data Factory إلى نقطة نهاية REST عبر بروتوكول HTTP، وتفشل عملية الطلب.

  • التوصية: تحقق من رمز حالة HTTP أو عنوان URL للطلب أو حمولة الاستجابة في رسالة الخطأ وأصلح مشكلة الخادم البعيد.

رمز الخطأ: RestSinkUNSupportedCompressionType

  • الرسالة: User Configured CompressionType is Not Supported By Azure Data Factory：%message;

  • التوصية: تحقق من أنواع الضغط المدعومة لمتلقي REST.

استجابة شبكة غير متوقعة من موصل REST

  • الأعراض: تتلقى نقطة النهاية أحيانا استجابة غير متوقعة (400، 401، 403، 500) من موصل REST.

  • السبب: يستخدم موصل مصدر REST عنوان URL وأسلوب HTTP/الرأس/النص الأساسي من الخدمة/مجموعة البيانات المرتبطة/مصدر النسخ كمعلمات عند إنشاء طلب HTTP. من المحتمل أن تكون المشكلة ناتجة عن بعض الأخطاء في واحد أو أكثر من المعلمات المحددة.

  • التحليل:

    • استخدم "curl" في نافذة موجه الأوامر لمعرفة ما إذا كانت المعلمة هي السبب (يجب تضمين عناوين قبول وعامل المستخدم دائما):

      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>

      إذا قام الأمر بإرجاع نفس الاستجابة غير المتوقعة، فقم بإصلاح المعلمات السابقة بـ "curl" حتى يقوم بإرجاع الاستجابة المتوقعة.

      يمكنك أيضاً استخدام "curl - help" لاستخدام أكثر تقدماً للأمر.

    • إذا قام موصل REST فقط بإرجاع استجابة غير متوقعة، فاتصل بدعم Microsoft لمزيد من استكشاف الأخطاء وإصلاحها.

    • لاحظ أن "curl" قد لا يكون مناسباً لإعادة إنتاج مشكلة التحقق من صحة شهادة SSL. في بعض السيناريوهات، تم تنفيذ الأمر "curl" بنجاح دون مواجهة أي مشكلات في التحقق من صحة شهادة SSL. ولكن عند تنفيذ نفس عنوان URL في مستعرض، لا يتم إرجاع أي شهادة SSL للعميل لتأسيس الثقة مع الخادم.

      يوصى باستخدام أدوات مثل Fiddler للحالة السابقة.

الشهادة الأساسية للخدمة في Azure Key Vault غير صحيحة

  • الرسالة: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • السبب: دعم الشهادة الأساسية لخدمة سلسلة base64 فقط لمصادقة الشهادة الأساسية لخدمة موصل Rest.
  • التوصية: اتبع هذا القسم لحفظ الشهادة الأساسية للخدمة في Azure Key Vault بشكل صحيح.

المحتوى ذو الصلة

لمزيد من تعليمات استكشاف الأخطاء وإصلاحها، جرب هذه الموارد: