استكشاف أخطاء Azure Data Factory وموصلات تحليلات Azure Synapse

مقالة
10/20/2023

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

تلميح

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

توضح هذه المقالة كيفية استكشاف أخطاء الموصلات في Azure Data Factory وتحليلات Azure Synapse وإصلاحها.

المشاكل الخاصة بالموصل

يمكنك الاطلاع على صفحات استكشاف الأخطاء وإصلاحها لكل موصل للاطلاع على المشكلات الخاصة به مع شرح أسبابها والتوصيات لحلها.

أخطاء نشاط النسخ العام

تعتبر الأخطاء الواردة أدناه عامة بالنسبة إلى نشاط النسخ ويمكن أن تحدث مع أي موصل.

رمز الخطأ: JreNotFound

الرسالة: Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.
السبب : لا يمكن لوقت تشغيل التكامل المستضاف ذاتياً العثور على وقت تشغيل Java. وقت تشغيل Java مطلوب لقراءة مصادر معينة.
توصية: تحقق من بيئة Microsoft Integration Runtime، راجع استخدام وقت تشغيل التكامل المستضاف ذاتياً.

رمز الخطأ: WildcardPathSinkNotSupported

الرسالة: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
السبب : مجموعة بيانات المتلقي لا تدعم قيم حرف البدل.
توصية: تحقق من مجموعة بيانات المتلقي وأعد كتابة المسار دون استخدام قيمة حرف بدل.

مشكلة في معايير معالجة المعلومات الفيدرالية (FIPS)

الأعراض: فشل نشاط النسخ على جهاز وقت تشغيل التكامل المستضاف ذاتياً مزود بخدمة FIPS مع ظهور رسالة الخطأ التالية: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
السبب : قد يحدث هذا الخطأ عند نسخ البيانات باستخدام موصلات مثل ;كائن ثنائي كبير الحجم Azure وبروتوكول نقل الملفات الآمن (SFTP) وما إلى ذلك. تُعرّف معايير معالجة المعلومات الفيدرالية (FIPS) كمجموعة معينة من خوارزميات التشفير المسموح باستخدامها. عند تمكين وضع معايير معالجة المعلومات الفيدرالية (FIPS) على الجهاز، تُحظر بعض فئات التشفير التي تعتمد على نسخ النشاط في بعض وحدات السيناريو.
الحل: التعرّف على سبب عدم اقتراح "وضع FIPS" بعد الآن، وتقييم ما إذا كان يمكنك تعطيل معايير معالجة المعلومات الفيدرالية (FIPS) على جهاز وقت تشغيل التكامل المستضاف ذاتياً.

بدلاً من ذلك، إذا كنت تريد فقط تجاوز معايير معالجة المعلومات الفيدرالية (FIPS) وجعل تشغيل النشاط بنجاح، فقم بما يلي:
1. افتح المجلد حيث يُثبت وقت تشغيل التكامل المستضاف ذاتياً. عادةً ما يكون المسار هو usually C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.
2. افتح ملف diawp.exe.config ثم، في نهاية المقطع <runtime>، أضف <enforceFIPSPolicy enabled="false"/>، كما هو موضح هنا:
3. احفظ الملف، ثم أعد تشغيل جهاز وقت تشغيل التكامل المستضاف ذاتياً.

رمز الخطأ: JniException

الرسالة: An error occurred when invoking Java Native Interface.
السبب: إذا كانت رسالة الخطأ تحتوي على "لا يمكن إنشاء جهاز Java ظاهري: JNI إرجاع التعليمات البرمجية [-6][JNI فشل استدعاء: وسائط غير صالحة.]"، فالسبب المحتمل هو أنه لا يمكن إنشاء جهاز Java ظاهري بسبب تعيين بعض الوسيطات غير قانوني (العمومية).
التوصية: تسجيل الدخول إلى الجهاز الذي يستضيف كل عقدة من وقت تشغيل التكامل المستضاف ذاتياً. تحقق للتأكد من تعيين متغير النظام بشكل صحيح، على النحو التالي: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. أعد تشغيل جميع عقد وقت تشغيل تكامل ثم أعد تشغيل مسارات المعالجة.

رمز الخطأ: GetOAuth2AccessTokenErrorResponse

الرسالة: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
السبب: معرّف العميل أو سر العميل غير صالح، وفشل المصادقة في خادم التخويل الخاص بك.
التوصية: صحح جميع إعدادات تدفق بيانات اعتماد عميل OAuth2 لخادم التخويل.

رمز الخطأ: FailedToGetOAuth2AccessToken

الرسالة: Failed to get access token from your token endpoint. Error message: %errorMessage;.
السبب: إعدادات تدفق بيانات اعتماد العميل OAuth2 غير صالحة.
التوصية: صحح جميع إعدادات تدفق بيانات اعتماد عميل OAuth2 لخادم التخويل.

رمز الخطأ: OAuth2AccessTokenTypeNotSupported

الرسالة: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
السبب: خادم التخويل الخاص بك غير معتمد.
التوصية: استخدم خادم تخويل يمكنه إرجاع الرموز المميزة بأنواع الرموز المميزة المدعومة.

رمز الخطأ: OAuth2ClientIdColonNotAllowed

الرسالة: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
السبب: يتضمن مُعرّف العميل الخاص بك حرف غير صالح (:).
التوصية: استخدام مُعرّف عميل صالح.

رمز الخطأ: ManagedIdentityCredentialObjectNotSupported

الرسالة: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
التوصية: تحقق من الإصدار المعتمد وترقية وقت تشغيل التكامل إلى إصدار أعلى.

رمز الخطأ: QueryMissingFormatSettingsInDataset

الرسالة: The format settings are missing in dataset %dataSetName;.
السبب: نوع مجموعة البيانات ثنائي، وهو غير معتمد.
التوصية: استخدام مجموعة بيانات محدد النص أو Json أو Avro أو Orc أو باركيه بدلاً من ذلك.
السبب: بالنسبة لتخزين الملفات، إعدادات التنسيق مفقودة في مجموعة البيانات.
التوصية: إلغاء تحديد "نسخة ثنائية" في مجموعة البيانات، وتعيين إعدادات التنسيق الصحيحة.

رمز الخطأ: QueryUnsupportedCommandBehavior

الرسالة: The command behavior "%behavior;" is not supported.
التوصية: لا تقم بإضافة سلوك الأمر كمعلمة للمعاينة أو عنوان URL لطلب واجهة برمجة التطبيقات GetSchema.

رمز الخطأ: DataConsistencyFailedToGetSourceFileMetadata

الرسالة: Failed to retrieve source file ('%name;') metadata to validate data consistency.
السبب: هناك مشكلة عابرة في مخزن البيانات المتلقي أو استرداد بيانات التعريف من مخزن البيانات المتلقي غير مسموح به.

رمز الخطأ: DataConsistencyFailedToGetSinkFileMetadata

الرسالة: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
السبب: هناك مشكلة عابرة في مخزن البيانات المتلقي أو استرداد بيانات التعريف من مخزن البيانات المتلقي غير مسموح به.

رمز الخطأ: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

الرسالة: Data consistency validation is not supported in current copy activity settings.
السبب: التحقق من صحة تناسق البيانات معتمد فقط في سيناريو النسخ الثنائي المباشر.
التوصية: إزالة الخاصية 'validateDataConsistency' في حمولة نشاط النسخ.

رمز الخطأ: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

الرسالة: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
التوصية: التحقق من إصدار وقت تشغيل التكامل المعتمد وترقيته إلى إصدار أعلى، أو إزالة خاصية "validateDataConsistency" من أنشطة النسخ.

رمز الخطأ: SkipMissingFileNotSupportedForNonDirectBinaryCopy

الرسالة: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
التوصية: إزالة "fileMissing" من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

الرسالة: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
توصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

الرسالة: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
توصية: إزالة 'fileForbidden' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipForbiddenFileNotSupportedForThisConnector

الرسالة: Skip forbidden file is not supported for this connector: ('%connectorName;').
توصية: إزالة 'fileForbidden' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

الرسالة: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipInvalidFileNameNotSupportedForSource

الرسالة: Skip invalid file name is not supported for '%connectorName;' source.
التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipInvalidFileNameNotSupportedForSink

الرسالة: Skip invalid file name is not supported for '%connectorName;' sink.
التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: SkipAllErrorFileNotSupportedForNonBinaryCopy

الرسالة: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
التوصية: إزالة 'allErrorFile' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

الرسالة: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
التوصية: إزالة الإعداد 'deleteFilesAfterCompletion' أو استخدام نسخة ثنائية مباشرة.

رمز الخطأ: DeleteFilesAfterCompletionNotSupportedForThisConnector

الرسالة: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
التوصية: إزالة الإعداد 'deleteFilesAfterCompletion' في حمولة نشاط النسخ.

رمز خطأ: FailedToDownloadCustomPlugins

الرسالة: Failed to download custom plugins.
السبب: ارتباطات تحميل غير صالحة أو مشكلات اتصال عابرة.
التوصية: إعادة المحاولة إذا أظهرت الرسالة أنها مشكلة عابرة. إذا استمرت المشكلة، اتصل بفريق الدعم.

أخطاء الموصل العام

رمز الخطأ: UserErrorOdbcInvalidQueryString

الرسالة: The following ODBC Query is not valid: '%'.
السبب: توفر استعلامًا خاطئًا أو غير صالح لإحضار البيانات/المخططات.
التوصية: تحقق من صحة الاستعلام الخاص بك ويمكنه إرجاع البيانات/المخططات. استخدم نشاط البرنامج النصي إذا كنت تريد تنفيذ البرامج النصية غير الاستعلامية وكان مخزن البيانات الخاص بك مدعومًا. بدلاً من ذلك، ضع في اعتبارك استخدام الإجراء المخزن الذي يقوم بإرجاع نتيجة وهمية لتنفيذ البرامج النصية التي لا تتطلب استعلامًا.

رمز الخطأ: FailToResolveParametersInExploratoryController

الرسالة: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
السبب: الخدمة لديها قيود لدعم الخدمة المرتبطة التي تشير إلى خدمة مرتبطة أخرى مع معلمات لاختبار الاتصال أو معاينة البيانات. على سبيل المثال، قد يحدث تمرير معلمة من Key Vault إلى خدمة مرتبطة المشكلة.
التوصية: قم بإزالة المعلمات في الخدمة المرتبطة المشار إليها لإزالة الخطأ. وإلا، قم بتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية دون اختبار الاتصال أو معاينة البيانات.

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