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

ينطبق على: NoSQL

يتم تضمين أحدث نماذج التطبيقات التي تنفذ عمليات 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 قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

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

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

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

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

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

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

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

• في حال كان كل ما تعرفه هو عدد vcores والخوادم في مجموعة قاعدة البيانات الحالية، فاقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs
• إذا كان كل ما تعرفه هو عدد vcores والخوادم الموجودة في مجموعة قاعدة البيانات، اقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs