مشاركة عبر

Azure Cosmos DB for NoSQL: أمثلة Spring Data Azure Cosmos DB v5

  • مقالة

ينطبق على: NoSQL

هام

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

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

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

هام

إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

بدلاً من ذلك، يمكنك تجربة قاعدة بيانات Azure Cosmos مجاناً دون اشتراك Azure، مجاناً دون التزامات. بدلاً من ذلك، يمكنك إنشاء حساب Azure Cosmos DB مجاني ، مع أول 1000 RU/s و 25GB من التخزين مجاناً. يمكنك أيضًا استخدام محاكي Azure Cosmos DB مع عنوان URL المستخدم https://localhost:8081. لاستخدام المفتاح مع المحاكي، راجع مصادقة الطلبات.

يتم تضمين أحدث نماذج التطبيقات التي تنفذ عمليات CRUD والعمليات الشائعة الأخرى على موارد Azure Cosmos DB في مستودع GitHub azure-spring-boot-samples . توفر هذه المقالة:

  • ارتباطات إلى المهام في كل أمثلة ملفات مشروع Spring Data الخاصة بـ ​Azure Cosmos DB.
  • روابط إلى المحتوى المرجعي API ذات الصلة.

المتطلبات المسبقه

تحتاج إلى ما يلي لتشغيل نموذج التطبيق هذا:

  • Java Development Kit 8
  • Spring Data Azure Cosmos DB v5

يمكنك اختياريًا استخدام Maven للحصول على أحدث ثنائيات الإصدار 3 من Spring Data في Azure Cosmos DB لاستخدامها في مشروعك. يضيف Maven تلقائيًا أي تبعيات ضرورية. بخلاف ذلك، يمكنك تنزيل التبعيات المدرجة في ملف pom.xml وإضافتها إلى مسار البناء مباشرةً.

<dependency>
	<groupId>com.azure</groupId>
	<artifactId>azure-spring-data-cosmos</artifactId>
	<version>LATEST</version>
</dependency>

تشغيل نماذج التطبيقات

استنساخ مستودع النموذج:

$ git clone https://github.com/Azure-Samples/azure-spring-boot-samples

$ cd cosmos/azure-spring-data-cosmos/spring3-samples/cosmos-quickstart-samples

يمكنك تشغيل العينات باستخدام إما IDE (Eclipse أو IntelliJ أو VS Code) أو من سطر الأوامر باستخدام Maven.

في application.properties، يجب تعيين متغيرات البيئة هذه

cosmos.uri=${ACCOUNT_HOST}
cosmos.key=${ACCOUNT_KEY}
cosmos.secondaryKey=${SECONDARY_ACCOUNT_KEY}

dynamic.collection.name=spel-property-collection
# Populate query metrics
cosmos.queryMetricsEnabled=true

من أجل منح العينات إذن الوصول لإمكانيات القراءة والكتابة إلى حسابك وقواعد بياناتك وحاوياتك.

قد توفر IDE القدرة على تنفيذ عينة التعليمات البرمجية لـ Spring Data. بخلاف ذلك، يمكنك استخدام الأمر الطرفي التالي لتنفيذ العينة:

mvn spring-boot:run

أمثلة على CRUD المستند

يوضح ملف العينات كيفية إجراء المهام التالية. للتعرف على مستندات Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
أنشئ مستند CosmosRepository.save
اقرأ مستندًا بواسطة ID CosmosRepository.derivedQueryMethod
حذف جميع المستندات CosmosRepository.deleteAll

أمثلة على أساليب الاستعلامات المشتقة

يوضح ملف العينات كيفية إجراء المهام التالية. للتعرف على استعلامات Azure Cosmos DB قبل تشغيل العينات التالية، قد تفيدك قراءة مقالة أساليب الاستعلامات المشتقة من Baeldung في Spring.

| استعلام عن مستندات | CosmosRepository.derivedQueryMethod |

أمثلة على الاستعلامات المخصصة

يوضح ملف العينات كيفية تنفيذ المهام التالية باستخدام قواعد استعلام SQL. للتعرف على مرجع استعلام SQL في Azure Cosmos DB قبل تشغيل العينات التالية، راجع أمثلة على استعلام SQL لـ Azure Cosmos DB.

مهمة مرجع واجهة برمجة التطبيقات
استعلام عن جميع المستندات تعليق توضيحي @Query
استعلام عن المساواة باستخدام == تعليق توضيحي @Query
استعلام عن عدم المساواة باستخدام != وNOT تعليق توضيحي @Query
طلب بحث باستخدام عوامل تشغيل النطاق مثل >، <، >=، <= تعليق توضيحي @Query
استعلام باستخدام عوامل تشغيل النطاق مقابل السلاسل تعليق توضيحي @Query
استعلام باستخدام ORDER BY تعليق توضيحي @Query
استعلام باستخدام "مميز" تعليق توضيحي @Query
استعلام باستخدام وظائف مجمعة تعليق توضيحي @Query
استخدام المستندات الفرعية تعليق توضيحي @Query
استعلم باستخدام صلات داخل المستند تعليق توضيحي @Query
استعلام باستخدام عوامل تشغيل السلسلة والرياضيات والمصفوفات تعليق توضيحي @Query

الخطوات التالية

هل تحاول القيام بتخطيط السعة للترحيل إلى Azure Cosmos DB؟ يمكنك استخدام معلومات حول نظام مجموعة قاعدة البيانات الموجودة لديك لـ تخطيط السعة.