استكشاف أخطاء Azure Data Factory وSynapse

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

تلميح

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

تستكشف هذه المقالة الأساليب الشائعة لاستكشاف أخطاء أنشطة التحكم الخارجي في مسارات Azure Data Factory وSynapse وإصلاحها.

الموصل ونشاط النسخ

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

Azure Databricks

رمز الخطأ: 3200

  • الرسالة: خطأ 403.

  • السبب: The Databricks access token has expired.

  • توصية: بشكل افتراضي، يكون الرمز المميز للوصول إلى Azure Databricks صالحاً لمدة 90 يوماً. قم بإنشاء رمز مميز جديد وتحديث الخدمة المرتبطة.

رمز الخطأ: 3201

  • الرسالة: Missing required field: settings.task.notebook_task.notebook_path.

  • السبب: Bad authoring: Notebook path not specified correctly.

  • التوصية: تحديد مسار دفتر الملاحظات في نشاط Databricks.


  • الرسالة: Cluster... does not exist.

  • السبب: Authoring error: Databricks cluster does not exist or has been deleted.

  • التوصية: تحقق من وجود مقطع تخزين Databricks.


  • الرسالة: Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.

  • السبب: Bad authoring.

  • التوصية: حدد المسارات المطلقة لمخططات معالجة مساحة العمل أو dbfs:/folder/subfolder/foo.py للملفات المخزنة في نظام ملفات Databricks (DFS).



  • الرسالة: {0} LinkedService should specify either existing cluster ID or new cluster information for creation.

  • السبب: Bad authoring.

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


  • الرسالة: Node type Standard_D16S_v3 is not supported. Supported node types: Standard_DS3_v2, Standard_DS4_v2, Standard_DS5_v2, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D64s_v3, Standard_D3_v2, Standard_D8_v3, Standard_D16_v3, Standard_D32_v3, Standard_D64_v3, Standard_D12_v2, Standard_D13_v2, Standard_D14_v2, Standard_D15_v2, Standard_DS12_v2, Standard_DS13_v2, Standard_DS14_v2, Standard_DS15_v2, Standard_E8s_v3, Standard_E16s_v3, Standard_E32s_v3, Standard_E64s_v3, Standard_L4s, Standard_L8s, Standard_L16s, Standard_L32s, Standard_F4s, Standard_F8s, Standard_F16s, Standard_H16, Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_NC12, Standard_NC24, Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_L8s_v2, Standard_L16s_v2, Standard_L32s_v2, Standard_L64s_v2, Standard_L80s_v2.

  • السبب: Bad authoring.

  • التوصية: ارجع إلى رسالة الخطأ.


رمز الخطأ: 3202

  • الرسالة: There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.

  • السبب: Too many Databricks runs in an hour.

  • التوصية: تحقق من كافة المسارات التي تستخدم مساحة عمل Databricks هذه للتعرّف على معدل إنشاء الوظائف الخاصة بها. إذا قامت المسارات بتشغيل عدد أكثر من اللازم من مرات تشغيل Databricks بشكل إجمالي، فقم بترحيل بعض المسارات إلى مساحة عمل جديدة.


  • الرسالة: Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.

  • السبب: Authoring error: No value provided for the parameter.

  • التوصية: فحص مسار JSON وتأكد من أن كل المعلمات في دفتر ملاحظات baseParameters تحدد قيمة غير فارغة.


  • الرسالة: User: 'SimpleUserContext{userId=..., name=user@company.com, orgId=...}' is not authorized to access cluster.

  • السبب: لا يُسمح للمستخدم الذي قام بإنشاء رمز الوصول المميز بالوصول إلى كتلة Databricks المحددة في الخدمة المرتبطة.

  • التوصية: تأكد من أن المستخدم لديه الأذونات المطلوبة في مساحة العمل.


  • الرسالة: Job is not fully initialized yet. Please retry later.

  • السبب: لم تتم تهيئة المهمة.

  • التوصية: انتظر وحاول مرة أخرى لاحقاً.

رمز الخطأ: 3203

  • الرسالة: The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.

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

  • التوصية: لتجنب هذا الخطأ، استخدم مقاطع تخزين وظائف.

رمز الخطأ: 3204

  • الرسالة: Job execution failed.

  • السبب: تشير رسائل الخطأ إلى مشكلات مختلفة، مثل حالة مقطع تخزين غير متوقعة أو نشاط معين. غالباً ما لا تظهر أي رسالة خطأ.

  • التوصية: غير معروفة

رمز الخطأ: 3208

  • الرسالة: An error occurred while sending the request.

  • السبب: تمت قطع اتصال شبكة الاتصال بخدمة Databricks.

  • التوصية: إذا كنت تستخدم وقت تشغيل تكامل ذاتي الاستضافة، فتأكد من أن اتصال الشبكة موثوق به من عُقد وقت تشغيل التكامل. إذا كنت تستخدم وقت تشغيل تكامل Azure، فعادةً ما تنجح إعادة المحاولة.

يبدأ إخراج تشغيل Boolean في الظهور كسلسلة بدلاً من int المتوقع

  • الأعراض: يبدأ إخراج تشغيل Boolean في الظهور كسلسلة (على سبيل المثال، "0" أو "1") بدلا من int المتوقع (على سبيل المثال، 0 أو 1).

    لقطة شاشة لمسار Databricks.

    لاحظتَ هذا التغيير في 28 سبتمبر 2021 في نحو الساعة 9 صباحاً بالتوقيت الرسمي للهند (IST) عندما بدأ مسارك المستند إلى هذا الإخراج في التعطل. لم يتم إجراء أي تغيير على البنية الأساسية لبرنامج ربط العمليات التجارية، ووصلت بيانات الإخراج المنطقية كما هو متوقع قبل الفشل.

    لقطة شاشة للفرق في الإخراج.

  • السبب: سبب هذه المشكلة تغيير حديث، وهو راجع إلى التصميم. بعد التغيير، إذا كانت النتيجة رقم يبدأ بصفر، فسيقوم Azure Data Factory بتحويل الرقم إلى القيمة الثمانية، وهو خطأ. هذا الرقم هو 0 أو 1 دائماً، ولم يسبب أي مشاكل قبل التغيير على الإطلاق. ومن ثمّ لإصلاح التحويل الثماني، يتم تمرير إخراج سلسلة من تشغيل دفتر الملاحظات كما هو.

  • التوصية: قم بتغيير شرط if إلى شيء من هذا القبيل if(value=="0").

Azure Data Lake Analytics

ينطبق الجدول التالي على U-SQL.

رمز الخطأ: 2709

  • الرسالة: The access token is from the wrong tenant.

  • السبب: مستأجر Microsoft Entra غير صحيح.

  • التوصية: مستأجر Microsoft Entra غير صحيح.


  • الرسالة: We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.

  • السبب: يحدث هذا الخطأ بسبب تقييد البيانات في تحليلات مستودع البيانات.

  • التوصية: تقليل عدد الوظائف المقدمة إلى تحليلات مستودع البيانات. إما تغيير المشغلات وإعدادات التزامن على الأنشطة، أو زيادة القيود المفروضة على تحليلات مستودع البيانات.


  • الرسالة: This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.

  • السبب: يحدث هذا الخطأ بسبب تقييد البيانات في تحليلات مستودع البيانات.

  • التوصية: تقليل عدد الوظائف المقدمة إلى تحليلات مستودع البيانات. إما تغيير المشغلات وإعدادات التزامن على الأنشطة، أو زيادة القيود المفروضة على تحليلات مستودع البيانات.

رمز الخطأ: 2705

  • الرسالة: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

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

  • التوصية: تحقق من أن كيان الخدمة أو الشهادة التي يوفرها المستخدم لوظائف تحليلات مستودع البيانات لها حق الوصول إلى كل من حساب تحليلات مستودع البيانات ومثيل Data Lake Store الافتراضي من المجلد الجذر.

رمز الخطأ: 2711

  • الرسالة: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

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

  • التوصية: تحقق من أن كيان الخدمة أو الشهادة التي يوفرها المستخدم لوظائف تحليلات مستودع البيانات لها حق الوصول إلى كل من حساب تحليلات مستودع البيانات ومثيل Data Lake Store الافتراضي من المجلد الجذر.


  • الرسالة: Cannot find the 'Azure Data Lake Store' file or folder.

  • السبب: المسار إلى ملف U-SQL غير صحيح، أو بيانات اعتماد الخدمة المرتبطة لا تتيح حق الوصول.

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

رمز الخطأ: 2704

  • الرسالة: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

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

  • التوصية: تحقق من أن كيان الخدمة أو الشهادة التي يوفرها المستخدم لوظائف تحليلات مستودع البيانات لها حق الوصول إلى كل من حساب تحليلات مستودع البيانات ومثيل Data Lake Store الافتراضي من المجلد الجذر.

رمز الخطأ: 2707

  • الرسالة: Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.

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

  • التوصية: تحقق من تقديم الحساب الصحيح.

رمز الخطأ: 2703

  • الرسالة: Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").

  • السبب: الخطأ من تحليلات مستودع البيانات.

  • التوصية: تم تقديم المهمة إلى تحليلات مستودع البيانات، والبرنامج النصي هناك، وقد فشل الاثنان. قم بإجراء تحقيق في تحليلات مستودع البيانات. في المدخل، انتقل إلى حساب تحليلات مستودع البيانات وابحث عن المهمة باستخدام معرف تشغيل نشاط Data Factory (لا تستخدم معرف تشغيل المسار). توفر المهمة هناك مزيداً من المعلومات حول الخطأ، وسوف تساعدك على استكشاف الأخطاء وإصلاحها.

    إذا لم يكن الحل واضحاً، فاتصل بفريق دعم تحليلات مستودع البيانات وقدم محدد موقع الموارد العالمي (URL) للوظيفة الذي يتضمن اسم الحساب ومعرف الوظيفة الخاصين بك.

Azure Functions

رمز الخطأ: 3602

  • الرسالة: Invalid HttpMethod: '%method;'.

  • السبب: لا يتوفر الدعم لأسلوب Http المحدد في حمولة النشاط بواسطة نشاط Azure Function.

  • التوصية: أساليب Http المدعومة هي: الوضع والنشر والحصول والحذف والخيارات والرأسية والتتبع.

رمز الخطأ: 3603

  • الرسالة: Response Content is not a valid JObject.

  • السبب: لم تُرجع دالة Azure التي تم استدعاؤها حمولة JSON في الرد. يدعم نشاط دالة Azure في مسار Azure Data Factory وSynapse محتوى استجابة JSON فقط.

  • التوصية: قم بتحديث الدالة Azure لإرجاع حمولة JSON صالحة مثل دالة C# التي قد تقوم بإرجاع (ActionResult)new OkObjectResult("{\"Id\":\"123\"}");

رمز الخطأ: 3606

  • الرسالة: نشاط دالة Azure يفتقد مفتاح الدالة.

  • السبب: تعريف نشاط دالة Azure غير مكتمل.

  • التوصية: تحقق من أن تعريف JSON لنشاط دالة Azure للإدخال يشتمل على خاصية باسم functionKey.

رمز الخطأ: 3607

  • الرسالة: Azure function activity missing function name.

  • السبب: تعريف نشاط دالة Azure غير مكتمل.

  • التوصية: تحقق من أن تعريف JSON لنشاط دالة Azure للإدخال يشتمل على خاصية باسم functionName.

رمز الخطأ: 3608

  • الرسالة: Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.

  • السبب: قد تكون تفاصيل الدالة Azure في تعريف النشاط غير صحيحة.

  • التوصية: قم بإصلاح تفاصيل دالة Azure وحاول مرة أخرى.

رمز الخطأ: 3609

  • الرسالة: Azure function activity missing functionAppUrl.

  • السبب: تعريف نشاط دالة Azure غير مكتمل.

  • التوصية: تحقق من أن تعريف JSON لنشاط دالة Azure للإدخال يشتمل على خاصية باسم functionAppUrl.

رمز الخطأ: 3610

  • الرسالة: There was an error while calling endpoint.

  • السبب: قد يكون عنوان URL للدالة غير صحيح.

  • التوصية: تحقق من صحة قيمة functionAppUrl في ملف JSON الخاص بالنشاط ثم حاول مرة أخرى.

رمز الخطأ: 3611

  • الرسالة: Azure function activity missing Method in JSON.

  • السبب: تعريف نشاط دالة Azure غير مكتمل.

  • التوصية: تحقق من أن تعريف JSON لنشاط دالة Azure للإدخال يشتمل على خاصية باسم method.

رمز الخطأ: 3612

  • الرسالة: Azure function activity missing LinkedService definition in JSON.

  • السبب: تعريف نشاط دالة Azure غير مكتمل.

  • التوصية: تحقق من أن تعريف JSON لنشاط دالة Azure للإدخال يشتمل على تفاصيل خدمة مرتبطة.

Azure Machine Learning  

رمز الخطأ: 4101

  • الرسالة: AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.

  • السبب: تنسيق غير صالح أو تعريف مفقود للخاصية %propertyName;.

  • التوصية: تحقق مما إذا كان النشاط %activityName; يحتوي على الخاصية %propertyName; المعرّفة ببيانات صحيحة.

رمز الخطأ: 4110

  • الرسالة: AzureMLExecutePipeline activity missing LinkedService definition in JSON.

  • السبب: تعريف النشاط AzureMLExecutePipeline غير مكتمل.

  • التوصية: تحقق من أن تعريف JSON لنشاط AzureMLExecutePipeline للإدخال يشتمل على تفاصيل خدمة مرتبطة بشكل صحيح.

رمز الخطأ: 4111

  • الرسالة: AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.

  • السبب: تعريف نشاط غير صحيح.

  • التوصية: تحقق من أن تعريف JSON لنشاط AzureMLExecutePipeline للإدخال يشتمل على تفاصيل خدمة مرتبطة بشكل صحيح.

رمز الخطأ: 4112

  • الرسالة: AzureMLService linked service has invalid value for property '%propertyName;'.

  • السبب: تنسيق غير صالح أو تعريف مفقود للخاصية '%propertyName;'.

  • التوصية: تحقق مما إذا كانت الخدمة المرتبطة تحتوي على الخاصية %propertyName; المعرفة ببيانات صحيحة.

رمز الخطأ: 4121

  • الرسالة: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • السبب: انتهت صلاحية بيانات الاعتماد المستخدمة للوصول إلى التعلم الآلي من Azure.

  • التوصية: تحقق من صلاحية بيانات الاعتماد ثم أعد المحاولة.

رمز الخطأ: 4122

  • الرسالة: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • السبب: بيانات الاعتماد المقدمة في خدمة التعلم الآلي من Azure المرتبطة غير صالحة أو لا تشتمل على إذن للعملية.

  • التوصية: تحقق من صلاحية بيانات الاعتماد في الخدمة المرتبطة، ولا تشتمل على إذن للوصول إلى التعلم الآلي من Azure.

رمز الخطأ: 4123

  • الرسالة: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • السبب: خصائص النشاط مثل pipelineParameters غير صالحة لمسار التعلم الآلي من Azure (ML).

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

رمز الخطأ: 4124

  • الرسالة: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • السبب: نقطة نهاية مسار Azure التعلم الآلي المنشورة غير موجودة.

  • التوصية: تحقق من أن نقطة نهاية مسار التعلم الآلي من Azure المنشورة والمحددة في "الخدمة المرتبطة" موجودة في التعلم الآلي من Azure.

رمز الخطأ: 4125

  • الرسالة: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • السبب: يوجد خطأ خادم في التعلم الآلي من Azure.

  • التوصية: قم بإعادة المحاولة لاحقاً. اتصل بفريق التعلم الآلي من Azure للحصول على تعليمات إذا استمرت المشكلة.

رمز الخطأ: 4126

  • الرسالة: Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Azure Machine Learning for more error logs.

  • السبب: فشل تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية التعلم الآلي Azure.

  • توصية: تحقق من التعلم الآلي من Azure لمزيد من سجلات الأخطاء، ثم قم بإصلاح مسار التعلم الآلي من Azure.

Azure Synapse Analytics

التعليمة البرمجية للخطأ: 3250

  • الرسالة: There are not enough resources available in the workspace, details: '%errorMessage;'

  • السبب: موارد غير كافية

  • التوصية: حاول إنهاء المهمة (المهام) قيد التشغيل في مساحة العمل، وتقليل أعداد vCores المطلوبة، أو زيادة الحصة النسبية لمساحة العمل أو استخدام مساحة عمل أخرى.

التعليمة البرمجية للخطأ: 3251

  • الرسالة: There are not enough resources available in the pool, details: '%errorMessage;'

  • السبب: موارد غير كافية

  • التوصية: حاول إنهاء المهمة (المهام) قيد التشغيل في التجمع، وتقليل أعداد vCores المطلوبة، أو زيادة الحد الأقصى لحجم التجمع أو استخدام تجمع آخر.

التعليمة البرمجية للخطأ: 3252

  • الرسالة: There are not enough vcores available for your spark job, details: '%errorMessage;'

  • السبب: الذاكرات الأساسية الظاهرية غير كافية

  • التوصية: حاول تقليل أعداد vCores المطلوبة أو زيادة الحصة النسبية لـvCore. لمزيد من المعلومات، راجع مفاهيم Apache Spark الأساسية.

التعليمة البرمجية للخطأ: 3253

  • الرسالة: There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.

  • السبب: تم الوصول إلى حد التقييد.

  • التوصية: أعد محاولة الطلب بعد فترة انتظار.

التعليمة البرمجية للخطأ: 3254

  • الرسالة: AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.

  • السبب: تنسيق غير صالح أو تعريف مفقود للخاصية '%propertyName;'.

  • التوصية: تحقق مما إذا كانت الخدمة المرتبطة تحتوي على الخاصية '%propertyName;' المعرفة ببيانات صحيحة.

عام

رمز الخطأ: 2103

  • الرسالة: Please provide value for the required property '%propertyName;'.

  • السبب: لم يتم توفير القيمة المطلوبة للخاصية.

  • التوصية: قم بتوفير القيمة من الرسالة ثم حاول مرةً أخرى.

رمز الخطأ: 2104

  • الرسالة: The type of the property '%propertyName;' is incorrect.

  • السبب: نوع الخاصية المقدمة غير صحيح.

  • التوصية: قم بإصلاح نوع الخاصية ثم حاول مرةً أخرى.

رمز الخطأ: 2105

  • الرسالة: An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.

  • السبب: قيمة الخاصية غير صالحة أو ليست بالتنسيق المتوقع.

  • التوصية: قم بالرجوع إلى الوثائق الخاصة بالخاصية والتحقق من أن القيمة المقدمة تتضمن التنسيق والنوع الصحيحين.

رمز الخطأ: 2106

  • الرسالة: The storage connection string is invalid. %errorMessage;

  • السبب: سلسلة الاتصال للتخزين غير صالحة أو تتميز بتنسيق غير صحيح.

  • التوصية: انتقل إلى مدخل Microsoft Azure وابحث عن التخزين، ثم انسخ سلسلة الاتصال وقم بلصقها في الخدمة المرتبطة وحاول مرةً أخرى.

رمز الخطأ: 2110

  • الرسالة: The linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.

  • السبب: الخدمة المرتبطة المحددة في النشاط غير صحيحة.

  • التوصية: تحقق من أن نوع الخدمة المرتبطة هو أحد الأنواع المدعومة للنشاط. على سبيل المثال، يمكن أن يكون نوع الخدمة المرتبطة لأنشطة HDI هو HDInsight أو HDInsightOnDemand.

رمز الخطأ: 2111

  • الرسالة: The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.

  • السبب: نوع الخاصية المقدمة غير صحيح.

  • التوصية: قم بإصلاح نوع الخاصية ثم حاول مرةً أخرى.

رمز الخطأ: 2112

  • الرسالة: The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.

  • السبب: نوع السحابة غير مدعوم أو تعذر تحديده للتخزين من EndpointSuffix.

  • التوصية: قم باستخدام التخزين في سحابة أخرى وحاول مرةً أخرى.

مخصص

ينطبق الجدول التالي على Azure Batch.

رمز الخطأ: 2500

  • الرسالة: Hit unexpected exception and execution failed.

  • السبب: Can't launch command, or the program returned an error code.

  • التوصية: تأكد من وجود الملف القابل للتنفيذ. إذا بدأ البرنامج، فتحقق من أنه تم تحميل stdout.txt وstderr.txt إلى حساب التخزين. من الجيد تضمين السجلات في التعليمة البرمجية لتصحيح الأخطاء.

رمز الخطأ: 2501

  • الرسالة: Cannot access user batch account; please check batch account settings.

  • السبب: مفتاح وصول دفعة أو اسم مجموعة غير صحيح.

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

رمز الخطأ: 2502

  • الرسالة: Cannot access user storage account; please check storage account settings.

  • السبب: اسم حساب تخزين أو مفتاح وصول غير صحيح.

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

رمز الخطأ: 2504

  • الرسالة: Operation returned an invalid status code 'BadRequest'.

  • السبب: عدد أكبر من اللازم من الملفات في folderPath الخاص بالنشاط المخصص. لا يمكن أن يكون الحجم الإجمالي لـ resourceFiles أكبر من 32768 حرفاً.

  • التوصية: قم بإزالة الملفات غير الضرورية، أو قم بضغطها وإضافة أمر فك ضغط لاستخراجها.

    على سبيل المثال، عليك استخدام powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe

رمز الخطأ: 2505

  • الرسالة: Cannot create Shared Access Signature unless Account Key credentials are used.

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

  • التوصية: راجع رسالة الخطأ.

رمز الخطأ: 2507

  • الرسالة: The folder path does not exist or is empty: ...

  • السبب: لا توجد ملفات في حساب التخزين في المسار المحدد.

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

رمز الخطأ: 2508

  • الرسالة: There are duplicate files in the resource folder.

  • السبب: توجد ملفات متعددة تحمل الاسم نفسه في مجلدات فرعية مختلفة لمسار المجلد.

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

    على سبيل المثال، عليك استخدام powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe

رمز الخطأ: 2509

  • الرسالة: Batch url ... is invalid; it must be in Uri format.

  • السبب: يجب أن تكون عناوين URL للدفعة مشابهة لـ https://mybatchaccount.eastus.batch.azure.com

  • التوصية: راجع رسالة الخطأ.

رمز الخطأ: 2510

  • الرسالة: An error occurred while sending the request.

  • السبب: عنوان URL للدفعة غير صالح.

  • التوصية: تحقق من عنوان URL للدفعة.

HDInsight

