استكشاف أخطاء 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 have domain and accessToken as required properties.
السبب:
Bad authoring.
التوصية: تحقق من تعريف الخدمة المرتبطة.
الرسالة:
{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
).لاحظتَ هذا التغيير في 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 عن طريق إعادة تمهيد عُقدة الرأس.
قم بالاتصال بإحدى العقد الخاصة بك على HDInsight باستخدام SSH.
قم بتحديد مضيف عقدة الرأس النشط عن طريق تشغيل
ping headnodehost
.قم بالاتصال بعقدة الرأس النشط الخاصة بك أن خادم Ambari يتم إرساؤه على عقدة الرأس النشط باستخدام SSH.
قم بإعادة تشغيل عُقدة الرأس النشط.
لمزيد من المعلومات، طالع وثائق استكشاف أخطاء 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 وحدث الفشل هناك.
التوصية:
- تحقق من واجهة مستخدم Ambari:
- تأكد من استمرار تشغيل كل الخدمات.
- من واجهة مستخدم Ambari، تحقق من قسم التنبيهات في لوحة المعلومات.
- لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
- قم بمراجعة ذاكرة YARN الخاصة بك. إذا كانت ذاكرة YARN لديك عالية، فقد تتأخر معالجة مهامك. إذا لم يكن لديك موارد كافية لاستيعاب تطبيق/مهمة Spark لديك، فقم بتوسيع سعة مقطع التخزين للتأكد من أن المقطع يحتوي على ذاكرة وذاكرات أساسية كافية.
- قم بتشغيل مهمة اختبار نموذج.
- إذا قمت بتشغيل المهمة نفسها في النهاية الخلفية لـ HDInsight، فتحقق من أنها تكللت بالنجاح. للحصول على أمثلة لعمليات تشغيل النماذج، فراجع تشغيل نماذج MapReduce المضمنة في HDInsight
- إذا استمرت المهمة في الفشل على HDInsight، فتحقق من سجلات التطبيق والمعلومات التي يجب توفيرها إلى الدعم:
- تحقق مما إذا كان المهمة قد تم تقديمها إلى YARN. إذا لم تكن المهمة قد تم تقديمها إلى YARN، فاستخدم
--master yarn
. - إذا كان التطبيق قد انتهى من التنفيذ، فاجمع وقت البدء ووقت الانتهاء لتطبيق YARN. إذا لم يكن التطبيق قد أكمل التنفيذ، فاجمع وقت البدء/وقت التشغيل.
- تحقق من سجل التطبيق واجمعه باستخدام
yarn logs -applicationId <Insert_Your_Application_ID>
. - تحقق من سجلات إدارة موارد YARN وقم بجمعها ضمن الدليل
/var/log/hadoop-yarn/yarn
. - إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight للحصول على الدعم وتوفير السجلات والطوابع الزمنية أعلاه.
- تحقق مما إذا كان المهمة قد تم تقديمها إلى YARN. إذا لم تكن المهمة قد تم تقديمها إلى YARN، فاستخدم
رمز الخطأ: 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 وحدث الفشل هناك.
التوصية:
- تحقق من واجهة مستخدم Ambari:
- تأكد من استمرار تشغيل كل الخدمات.
- من واجهة مستخدم Ambari، تحقق من قسم التنبيهات في لوحة المعلومات.
- لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
- قم بمراجعة ذاكرة YARN الخاصة بك. إذا كانت ذاكرة YARN لديك عالية، فقد تتأخر معالجة مهامك. إذا لم يكن لديك موارد كافية لاستيعاب تطبيق/مهمة Spark لديك، فقم بتوسيع سعة مقطع التخزين للتأكد من أن المقطع يحتوي على ذاكرة وذاكرات أساسية كافية.
- قم بتشغيل مهمة اختبار نموذج.
- إذا قمت بتشغيل المهمة نفسها في النهاية الخلفية لـ HDInsight، فتحقق من أنها تكللت بالنجاح. للحصول على أمثلة لعمليات تشغيل النماذج، فراجع تشغيل نماذج MapReduce المضمنة في HDInsight
- إذا استمرت المهمة في الفشل على HDInsight، فتحقق من سجلات التطبيق والمعلومات التي يجب توفيرها إلى الدعم:
- تحقق مما إذا كان المهمة قد تم تقديمها إلى YARN. إذا لم تكن المهمة قد تم تقديمها إلى YARN، فاستخدم
--master yarn
. - إذا كان التطبيق قد انتهى من التنفيذ، فاجمع وقت البدء ووقت الانتهاء لتطبيق YARN. إذا لم يكن التطبيق قد أكمل التنفيذ، فاجمع وقت البدء/وقت التشغيل.
- تحقق من سجل التطبيق واجمعه باستخدام
yarn logs -applicationId <Insert_Your_Application_ID>
. - تحقق من سجلات إدارة موارد YARN وقم بجمعها ضمن الدليل
/var/log/hadoop-yarn/yarn
. - إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight للحصول على الدعم وتوفير السجلات والطوابع الزمنية أعلاه.
- تحقق مما إذا كان المهمة قد تم تقديمها إلى YARN. إذا لم تكن المهمة قد تم تقديمها إلى YARN، فاستخدم
رمز الخطأ: 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 بمقطع التخزين.
التوصية:
تحقق من صحة بيانات الاعتماد عن طريق فتح واجهة مستخدم Ambari لمقطع تخزين HDInsight في أي مستعرض.
إذا كان مقطع التخزين في الشبكة الظاهرية (VNet) ويتم استخدام وقت تشغيل التكامل المستضاف ذاتياً، يجب أن يكون عنوان URL لـ HDI عنوان URL خاصّاً في VNets، ويجب أن يكون
-int
وارداً بعد اسم مقطع التخزين.على سبيل المثال، قم بتغيير
https://mycluster.azurehdinsight.net/
إلىhttps://mycluster-int.azurehdinsight.net/
. لاحظ أن-int
بعدmycluster
، ولكنه قبل.azurehdinsight.net
إذا كان مقطع التخزين في VNet، فإن وقت تشغيل التكامل المستضاف ذاتياً يجري استخدامه، وتم استخدام عنوان URL الخاص، ومع ذلك فشل الاتصال، ومن ثم واجه الجهاز الظاهري حيث يتم تثبيت IR مشاكل في الاتصال بـ HDI.
قم بالاتصال بالجهاز الظاهري الذي يتم تثبيت IR فيه وافتح واجهة مستخدم Ambari في أي مستعرض. استخدم عنوان URL الخاص لمقطع التخزين. يجب أن يعمل هذا الاتصال من المستعرض. إذا لم يحدث هذا، فاتصل بفريق دعم HDInsight لمزيد من المساعدة.
إذا لم يتم استخدام وقت تشغيل التكامل المستضاف ذاتياً، يجب أن يكون مقطع تخزين 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، وفشلت مع وجود خطأ.
التوصية:
- تأكد من إعداد الاتصال المسمى "اتصال قاعدة البيانات المفتوح (JDBC)/Java" بشكل صحيح.
- بالنسبة إلى JDBC، إذا كنت تستخدم الشبكة الظاهرية نفسها، يمكنك الحصول على هذا الاتصال من:
Hive -> Summary -> HIVESERVER2 JDBC URL
- للتأكد من أن لديك إعداد JDBC الصحيح، راجع استعلام Apache Hive من خلال برنامج تشغيل JDBC في HDInsight.
- بالنسبة إلى قاعدة البيانات المفتوحة (ODB)، راجع البرنامج التعليمي: استعلام Apache Hive باستخدام ODBC وPowerShell للتأكد من أن لديك الإعداد الصحيح.
- بالنسبة إلى JDBC، إذا كنت تستخدم الشبكة الظاهرية نفسها، يمكنك الحصول على هذا الاتصال من:
- تحقق من أن Hiveserver2 وHive Metastore وHiveserver2 Interactive نشطة وتعمل.
- تحقق من واجهة مستخدم Ambari (UI):
- تأكد من استمرار تشغيل كل الخدمات.
- من واجهة مستخدم Ambari، تحقق من قسم التنبيه في لوحة المعلومات.
- لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
- إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight.
- تأكد من إعداد الاتصال المسمى "اتصال قاعدة البيانات المفتوح (JDBC)/Java" بشكل صحيح.
رمز الخطأ: 2347
الرسالة:
Hive execution through ODBC failed with error message '%message;'.
السبب: قامت الخدمة بإرسال البرنامج النصي للخلية من أجل التنفيذ إلى مقطع تخزين HDI عبر اتصال ODBC، وفشل البرنامج النصي على HDI.
التوصية:
- تأكد من إعداد الاتصال المسمى "اتصال قاعدة البيانات المفتوح (JDBC)/Java" بشكل صحيح.
- بالنسبة إلى JDBC، إذا كنت تستخدم الشبكة الظاهرية نفسها، يمكنك الحصول على هذا الاتصال من:
Hive -> Summary -> HIVESERVER2 JDBC URL
- للتأكد من أن لديك إعداد JDBC الصحيح، راجع استعلام Apache Hive من خلال برنامج تشغيل JDBC في HDInsight.
- بالنسبة إلى قاعدة البيانات المفتوحة (ODB)، راجع البرنامج التعليمي: استعلام Apache Hive باستخدام ODBC وPowerShell للتأكد من أن لديك الإعداد الصحيح.
- بالنسبة إلى JDBC، إذا كنت تستخدم الشبكة الظاهرية نفسها، يمكنك الحصول على هذا الاتصال من:
- تحقق من أن Hiveserver2 وHive Metastore وHiveserver2 Interactive نشطة وتعمل.
- تحقق من واجهة مستخدم Ambari (UI):
- تأكد من استمرار تشغيل كل الخدمات.
- من واجهة مستخدم Ambari، تحقق من قسم التنبيه في لوحة المعلومات.
- لمزيد من المعلومات حول التنبيهات وحلول التنبيهات، راجع إدارة ومراقبة مقطع تخزين .
- إذا كانت هذه الخطوات غير كافية لحل المشكلة، فاتصل بفريق Azure HDInsight.
- تأكد من إعداد الاتصال المسمى "اتصال قاعدة البيانات المفتوح (JDBC)/Java" بشكل صحيح.
رمز الخطأ: 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 لتغيير الإعداد.
توقف نشاط HDI في التحضير لنظام المجموعة
إذا كان نشاط HDI عالقًا في التحضير لنظام المجموعة، فاتبع الإرشادات أدناه:
تأكد من أن المهلة أكبر مما هو موضح أدناه وانتظر حتى يكتمل التنفيذ أو حتى انتهاء المهلة، وانتظر وقت البقاء (TTL) قبل إرسال مهام جديدة.
الحد الأقصى للوقت الافتراضي الذي يستغرقه تدوير نظام المجموعة هو ساعتين، وإذا كان لديك أي برنامج نصي init، فسيتم جمعه، حتى ساعتين أخريين.
تأكد من توفير التخزين وHDI في نفس المنطقة.
تأكد من أن كيان الخدمة المستخدم للوصول إلى مجموعة HDI صالح.
إذا استمرت المشكلة، كحل بديل، فاحذف الخدمة المرتبطة بـ 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 لتطبيق الويب المراقب:
قم بتنزيل Fiddler وتثبيته وفتحه.
إذا كان تطبيق الويب يستخدم HTTPS، فانتقل إلى أدوات>خيارات Fiddler>HTTPS.
في علامة التبويب HTTPS، حدد كلاً من التقاط HTTPS CONNECTs وفك تشفير حركة مرور HTTPS.
إذا كان التطبيق الخاص بك يستخدم شهادات TLS/SSL، فقم بإضافة شهادة Fiddler إلى جهازك.
انتقل إلى: أدوات>خيارات Fiddler>HTTPS>الإجراءات>تصدير شهادة الجذر إلى سطح المكتب.
قم بإيقاف تشغيل الالتقاط عن طريق الانتقال إلى الملف>التقاط حركة المرور. أو اضغط على F12.
قم بمسح ذاكرة التخزين المؤقت للمستعرض بحيث تتم إزالة كافة العناصر المخزنة مؤقتاً ويجب تنزيلها مرة أخرى.
لإنشاء طلب:
حدد علامة التبويب Composer.
قم بتعيين أسلوب HTTP وعنوان URL له.
إذا لزم الأمر، فأضف العناوين ونص طلب.
حدد التنفيذ.
قم بتشغيل التقاط حركة المرور مرة أخرى، وأكمل المعاملة المسببة للمشكلة على صفحتك.
انتقل إلى: الملف>حفظ>كل الجلسات.
لمزيد من المعلومات، راجع البدء باستخدام 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.
السبب: حتى إذا قمت في مسار التنفيذ بإنشاء معلمة صفيف النوع، كما هو موضح في الصورة أدناه، سيفشل المسار.
ويرجع ذلك إلى حقيقة أن الحمولة يتم تمريرها من البنية الأساسية لبرنامج ربط العمليات التجارية الأصل إلى التابع كسلسلة. يمكننا رؤيته عندما نتحقق من الإدخال الذي تم تمريره إلى البنية الأساسية لبرنامج ربط العمليات التجارية التابعة.
التوصية: لحل المشكلة، يمكننا الاستفادة من وظيفة إنشاء صفيف كما هو موضح في الصورة أدناه.
ثم ستنجح البنية الأساسية لبرنامج ربط العمليات التجارية لدينا. ويمكننا أن نرى في مربع الإدخال أن المعلمة التي تم تمريرها هي صفيف.
المحتوى ذو الصلة
لمزيد من تعليمات استكشاف الأخطاء وإصلاحها، جرب هذه الموارد: