مشاركة عبر

Spring Data Azure Cosmos DB v2 لواجهة برمجة التطبيقات ل NoSQL (قديم): ملاحظات الإصدار والموارد

  • مقالة

ينطبق على: NoSQL

يسمح الإصدار 2 من Spring Data Azure Cosmos DB ل NoSQL للمطورين باستخدام Azure Cosmos DB في تطبيقات Spring. يعرض Spring Data Azure Cosmos DB واجهة Spring Data لمعالجة قواعد البيانات والمجموعات، والعمل مع المستندات، وإصدار الاستعلامات. يتم دعم كل من واجهات برمجة التطبيقات للمزامنة وغير المتزامنة (التفاعلية) في نفس الأداة Maven.

تحذير

يعتمد هذا الإصدار من Spring Data Azure Cosmos DB SDK على إصدار متوقف من Azure Cosmos DB Java SDK. سيتم الإعلان عن Spring Data Azure Cosmos DB SDK هذا على أنه سيتوقف في المستقبل القريب! هذا ليس أحدث Azure Spring Data Azure Cosmos DB SDK ل Azure Cosmos DB وهو قديم. نظرا لمشكلات الأداء وعدم الاستقرار في Azure Spring Data Azure Cosmos DB SDK V2، نوصي بشدة باستخدام Azure Spring Data Azure Cosmos DB v3 لمشروعك. للترقية، اتبع الإرشادات الواردة في دليل الترحيل إلى Azure Cosmos DB Java SDK v4 لفهم الاختلاف في Java SDK V4 الأساسي.

Spring Framework هو نموذج برمجة وتكوين يبسط عملية تطوير تطبيقات Java. يبسط الربيع "السباكة" للتطبيقات باستخدام مضخات التبعية. يحب العديد من المطورين Spring لأنه يجعل إنشاء التطبيقات واختبارها أكثر وضوحاً. يوسع Spring Boot هذه المعالجة لأعمال السباكة مع التركيز على تطوير تطبيقات الويب والخدمات المصغرة. تمثل Spring Data نموذج برمجة للوصول إلى مخازن البيانات كقاعدة بيانات Azure Cosmos DB من سياق تطبيق Spring أو Spring Boot.

يمكنك استخدام Spring Data Azure Cosmos DB في تطبيقاتك المُستضافة في Azure Spring Apps.

هام

ملاحظات الإصدار هذه للإصدار 2 من Spring Data Azure Cosmos DB. يمكنك العثور على ملاحظات الإصدار للإصدار 3 هنا.

يدعم Spring Data Azure Cosmos DB واجهة برمجة التطبيقات ل NoSQL فقط.

راجع المقالات التالية للحصول على معلومات حول Spring Data على واجهات برمجة تطبيقات Azure Cosmos DB الأخرى:

هل ترغب في التنقل بسرعة؟

  1. قم بتثبيت الحد الأدنى من وقت تشغيل Java المدعوم، JDK 8، حتى تتمكن من استخدام SDK.
  2. أنشئ تطبيق Spring Data Azure Cosmos DB باستخدام المبدئ. إنه أمر سهل
  3. ابدأ العمل من خلال دليل مطور قاعدة بيانات Spring Data Azure Cosmos DB الذي يشرح الطلبات الأساسية لقاعدة بيانات Azure Cosmos DB.

يمكنك تشغيل تطبيقات Spring Boot Starter بسرعة باستخدام Spring Initializr!

الموارد

Resource الارتباط‬
تنزيل SDK Maven
مستندات API الوثائق المرجعية لـ Spring Data Azure Cosmos DB
المساهمة في SDK مستودع Spring Data Azure Cosmos DB على GitHub
بادئ Spring Boot مكتبة عميل Azure Cosmos DB Spring Boot Starter لـ Java
دليل المطور دليل مطور Spring Data Azure Cosmos DB
استخدام Starter كيفية استخدام Spring Boot Starter مع Azure Cosmos DB ل NoSQL
GitHub repo لـ Azure Cosmos DB Spring Boot Starter
نموذج مع خدمة تطبيق Azure كيفية استخدام Spring وAzure Cosmos DB مع App Service على Linux