رمز الخطأ: 206

  • الرسالة: The batch ID for Spark job is invalid. Please retry your job.

  • السبب: حدثت مشكلة داخلية بخصوص الخدمة وتسببت في حدوث هذا الخطأ.

  • التوصية: قد تكون هذه المشكلة مؤقتة. أعد محاولة إنجاز مهمتك بعد بعض الوقت.

رمز الخطأ: 207

  • الرسالة: Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.

  • السبب: حدث خطأ داخلي أثناء محاولة تحديد المنطقة من حساب التخزين الأساسي.

  • التوصية: جرب موقع تخزين آخر.

رمز الخطأ: 208

  • الرسالة: Service Principal or the MSI authenticator are not instantiated. Please consider providing a Service Principal in the HDI on demand linked service which has permissions to create an HDInsight cluster in the provided subscription and try again.

  • السبب: حدث خطأ داخلي أثناء محاولة قراءة "كيان الخدمة" أو إنشاء مثيل لمصادقة MSI.

  • التوصية: انظر في توفير كيان خدمة تكون لديه أذونات لإنشاء مقطع تخزين HDInsight في الاشتراك المقدم وحاول مرةً أخرى. تحقق من إعداد إدارة هويات بشكل صحيح.

رمز الخطأ: 2300

  • الرسالة: Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.

  • السبب: تحتوي رسالة الخطأ على رسالة مشابهة لـ The remote name could not be resolved.. قد يكون URI لمقطع التخزين المقدم غير صالح.

  • التوصية: تحقق من أن مقطع التخزين لم يتم حذفه، وأن URI المقدم صحيح. عند فتح URI في مستعرض، يجب أن تشاهد واجهة مستخدم Ambari. إذا كان مقطع التخزين في شبكة ظاهرية، يجب أن يكون URI من النوع الخاص. لفتحه، استخدم جهازاً ظاهريّاً (VM) يمثل جزءاً من الشبكة الظاهرية نفسها.

    لمزيد من المعلومات، راجع الاتصال المباشر بخدمات Apache Hadoop.


  • السبب: إذا كانت رسالة الخطأ تحتوي على رسالة مشابهة لـ A task was canceled.، فإن مهلة إرسال المهمة قد انقضت.

  • التوصية: يمكن أن تكون المشكلة اتصال HDInsight عاماً أو اتصال شبكة. تأكد أولاً من توفر واجهة مستخدم HDInsight Ambari من أي مستعرض. تحقق بعد ذلك من أن بيانات الاعتماد الخاصة بك لا تزال صالحة.

    إذا كنت تستخدم وقت تشغيل التكامل المستضاف ذاتياً (IR)، فقم بتنفيذ هذه الخطوة من الجهاز الظاهري أو الجهاز حيث يتم تثبيت وقت تشغيل التكامل الذاتية الاستضافة. جرّب بعد ذلك إرسال المهمة مرة أخرى.

    لمزيد من المعلومات، تفضل بقراء واجهة مستخدم الويب Ambari.


  • السبب: عندما تحتوي رسالة الخطأ على رسالة مشابهة لـ User admin is locked out in Ambari أو Unauthorized: Ambari user name or password is incorrect، فإن بيانات الاعتماد لـ HDInsight تكون غير صحيحة أو انتهت صلاحيتها.

  • التوصية: قم بتصحيح بيانات الاعتماد وإعادة نشر الخدمة المرتبطة. تحقق أولاً من أن بيانات الاعتماد تعمل على HDInsight عن طريق فتح URI لمقطع التخزين في أي مستعرض ومحاولة تسجيل الدخول. إذا لم تعمل بيانات الاعتماد، يمكنك إعادة تعيينها من مدخل Microsoft Azure.

    بالنسبة إلى مقطع تخزين ESP، قم بإعادة تعيين كلمة المرور من خلال إعادة تعيين كلمة مرور الخدمة الذاتية.


  • السبب: عندما تحتوي رسالة الخطأ على رسالة مشابهة لـ 502 - Web server received an invalid response while acting as a gateway or proxy server، فإن هذا الخطأ سيتم إرجاعه بواسطة خدمة HDInsight.

  • التوصية: غالباً ما يحدث خطأ 502 عند إيقاف تشغيل عملية خادم Ambari. يمكنك إعادة تشغيل خدمات Ambari عن طريق إعادة تمهيد عُقدة الرأس.

    1. قم بالاتصال بإحدى العقد الخاصة بك على HDInsight باستخدام SSH.

    2. قم بتحديد مضيف عقدة الرأس النشط عن طريق تشغيل ping headnodehost.

    3. قم بالاتصال بعقدة الرأس النشط الخاصة بك أن خادم Ambari يتم إرساؤه على عقدة الرأس النشط باستخدام SSH.

    4. قم بإعادة تشغيل عُقدة الرأس النشط.

      لمزيد من المعلومات، طالع وثائق استكشاف أخطاء Azure HDInsight وإصلاحها. على سبيل المثال:


  • السبب: عندما تحتوي رسالة الخطأ على رسالة مشابهة لـ Unable to service the submit job request as templeton service is busy with too many submit job requests أو Queue root.joblauncher already has 500 applications, cannot accept submission of application، فإن مهاماً أكثر مما يلزم يتم إرسالها إلى HDInsight في الوقت نفسه.

  • التوصية: احرص على الحد من عدد الوظائف المتزامنة المقدمة إلى HDInsight. راجع تزامن النشاط إذا كانت المهام يجري إرسالها من قِبل النشاط نفسه. قم بتغيير المشغلات بحيث يتم توزيع عمليات تشغيل المسارات المتزامنة بمرور الوقت.

    راجع وثائق HDInsight لضبط templeton.parallellism.job.submit كما يقترح الخطأ.

رمز الخطأ: 2301

  • الرسالة: Could not get the status of the application '%physicalJobId;' from the HDInsight service. Received the following error: %message;. Please refer to HDInsight troubleshooting documentation or contact their support for further assistance.

  • السبب: يواجه مقطع تخزين HDInsight أو الخدمة مشكلات.

  • التوصية: يحدث هذا الخطأ عندما لا تتلقى الخدمة استجابة من مقطع تخزين HDInsight عند محاولة طلب حالة المهمة قيد التشغيل. قد تكون هذه المشكلة بخصوص مقطع التخزين نفسه، أو ربما تكون خدمة HDInsight تواجه انقطاعاً.

    راجع وثائق استكشاف أخطاء HDInsight وإصلاحها، أو اتصل بدعم Microsoft للحصول على مزيد من المساعدة.

رمز الخطأ: 2302

  • الرسالة: Hadoop job failed with exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Contact HDInsight team for further support.

  • السبب: تم إرسال المهمة إلى مقطع تخزين HDI وحدث الفشل هناك.

  • التوصية:

  1. تحقق من واجهة مستخدم Ambari:
    1. تأكد من استمرار تشغيل كل الخدمات.
    2. من واجهة مستخدم Ambari، تحقق من قسم التنبيهات في لوحة المعلومات.
      1. لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
    3. قم بمراجعة ذاكرة YARN الخاصة بك. إذا كانت ذاكرة YARN لديك عالية، فقد تتأخر معالجة مهامك. إذا لم يكن لديك موارد كافية لاستيعاب تطبيق/مهمة Spark لديك، فقم بتوسيع سعة مقطع التخزين للتأكد من أن المقطع يحتوي على ذاكرة وذاكرات أساسية كافية.
  2. قم بتشغيل مهمة اختبار نموذج.
    1. إذا قمت بتشغيل المهمة نفسها في النهاية الخلفية لـ HDInsight، فتحقق من أنها تكللت بالنجاح. للحصول على أمثلة لعمليات تشغيل النماذج، فراجع تشغيل نماذج MapReduce المضمنة في HDInsight
  3. إذا استمرت المهمة في الفشل على HDInsight، فتحقق من سجلات التطبيق والمعلومات التي يجب توفيرها إلى الدعم:
    1. تحقق مما إذا كان المهمة قد تم تقديمها إلى YARN. إذا لم تكن المهمة قد تم تقديمها إلى YARN، فاستخدم --master yarn.
    2. إذا كان التطبيق قد انتهى من التنفيذ، فاجمع وقت البدء ووقت الانتهاء لتطبيق YARN. إذا لم يكن التطبيق قد أكمل التنفيذ، فاجمع وقت البدء/وقت التشغيل.
    3. تحقق من سجل التطبيق واجمعه باستخدام yarn logs -applicationId <Insert_Your_Application_ID>.
    4. تحقق من سجلات إدارة موارد YARN وقم بجمعها ضمن الدليل /var/log/hadoop-yarn/yarn.
    5. إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight للحصول على الدعم وتوفير السجلات والطوابع الزمنية أعلاه.

