aio الحزمة

الفصول

ContainerProxy

واجهة للتفاعل مع حاوية DB معينة.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، استخدم <xref:azure.cosmos.aio.database.DatabaseProxy.get_container_client> الأسلوب للحصول على حاوية موجودة، أو <xref:azure.cosmos.aio.database.DatabaseProxy.create_container> الأسلوب لإنشاء حاوية جديدة.

حاوية في قاعدة بيانات Azure Cosmos DB SQL API هي مجموعة من المستندات، يتم تمثيل كل منها كعنصر.

CosmosClient

تمثيل منطقي من جانب العميل لحساب Azure Cosmos DB.

استخدم هذا العميل لتكوين الطلبات وتنفيذها إلى خدمة Azure Cosmos DB.

يوصى به للحفاظ على مثيل واحد من CosmosClient لكل عمر للتطبيق الذي يتيح إدارة الاتصال والأداء الفعالين.

تهيئة CosmosClient هي عملية ثقيلة - لا تستخدم مثيلات تهيئة CosmosClient كبيانات اعتماد أو عمليات التحقق من صحة اتصال الشبكة.

إنشاء مثيل CosmosClient جديد.

DatabaseProxy

واجهة للتفاعل مع قاعدة بيانات معينة.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، استخدم <xref:azure.cosmos.aio.cosmos_client.CosmosClient.get_database_client> الأسلوب للحصول على قاعدة بيانات موجودة، أو <xref:azure.cosmos.aio.cosmos_client.CosmosClient.create_database> الأسلوب لإنشاء قاعدة بيانات جديدة.

تحتوي قاعدة البيانات على حاوية واحدة أو أكثر، يمكن أن تحتوي كل منها على عناصر وإجراءات مخزنة ومشغلات ووظائف معرفة من قبل المستخدم.

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

تحتوي قاعدة بيانات Azure Cosmos DB SQL API على الخصائص التالية التي أنشأها النظام. هذه الخصائص للقراءة فقط:

  • _rid: معرف المورد.

  • _ts: عند آخر تحديث للمورد. القيمة هي طابع زمني.

  • _self: عنوان URI الفريد القابل للعنوان للمورد.

  • _etag: اسم المورد المطلوب للتحكم في التزامن المتفائل.

  • _colls: المسار القابل للعنوان لمورد المجموعات.

  • _users: المسار القابل للعنوان لمورد المستخدمين.

ScriptsProxy

واجهة للتفاعل مع الإجراءات المخزنة.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، استخدم السمة scripts .

UserProxy

واجهة للتفاعل مع مستخدم معين.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، استخدم get_user_client الأسلوب .