استكشاف أخطاء Azure Data Factory وموصلات تحليلات Azure Synapse
ينطبق على: Azure Data Factory
Azure Synapse Analytics
تلميح
جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!
توضح هذه المقالة كيفية استكشاف أخطاء الموصلات في Azure Data Factory وتحليلات Azure Synapse وإصلاحها.
المشاكل الخاصة بالموصل
يمكنك الاطلاع على صفحات استكشاف الأخطاء وإصلاحها لكل موصل للاطلاع على المشكلات الخاصة به مع شرح أسبابها والتوصيات لحلها.
- مخزن البيانات الثنائية كبيرة الحجم لـ Azure
- Azure Cosmos DB (بما في ذلك Azure Cosmos DB لموصل NoSQL)
- مستودع بيانات Azure (Gen1 وGen2)
- Azure Database for PostgreSQL
- تخزين ملفات Azure
- تحليلات Azure Synapse وقاعدة بيانات Azure SQL، وخادم SQL
- DB2
- تنسيق نص محدد
- ديناميكيات 365 وDataverse (خدمة البيانات المشتركة) وDynamics CRM
- بروتوكول نقل الملفات (FTP)، وبروتوكول نقل الملفات الآمن (SFTP) وبروتوكول نقل نص تشعبي (HTTP)
- خلية
- Oracle
- تنسيق ORC
- تنسيق باركيه
- REST
- Salesforce وSalesforce Service Cloud
- قائمة SharePoint Online
- تنسيق XML
أخطاء نشاط النسخ العام
تعتبر الأخطاء الواردة أدناه عامة بالنسبة إلى نشاط النسخ ويمكن أن تحدث مع أي موصل.
رمز الخطأ: 20000
الرسالة:
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، راجع استخدام وقت تشغيل التكامل المستضاف ذاتياً.
رمز الخطأ: 20002
الرسالة:
An error occurred when invoking Java Native Interface.
السبب: إذا كانت رسالة الخطأ تحتوي على "لا يمكن إنشاء جهاز Java ظاهري: JNI إرجاع التعليمات البرمجية [-6][JNI فشل استدعاء: وسائط غير صالحة.]"، فالسبب المحتمل هو أنه لا يمكن إنشاء جهاز Java ظاهري بسبب تعيين بعض الوسيطات غير قانوني (العمومية).
التوصية: تسجيل الدخول إلى الجهاز الذي يستضيف كل عقدة من وقت تشغيل التكامل المستضاف ذاتياً. تحقق للتأكد من تعيين متغير النظام بشكل صحيح، على النحو التالي:
_JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G
. أعد تشغيل جميع عقد وقت تشغيل تكامل ثم أعد تشغيل مسارات المعالجة.
رمز الخطأ: 20020
الرسالة:
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) وجعل تشغيل النشاط بنجاح، فقم بما يلي:
افتح المجلد حيث يُثبت وقت تشغيل التكامل المستضاف ذاتياً. عادةً ما يكون المسار هو usually C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.
افتح ملف diawp.exe.config ثم، في نهاية المقطع
<runtime>
، أضف<enforceFIPSPolicy enabled="false"/>
، كما هو موضح هنا:احفظ الملف، ثم أعد تشغيل جهاز وقت تشغيل التكامل المستضاف ذاتياً.
رمز الخطأ: 20150
الرسالة:
Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
السبب: معرّف العميل أو سر العميل غير صالح، وفشل المصادقة في خادم التخويل الخاص بك.
التوصية: صحح جميع إعدادات تدفق بيانات اعتماد عميل OAuth2 لخادم التخويل.
رمز الخطأ: 20151
الرسالة:
Failed to get access token from your token endpoint. Error message: %errorMessage;.
السبب: إعدادات تدفق بيانات اعتماد العميل OAuth2 غير صالحة.
التوصية: صحح جميع إعدادات تدفق بيانات اعتماد عميل OAuth2 لخادم التخويل.
رمز الخطأ: 20152
الرسالة:
The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
السبب: خادم التخويل الخاص بك غير معتمد.
التوصية: استخدم خادم تخويل يمكنه إرجاع الرموز المميزة بأنواع الرموز المميزة المدعومة.
رمز الخطأ: 20153
الرسالة:
The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
السبب: يتضمن مُعرّف العميل الخاص بك حرف غير صالح (
:
).التوصية: استخدام مُعرّف عميل صالح.
رمز الخطأ: 20523
الرسالة:
Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
التوصية: تحقق من الإصدار المعتمد وترقية وقت تشغيل التكامل إلى إصدار أعلى.
رمز الخطأ: 20551
الرسالة:
The format settings are missing in dataset %dataSetName;.
السبب: نوع مجموعة البيانات ثنائي، وهو غير معتمد.
التوصية: استخدام مجموعة بيانات محدد النص أو Json أو Avro أو Orc أو باركيه بدلاً من ذلك.
السبب: بالنسبة لتخزين الملفات، إعدادات التنسيق مفقودة في مجموعة البيانات.
التوصية: إلغاء تحديد "نسخة ثنائية" في مجموعة البيانات، وتعيين إعدادات التنسيق الصحيحة.
رمز الخطأ: 20552
الرسالة:
The command behavior "%behavior;" is not supported.
التوصية: لا تقم بإضافة سلوك الأمر كمعلمة للمعاينة أو عنوان URL لطلب واجهة برمجة التطبيقات GetSchema.
رمز الخطأ: 20701
الرسالة:
Failed to retrieve source file ('%name;') metadata to validate data consistency.
السبب: هناك مشكلة عابرة في مخزن البيانات المتلقي أو استرداد بيانات التعريف من مخزن البيانات المتلقي غير مسموح به.
رمز الخطأ: 20703
الرسالة:
Failed to retrieve sink file ('%name;') metadata to validate data consistency.
السبب: هناك مشكلة عابرة في مخزن البيانات المتلقي أو استرداد بيانات التعريف من مخزن البيانات المتلقي غير مسموح به.
رمز الخطأ: 20704
الرسالة:
Data consistency validation is not supported in current copy activity settings.
السبب: التحقق من صحة تناسق البيانات معتمد فقط في سيناريو النسخ الثنائي المباشر.
التوصية: إزالة الخاصية 'validateDataConsistency' في حمولة نشاط النسخ.
رمز الخطأ: 20705
الرسالة:
'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
التوصية: التحقق من إصدار وقت تشغيل التكامل المعتمد وترقيته إلى إصدار أعلى، أو إزالة خاصية "validateDataConsistency" من أنشطة النسخ.
رمز الخطأ: 20741
الرسالة:
Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
التوصية: إزالة "fileMissing" من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20742
الرسالة:
Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
توصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20743
الرسالة:
Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
توصية: إزالة 'fileForbidden' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20744
الرسالة:
Skip forbidden file is not supported for this connector: ('%connectorName;').
توصية: إزالة 'fileForbidden' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20745
الرسالة:
Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20746
الرسالة:
Skip invalid file name is not supported for '%connectorName;' source.
التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20747
الرسالة:
Skip invalid file name is not supported for '%connectorName;' sink.
التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20748
الرسالة:
Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
التوصية: إزالة 'allErrorFile' من إعداد skipErrorFile في حمولة نشاط النسخ.
رمز الخطأ: 20771
الرسالة:
'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
التوصية: إزالة الإعداد 'deleteFilesAfterCompletion' أو استخدام نسخة ثنائية مباشرة.
رمز الخطأ: 20772
الرسالة:
'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
التوصية: إزالة الإعداد 'deleteFilesAfterCompletion' في حمولة نشاط النسخ.
رمز الخطأ: 27002
الرسالة:
Failed to download custom plugins.
السبب: ارتباطات تحميل غير صالحة أو مشكلات اتصال عابرة.
التوصية: إعادة المحاولة إذا أظهرت الرسالة أنها مشكلة عابرة. إذا استمرت المشكلة، اتصل بفريق الدعم.
أخطاء الموصل العام
رمز الخطأ: 9611
الرسالة:
The following ODBC Query is not valid: '%'.
السبب: توفر استعلامًا خاطئًا أو غير صالح لإحضار البيانات/المخططات.
التوصية: تحقق من صحة الاستعلام الخاص بك ويمكنه إرجاع البيانات/المخططات. استخدم نشاط البرنامج النصي إذا كنت تريد تنفيذ البرامج النصية غير الاستعلامية وكان مخزن البيانات الخاص بك مدعومًا. بدلاً من ذلك، ضع في اعتبارك استخدام الإجراء المخزن الذي يقوم بإرجاع نتيجة وهمية لتنفيذ البرامج النصية التي لا تتطلب استعلامًا.
رمز الخطأ: 11775
الرسالة:
Failed to connect to your instance of Azure Database for PostgreSQL flexible server.
السبب: المستخدم أو كلمة المرور المقدمة غير صحيحة. أسلوب التشفير المحدد غير متوافق مع تكوين الخادم. لا يسمح أسلوب اتصال الشبكة الذي تم تكوينه للمثيل الخاص بك بالاتصالات من وقت تشغيل التكامل المحدد.
التوصية: تأكد من وجود المستخدم المقدم في مثيل PostgreSQL وأن كلمة المرور تتوافق مع كلمة المرور المعينة حاليا لهذا المستخدم. تأكد من أن طريقة التشفير المحددة مقبولة من قبل مثيل PostgreSQL الخاص بك، استنادا إلى تكوينه الحالي. إذا تم تكوين أسلوب اتصال الشبكة للمثيل الخاص بك للوصول الخاص (تكامل VNet)، فاستخدم وقت تشغيل التكامل المستضاف ذاتيا (IR) للاتصال به. إذا تم تكوينه للوصول العام (عناوين IP المسموح بها)، فمن المستحسن استخدام وقت تشغيل تكامل Azure مع شبكة ظاهرية مدارة ونشر نقطة نهاية خاصة مدارة للاتصال بالمثيل الخاص بك. عند تكوينه للوصول العام (عناوين IP المسموح بها) يتكون بديل أقل موصى به في إنشاء قواعد جدار الحماية في المثيل الخاص بك للسماح بنسبة استخدام الشبكة التي تنشأ على عناوين IP المستخدمة من قبل وقت تشغيل تكامل Azure الذي تستخدمه.
المحتوى ذو الصلة
لمزيد من تعليمات استكشاف الأخطاء وإصلاحها، جرب هذه الموارد:
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