رمز الخطأ: 2303

  • الرسالة: Hadoop job failed with transient exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Try again or contact HDInsight team for further support.

  • السبب: تم إرسال المهمة إلى مقطع تخزين HDI وحدث الفشل هناك.

  • التوصية:

  1. تحقق من واجهة مستخدم Ambari:
    1. تأكد من استمرار تشغيل كل الخدمات.
    2. من واجهة مستخدم Ambari، تحقق من قسم التنبيهات في لوحة المعلومات.
      1. لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
    3. قم بمراجعة ذاكرة YARN الخاصة بك. إذا كانت ذاكرة YARN لديك عالية، فقد تتأخر معالجة مهامك. إذا لم يكن لديك موارد كافية لاستيعاب تطبيق/مهمة Spark لديك، فقم بتوسيع سعة مقطع التخزين للتأكد من أن المقطع يحتوي على ذاكرة وذاكرات أساسية كافية.
  2. قم بتشغيل مهمة اختبار نموذج.
    1. إذا قمت بتشغيل المهمة نفسها في النهاية الخلفية لـ HDInsight، فتحقق من أنها تكللت بالنجاح. للحصول على أمثلة لعمليات تشغيل النماذج، فراجع تشغيل نماذج MapReduce المضمنة في HDInsight
  3. إذا استمرت المهمة في الفشل على HDInsight، فتحقق من سجلات التطبيق والمعلومات التي يجب توفيرها إلى الدعم:
    1. تحقق مما إذا كان المهمة قد تم تقديمها إلى YARN. إذا لم تكن المهمة قد تم تقديمها إلى YARN، فاستخدم --master yarn.
    2. إذا كان التطبيق قد انتهى من التنفيذ، فاجمع وقت البدء ووقت الانتهاء لتطبيق YARN. إذا لم يكن التطبيق قد أكمل التنفيذ، فاجمع وقت البدء/وقت التشغيل.
    3. تحقق من سجل التطبيق واجمعه باستخدام yarn logs -applicationId <Insert_Your_Application_ID>.
    4. تحقق من سجلات إدارة موارد YARN وقم بجمعها ضمن الدليل /var/log/hadoop-yarn/yarn.
    5. إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight للحصول على الدعم وتوفير السجلات والطوابع الزمنية أعلاه.

رمز الخطأ: 2304

  • الرسالة: MSI authentication is not supported on storages for HDI activities.

  • السبب: يتم تكوين خدمات التخزين المرتبطة المستخدمة في الخدمة المرتبطة HDInsight (HDI) أو نشاط HDI باستخدام مصادقة MSI غير المدعومة.

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

رمز الخطأ: 2305

  • الرسالة: Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'

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

  • التوصية: تحقق من صحة معلومات المستخدم، ومن أنه يمكن فتح واجهة مستخدم Ambari لنظام مجموعة HDI في أي مستعرض من الجهاز الظاهري حيث يتم تثبيت IR (لوقت تشغيل التكامل المستضاف ذاتياً)، أو يمكن فتحها من أي جهاز (لـ Azure IR).

رمز الخطأ: 2306

  • الرسالة: An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'

  • السبب: JSON المتوفر لإجراء البرنامج النصي غير صالح.

  • التوصية: من المفترض أن تساعد رسالة الخطأ على تحديد المشكلة. قم بإصلاح تكوين json ثم حاول مرة أخرى.

    راجع خدمة Azure HDInsight المرتبطة عند الطلب للحصول على مزيد من المعلومات.

رمز الخطأ: 2310

  • الرسالة: Failed to submit Spark job. Error: '%message;'

  • السبب: حاولت الخدمة إنشاء دفعة على مقطع تخزين Spark باستخدام واجهة برمجة التطبيقات Livy (livy/الدفعة)، ولكنها حصلت على خطأ.

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

    لمزيد من المعلومات حول كيفية تجميع السجل الكامل، راجع الحصول على السجل الكامل لوظيفة دفعية.

رمز الخطأ: 2312

  • الرسالة: Spark job failed, batch id:%batchId;. Please follow the links in the activity run Output from the service Monitoring page to troubleshoot the run on HDInsight Spark cluster. Please contact HDInsight support team for further assistance.

  • السبب: فشلت المهمة على مقطع تخزين HDInsight Spark.

  • توصية: اتبع الارتباطات في إخراج تشغيل النشاط في صفحة مراقبة الخدمة لاستكشاف أخطاء التشغيل على نظام مجموعة HDInsight Spark وإصلاحها. اتصل بفريق دعم HDInsight للحصول على مزيد من المساعدة.

    لمزيد من المعلومات حول كيفية تجميع السجل الكامل، راجع الحصول على السجل الكامل لوظيفة دفعية.

رمز الخطأ: 2313

  • الرسالة: The batch with ID '%batchId;' was not found on Spark cluster. Open the Spark History UI and try to find it there. Contact HDInsight support for further assistance.

  • السبب: تم حذف الدفعة على مقطع تخزين HDInsight Spark.

  • التوصية: قم باستكشاف أخطاء الدفعات على مقطع تخزين HDInsight Spark وإصلاحها. اتصل بدعم HDInsight للحصول على مزيد من المساعدة.

    لمزيد من المعلومات حول كيفية تجميع السجل الكامل، راجع الحصول على السجل الكامل لوظيفة دفعية، وشارك السجل الكامل مع فريق دعم HDInsight للحصول على مزيد من المساعدة.

رمز الخطأ: 2328

  • الرسالة: Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • السبب: ستظهر رسالة الخطأ تفاصيل ما حدث من أخطاء.

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

رمز الخطأ: 2329

  • الرسالة: Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • السبب: ستظهر رسالة الخطأ تفاصيل ما حدث من أخطاء.

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

رمز الخطأ: 2331

  • الرسالة: The file path should not be null or empty.

  • السبب: مسار الملف المقدم فارغ.

  • التوصية: قم بتقديم مسار موجود للملف.

رمز الخطأ: 2340

  • الرسالة: HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.

  • السبب: لا تدعم الخدمة المرتبطة HDInsightOnDemand التنفيذ عبر IR الذاتي الاستضافة.

  • التوصية: حدد Azure IR وحاول مرة أخرى.

رمز الخطأ: 2341

  • الرسالة: HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.

  • السبب: عنوان URL المقدم ليس بالتنسيق الصحيح.

  • التوصية: قم بإصلاح عنوان URL لمقطع التخزين وحاول مرة أخرى.

رمز الخطأ: 2342

  • الرسالة: Failed to connect to HDInsight cluster: '%errorMessage;'.

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

  • التوصية:

    1. تحقق من صحة بيانات الاعتماد عن طريق فتح واجهة مستخدم Ambari لمقطع تخزين HDInsight في أي مستعرض.

    2. إذا كان مقطع التخزين في الشبكة الظاهرية (VNet) ويتم استخدام وقت تشغيل التكامل المستضاف ذاتياً، يجب أن يكون عنوان URL لـ HDI عنوان URL خاصّاً في VNets، ويجب أن يكون -int وارداً بعد اسم مقطع التخزين.

      على سبيل المثال، قم بتغيير https://mycluster.azurehdinsight.net/ إلى https://mycluster-int.azurehdinsight.net/. لاحظ أن -int بعد mycluster، ولكنه قبل .azurehdinsight.net

    3. إذا كان مقطع التخزين في VNet، فإن وقت تشغيل التكامل المستضاف ذاتياً يجري استخدامه، وتم استخدام عنوان URL الخاص، ومع ذلك فشل الاتصال، ومن ثم واجه الجهاز الظاهري حيث يتم تثبيت IR مشاكل في الاتصال بـ HDI.

      قم بالاتصال بالجهاز الظاهري الذي يتم تثبيت IR فيه وافتح واجهة مستخدم Ambari في أي مستعرض. استخدم عنوان URL الخاص لمقطع التخزين. يجب أن يعمل هذا الاتصال من المستعرض. إذا لم يحدث هذا، فاتصل بفريق دعم HDInsight لمزيد من المساعدة.

    4. إذا لم يتم استخدام وقت تشغيل التكامل المستضاف ذاتياً، يجب أن يكون مقطع تخزين HDI قابلاً للوصول بشكل عام. افتح واجهة مستخدم Ambari في المستعرض وتحقق من أنه ينفتح. إذا كانت هناك أي مشاكل مع مقطع التخزين أو الخدمات الموجودة عليه، فاتصل بفريق دعم HDInsight للحصول على المساعدة.

      يجب أن يكون عنوان URL الخاص بمقطع تخزين HDI المستخدَم في الخدمة المرتبطة متاحاً لوصول IR (مستضاف ذاتيّاً أو Azure) لكي ينجح الاتصال التجريبي، ولكي تعمل عمليات التشغيل. يمكن التحقق من هذه الحالة عن طريق فتح عنوان URL من مستعرض في جهاز ظاهري أو أي جهاز عام.

رمز الخطأ: 2343

  • الرسالة: User name and password cannot be null or empty to connect to the HDInsight cluster.

  • السبب: اسم المستخدم فارغ أو كلمة المرور فارغة.

  • التوصية: قم بتوفير بيانات الاعتماد الصحيحة للاتصال بـ HDI وحاول مرةً أخرى.

رمز الخطأ: 2345

  • الرسالة: Failed to read the content of the hive script. Error: '%message;'

  • السبب: ملف البرنامج النصي غير موجود أو تعذر على الخدمة الاتصال بموقع البرنامج النصي.

  • التوصية: تحقق من وجود البرنامج النصي، ومن أن الخدمة المرتبطة والمقترنة لديها بيانات الاعتماد المناسبة للاتصال.

رمز الخطأ: 2346

  • الرسالة: Failed to create ODBC connection to the HDI cluster with error message '%message;'.

  • السبب: حاولت الخدمة إنشاء اتصال من نوع "اتصال قاعدة البيانات المفتوح (ODBC)" بمقطع تخزين HDI، وفشلت مع وجود خطأ.

  • التوصية:

    1. تأكد من إعداد الاتصال المسمى "اتصال قاعدة البيانات المفتوح (JDBC)/Java" بشكل صحيح.
      1. بالنسبة إلى JDBC، إذا كنت تستخدم الشبكة الظاهرية نفسها، يمكنك الحصول على هذا الاتصال من:
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. للتأكد من أن لديك إعداد JDBC الصحيح، راجع استعلام Apache Hive من خلال برنامج تشغيل JDBC في HDInsight.
      3. بالنسبة إلى قاعدة البيانات المفتوحة (ODB)، راجع البرنامج التعليمي: استعلام Apache Hive باستخدام ODBC وPowerShell للتأكد من أن لديك الإعداد الصحيح.
    2. تحقق من أن Hiveserver2 وHive Metastore وHiveserver2 Interactive نشطة وتعمل.
    3. تحقق من واجهة مستخدم Ambari (UI):
      1. تأكد من استمرار تشغيل كل الخدمات.
      2. من واجهة مستخدم Ambari، تحقق من قسم التنبيه في لوحة المعلومات.
        1. لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
    4. إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight.

رمز الخطأ: 2347

  • الرسالة: Hive execution through ODBC failed with error message '%message;'.

  • السبب: قامت الخدمة بإرسال البرنامج النصي للخلية من أجل التنفيذ إلى مقطع تخزين HDI عبر اتصال ODBC، وفشل البرنامج النصي على HDI.

  • التوصية:

    1. تأكد من إعداد الاتصال المسمى "اتصال قاعدة البيانات المفتوح (JDBC)/Java" بشكل صحيح.
      1. بالنسبة إلى JDBC، إذا كنت تستخدم الشبكة الظاهرية نفسها، يمكنك الحصول على هذا الاتصال من:
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. للتأكد من أن لديك إعداد JDBC الصحيح، راجع استعلام Apache Hive من خلال برنامج تشغيل JDBC في HDInsight.
      3. بالنسبة إلى قاعدة البيانات المفتوحة (ODB)، راجع البرنامج التعليمي: استعلام Apache Hive باستخدام ODBC وPowerShell للتأكد من أن لديك الإعداد الصحيح.
    2. تحقق من أن Hiveserver2 وHive Metastore وHiveserver2 Interactive نشطة وتعمل.
    3. تحقق من واجهة مستخدم Ambari (UI):
      1. تأكد من استمرار تشغيل كل الخدمات.
      2. من واجهة مستخدم Ambari، تحقق من قسم التنبيه في لوحة المعلومات.
        1. لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
    4. إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight.

رمز الخطأ: 2348

  • الرسالة: The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.

  • السبب: لم يتم تعيين خصائص الخدمة المرتبطة للتخزين بشكل صحيح.

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

رمز الخطأ: 2350

  • الرسالة: Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'

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

  • التوصية: يحدث هذا الخطأ عندما تقوم الخدمة بإعداد أنشطة HDI، وتحاول نسخ الملفات إلى التخزين الرئيسي قبل إرسال المهمة إلى HDI. تحقق من وجود الملفات في الموقع المقدم، ومن صحة اتصال التخزين. وبما أن أنشطة HDI لا تدعم مصادقة MSI على حسابات التخزين المتعلقة بأنشطة HDI، تحقق من أن تلك الخدمات المرتبطة تحتوي على مفاتيح كاملة أو تستخدم Azure Key Vault.

رمز الخطأ: 2351

  • الرسالة: Could not open the file '%filePath;' in container/fileSystem '%container;'.

  • السبب: الملف غير موجود في المسار المحدد.

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

رمز الخطأ: 2352

  • الرسالة: The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.

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

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

رمز الخطأ: 2353

  • الرسالة: The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.

  • السبب: لم يتم تعيين خصائص الخدمة المرتبطة لتخزين البرنامج النصي بشكل صحيح.

  • التوصية: تحقق من تكوين خصائص الخدمة المرتبطة بتخزين البرنامج النصي بشكل صحيح.

