التشغيل السريع: استخدام Azure Cosmos DB للجدول مع Azure SDK ل Python
في هذا التشغيل السريع، يمكنك نشر تطبيق Azure Cosmos DB الأساسي للجدول باستخدام Azure SDK ل Python. Azure Cosmos DB للجدول هو مخزن بيانات بلا مخطط يسمح للتطبيقات بتخزين بيانات الجدول المنظمة في السحابة. ستتعلم كيفية إنشاء جداول وصفوف وتنفيذ المهام الأساسية داخل مورد Azure Cosmos DB باستخدام Azure SDK ل Python.
الوثائق | المرجعية لواجهة برمجة التطبيقات حزمة التعليمات البرمجية | المصدر لمكتبة (PyPI) | Azure Developer CLI
المتطلبات الأساسية
- Azure Developer CLI
- Docker Desktop
- Python 3.12
إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.
تهيئة المشروع
استخدم Azure Developer CLI (azd) لإنشاء حساب Azure Cosmos DB للجدول ونشر نموذج تطبيق حاوية. يستخدم نموذج التطبيق مكتبة العميل لإدارة البيانات النموذجية وإنشاءها وقراءتها والاستعلام عن البيانات.
افتح محطة طرفية في دليل فارغ.
إذا لم تكن قد تمت مصادقتك بالفعل، فقم بالمصادقة على Azure Developer CLI باستخدام
azd auth login. اتبع الخطوات المحددة بواسطة الأداة للمصادقة على CLI باستخدام بيانات اعتماد Azure المفضلة لديك.azd auth loginاستخدم
azd initلتهيئة المشروع.azd init --template cosmos-db-table-python-quickstartأثناء التهيئة، قم بتكوين اسم بيئة فريد.
انشر حساب Azure Cosmos DB باستخدام
azd up. تنشر قوالب Bicep أيضا نموذج تطبيق ويب.azd upأثناء عملية التوفير، حدد اشتراكك والموقع المطلوب ومجموعة الموارد المستهدفة. انتظر حتى اكتمال عملية التوفير. قد تستغرق العملية حوالي خمس دقائق.
بمجرد توفير موارد Azure الخاصة بك، يتم تضمين عنوان URL لتطبيق الويب قيد التشغيل في الإخراج.
Deploying services (azd deploy) (✓) Done: Deploying service web - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io> SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.استخدم عنوان URL في وحدة التحكم للانتقال إلى تطبيق الويب الخاص بك في المستعرض. لاحظ إخراج التطبيق قيد التشغيل.
تثبيت مكتبة العميل
تتوفر مكتبة العميل من خلال PyPi، كحزمة azure-data-tables .
افتح terminal وانتقل إلى
/srcالمجلد.cd ./srcإذا لم يكن مثبتا بالفعل، فقم بتثبيت الحزمة
azure-data-tablesباستخدامpip install.pip install azure-data-tablesافتح الملف src/requirements.txt وراجعه للتحقق من
azure-data-tablesوجود الإدخال.
نموذج الكائن
| Name | الوصف |
|---|---|
TableServiceClient |
هذا النوع هو نوع العميل الأساسي ويستخدم لإدارة بيانات التعريف أو قواعد البيانات على مستوى الحساب. |
TableClient |
يمثل هذا النوع العميل لجدول داخل الحساب. |
أمثلة على التعليمات البرمجية
يستخدم نموذج التعليمات البرمجية في القالب جدولا يسمى cosmicworks-products. cosmicworks-products يحتوي الجدول على تفاصيل مثل الاسم والفئة والكمية والسعر والمعرف الفريد وعلامة البيع لكل منتج. تستخدم الحاوية معرفا فريدا كمفتاح الصف والفئة كمفتاح قسم.
مصادقة العميل
ينشئ هذا النموذج مثيلا جديدا من TableServiceClient النوع .
credential = DefaultAzureCredential()
client = TableServiceClient(endpoint="<azure-cosmos-db-table-account-endpoint>", credential=credential)
الحصول على جدول
ينشئ هذا النموذج مثيلا من TableClient النوع باستخدام الدالة GetTableClient من TableServiceClient النوع .
table = client.get_table_client("<azure-cosmos-db-table-name>")
إنشاء كيان
أسهل طريقة لإنشاء كيان جديد في جدول هي إنشاء كائن جديد لضمان تحديد الخصائص والخصائص PartitionKey الإلزاميةRowKey.
new_entity = {
"RowKey": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"PartitionKey": "gear-surf-surfboards",
"Name": "Yamba Surfboard",
"Quantity": 12,
"Sale": False,
}
إنشاء كيان في الجدول باستخدام upsert_entity.
created_entity = table.upsert_entity(new_entity)
الحصول على كيان
يمكنك استرداد كيان معين من جدول باستخدام get_entity.
existing_entity = table.get_entity(
row_key="aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
partition_key="gear-surf-surfboards",
)
الاستعلام عن الكيانات
بعد إدراج كيان، يمكنك أيضا تشغيل استعلام للحصول على كافة الكيانات التي تطابق عامل تصفية معين باستخدام query_entities مع عامل تصفية OData سلسلة.
category = "gear-surf-surfboards"
# Ensure the value is OData-compliant by escaping single quotes
safe_category = category.replace("'", "''")
filter = f"PartitionKey eq '{safe_category}'"
entities = table.query_entities(query_filter=filter)
تحليل نتائج الاستعلام المرقمة باستخدام تكرار for حلقي.
for entity in entities:
# Do something
تنظيف الموارد
عندما لم تعد بحاجة إلى نموذج التطبيق أو الموارد، قم بإزالة التوزيع المقابل وجميع الموارد.
azd down