إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يتضمن هذا الدليل أفضل الممارسات للحلول المبنية باستخدام أحدث إصدار من مجموعة تطوير تطوير تطوير جافا سكريبت لقاعدة بيانات Azure Cosmos لنظام NoSQL. أفضل الممارسات المضمنة هنا تساعد في تحسين التأخير، وتحسين التوفر، وتعزيز الأداء العام لحلولك.
تكوين الحساب
- تأكد من تشغيل تطبيقك في منطقة Azure نفسها الموجودة في حساب Azure Cosmos DB، لتقليل زمن الانتقال إن أمكن ذلك. مكِّن منطقتين إلى 4 مناطق وانسخ حساباتك في مناطق متعددة للحصول على أفضل إمكانية توافر. بالنسبة لأحمال عمل الإنتاج، قم بتمكين تجاوز الفشل المدار بواسطة الخدمة. في غياب هذا التكوين، يواجه الحساب فقدان توفر الكتابة طوال فترة انقطاع منطقة الكتابة، حيث لا يمكن للتحويل اليدوي للفشل بسبب نقص الاتصال بالمناطق. لمزيد من المعلومات حول كيفية إضافة عدة مناطق باستخدام مجموعة تطوير تطوير جافاسكريبت، راجع دليل التوزيع العام.
استخدام SDK
- استخدم دائما أحدث إصدار من Azure Cosmos DB SDK المتوفر للحصول على الأداء الأمثل.
- استخدم نسخة واحدة من التطبيق
CosmosClientطوال عمر تطبيقك لتحسين الأداء. - قم بتعيين المناطق المفضلة في مجموعة تطوير البرمجيات باستخدام سياسة الاتصال. أثناء تجاوز الفشل، تُرسَل عمليات الكتابة إلى منطقة الكتابة الحالية وتُرسَل عمليات القراءة إلى المنطقة الأولى ضمن قائمة المناطق المفضلة. لمزيد من المعلومات حول آليات التحويل الإقليمي، راجع استكشاف أخطاء التوفر.
- خطأ عابر هو خطأ يحدث بسبب أساسي يحل نفسه قريباً. يجب إنشاء التطبيقات التي تتصل بقاعدة البيانات لتوقع هذه الأخطاء عابرة. لمعالجتها، استخدم منطق إعادة المحاولة في التعليمات البرمجية بدلاً من الظهور للمستخدمين كأخطاء في التطبيق. تتبع أداة SDK منطقاً مضمناً لمعالجة هذه الفشل العابر في الطلبات القابلة لإعادة المحاولة مثل عمليات القراءة أو الاستعلام. لا يمكن لحزمة تطوير البرمجيات إعادة المحاولة على الكتابة بسبب الأعطال المؤقتة لأن الكتابة ليست ذات قدرة ذاتية الصلاحية. تسمح أداة SDK للمستخدمين بتكوين منطق إعادة المحاولة لعمليات التقييد. لمزيد من التفاصيل حول الأخطاء التي يجب إعادة المحاولة، يرجى زيارة هنا.
- استخدم تسجيل SDK لالتقاط معلومات تشخيصية إضافية وحل مشاكل التأخير.
تصميم البيانات
- يرتبط رسم الطلب لعملية محددة بحجم المستند مباشرة. نوصي بتقليل حجم المستندات حيث تكلف العمليات التي تُجرى على المستندات الكبيرة مبلغاً أكبر من العمليات التي تُجرى على المستندات الأصغر.
- بعض الأحرف مقيدة ولا يمكن استخدامها في بعض المعرفات: '/'، '\'، '?'، '#'. التوصية العامة هي عدم استخدام أي أحرف خاصة في معرفات مثل اسم قاعدة البيانات أو اسم المجموعة أو معرف العنصر أو مفتاح القسم لتجنب أي سلوك غير متوقع.
- تسمح لك نهج الفهرسة Azure Cosmos DB أيضاً بتحديد مسارات المستندات المراد تضمينها أو استبعادها من الفهرسة باستخدام مسارات الفهرسة
IndexingPolicy#getIncludedPaths()وIndexingPolicy#getExcludedPaths(). تأكد من استبعاد المسارات غير المستخدمة من الفهرسة للكتابة بشكل أسرع. لمزيد من المعلومات، انظر إنشاء الفهارس باستخدام عينة SDK.
خصائص المضيف
- قد تواجه مشكلات في الاتصال/التوفر بسبب عدم وجود موارد على جهاز العميل. راقب استخدام CPU الخاص بك على العقد التي تقوم بتشغيل عميل Azure Cosmos DB، وقم بزيادة / زيادة الاستخدام إذا كان الاستخدام مرتفعاً. أيضا، فكر في تشغيل عبء العمل باستخدام وحدة العنقود .
- بالنسبة لمعظم حالات أحمال العمل الإنتاجية الشائعة، نوصي بشدة باستخدام أجهزة ظاهرية ذات 4 مراكز وذاكرة 8 غيغابايت على الأقل كلما أمكن ذلك.
- في حالة استخدام جهاز ظاهري لتشغيل التطبيق، مكِّن الشبكات المتسارعة على الجهاز الظاهري للمساعدة في تخفيف الازدحامات بسبب ارتفاع نسبة استخدام الشبكة وتقليل زمن الانتقال أو توتر وحدة المعالجة المركزية. قد ترغب أيضاً في النظر في استخدام جهاز ظاهري بنهاية عالية حيث يبلغ الحد الأقصى لاستخدام وحدة المعالجة المركزية أقل من 70٪.
- بشكل افتراضي، يتم إرجاع نتائج الاستعلام في مجموعات من 100 عنصر أو 4 ميغابايت، أيهما يصل أولا. إذا أعاد الاستعلام أكثر من 100 عنصر، قم بزيادة حجم الصفحة لتقليل عدد الرحلات ذهابا وإيابا المطلوبة. يزداد استهلاك الذاكرة مع زيادة حجم الصفحة.