رمز الخطأ: 2354

  • الرسالة: The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.

  • السبب: نوع الخدمة المرتبطة بالتخزين غير مدعوم من قبل النشاط.

  • التوصية: تحقق من أن نوع الخدمة المرتبطة المحدد هو أحد الأنواع المدعومة للنشاط. تدعم أنشطة HDI خدمات تخزين Azure Blob وAzure Blob FS المرتبطة.

    لمزيد من المعلومات، اقرأ مقارنة بين خيارات التخزين للاستخدام مع مقاطع تخزين Azure HDInsight

رمز الخطأ: 2355

  • الرسالة: The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.

  • السبب: القيمة المقدمة من أجل commandEnvironment غير صحيحة.

  • التوصية: تحقق من أن القيمة المقدمة مشابهة لما يلي:

    \"variableName=variableValue\"
    ]
    

    تحقق أيضاً من ظهور كل متغير في القائمة مرة واحدة فقط.

رمز الخطأ: 2356

  • الرسالة: The commandEnvironment already contains a variable named '%variableName;'.

  • السبب: القيمة المقدمة من أجل commandEnvironment غير صحيحة.

  • التوصية: تحقق من أن القيمة المقدمة مشابهة لما يلي:

    \"variableName=variableValue\"
    ]
    

    تحقق أيضاً من ظهور كل متغير في القائمة مرة واحدة فقط.

رمز الخطأ: 2357

  • الرسالة: The certificate or password is wrong for ADLS Gen 1 storage.

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

  • التوصية: تحقق من أن معلومات الاتصال في ADLS Gen 1 مرتبطة بالخدمة، وتحقق من نجاح الاتصال التجريبي.

رمز الخطأ: 2358

  • الرسالة: The value '%value;' for the required property 'TimeToLive' in the on demand HDInsight linked service '%linkedServiceName;' has invalid format. It should be a timespan between '00:05:00' and '24:00:00'.

  • السبب: القيمة المقدمة للخاصية TimeToLive المطلوبة لها تنسيق غير صالح.

  • التوصية: قم بتحديث القيمة إلى النطاق المقترح وحاول مرةً أخرى.

رمز الخطأ: 2359

  • الرسالة: The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.

  • السبب: القيمة المقدمة للخاصية roles غير صالحة.

  • التوصية: قم بتحديث القيمة لتكون أحد الاقتراحات وحاول مرة أخرى.

رمز الخطأ: 2360

  • الرسالة: The connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

  • السبب: سلسلة الاتصال المقدمة لـ HCatalogLinkedService غير صالحة.

  • التوصية: قم بتحديث القيمة إلى سلسلة اتصال Azure SQL الصحيحة ثم حاول مرةً أخرى.

رمز الخطأ: 2361

  • الرسالة: Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.

  • السبب: فشل إنشاء مقطع التخزين، ولم يظهر خطأ للخدمة من خدمة HDInsight.

  • التوصية: افتح مدخل Microsoft Azure وحاول العثور على مورد HDI الذي يحمل الاسم المقدم، ثم تحقق من حالة التوريد. اتصل بفريق دعم HDInsight للحصول على مزيد من المساعدة.

رمز الخطأ: 2362

  • الرسالة: Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.

  • السبب: التخزين الإضافي المقدم لم يكن تخزين Azure Blob.

  • التوصية: قم بتوفير حساب تخزين Azure Blob كمكان تخزين إضافي لخدمة HDInsight المرتبطة عند الطلب.

خطأ SSL عند ربط الخدمة باستخدام مقطع تخزين ESP HDInsight

  • الرسالة: Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'

  • السبب: المشكلة مرتبطة على الأرجح بـ System Trust Store.

  • الدقة: يمكنك التنقل إلى المسار Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib وفتح DriverConfiguration64.exe لتغيير الإعداد.

    إلغاء تحديد استخدام System Trust Store

توقف نشاط HDI في التحضير لنظام المجموعة

إذا كان نشاط HDI عالقًا في التحضير لنظام المجموعة، فاتبع الإرشادات أدناه:

  1. تأكد من أن المهلة أكبر مما هو موضح أدناه وانتظر حتى يكتمل التنفيذ أو حتى انتهاء المهلة، وانتظر وقت البقاء (TTL) قبل إرسال مهام جديدة.

    الحد الأقصى للوقت الافتراضي الذي يستغرقه تدوير نظام المجموعة هو ساعتين، وإذا كان لديك أي برنامج نصي init، فسيتم جمعه، حتى ساعتين أخريين.

  2. تأكد من توفير التخزين وHDI في نفس المنطقة.

  3. تأكد من أن كيان الخدمة المستخدم للوصول إلى مجموعة HDI صالح.

  4. إذا استمرت المشكلة، كحل بديل، فاحذف الخدمة المرتبطة بـ HDI وأعد إنشائها باسم جديد.

نشاط الويب

رمز الخطأ: 2001

  • الرسالة: The length of execution output is over limit (around 4MB currently).

  • السبب: إخراج التنفيذ أكبر من 4 ميغابايت في الحجم ولكن الحد الأقصى لحجم حمولة استجابة الإخراج المدعوم هو 4 ميغابايت.

  • التوصية: تأكد من أن حجم إخراج التنفيذ لا يتجاوز 4 ميغابايت. لمزيد من المعلومات، راجع كيفية توسيع نطاق نقل البيانات باستخدام Azure Data Factory.

رمز الخطأ: 2002

  • الرسالة: The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

  • السبب: الحمولة التي تحاول إرسالها كبيرة جدًا.

  • التوصية: الرجوع إلى Payload كبير جدًا.

رمز الخطأ: 2003

  • الرسالة: There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.

  • السبب: يتم تشغيل عدد كبير جدا من الأنشطة بشكل متزامن. يمكن أن يحدث هذا عند تشغيل عدد كبير جدًا من المسارات في وقت واحد.

  • التوصية: تقليل تزامن التدفقات. قد تضطر إلى توزيع وقت تشغيل التدفقات الخاصة بك.

رمز الخطأ: 2010

  • الرسالة: The Self-hosted Integration Runtime ‘<SHIR name>’ is offline

  • السبب: وقت تشغيل التكامل المستضاف ذاتيًا غير متصل أو انتهت صلاحية وقت تشغيل تكامل Azure أو لم يتم تسجيله.

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

رمز الخطأ: 2105

  • الرسالة: The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'

  • السبب: لا تتطابق البيانات التي تم إنشاؤها في تعبير المحتوى الديناميكي مع المفتاح وتتسبب في فشل تحليل JSON.

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

