مشاركة عبر

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

  • مقالة

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

تلميح

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

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

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

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

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

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

رمز الخطأ: 2200 - UserErrorOdbcOperationFailed

  • الرسالة: The underlying connection was closed: An unexpected error occurred on a send.

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

  • إعادة التعليق:

    • تحقق من اتصال المصدر واختبره للتأكد من أنه يعمل بشكل صحيح.
    • تحقق من أسلوب المصادقة المستخدم للاتصال.
    • راجع إعدادات تكوين جدار الحماية ل Azure Cosmos DB للتأكد من أنها تسمح بنسبة استخدام الشبكة الضرورية.

رمز الخطأ: 20000 - 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، راجع استخدام وقت تشغيل التكامل المستضاف ذاتياً.

رمز الخطأ: 20002 - JniException

  • الرسالة: An error occurred when invoking Java Native Interface.

  • السبب: إذا كانت رسالة الخطأ تحتوي على "لا يمكن إنشاء JVM: رمز إرجاع JNI [-6][فشل استدعاء JNI: وسيطات غير صالحة.]"، فإن السبب المحتمل هو أنه لا يمكن إنشاء JVM بسبب تعيين بعض الوسيطات غير القانونية (العمومية).

  • التوصية: سجل الدخول إلى الجهاز الذي يستضيف كل عقدة من وقت تشغيل التكامل المستضاف ذاتيا. تحقق للتأكد من تعيين متغير النظام بشكل صحيح، على النحو التالي: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. أعد تشغيل جميع عقد وقت تشغيل تكامل ثم أعد تشغيل مسارات المعالجة.

رمز الخطأ: 20020 - 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"/>، كما هو موضح هنا:

      لقطة شاشة لجزء من ملف diawp.exe.config يُظهر تعطيل FIPS.

    3. احفظ الملف، ثم أعد تشغيل جهاز وقت تشغيل التكامل المستضاف ذاتياً.

رمز الخطأ: 20150 - GetOAuth2AccessTokenErrorResponse

  • الرسالة: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

  • السبب: معرّف العميل أو سر العميل غير صالح، وفشل المصادقة في خادم التخويل الخاص بك.

  • التوصية: صحح جميع إعدادات تدفق بيانات اعتماد عميل OAuth2 لخادم التخويل.

رمز الخطأ: 20151 - FailedToGetOAuth2AccessToken

  • الرسالة: Failed to get access token from your token endpoint. Error message: %errorMessage;.

  • السبب: إعدادات تدفق بيانات اعتماد العميل OAuth2 غير صالحة.

  • التوصية: صحح جميع إعدادات تدفق بيانات اعتماد عميل OAuth2 لخادم التخويل.

رمز الخطأ: 20152 - OAuth2AccessTokenTypeNotSupported

  • الرسالة: The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

  • السبب: خادم التخويل الخاص بك غير مدعوم.

  • التوصية: استخدم خادم تخويل يمكنه إرجاع الرموز المميزة بأنواع الرموز المميزة المدعومة.

رمز الخطأ: 20153 - OAuth2ClientIdColonNotAllowed

  • الرسالة: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

  • السبب: يتضمن مُعرّف العميل الخاص بك حرف غير صالح (:).

  • التوصية: استخدام مُعرّف عميل صالح.

رمز الخطأ: 20523 - ManagedIdentityCredentialObjectNotSupported

  • الرسالة: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • التوصية: تحقق من الإصدار المعتمد وترقية وقت تشغيل التكامل إلى إصدار أعلى.

رمز الخطأ: 20551 - QueryMissingFormatSettingsInDataset

  • الرسالة: The format settings are missing in dataset %dataSetName;.

  • السبب: نوع مجموعة البيانات ثنائي، وهو غير مدعوم.

  • التوصية: استخدام مجموعة بيانات محدد النص أو Json أو Avro أو Orc أو باركيه بدلاً من ذلك.

  • السبب: بالنسبة لتخزين الملفات، إعدادات التنسيق مفقودة في مجموعة البيانات.

  • التوصية: إلغاء تحديد "نسخة ثنائية" في مجموعة البيانات، وتعيين إعدادات التنسيق الصحيحة.

رمز الخطأ: 20552 - QueryUnsupportedCommandBehavior

  • الرسالة: The command behavior "%behavior;" is not supported.

  • التوصية: لا تقم بإضافة سلوك الأمر كمعلمة للمعاينة أو عنوان URL لطلب واجهة برمجة التطبيقات GetSchema.

رمز الخطأ: 20701 - DataConsistencyFailedToGetSourceFileMetadata

  • الرسالة: Failed to retrieve source file ('%name;') metadata to validate data consistency.

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

رمز الخطأ: 20703 - DataConsistencyFailedToGetSinkFileMetadata

  • الرسالة: Failed to retrieve sink file ('%name;') metadata to validate data consistency.

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

رمز الخطأ: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

  • الرسالة: Data consistency validation is not supported in current copy activity settings.

  • السبب: التحقق من صحة تناسق البيانات معتمد فقط في سيناريو النسخ الثنائي المباشر.

  • التوصية: إزالة الخاصية 'validateDataConsistency' في حمولة نشاط النسخ.

رمز الخطأ: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

  • الرسالة: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • التوصية: التحقق من إصدار وقت تشغيل التكامل المعتمد وترقيته إلى إصدار أعلى، أو إزالة خاصية "validateDataConsistency" من أنشطة النسخ.

رمز الخطأ: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy

  • الرسالة: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • التوصية: إزالة "fileMissing" من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: 20742 - 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 في حمولة نشاط النسخ.

رمز الخطأ: 20743 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

  • الرسالة: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • توصية: إزالة 'fileForbidden' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: 20744 - SkipForbiddenFileNotSupportedForThisConnector

  • الرسالة: Skip forbidden file is not supported for this connector: ('%connectorName;').

  • توصية: إزالة 'fileForbidden' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: 20745 - 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 في حمولة نشاط النسخ.

رمز الخطأ: 20746 - SkipInvalidFileNameNotSupportedForSource

  • الرسالة: Skip invalid file name is not supported for '%connectorName;' source.

  • التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: 20747 - SkipInvalidFileNameNotSupportedForSink

  • الرسالة: Skip invalid file name is not supported for '%connectorName;' sink.

  • التوصية: إزالة 'dataInconsistency' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy

  • الرسالة: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

  • التوصية: إزالة 'allErrorFile' من إعداد skipErrorFile في حمولة نشاط النسخ.

رمز الخطأ: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

  • الرسالة: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

  • التوصية: إزالة الإعداد 'deleteFilesAfterCompletion' أو استخدام نسخة ثنائية مباشرة.

رمز الخطأ: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector

  • الرسالة: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

  • التوصية: إزالة الإعداد 'deleteFilesAfterCompletion' في حمولة نشاط النسخ.

رمز الخطأ: 27002 - FailedToDownloadCustomPlugins

  • الرسالة: Failed to download custom plugins.

  • السبب: ارتباطات تحميل غير صالحة أو مشكلات اتصال عابرة.

  • التوصية: إعادة المحاولة إذا أظهرت الرسالة أنها مشكلة عابرة. إذا استمرت المشكلة، اتصل بفريق الدعم.

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

رمز الخطأ: 9611 - UserErrorOdbcInvalidQueryString

  • الرسالة: The following ODBC Query is not valid: '%'.

  • السبب: توفر استعلامًا خاطئًا أو غير صالح لإحضار البيانات/المخططات.

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

رمز الخطأ: 11775

  • الرسالة: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

  • السبب: يعتمد السبب الدقيق على النص الذي تم إرجاعه في '%'. إذا كان قد انتهت مهلة العملية، فقد يكون ذلك بسبب إيقاف مثيل PostgreSQL أو لأن أسلوب اتصال الشبكة الذي تم تكوينه لمثيلك لا يسمح بالاتصالات من وقت تشغيل التكامل المحدد. المستخدم أو كلمة المرور المقدمة غير صحيحة. إذا كان 28P01: فشلت مصادقة كلمة المرور للمستخدم <الذي يستخدمه>، فهذا يعني أن المستخدم المقدم غير موجود في المثيل أو أن كلمة المرور غير صحيحة. إذا كان 28000: لا يوجد إدخال pg_hba.conf للمضيف "###.##.###.#.###"، المستخدم "<youruser>"، قاعدة البيانات "<yourdatabase>"، بدون تشفير، فهذا يعني أن أسلوب التشفير المحدد غير متوافق مع تكوين الخادم.

  • التوصية: تأكد من وجود المستخدم المقدم في مثيل PostgreSQL وأن كلمة المرور تتوافق مع كلمة المرور المعينة حاليا لهذا المستخدم. تأكد من أن طريقة التشفير المحددة مقبولة من قبل مثيل PostgreSQL الخاص بك، استنادا إلى تكوينه الحالي. إذا تم تكوين أسلوب اتصال الشبكة للمثيل الخاص بك للوصول الخاص (تكامل الشبكة الظاهرية)، فاستخدم وقت تشغيل التكامل المستضاف ذاتيا (IR) للاتصال به. إذا تم تكوينه للوصول العام (عناوين IP المسموح بها)، فمن المستحسن استخدام وقت تشغيل تكامل Azure مع شبكة ظاهرية مدارة ونشر نقطة نهاية خاصة مدارة للاتصال بالمثيل الخاص بك. عند تكوينه للوصول العام (عناوين IP المسموح بها) يتكون بديل أقل موصى به في إنشاء قواعد جدار الحماية في المثيل الخاص بك للسماح بنسبة استخدام الشبكة التي تنشأ على عناوين IP المستخدمة من قبل وقت تشغيل تكامل Azure الذي تستخدمه.

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

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