أمثلة Node.js لإدارة البيانات في قاعدة بيانات Azure Cosmos

  • مقالة
  • قراءة خلال 3 دقائق

ينطبق على: واجهة برمجة تطبيقات SQL

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

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

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

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

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

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

ملاحظة

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

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

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

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

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

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

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

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

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

المهمة مرجع واجهة برمجة التطبيقات‬
إنشاء عناصر Items.create
قراءة جميع العناصر في حاوية Items.readAll
قراءة العنصر حسب المعرّف 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 الخاص بمشروع ServerSideScripts كيفية تنفيذ المهام الآتية. وللتعرّف على البرمجة من جانب الخادم في قاعدة بيانات Azure Cosmos قبل تشغيل النماذج الآتية، راجع المقالة التصورية الإجراءات المخزّنة والمشغّلات والوظائف المعرّفة من قبل المستخدم.

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

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

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

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