Azure Cosmos DB Java SDK v4 لواجهة برمجة التطبيقات ل NoSQL: ملاحظات الإصدار والموارد
ينطبق على: 
NoSQL
يجمع Azure Cosmos DB Java SDK v4 for NoSQL بين واجهة برمجة تطبيقات غير متزامنة وواجهة برمجة تطبيقات مزامنة في أداة Maven واحدة. يوفر الإصدار 4 SDK أداءً محسناً وميزات جديدة لواجهة برمجة التطبيقات ودعم Async استناداً إلى Project Reactor و مكتبة Netty . يمكن للمستخدمين توقع أداء محسن مع Azure Cosmos DB Java SDK v4 مقابل Azure Cosmos DB Async Java SDK v2 و Azure Cosmos DB Sync Java SDK v2 .
هام
ملاحظات الإصدار هذه مخصصة لـ Azure Cosmos DB Java SDK v4 فقط. إذا كنت تستخدم حاليّاً إصداراً أقدم من الإصدار 4، فراجع دليل الترحيل إلى حزمة تطوير برامج Java Azure Cosmos DB - الإصدار 4 للمساعدة على الترقية إلى الإصدار 4.
فيما يلي ثلاث خطوات للمضي قدماً بسرعة!
- قم بتثبيت الحد الأدنى من وقت تشغيل Java المدعوم، JDK 8 حتى تتمكن من استخدام SDK.
- اعمل من خلال دليل البدء السريع لـ Azure Cosmos DB Java SDK v4 الذي يتيح لك الوصول إلى الأداة Maven ويمشي عبر طلبات Azure Cosmos DB الأساسية.
- اقرأ أدلة Azure Cosmos DB Java SDK v4 نصائح الأداء و تحري الخلل وإصلاحه لتحسين SDK لتطبيقك.
تعد ورش العمل والمختبرات الخاصة بـ Azure Cosmos DB مورداً رائعاً آخر لتعلم كيفية استخدام Azure Cosmos DB Java SDK v4!
محتوى مفيد
| المحتوى | الارتباط |
|---|---|
| ملاحظات الإصدار | ملاحظات حول إصدار Java SDK v4 |
| تنزيل SDK | Maven |
| مستندات API | وثائق مرجعية لواجهة برمجة تطبيقات Java |
| المساهمة في SDK | Azure SDK لـ Java Central Repo على GitHub |
| بدء الاستخدام | التشغيل السريع: إنشاء تطبيق Java لإدارة Azure Cosmos DB لبيانات NoSQL GitHub repo بتعليمة برمجية لبدء التشغيل |
| أفضل الممارسات | أفضل الممارسات بخصوص Java SDK v4 |
| نماذج التعليمات البرمجية الأساسية | Azure Cosmos DB: أمثلة Java لواجهة برمجة التطبيقات ل NoSQL GitHub repo مع نموذج التعليمات البرمجية |
| تطبيق وحدة التحكم مع تغيير الخلاصة | تغيير الخلاصة - نموذج Java SDK v4 GitHub repo مع نموذج التعليمات البرمجية |
| نموذج لتطبيق الويب | Build a web app with Java SDK v4 GitHub repo مع نموذج التعليمات البرمجية |
| نصائح حول الأداء | نصائح حول أداء Java SDK v4 |
| استكشاف الأخطاء وإصلاحها | استكشاف أخطاء Java SDK الإصدار 4 وإصلاحها |
| الترحيل إلى الإصدار 4 من SDK أقدم | الترحيل إلى Java V4 SDK |
| أدنى وقت تشغيل مدعوم | JDK 8 |
| ورش عمل ومعامل Azure Cosmos DB | الصفحة الرئيسية لورش عمل Azure Cosmos DB |
هام
- تحديثات الإصدار 4.13.0
reactor-coreوreactor-nettyالإصدارات الرئيسية إلى2020.0.4 (Europium)تدريب الإصدار.
محفوظات الإصدارات
يتم الاحتفاظ بمحفوظات الإصدار في azure-sdk-for-java repo، للحصول على قائمة مفصلة من الإصدارات، راجع ملف changelog.
إصدار الموصى به
يوصى بشدة باستخدام الإصدار 4.48.2 وما فوق.
الأسئلة المتداولة
كيف سيتم إخطاري بانتهاء حزمة SDK؟
ستقدم Microsoft إشعاراً مسبقاً قبل 12 شهراً من انتهاء دعم SDK المتقاعد لتسهيل الانتقال السلس إلى SDK المدعوم. سنعلمك من خلال قنوات الاتصال المختلفة: مدخل Azure وتحديثات Azure والاتصال المباشر بمسؤولي الخدمة المعينين.
هل يمكنني تأليف تطبيقات باستخدام حزمة Azure Cosmos DB SDK التي سيتم إيقاف العمل بها خلال فترة 12 شهراً؟
نعم، ستكون قادراً على تأليف التطبيقات ونشرها وتعديلها باستخدام Azure Cosmos DB SDK الذي سيتم إيقافه خلال فترة الإشعار التي تبلغ 12 شهراً. نوصي بالترحيل إلى إصدار أحدث مدعوم من Azure Cosmos DB SDK خلال فترة الإشعار التي تبلغ 12 شهراً، حسب الاقتضاء.
بعد تاريخ التقاعد، ماذا يحدث للتطبيقات التي تستخدم Azure Cosmos DB SDK غير المدعوم؟
بعد تاريخ التقاعد، لن يقوم Azure Cosmos DB بعد الآن بإجراء إصلاحات للأخطاء أو إضافة ميزات جديدة أو تقديم الدعم لإصدارات SDK المتوقفة. إذا كنت تفضل عدم الترقية، فسيستمر تقديم الطلبات المرسلة من الإصدارات المتوقفة من SDK بواسطة خدمة Azure Cosmos DB.
ما إصدارات SDK التي ستحتوي على أحدث الميزات والتحديثات؟
ستتم إضافة الميزات والتحديثات الجديدة فقط إلى أحدث إصدار ثانوي من أحدث إصدار SDK رئيسي مدعوم. نوصي دائماً باستخدام أحدث إصدار للاستفادة من الميزات الجديدة وتحسينات الأداء وإصلاحات الأخطاء. إذا كنت تستخدم إصداراً قديماً غير متقاعد من SDK، فستظل طلباتك إلى Azure Cosmos DB تعمل، ولكن لن تتمكن من الوصول إلى أي إمكانات جديدة.
ماذا أفعل إذا لم أتمكن من تحديث طلبي قبل الموعد النهائي؟
نوصي بالترقية إلى أحدث إصدار من SDK في أقرب وقت ممكن. بعد وضع علامة على SDK للتقاعد، سيكون لديك 12 شهراً لتحديث تطبيقك. إذا لم تتمكن من التحديث بحلول تاريخ التقاعد، فسيستمر Azure Cosmos DB في تقديم الطلبات المرسلة من الإصدارات المتقاعدة من SDK، لذلك ستستمر تطبيقاتك قيد التشغيل. لكن Azure Cosmos DB لن يُجري إصلاحات للأخطاء أو يضيف ميزات جديدة أو يوفر دعماً لإصدارات SDK المتقاعدة.
إذا كانت لديك خطة دعم وتحتاج إلى دعم فني، فاتصل بنا عن طريق ملء بطاقة دعم.
كيف يمكنني طلب إضافة ميزات إلى SDK أو موصل؟
لا تتم دائماً إضافة ميزات جديدة إلى كل SDK أو موصل على الفور. إذا كانت هناك ميزة غير مدعمة وتريد إضافتها، يرجى إضافة تعليقات إلى منتدى المجتمع.
الخطوات التالية
لمعرفة المزيد حول Azure Cosmos DB، راجع صفحة خدمة Microsoft Azure Cosmos DB .