محفوظات الإصدارات

2.3.0 (مايو 21، 2020)

الميزات الجديدة

  • يحدّث إصدار Spring Boot إلى 2.3.0.

2.2.5 (19 مايو 2020)

الميزات الجديدة

  • يحدّث إصدار Azure Cosmos DB إلى 3.7.3.

إصلاحات الشوائب الرئيسية

  • يحتوي على إصلاحات تسرب الذاكرة وترقيات إصدار Netty منAzure Cosmos DB SDK 3.7.3.

2.2.4 (6 أبريل 2020)

إصلاحات الشوائب الرئيسية

  • إصلاحات علامة allowTelemetry لأخذها في الاعتبار من CosmosDbConfig.
  • يعمل على إصلاح خاصية TTL الموجودة في الحاوية.

2.2.3 (25 فبراير 2020)

الميزات الجديدة

  • إضافة findAll جديد عن طريق واجهة برمجة تطبيقات مفتاح القسم.
  • يحدّث إصدار Azure Cosmos DB إلى 3.7.0.

إصلاحات الشوائب الرئيسية

  • الإصلاحات collectionName ->containerName.
  • الإصلاحات entityClass و domainClass ->domainType.
  • إجراء إصلاحات "إرجاع مجموعة الكيانات المحفوظة بواسطة المستودع بدلًا من كيان الإدخال".

2.1.10 (25 فبراير 2020)

إصلاحات الشوائب الرئيسية

  • إصلاح الأحمال العكسية لخيار "إعادة مجموعة كيان محفوظة بواسطة المستودع بدلًا من كيان الإدخال".

2.2.2 (15 يناير 2020)

الميزات الجديدة

  • يحدّث إصدار Azure Cosmos DB إلى 3.6.0.

إصلاحات الشوائب الرئيسية

2.2.1 (31 ديسمبر 2019)

الميزات الجديدة

  • يحدّث إصدار Azure Cosmos DB SDK إلى 3.5.0.
  • يضيف حقل التعليق التوضيحي لتمكين أو تعطيل إنشاء المجموعة تلقائياً.
  • يحسن معالجة الاستثناءات. يعرض من CosmosClientException إلى CosmosDBAccessException.
  • يعرض requestCharge وactivityId إلى ResponseDiagnostics.

إصلاحات الشوائب الرئيسية

  • يعمل تحديث SDK 3.5.0 على إصلاح "الاستثناء عندما يكون رأس استجابة Http Azure Cosmos DB أكبر من 8192 بايت"، وفشل "ConsistencyPolicy.defaultConsistencyLevel() على Bounded Staleness وS consistent Prefix."
  • إصلاحfindById تحليل الأسلوب في السابق، كان يظهر هذا الأسلوب فارغًا إذا لم يُعثر على الكيان بدلًا من طرح استثناء.
  • يعمل على إصلاح خطأ حيث لم يتم تطبيق الفرز على الصفحة التالية عند استخدام CosmosPageRequest.

2.1.9 (26 ديسمبر 2019)

الميزات الجديدة

  • يضيف حقل التعليق التوضيحي لتمكين أو تعطيل إنشاء المجموعة تلقائياً.

إصلاحات الشوائب الرئيسية

  • إصلاحfindById تحليل الأسلوب في السابق، كان يظهر هذا الأسلوب فارغًا إذا لم يُعثر على الكيان بدلًا من طرح استثناء.

2.2.0 (21 أكتوبر 2019)

