مشاركة عبر

أمثلة ل Azure Cosmos DB ل NoSQL SDK ل JS

  • مقالة

ينطبق على: NoSQL

يتم تضمين نماذج الحلول التي تنفذ عمليات CRUD والعمليات الشائعة الأخرى على موارد Azure Cosmos DB في JavaScript SDK لمستودع Azure Cosmos DB GitHub. توفر هذه المقالة:

  • ارتباطات للمهام في كل من ملفات مشروع مثال Node.js.
  • روابط إلى المحتوى المرجعي API ذات الصلة.

المتطلبات الأساسية

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

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

تحتاج أيضاً إلى حزمة تطوير برنامج JavaScript.

إشعار

كل النماذج مستقلة، وتقوم بضبط وتنظيف نفسها تلقائياً. وعلى هذا النحو، تُصدر النماذج استدعاءات متعددة إلى Containers.create. وفي كل مرة يتم فيها ذلك، تتم محاسبتك على الاشتراك لمدة ساعة واحدة من استخدام كل مستوى أداء للحاوية التي يتم إنشاؤها.

أمثلة قاعدة البيانات

يُظهر ملف DatabaseManagement كيفية تنفيذ عمليات CRUD على قاعدة البيانات. للتعرف على قواعد بيانات Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
إنشاء قاعدة بيانات إذا لم تكن موجودة Databases.createIfNotExists
إدراج قواعد البيانات في حساب Databases.readAll
قراءة قاعدة بيانات حسب المعرّف Database.read
حذف قاعدة بيانات Database.delete

أمثلة الحاوية

يُظهر ملف ContainerManagement كيفية تنفيذ عمليات CRUD على الحاوية. للتعرف على مجموعات Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
إنشاء حاوية إذا لم تكن موجودة Containers.createIfNotExists
إدراج حاويات في حساب Containers.readAll
قراءة تعريف حاوية Container.read
حذف حاوية Container.delete

أمثلة العناصر

يُظهر ملف ItemManagement كيفية تنفيذ عمليات CRUD على العناصر. للتعرف على مستندات Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
إنشاء عناصر Items.create
قراءة جميع العناصر في حاوية Items.readAll
قراءة العنصر تبعًا للمعرّف ID Item.read
قراءة العنصر إذا تم تغيير العنصر فحسب Item.read - RequestOptions.accessCondition
استعلام عن المستندات Items.query
استبدال عنصر Item.replace
استبدال عنصر مع فحص ETag الشرطي Item.replace - RequestOptions.accessCondition
حذف عنصر Item.delete

فهرسة الأمثلة

يُظهر الملف IndexManagement كيفية إدارة الفهرسة. وللتعرف على الفهرسة في قاعدة بيانات Azure Cosmos قبل تشغيل النماذج الآتية، راجع المقالة المفاهيمية سياسات الفهرسة وأنواع الفهرسة ومسارات الفهرسة.

مهمة مرجع واجهة برمجة التطبيقات
فهرسة عنصر معين يدوياً RequestOptions.indexingDirective: 'include'
استبعاد عنصر معين يدوياً من الفهرس RequestOptions.indexingDirective: 'exclude'
استبعاد مسار من الفهرس IndexingPolicy.ExcludedPath
إنشاء فهرس نطاق على مسار سلسلة IndexKind.Range, IndexingPolicy, Items.query
إنشاء حاوية باستخدام indexPolicy الافتراضي، ثم تحديث الحاوية عبر الإنترنت Containers.create

أمثلة برمجة من جانب الخادم

يوضح ملف index.ts كيفية تنفيذ المهام التالية. وللتعرّف على البرمجة من جانب الخادم في قاعدة بيانات Azure Cosmos قبل تشغيل النماذج الآتية، راجع المقالة التصورية الإجراءات المخزّنة والمشغّلات والوظائف المعرّفة من قبل المستخدم.

مهمة مرجع واجهة برمجة التطبيقات
إنشاء إجراء مخزّن StoredProcedures.create
تنفيذ إجراء مخزن StoredProcedure.execute
تحديث مجمع مع إجراء مخزن StoredProcedure.execute

لمزيد من المعلومات حول البرمجة من جانب الخادم، راجع البرمجة من جانب خادم قاعدة بيانات Azure Cosmos: الإجراءات المخزّنة ومشغّلات قاعدة البيانات وUDFs.

أمثلة على Microsoft Entra Auth

يوضح ملف EntraAuth.ts كيفية تنفيذ المهام التالية.

مهمة مرجع واجهة برمجة التطبيقات
Create credential object from @azure/identity API
تمرير بيانات اعتماد الرمز المميز إلى منشئ العميل API
تنفيذ عميل cosmos باستخدام بيانات اعتماد aad API

عينات متنوعة

توضح العينات المنسقة التالية السيناريوهات الشائعة.

مهمة مرجع واجهة برمجة التطبيقات
تغيير معدل نقل الاستعلام API
الحصول على معدل نقل الاستعلام API
استخدام SasTokens لمنح الوصول المحدد النطاق إلى موارد Cosmos DB API

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

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