مشاركة عبر

إنشاء قاعدة بيانات في Azure Cosmos DB ل NoSQL باستخدام Python

  • ينطبق على: ✅ NoSQL

قواعد البيانات في Azure Cosmos DB هي وحدات إدارة لحاوية أو أكثر. قبل أن تتمكن من إنشاء أو إدارة الحاويات، يجب أولا إنشاء قاعدة بيانات.

سم قاعدة بيانات

في Azure Cosmos DB، قاعدة البيانات تشبه مساحة الأسماء. عند إنشاء قاعدة بيانات، يشكل اسم قاعدة البيانات جزءا من رابط المستخدم للوصول إلى مورد قاعدة البيانات وأي موارد فرعية.

بمجرد إنشائها، يكون URI لقاعدة البيانات بهذا الشكل:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>

إنشاء قاعدة بيانات

لإنشاء قاعدة بيانات، استدعي إحدى الطرق التالية:

إنشاء قاعدة بيانات

المثال التالي ينشئ قاعدة بيانات باستخدام الطريقة CosmosClient.create_database . تفرض هذه الطريقة استثناء إذا وجدت قاعدة بيانات تحمل نفس الاسم.

try:
    database = client.create_database(id=DATABASE_ID)
    print(f"Database created: {database.id}")

except CosmosResourceExistsError:
    print("Database already exists.")

أنشئ قاعدة بيانات إذا لم تكن موجودة بالفعل

المثال التالي ينشئ قاعدة بيانات باستخدام الطريقة CosmosClient.create_database_if_not_exists . إذا كانت قاعدة البيانات موجودة، فإن هذه الطريقة تعيد إعدادات قاعدة البيانات. مقارنة بطريقة الإنشاء السابقة، هذه الطريقة لا تظهر استثناء إذا كانت قاعدة البيانات موجودة بالفعل. هذا الأسلوب مفيد لتجنب الأخطاء إذا قمت بتشغيل نفس التعليمة البرمجية عدة مرات.

try:
    database = client.create_database_if_not_exists(id=DATABASE_ID)
    print(f"Database created or returned: {database.id}")

except CosmosHttpResponseError:
    print("Request to the Azure Cosmos database service failed.")

إنشاء قاعدة بيانات بشكل غير متزامن

يمكنك أيضا إنشاء قاعدة بيانات بشكل غير متزامن باستخدام كائن وطرق مشابهة في مساحة اسم azure.cosmos.aio . على سبيل المثال، استخدم الطريقة CosmosClient.create_database أو CosmosClient.create_database_if_not_exists الطريقة.

العمل بشكل غير متزامن مفيد عندما تريد تنفيذ عدة عمليات بالتوازي. لمزيد من المعلومات، راجع Using the asynchronous client.

تحليل الاستجابة

في الأمثلة أعلاه، يكون الاستجابة من الطلبات هي ، DatabaseProxyوهي واجهة للتفاعل مع قاعدة بيانات محددة. من خلال الوكيل، يمكنك الوصول إلى طرق لتنفيذ العمليات على قاعدة البيانات.

المثال التالي يوضح طريقة create_database_if_not_exists التي تعيد كائن قاعدة البيانات .

database = client.create_database_if_not_exists(id=DATABASE_ID)
for container in database.list_containers():
    print(f'Container name: {container["id"]}')

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

الآن بعد أن أنشأت قاعدة بيانات، استخدم الدليل التالي لإنشاء الحاويات.

إنشاء حاوية

  • Last updated on