المشكلات المعروفة في Azure Synapse Analytics
تسرد هذه الصفحة المشكلات المعروفة في Azure Synapse Analytics وتاريخ حلها أو الحل البديل المحتمل. قبل إرسال طلب دعم Azure، راجع هذه القائمة لمعرفة ما إذا كانت المشكلة التي تواجهها معروفة بالفعل ويتم معالجتها.
لمعرفة المزيد حول Azure Synapse Analytics، راجع نظرة عامة على Azure Synapse Analytics، وما الجديد في Azure Synapse Analytics؟
المشكلات المعروفة النشطة
ملخص المشكلات المعروفة النشطة لتجمع SQL المخصص ل Azure Synapse Analytics
العملاء غير قادرين على مراقبة استخدامهم لتجمع SQL المخصص باستخدام المقاييس
تسببت الترقية الداخلية لمنطق انبعاث بيانات تتبع الاستخدام لدينا، والذي كان من المفترض أن يعزز أداء وموثوقية بيانات تتبع الاستخدام لدينا، في حدوث مشكلة غير متوقعة أثرت على قدرة بعض العملاء على مراقبة مجموعة SQL المخصصة الخاصة بهم، tempdbومقاييس IO لبيانات مستودع البيانات.
الحل البديل: عند تحديد المشكلة، اتخذ فريقنا إجراء لتحديد السبب الجذري وتحديث التكوين في نظامنا. يمكن للعملاء إصلاح المشكلة عن طريق إيقاف المثيل مؤقتا واستئنامه، مما سيستعيد الحالة العادية للمثيل وتدفق بيانات تتبع الاستخدام.
فشل الاستعلام عند إدخال ملف parquet في جدول باستخدام AUTO_CREATE_TABLE='ON'
يمكن للعملاء الذين يحاولون استيعاب ملف parquet في جدول تجزئة موزع مع AUTO_CREATE_TABLE='ON' تلقي الخطأ التالي:
COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables
الاستيعاب في جدول موزع للتجزئة تم إنشاؤه تلقائيا باستخدام AUTO_CREATE_TABLE غير مدعوم. يجب على العملاء الذين قاموا بتحميلها مسبقا باستخدام هذا السيناريو غير المدعوم CTAS بياناتهم في جدول جديد واستخدامها بدلا من الجدول القديم.
فشل الاستعلامات مع خطأ في النقل غير المصرح للبيانات
مساحات عمل Synapse التي تم إنشاؤها من فشل استعلام تقرير تجمع SQL مخصص موجود متعلق بحماية النقل غير المصرح للبيانات مع رسالة خطأ عامة أثناء إيقاف تشغيل حماية النقل غير المصرح للبيانات في Synapse Analytics:
Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.
الحل البديل: إذا واجهت خطأ مشابها، فاشرك فريق دعم Microsoft للحصول على المساعدة.
فشل UPDATE STATISTICS
يمكن أن تواجه بعض تجمعات SQL المخصصة استثناء عند تنفيذ عبارة UPDATE STATISTICS . ينتج عن الأمر الرسالة "دفق الإحصائيات المتوفرة تالف" ويفشل في تحديث الإحصائيات الخاصة بك.
عند إضافة قيد جديد إلى جدول، يتم إنشاء إحصائية ذات صلة في التوزيعات. إذا تم إنشاء فهرس متفاوت المسافات أيضا على الجدول، فيجب أن يتضمن نفس الأعمدة (بنفس الترتيب) مثل القيد، وإلا UPDATE STATISTICS فقد تفشل الأوامر الموجودة على هذه الأعمدة.
الحل البديل: تحديد ما إذا كان هناك قيد وفهرس متفاوت المسافات على الجدول. إذا كان الأمر كذلك، فسقط كل من القيد والفهرس المجمع. بعد ذلك، أعد إنشاء الفهرس المتفاوت المسافات ثم القيد الذي يضمن أن كلا منهما يتضمن نفس الأعمدة بالترتيب نفسه. إذا لم يكن الجدول يحتوي على قيد وفهرس متفاوت المسافات، أو إذا كانت الخطوة أعلاه تؤدي إلى نفس الخطأ، فاتصل بفريق دعم Microsoft للحصول على المساعدة.
يبدو أن تحديثات العلامات تفشل
عند إجراء تغيير على علامات تجمع SQL مخصص من خلال مدخل Microsoft Azure أو أساليب أخرى، يمكن أن تظهر رسالة خطأ على الرغم من إجراء التغيير بنجاح.
الحل البديل: يمكنك التأكد من نجاح التغيير في العلامات وتجاهل/منع رسالة الخطأ حسب الحاجة.
ملخص المشكلات المعروفة النشطة لمساحة عمل Azure Synapse
فيما يلي مشكلات معروفة في مساحة عمل Synapse.
خدمة تخزين Blob المرتبطة مع الهوية المدارة المعينة من قبل المستخدم (UAMI) لا يتم إدراجها
قد لا تكون الخدمة المرتبطة مرئية ضمن Data Hub ->Linked ->Azure Blob Storage بعد تكوين خدمة تخزين blob المرتبطة لاستخدام مصادقة "الهوية المدارة المعينة من قبل المستخدم" في Azure Synapse Analytics.
الحل البديل: الفريق الهندسي على علم حاليا بهذا السلوك ويعمل على إصلاحه. كبديل، استخدم أسلوب مصادقة "الهوية المدارة المعينة من قبل النظام" بدلا من "الهوية المدارة المعينة من قبل المستخدم".
فشل حذف مساحة عمل Synapse وتعذر حذف الشبكة الظاهرية
فشل حذف مساحة عمل Synapse مع ظهور رسالة الخطأ:
Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;
الحل البديل: يمكن تخفيف المشكلة عن طريق إعادة محاولة عملية الحذف. الفريق الهندسي على علم بهذا السلوك ويعمل على إصلاح.
تفشل عمليات REST API PUT أو قوالب ARM/Bicep لتحديث إعدادات الشبكة
عند استخدام قالب ARM أو قالب Bicep أو عملية REST API PUT المباشرة لتغيير إعدادات الوصول إلى الشبكة العامة و/أو قواعد جدار الحماية لمساحة عمل Synapse، يمكن أن تفشل العملية.
الحل البديل: يمكن تخفيف المشكلة باستخدام عملية REST API PATCH أو واجهة مستخدم مدخل Microsoft Azure لعكس تغييرات التكوين المطلوبة وإعادة محاولة إجراءها. الفريق الهندسي على علم بهذا السلوك ويعمل على إصلاح.
مشكلة معروفة تتضمن الأقواس المربعة [] في قيمة العلامات
في سياق تحديث قيم العلامات داخل مساحة عمل Azure Synapse، سيؤدي تضمين الأقواس المربعة ([]) إلى عملية تحديث غير ناجحة.
الحل البديل: الحل البديل الحالي هو الامتناع عن استخدام الأقواس المربعة ([]) في قيم علامة مساحة عمل Azure Synapse.
فشل التوزيع في مساحة عمل Synapse باستخدام Synapse-workspace-deployment v1.8.0 في إجراءات GitHub مع قوالب ARM
يحدث الفشل أثناء النشر إلى الإنتاج ويرتبط بمشغل يحتوي على اسم مضيف مع شرطة مائلة عكسية مزدوجة.
رسالة الخطأ المعروضة هي Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057.
الحل البديل: يمكن اتخاذ الإجراءات التالية كتخفيف سريع:
- إزالة أحرف الإلغاء: إزالة أي أحرف إلغاء يدويا (
\) من ملف المعلمات قبل النشر. وهذا يعني تحرير الملف لإزالة هذه الأحرف التي قد تتسبب في حدوث مشكلات أثناء مرحلة التحليل أو المعالجة للنشر. - استبدال أحرف الإلغاء مع شرطة مائلة للأمام: استبدل أحرف الإلغاء (
\) مع شرطة مائلة للأمام (/). يمكن أن يكون هذا مفيدا بشكل خاص في مسارات الملفات، حيث تقبل العديد من الأنظمة الشرطة المائلة للأمام كفواصل مسار صالحة. قد يساعد هذا الاستبدال في تجاوز المشكلة مع أحرف الإلغاء، مما يسمح لعملية التوزيع بنجاح.
بعد تطبيق أي من هذه الحلول البديلة والنشر بنجاح، قم بتحديث التكوينات الضرورية يدويا داخل مساحة العمل لضمان إعداد كل شيء بشكل صحيح. قد يتضمن ذلك تحرير ملفات التكوين أو ضبط الإعدادات أو تنفيذ مهام أخرى ذات صلة بالبيئة أو التطبيق المحدد الذي يتم نشره.
لا توجد عملية واجهة برمجة تطبيقات 'GET' مخصصة لإعداد "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled"
ملخص المشكلة: في Azure Synapse Analytics، لا توجد عملية مخصصة لواجهة برمجة التطبيقات "GET" لاسترداد حالة إعداد "trustedServiceBypassEnabled" في نطاق المورد "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled". بينما يمكن للمستخدمين تعيين هذا التكوين، لا يمكنهم استرداد حالته مباشرة عبر نطاق المورد المحدد هذا.
التأثير: يؤثر هذا القيد على تعريفات نهج Azure، حيث لا يمكنها فرض حالة معينة لإعداد "trustedServiceBypassEnabled". يتعذر على العملاء استخدام نهج Azure لرفض هذا التكوين أو إدارته.
الحل البديل: لا يوجد حل بديل متوفر في نهج Azure لفرض حالة التكوين المطلوبة لهذه الخاصية. ومع ذلك، يمكن للمستخدمين استخدام عملية مساحة العمل "GET" لتدقيق حالة التكوين لأغراض إعداد التقارير.
تعين عملية مساحة العمل "GET" هذه إلى الاسم المستعار لنهج Azure "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled".
يمكن استخدام الاسم المستعار لنهج Azure لإدارة هذه الخاصية باستخدام تأثير نهج رفض Azure إذا كانت العملية عبارة عن طلب PUT مقابل مورد Microsoft.Synapse/workspace، ولكنه سيعمل فقط لأغراض التدقيق إذا تم إرسال طلب PUT مباشرة إلى المورد التابع Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. يحتوي المورد الأصل على خاصية [properties.trustedServiceBypassEnabled] التي تعين التكوين من المورد التابع ولهذا السبب لا يزال من الممكن تدقيقه من خلال الاسم المستعار لنهج Azure للمورد الأصل.
نظرا لعدم توفر عملية GET للمورد التابع Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration، لا يمكن لنهج Azure إدارة هذه الطلبات، ولا يمكن لنهج Azure إنشاء اسم مستعار لنهج Azure له.
المورد الأصل: Microsoft.Synapse/workspaces
المورد التابع: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration
يقوم مدخل Azure بإجراء طلب PUT مباشرة إلى واجهة برمجة تطبيقات PUT للمورد التابع، وبالتالي لا يمكن إدارة مدخل Azure، جنبا إلى جنب مع أي طلبات واجهة برمجة تطبيقات أخرى تم إجراؤها خارج واجهات برمجة تطبيقات Microsoft.Synapse/workspaces الأصلية، بواسطة نهج Azure من خلال رفض أو تأثير نهج Azure قابل للتنفيذ.
ملخص المشكلات المعروفة النشطة لتجمع SQL بلا خادم في Azure Synapse Analytics
فشل الاستعلام من تجمع SQL بلا خادم إلى مخزن Azure Cosmos DB التحليلي
قد تفشل الاستعلامات من تجمع SQL بلا خادم إلى مخزن Azure Cosmos DB التحليلي مع إحدى رسائل الخطأ التالية:
Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'Resolving CosmosDB path has failed with error 'Key not found'
يجب أن تكون الشروط التالية صحيحة لتأكيد هذه المشكلة:
- يستخدم الاتصال بمخزن Azure Cosmos DB التحليلي نقطة نهاية خاصة.
- تنجح إعادة محاولة الاستعلام.
الحل البديل: الفريق الهندسي على علم بهذا السلوك ويمكن اتخاذ الإجراءات التالية كتخفيف سريع:
- أعد محاولة الاستعلام الفاشل. سيتم تحديث الرمز المميز منتهية الصلاحية تلقائيا.
- تعطيل نقطة النهاية الخاصة. قبل تطبيق هذا التغيير، تأكد مع فريق الأمان الخاص بك من أنه يلبي نهج أمان شركتك.
تنشر طريقة عرض مخزن Azure Cosmos DB التحليلي سمات خاطئة في العمود
أثناء استخدام طرق العرض في تجمع Azure Synapse بلا خادم عبر مخزن Cosmos DB التحليلي، إذا كان هناك تغيير في الملفات في مخزن Cosmos DB التحليلي، لا يتم نشر التغيير بشكل صحيح إلى عبارات SELECT، يستخدم العميل في طريقة العرض. ونتيجة لذلك، يتم تعيين السمات بشكل غير صحيح إلى عمود مختلف في النتائج.
الحل البديل: الفريق الهندسي على علم بهذا السلوك ويمكن اتخاذ الإجراءات التالية كتخفيف سريع:
- أعد إنشاء طريقة العرض عن طريق إعادة تسمية الأعمدة.
- تجنب استخدام طرق العرض إن أمكن.
فشل تغيير بيانات الاعتماد ذات نطاق قاعدة البيانات إذا تم استخدام بيانات الاعتماد
في بعض الأحيان قد لا تتمكن من تنفيذ ALTER DATABASE SCOPED CREDENTIAL الاستعلام. السبب الجذري لهذه المشكلة هو تخزين بيانات الاعتماد مؤقتا بعد استخدامها الأول مما يجعلها غير قابلة للوصول لتغييرها. الخطأ الذي تم إرجاعه هو:
Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.
الحل البديل: الفريق الهندسي على علم بهذا السلوك حاليا ويعمل على إصلاحه. كحل بديل، يمكنك DROP وإنشاء بيانات الاعتماد، مما يعني أيضا إعادة إنشاء جداول خارجية باستخدام بيانات الاعتماد. بدلا من ذلك، يمكنك إشراك فريق دعم Microsoft للحصول على المساعدة.
فشل الاستعلام في تجمعات SQL بلا خادم
يمكن أن يؤدي انتهاء صلاحية الرمز المميز إلى أخطاء أثناء تنفيذ الاستعلام الخاص بهم، على الرغم من وجود الأذونات اللازمة للمستخدم عبر التخزين. يمكن أن تحدث رسائل الخطأ هذه أيضا بسبب أخطاء المستخدم الشائعة، مثل عندما لا يتم تعيين أدوار التحكم في الوصول استنادا إلى الدور (RBAC) إلى حساب التخزين.
مثال على رسائل الخطأ:
WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.Error 16536: Cannot bulk load because the file "%ls" could not be opened.
الحل البديل:
تختلف الدقة اعتمادا على المصادقة أو Microsoft Entra (المعروف سابقا باسم Azure Active Directory) أو هوية الخدمة المدارة (MSI):
لانتهاء صلاحية الرمز المميز ل Microsoft Entra:
بالنسبة للاستعلامات طويلة الأمد، قم بالتبديل إلى كيان الخدمة أو الهوية المدارة أو توقيع الوصول المشترك (SAS) بدلا من استخدام هوية المستخدم. لمزيد من المعلومات، راجع التحكم في الوصول إلى حساب التخزين لتجمع SQL بلا خادم في Azure Synapse Analytics.
أعد تشغيل العميل (SSMS/ADS) للحصول على رمز مميز جديد لتأسيس الاتصال.
لانتهاء صلاحية الرمز المميز MSI:
- قم بإلغاء تنشيط ثم تنشيط التجمع من أجل مسح ذاكرة التخزين المؤقت للرمز المميز. إشراك فريق دعم Microsoft للحصول على المساعدة.
مشكلات الوصول إلى التخزين بسبب طول عنوان التخويل
مثال على رسائل الخطأ في تجمعات SQL بلا خادم:
File {path} cannot be opened because it does not exist or it is used by another process.Content of directory on path {path} cannot be listed.WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}
تظهر أخطاء الوصول إلى التخزين العامة هذه عند تشغيل استعلام. قد تحدث المشكلة لمستخدم في مساحة عمل واحدة ولكن قد تعمل بشكل صحيح في مساحات عمل أخرى. هذا السلوك متوقع بسبب حجم الرمز المميز.
تحقق من طول الرمز المميز ل Microsoft Entra عن طريق تشغيل الأمر التالي في PowerShell. -ResourceUrl ستكون قيمة المعلمة مختلفة للسحب غير العامة. إذا كان طول الرمز المميز قريبا من 11000 أو أكثر، فشاهد قسم التخفيف .
(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length
الحل البديل:
الحلول البديلة المقترحة هي:
- قم بالتبديل إلى تخويل تخزين الهوية المدارة كما هو موضح في التحكم في الوصول إلى التخزين.
- تقليل عدد مجموعات الأمان (وجود نتائج مجموعات أمان 90 أو أقل برمز مميز له طول متوافق).
- زيادة عدد مجموعات الأمان أكثر من 200 (نظرا لأن ذلك يغير كيفية إنشاء الرمز المميز، فإنه سيحتوي على MS Graph API URI بدلا من قائمة كاملة من المجموعات). يمكن تحقيق ذلك عن طريق إضافة مجموعات وهمية/ اصطناعية باتباع المجموعات المدارة، بعد أن تحتاج إلى إضافة مستخدمين إلى المجموعات التي تم إنشاؤها حديثا.
ملخص المشكلات المعروفة النشطة لتجمع Azure Synapse Analytics Apache Spark
فيما يلي مشكلات معروفة مع Synapse Spark.
فشل الاستعلام باستخدام عبارة LIKE باستخدام Synapse Dedicated SQL Pool Connector في وقت تشغيل Spark 3.4
قدم مصدر مفتوح Apache Spark 3.4 مشكلة، والتي تهرب من الأحرف الخاصة، ولكن Synapse SQL لا يدعم الكلمة الأساسية للإلغاء. عندما يستخدم العملاء Azure Synapse Dedicated SQL Pool Connector ل Apache Spark، يمكنه إنشاء استعلام SQL غير صالح ل Synapse SQL ودفتر ملاحظات Synapse Spark أو مهمة دفعية قد تطرح خطأ مشابها لما يلي:
com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''
الحل البديل: الفريق الهندسي على علم حاليا بهذا السلوك ويعمل على إصلاحه. إذا واجهت خطأ مشابها، فيرجى إشراك فريق دعم Microsoft للحصول على المساعدة وتوفير حل بديل مؤقت.
المشكلات المعروفة المغلقة مؤخرا
| مكون Synapse | المشكلة | الحالة | تاريخ الحل |
|---|---|---|---|
| تجمع SQL لـ Azure Synapse بلا خادم | فشل الاستعلامات التي تستخدم مصادقة Microsoft Entra بعد ساعة واحدة | تم الحل | أغسطس 2023 |
| تجمع SQL لـ Azure Synapse بلا خادم | فشل الاستعلام أثناء قراءة بيانات Cosmos DB باستخدام OPENROWSET | تم الحل | مارس 2023 |
| تجمع Azure Synapse Apache Spark | فشل الكتابة إلى تجمع SQL المخصص من Synapse Spark باستخدام موصل تجمع SQL المخصص ل Azure Synapse ل Apache Spark عند استخدام دفاتر الملاحظات في المسارات | تم الحل | يونيو 2023 |
| تجمع Azure Synapse Apache Spark | فشل مهمة أو مهمة Spark معينة في وقت مبكر جدا مع رمز الخطأ 503 بسبب تقييد حساب التخزين | تم الحل | نوفمبر 2023 |
ملخص المشكلات المعروفة المغلقة مؤخرا لتجمع SQL بلا خادم في Azure Synapse Analytics
فشل الاستعلامات التي تستخدم مصادقة Microsoft Entra بعد ساعة واحدة
تبدأ اتصالات SQL التي تستخدم مصادقة Microsoft Entra التي تظل نشطة لأكثر من ساعة واحدة في الفشل. يتضمن ذلك الاستعلام عن التخزين باستخدام مصادقة المرور من Microsoft Entra والعبارات التي تتفاعل مع معرف Microsoft Entra، مثل CREATE EXTERNAL PROVIDER. يؤثر هذا على كل أداة تحافظ على الاتصالات نشطة، مثل محرر الاستعلام في SSMS و ADS. لا تتأثر الأدوات التي تفتح اتصالا جديدا لتنفيذ الاستعلامات، مثل Synapse Studio.
الحالة: تم الحل
فشل الاستعلام أثناء قراءة بيانات Azure Cosmos DB باستخدام OPENROWSET
تفشل الاستعلامات من تجمع SQL بلا خادم إلى مخزن Cosmos DB التحليلي باستخدام OPENROWSET مع ظهور رسالة الخطأ التالية:
Resolving CosmosDB path has failed with error 'bad allocation'.
الحالة: تم الحل
ملخص المشكلات المعروفة المغلقة مؤخرا في تجمع Azure Synapse Analytics Apache Spark
فشل الكتابة إلى تجمع SQL المخصص من Synapse Spark باستخدام موصل تجمع SQL المخصص ل Azure Synapse ل Apache Spark عند استخدام دفاتر الملاحظات في المسارات
أثناء استخدام موصل تجمع SQL المخصص ل Azure Synapse ل Apache Spark لكتابة تجمع Azure Synapse المخصص باستخدام دفاتر الملاحظات في البنية الأساسية لبرنامج ربط العمليات التجارية، سنرى رسالة خطأ:
com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.
الحالة: تم الحل
فشل مهمة أو مهمة Spark معينة في وقت مبكر جدا مع رمز الخطأ 503 بسبب تقييد حساب التخزين
بين 3 أكتوبر 2023 و16 نوفمبر 2023، كان من الممكن أن يواجه عدد قليل من تجمعات Azure Synapse Analytics Apache Spark حالات فشل مهمة/مهمة Spark بسبب تجاوز حد واجهة برمجة تطبيقات التخزين.
الحالة: تم الحل