المهارات Azure Cosmos DB SDK for Python
📦

Azure Cosmos DB SDK for Python

آمن 🌐 الوصول إلى الشبكة🔑 متغيرات البيئة

بناء تطبيقات Cosmos DB باستخدام Python SDK

العمل مع قواعد البيانات الموزعة عالميًا يتطلب فهم مفاتيح القسم والاستعلامات الفعالة. توفر هذه المهنة أنماطًا جاهزة للإنتاج لعمليات Azure Cosmos DB باستخدام Python SDK الرسمي.

يدعم: Claude Codex Code(CC)
🥉 73 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "Azure Cosmos DB SDK for Python". Query items where price is less than 500 in the electronics partition

النتيجة المتوقعة:

إرجاع قائمة مستندات المنتجات التي تطابق فلتر السعر، مرتبة حسب مفتاح القسم للاسترجاع الفعال لقسم واحد với استهلاك minimal لوحدات الطلب.

استخدام "Azure Cosmos DB SDK for Python". Upsert a new product item with id, category, name, and price fields

النتيجة المتوقعة:

إنشاء العنصر إذا ��م يكن موجودًا أو استبداله إذا كان موجودًا، وإرجاع المستند المنشأ أو المحدث مع البيانات الوصفية المُنشأة بواسطة النظام مثل _ts و _rid.

التدقيق الأمني

آمن
v1 • 2/24/2026

This is a prompt-only skill containing documentation and code examples for Azure Cosmos DB SDK. Static analysis found 0 security issues with a risk score of 0/100. The skill provides legitimate database operation patterns using official Azure SDK libraries. Network and environment access patterns shown are standard Azure authentication flows requiring user-provided credentials.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
2
النتائج
1
إجمالي عمليات التدقيق

عوامل الخطر

🌐 الوصول إلى الشبكة
لم يتم تسجيل أي مواقع محددة
🔑 متغيرات البيئة
لم يتم تسجيل أي مواقع محددة
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

كتالوج منتجات التجارة الإلكترونية

بناء كتالوج منتجات موزع عالميًا مع تحسين مفتاح القسم للعمليات السريعة حسب الفئة واستعلامات النطاق الفعالة لتصفية الأسعار.

تخزين القياس عن بُعد لإنترنت الأشياء

تخزين والاستعلام عن بيانات المستشعرات الزمنية باستخدام مفاتيح قسم هرمية لعزل المستخدمين والأجهزة مع النسخ المتماثل التلقائي العالمي.

إدارة جلسات المستخدم

تنفيذ تخزين جل��ات منخفض زمن الانتقال مع التجاوز التلقائي عبر مناطق Azure باستخدام مستويات اتساق Cosmos DB وسياسات TTL.

جرّب هذه الموجهات

عمليات CRUD الأساسية
إنشاء نص Python برمجي يتصل بـ Azure Cosmos DB ويؤدي عمليات الإنشاء والقراءة والتحديث والحذف على حاوية تخزن ملفات تعريف المستخدمين مع مفتاح قسم /user_id.
استعلام مُحدد بالمعاملات مع التصفية
كتابة دالة استعلام تسترجع المنتجات التي تقل أسعارها عن الحد الأقصى في قسم فئة محدد باستخدام SQL المُحدد بالمعاملات لمنع الحقن وتحسين التخزين المؤقت.
إدراج دفعات غير متزامن عالي الإنتاجية
تنفيذ دالة Python غير متزامنة تُجمع وتُدرج 1000 عنصر في Cosmos DB باست��دام العميل غير المتزامن مع معالجة أخطاء مناسبة ومنطق إعادة المحاولة لحد المعدل.
توفير الحاو��ات مع استراتيجية القسم
إنشاء نص إعداد ينشئ حاوية Cosmos DB بمفاتيح قسم هرمية وإنتاجية مُوفرة تبلغ 5000 RU/s وسياسات فهرسة مناسبة لنظام تسجيل أحداث متعدد المستخدمين.

أفضل الممارسات

  • تحديد مفتاح القسم دائمًا للقراءات النقطية والاستعلامات لتقليل زمن الانتقال والتكلفة
  • استخدام الاستعلامات المُحددة بالمعاملات بدلاً من تسلسل السلاسل لمنع هجمات الحقن
  • تصميم مفاتيح القسم لتوزيع البيانات بشكل متساوي لتجنب الأقسام الساخنة

تجنب

  • إجراء استعلامات عبر الأقسام بدون علم enable_cross_partition_query
  • استخدام read_all_items بدون تصفية مفتاح القسم في أحمال العمل الإنتاجية
  • إنشاء حاويات بدون تخطيط استراتيجية مفتاح القسم مسبقًا

الأسئلة المتكررة

ما هي الحد الأدنى للإنتاجية لحاوية Cosmos DB؟
الحد الأدنى للإنتاجية المُوفرة هو 400 RU/s لقسم واحد. وضع Serverless متاح أيضًا لأحمال العمل غير المتوقعة.
كيف أتعامل مع أخطاء حد المعدل 429؟
التقاط CosmosHttpResponseError مع رمز الحالة 429 وإعادة المحاولة بعد ال��دة المحددة في الرأس x-ms-retry-after-ms.
هل يمكنني تغيير مفتاح القسم بعد إنشاء الحاوية؟
لا، مفاتيح القسم غير قابلة للتغيير. يجب ترحيل البيانات إلى حاوية جديدة إذا كنت بحاجة ��لى تغيير استراتيجية القسم.
ما هي طرق المصادقة التي يدعمها SDK؟
يدعم SDK مصادقة سلسلة الاتصال والمصادقة القائمة على Azure Identity باستخدام DefaultAzureCredential للهويات المُدارة.
كيف أُمكّن العمليات غير المتزامنة في SDK؟
استيراد CosmosClient من azure.cosmos.aio واستخدام مديري السياق غير المتزامن مع await لجميع عمليات قاعدة البيانات.
ما هي مستويات الاتساق المتاحة في Cosmos DB؟
يقدم Cosmos DB خمسة مستويات: قوي، وقدم محدود، وجلسة، وبادئة متسقة،وأخير، مع الموازنة بين زمن الانتقال والاتساق.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md