مشاركة عبر

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

  • مقالة

ينطبق على: NoSQL

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

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

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

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

يوضح نموذج database_management.py Python كيفية القيام بالمهام التالية باستخدام أساليب CosmosClient. للتعرف على قواعد بيانات Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
إنشاء قاعدة بيانات CosmosClient.create_database
قراءة قاعدة بيانات حسب المعرّف CosmosClient.get_database_client
الاستعلام عن قواعد البيانات CosmosClient.query_databases
إدراج قواعد البيانات في حساب CosmosClient.list_databases
حذف قاعدة بيانات CosmosClient.delete_database

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

يوضح نموذج container_management.py Python كيفية القيام بالمهام التالية باستخدام أساليب DatabaseProxy. للتعرف على مجموعات Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
الاستعلام عن حاوية database.query_containers
إنشاء حاوية database.create_container
سرد جميع الحاويات في قاعدة بيانات database.list_containers
الحصول على حاوية حسب معرّفها database.get_container_client
إدارة معدل النقل المُقدم للحاوية container.replace_throughput
حذف حاوية database.delete_container

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

توضح عينات document_management.py و change_feed_management.py Python كيفية القيام بالمهام التالية باستخدام أساليب ContainerProxy. للتعرف على عناصر Azure Cosmos DB قبل تشغيل العينات التالية، راجع المقالة المفاهيمية للعمل مع قواعد البيانات والحاويات والعناصر .

مهمة مرجع واجهة برمجة التطبيقات
إنشاء عناصر في حاوية container.create_item
قراءة عنصر حسب مُعرّفه container.read_item
قراءة جميع العناصر في حاوية container.read_all_items
الاستعلام عن عنصر حسب مُعرّفه container.query_items
استبدال عنصر container.replace_item
إجراء عملية Upsert على العنصر container.upsert_item
حذف عنصر container.delete_item
الحصول على موجز تغيير العناصر في حاوية container.query_items_change_feed

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

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

مهمة مرجع واجهة برمجة التطبيقات
استبعاد عنصر معين من الفهرسة الوثائق.الفهرسةالصفية. استبعاد
استخدام الفهرسة اليدوية مع عناصر مفهرسة معينة documents.IndexingDirective.Include
استبعاد المسارات من الفهرسة تحديد المسارات التي يجب استبعادها في الخاصية IndexingPolicy
استخدام فهارس النطاقات على سلاسل تعريف نهج الفهرسة مع فهارس النطاق على نوع بيانات السلسلة. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
تنفيذ تحويل فهرس قاعدة بيانات. replace_container (استخدم نهج الفهرسة المحدث)
استخدام عمليات الفحص عند وجود فهرس التجزئة فقط على المسار تعيين enable_scan_in_query=True وenable_cross_partition_query=True عند الاستعلام عن العناصر

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

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