الميزات الجديدة

  • دعم مستودع Azure Cosmos DB التفاعلي الكامل.
  • Azure Cosmos DB طلب سلسلة التشخيص ودعم مقاييس الاستعلام.
  • تحديث إصدار Azure Cosmos DB SDK إلى 3.3.1.
  • ترقية إصدار Spring Framework إلى 5.2.0.
  • ترقية إصدار Spring Data Commons إلى 2.2.0.
  • يضيف واجهات برمجة تطبيقات findByIdAndPartitionKey وdeleteByIdAndPartitionKey.
  • يزيل التبعية من azure-documentdb.
  • إعادة إطلاق قاعدة بيانات DocumentDB إلى قاعدة بيانات Azure Cosmos DB.

إصلاحات الشوائب الرئيسية

  • يعمل على إصلاح "الفرز يطرح استثناء عندما يكون حجم الصفحة أقل من إجمالي العناصر في المستودع".

2.1.8 (18 أكتوبر 2019)

الميزات الجديدة

  • توقف واجهات برمجة تطبيقات DocumentDB.
  • يضيف واجهات برمجة تطبيقات findByIdAndPartitionKey وdeleteByIdAndPartitionKey.
  • يضيف قفلاً متفائلاً على أساس _etag.
  • لتمكين تعبير SpEL لاسم مجموعة المستندات.
  • يضيف ObjectMapper من التحسينات.

2.1.7 (18 أكتوبر 2019)

الميزات الجديدة

  • يضيف تبعية الإصدار 3 من Azure Cosmos DB SDK.
  • يضيف مستودع Azure Cosmos DB التفاعلي.
  • تحديثات تطبيق DocumentDbTemplate لاستخدام Azure Cosmos DB SDK الإصدار 3.
  • يضيف تغييرات التكوين الأخرى لدعم مستودع Azure Cosmos DB التفاعلي.

2.1.2 (19 مارس 2019)

إصلاحات الشوائب الرئيسية

  • إزالة التبعية applicationInsights من أجل:
    • المخاطر المحتملة لتلويث التبعيات.
    • عدم توافق Java 11.
    • تجنب تأثير الأداء المحتمل على وحدة المعالجة المركزية و/ أو الذاكرة.

2.0.7 (20 مارس 2019)

إصلاحات الشوائب الرئيسية

  • يزيل Backport التبعية applicationInsights ل:
    • المخاطر المحتملة لتلويث التبعيات.
    • عدم توافق Java 11.
    • تجنب تأثير الأداء المحتمل على وحدة المعالجة المركزية و/ أو الذاكرة.

2.1.1 (7 مارس 2019)

الميزات الجديدة

  • يحدّث الإصدار الرئيسي إلى 2.1.1.

2.0.6 (7 مارس 2019)

الميزات الجديدة

  • تجاهل كل الاستثناءات من القياس عن بعد.

2.1.0 (17 ديسمبر 2018)

الميزات الجديدة

  • يحدّث الإصدار إلى 2.1.0 لمعالجة المشكلة.

2.0.5 (13 سبتمبر 2018)

الميزات الجديدة

  • يضيف الكلمات الرئيسية exists وstartsWith.
  • الملف التمهيدي للتحديثات.

إصلاحات الشوائب الرئيسية

  • إصلاحات "لا يمكن استدعاء href الذاتية للكيان مباشرة".
  • إصلاحات "ستفشل findAll إذا لم يتم إنشاء المجموعة".

2.0.4 (الإصدار التجريبي) (23 أغسطس 2018)

الميزات الجديدة

  • يعيد تسمية الحزمة من documentdb إلى cosmosdb.
  • يضيف ميزة جديدة من الكلمات الأساسية لطريقة الاستعلام. يتم الآن دعم 16 كلمة أساسية من واجهة برمجة التطبيقات ل NoSQL.
  • يضيف ميزة جديدة للاستعلام مع الترحيل والفرز.
  • يبسط تكوين Spring-data-cosmosdb.
  • يضيف واجهات برمجة تطبيقات deleteCollection وdeleteAll.

إصلاحات الشوائب الرئيسية

  • إصلاح الخلل وتخفيف الخلل.

الأسئلة المتداولة

كيف سيتم إخطاري بانتهاء حزمة 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.