رمز الخطأ: 2108

  • الرسالة: Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url: <URL>. Please verify Url or integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime'

  • السبب: تعذر الوصول إلى عنوان URL المتوفر. يمكن أن يحدث هذا بسبب وجود مشكلة في اتصال الشبكة، أو كان URL غير قابل للحل، أو تم استخدام عنوان URL المضيف المحلي في وقت تشغيل تكامل Azure.

  • التوصية: تحقق من إمكانية الوصول إلى عنوان URL المتوفر.


  • الرسالة: Error calling the endpoint '%url;'. Response status code: '%code;'

  • السبب: فشل الطلب بسبب مشكلة أساسية، مثل اتصال الشبكة أو فشل DNS أو التحقق من صحة شهادة خادم، أو انقضاء مهلة.

  • التوصية: استخدم Fiddler/Netmon/Wireshark للتحقق من صحة الطلب.

    استخدام Fiddler

    لاستخدام Fiddler لإنشاء جلسة HTTP لتطبيق الويب المراقب:

    1. قم بتنزيل Fiddler وتثبيته وفتحه.

    2. إذا كان تطبيق الويب يستخدم HTTPS، فانتقل إلى أدوات>خيارات Fiddler>HTTPS.

      1. في علامة التبويب HTTPS، حدد كلاً من التقاط HTTPS CONNECTs وفك تشفير حركة مرور HTTPS.

        خيارات Fiddler

    3. إذا كان التطبيق الخاص بك يستخدم شهادات TLS/SSL، فقم بإضافة شهادة Fiddler إلى جهازك.

      انتقل إلى: أدوات>خيارات Fiddler>HTTPS>الإجراءات>تصدير شهادة الجذر إلى سطح المكتب.

    4. قم بإيقاف تشغيل الالتقاط عن طريق الانتقال إلى الملف>التقاط حركة المرور. أو اضغط على F12.

    5. قم بمسح ذاكرة التخزين المؤقت للمستعرض بحيث تتم إزالة كافة العناصر المخزنة مؤقتاً ويجب تنزيلها مرة أخرى.

    6. لإنشاء طلب:

    7. حدد علامة التبويب Composer.

      1. قم بتعيين أسلوب HTTP وعنوان URL له.

      2. إذا لزم الأمر، فأضف العناوين ونص طلب.

      3. حدد التنفيذ.

    8. قم بتشغيل التقاط حركة المرور مرة أخرى، وأكمل المعاملة المسببة للمشكلة على صفحتك.

    9. انتقل إلى: الملف>حفظ>كل الجلسات.

    لمزيد من المعلومات، راجع البدء باستخدام Fiddler.

رمز الخطأ: 2113

  • الرسالة: ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination

  • السبب: يتعذر إنشاء شهادة من تركيبة سلسلة/كلمة مرور Base64.

  • التوصية: تحقق من إدخال شهادة PFX المشفرة Base64 وتركيبة كلمة المرور التي تستخدمها بشكل صحيح.

رمز الخطأ: 2403

  • الرسالة: Get access token from MSI failed for Datafactory <DF mname>, region <region code>. Please verify resource url is valid and retry.

  • السبب: غير قادر على الحصول على رمز مميز للوصول من عنوان URL للمورد المتوفر.

  • التوصية: تحقق من توفير عنوان URL للمورد الصحيح لهويتك المدارة.

عام

خطأ NULL للرمز المميز لمتابعة REST

Error message: {"token":null,"range":{"min":..}

السبب: عند الاستعلام عبر أقسام/صفحات متعددة، تقوم خدمة الواجهة الخلفية بإرجاع رمز المتابعة بتنسيق JObject مع 3 خصائص: الرمز المميز والحد الأدنى ونطاقات المفاتيح القصوى، على سبيل المثال، {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}). اعتمادًا على بيانات المصدر، يمكن أن يؤدي الاستعلام إلى 0 يشير إلى الرمز المميز المفقود على الرغم من وجود المزيد من البيانات لجلبها.

التوصية: عندما يكون continuationToken غير خال، كسلسلة {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}، يلزم استدعاء واجهة برمجة التطبيقات queryActivityRuns مرة أخرى مع رمز المتابعة المميز من الاستجابة السابقة. تحتاج إلى تمرير السلسلة الكاملة لواجهة برمجة تطبيقات الاستعلام مرة أخرى. سيتم إرجاع الأنشطة في الصفحات اللاحقة لنتيجة الاستعلام. يجب تجاهل وجود صفيف فارغ في هذه الصفحة، طالما أن قيمة continueToken الكاملة != null، تحتاج إلى متابعة الاستعلام. لمزيد من التفاصيل، يرجى الرجوع إلى واجهة برمجة التطبيقات REST لاستعلام تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية.

مشكلة النشاط العالق

عند ملاحظة أن النشاط يعمل لفترة أطول بكثير من عمليات التشغيل العادية لديك مع وجود تقدم يكاد لا يُذكر، فربما يكون عالقاً. يمكنك تجربة إلغائه وإعادة المحاولة لترى ما إذا كان ذلك يفيد أم لا. إذا كان نشاط نسخ، يمكنك التعرف على مراقبة الأداء واستكشاف أخطائه وإصلاحها من استكشاف أخطاء أداء نشاط النسخ وإصلاحها؛ وإذا كان تدفق بيانات، فتعرّف عليه من تعيين تدفقات بيانات الأداء ودليل الضبط.

الحمولة أكبر مما يلزم

رسالة الخطأ: The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

السبب: تتضمن الحمولة لكل تشغيل نشاط تكوين النشاط، ومجموعة (مجموعات) البيانات المرتبطة وتكوينات الخدمة (الخدمات) المرتبطة إن وُجدت، وجزءاً صغيراً من خصائص النظام التي يتم إنشاؤها لكل نوع نشاط. الحد الأقصى لحجم الحمولة من هذا القبيل هو 896 كيلوبايت كما هو مذكور في وثائق حدود Azure لكلّ من Data Factory وAzure Synapse Analytics.

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

يؤدي الضغط غير المدعوم إلى تلف الملفات

الأعراض: أنت حاولت فك ضغط ملف مخزن في حاوية Blob. يتميز نشاط نسخة واحدة في مسار ما بتعيين نوع الضغط للمصدر إلى "deflate64" (أو أي نوع غير مدعوم). يعمل هذا النشاط بنجاح وينتج الملف النصي المضمن في الملف المضغوط. ومع ذلك، هناك مشكلة بخصوص النص المضمن في الملف، وهذا الملف يبدو تالفاً. عندما يتم فك ضغط هذا الملف محليّاً، فإن الأمر يكون على ما يرام.

السبب: يتم ضغط الملف المضغوط الخاص بك بواسطة خوارزمية "deflate64"، في حين لا تدعم مكتبة ضغط الملفات الداخلية لـ Azure Data Factory إلا "deflate". إذا كان الملف المضغوط قد تم ضغطه بواسطة نظام Windows وكان حجم الملف الإجمالي يتجاوز رقماً معيناً، فإن Windows سيستخدم "deflate64" بشكل افتراضي، وهو غير مدعوم في Azure Data Factory. من ناحية أخرى، إذا كان حجم الملف أصغر أو كنت تستخدم بعض أدوات ضغط الملفات من جهات خارجية وتدعم تحديد خوارزمية الضغط، فإن Windows سيستخدم "deflate" بشكل افتراضي.

تلميح

في الواقع، يصرح كلّ من التنسيق الثنائي في Azure Data Factory وSynapse Analytics وتنسيق النص المحدد في Azure Data Factory وAzure Synapse Analytics بوضوح أن تنسيق "deflate64" ليس مدعوماً في Azure Data Factory.

يقوم Execute Pipeline بتمرير معلمة الصفيف كسلسلة إلى البنية الأساسية لبرنامج ربط العمليات التجارية التابعة

رسالة الخطأ: Operation on target ForEach1 failed: The execution of template action 'MainForEach1' failed: the result of the evaluation of 'foreach' expression '@pipeline().parameters.<parameterName>' is of type 'String'. The result must be a valid array.

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

لقطة شاشة تعرض معلمات نشاط تنفيذ البنية الأساسية لبرنامج ربط العمليات التجارية.

ويرجع ذلك إلى حقيقة أن الحمولة يتم تمريرها من البنية الأساسية لبرنامج ربط العمليات التجارية الأصل إلى التابع كسلسلة. يمكننا رؤيته عندما نتحقق من الإدخال الذي تم تمريره إلى البنية الأساسية لبرنامج ربط العمليات التجارية التابعة.

لقطة شاشة تعرض سلسلة نوع الإدخال.

التوصية: لحل المشكلة، يمكننا الاستفادة من وظيفة إنشاء صفيف كما هو موضح في الصورة أدناه.

لقطة شاشة توضح كيفية استخدام دالة إنشاء صفيف.

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

لقطة شاشة تعرض صفيف نوع الإدخال.

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