أمثلة ل Azure Cosmos DB ل NoSQL SDK ل Python
ينطبق على: NoSQL
يتم تضمين نماذج الحلول التي تقوم بعمليات CRUD والعمليات الشائعة الأخرى على موارد Azure Cosmos DB في main/sdk/cosmos
مجلد مستودع Azure/azure-sdk-for-python GitHub. توفر هذه المقالة:
- ارتباطات إلى المهام الموجودة في كل ملفات مشروع أمثلة Python.
- روابط إلى المحتوى المرجعي API ذات الصلة.
المتطلبات الأساسية
- حساب Azure Cosmos DB. خياراتك هي:
- ضمن اشتراك Azure النشط:
- إنشاء حساب Azure مجاني أو استخدام اشتراكك الحالي
- بيانات فريق عمل Visual Studio الشهرية
- Azure Cosmos DB Free Tier
- بدون اشتراك Azure النشط:
- جرب Azure Cosmos DB مجاناً، وهي بيئة اختبارات تستمر لمدة 30 يوماً.
- Azure Cosmos DB Emulator
- ضمن اشتراك Azure النشط:
- Python 3.7+، مع
python
القابل للتنفيذ فيPATH
. (لمزيد من المعلومات، راجع نهج دعم إصدار Azure SDKs Python.) - تعليمة Visual Studio البرمجية.
- ملحق Python لـ Visual Studio Code.
- Git.
- Azure Cosmos DB ل NoSQL SDK ل Python
أمثلة قاعدة البيانات
يوضح نموذج 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؟ يمكنك استخدام معلومات حول نظام مجموعة قاعدة البيانات الموجودة لديك لـ تخطيط السعة.
- إذا لم تكن تعرف سوى عدد vCores والخوادم في نظام مجموعة قاعدة البيانات الحالية فقط، فاقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs
- إذا كان كل ما تعرفه هو عدد vcores والخوادم الموجودة في مجموعة قاعدة البيانات، اقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs