Spring Data Azure Cosmos DB v5 لواجهة برمجة التطبيقات ل NoSQL: ملاحظات الإصدار والموارد
ينطبق على: 
NoSQL
يسمح الإصدار 5 من Spring Data Azure Cosmos DB ل NoSQL للمطورين باستخدام Azure Cosmos DB في تطبيقات Spring. يعرض Spring Data Azure Cosmos DB واجهة Spring Data لمعالجة قواعد البيانات والمجموعات، والعمل مع المستندات، وإصدار الاستعلامات. يتم دعم كل من واجهات برمجة التطبيقات للمزامنة وغير المتزامنة (التفاعلية) في نفس الأداة Maven.
Spring Framework هو نموذج برمجة وتكوين يبسط عملية تطوير تطبيقات Java. يبسط الربيع "السباكة" للتطبيقات باستخدام مضخات التبعية. يحب العديد من المطورين Spring لأنه يجعل إنشاء التطبيقات واختبارها أكثر وضوحاً. يوسع Spring Boot هذه المعالجة لأعمال السباكة مع التركيز على تطوير تطبيقات الويب والخدمات المصغرة. Spring Data عبارة عن نموذج برمجة وإطار عمل للوصول إلى مخازن البيانات مثل Azure Cosmos DB من سياق تطبيق Spring أو Spring Boot.
يمكنك استخدام Spring Data Azure Cosmos DB في تطبيقاتك المُستضافة في Azure Spring Apps.
نهج دعم الإصدار
دعم إصدار Spring Boot
يدعم هذا المشروع إصدارات Spring Boot المتعددة. تفضل بزيارة نهج دعم spring boot للحصول على مزيد من المعلومات. يمكن لمستخدمي Maven الوراثة spring-boot-starter-parent من المشروع للحصول على قسم إدارة التبعية للسماح لـ Spring بإدارة إصدارات التبعيات. تفضل بزيارة دعم إصدار spring boot للحصول على مزيد من المعلومات.
دعم إصدار Spring Data
يدعم هذا المشروع إصدارات spring-data-commons المختلفة. تفضل بزيارة دعم إصدار بيانات spring للحصول على مزيد من المعلومات.
أي إصدار من Azure Spring Data Azure Cosmos DB يجب أن أستخدمه
تدعم مكتبة Azure Spring Data Azure Cosmos DB إصدارات متعددة من Spring Boot / Spring Cloud. راجع تعيين إصدار Azure Cosmos DB ل Azure Spring Data للحصول على معلومات مفصلة حول إصدار Azure Spring Data Azure Cosmos DB لاستخدامه مع إصدار Spring Boot / Spring Cloud.
هام
ملاحظات الإصدار هذه هي للإصدار 5 من Spring Data Azure Cosmos DB.
تعتمد Azure Spring Data Azure Cosmos DB SDK على إطار عمل Spring Data، وتدعم فقط واجهة برمجة التطبيقات ل NoSQL.
راجع هذه المقالات للحصول على معلومات حول Spring Data على واجهات برمجة تطبيقات Azure Cosmos DB الأخرى:
ابدأ بسرعة
ابدأ العمل باستخدام Spring Data Azure Cosmos DB من خلال اتباع دليل Spring Boot Starter . نهج Spring Boot Starter هو الطريقة الموصى بها لبدء استخدام موصل Spring Data Azure Cosmos DB.
بدلاً من ذلك، يمكنك إضافة تبعية Spring Data Azure Cosmos DB إلى ملف pom.xml كما هو موضح أدناه:
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-spring-data-cosmos</artifactId>
<version>latest-version</version>
</dependency>
محتوى مفيد
| المحتوى | الارتباط |
|---|---|
| ملاحظات الإصدار | ملاحظات الإصدار ل Spring Data Azure Cosmos DB SDK v5 |
| وثائق SDK | وثائق Azure Spring Data Azure Cosmos DB SDK v5 |
| تنزيل SDK | Maven |
| مستندات API | وثائق مرجعية لواجهة برمجة تطبيقات Java |
| المساهمة في SDK | Azure SDK لـ Java Central Repo على GitHub |
| بدء الاستخدام | التشغيل السريع: إنشاء تطبيق Spring Data Azure Cosmos DB لإدارة Azure Cosmos DB لبيانات NoSQL GitHub repo بتعليمة برمجية لبدء التشغيل |
| نماذج التعليمات البرمجية الأساسية | Azure Cosmos DB: أمثلة Spring Data Azure Cosmos DB لواجهة برمجة التطبيقات ل NoSQL GitHub repo مع نموذج التعليمات البرمجية |
| نصائح حول الأداء | نصائح أداء Java SDK v4 (تنطبق على Spring Data) |
| استكشاف الأخطاء وإصلاحها | تحرّي خلل Java SDK الإصدار 4 وإصلاحه (ينطبق على Spring Data) |
| ورش عمل ومعامل Azure Cosmos DB | الصفحة الرئيسية لورش عمل Azure Cosmos DB |
محفوظات الإصدارات
يتم الاحتفاظ بمحفوظات الإصدار في azure-sdk-for-java repo، للحصول على قائمة مفصلة من الإصدارات، راجع ملف changelog.
إصدار الموصى به
يوصى بشدة باستخدام الإصدار 5.18.0 والإصدارات الأحدث.
ملاحظات إضافية
- يدعم Spring Data Azure Cosmos DB v5 Java JDK 17 وما فوق فقط.
الأسئلة المتداولة
كيف سيتم إخطاري بانتهاء حزمة 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.
تعرف على المزيد حول Spring Framework.
تعرف على المزيد حول Spring Boot.
تعرف على المزيد حول بيانات Spring.