azure storage python

Microsoft Azure Storage SDK لـ Python (مهمل)

سيكون هذا المشروع موجودًا في [دعم المجتمع](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) حتى 13 سبتمبر 2024. وبعد هذا التاريخ، سيتم إيقاف المشروع ومكتبات العملاء المرتبطة به بشكل دائم. . لمزيد من التفاصيل حول التقاعد وبدائل استخدام هذا المشروع، قم بزيارة [إشعار التقاعد: سيتم إيقاف مكتبات عملاء Azure Storage Python القديمة في 13 سبتمبر 2024](https://azure.microsoft.com/updates/retirement-notice- سيتم إيقاف مكتبات-legacy-azure-storage-python-client-libraries-في 13 سبتمبر 2024/).

---

أخبار!! azure-storage-blob v12 أصبح GA الآن!

تفضل بزيارة https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage لمعرفة المزيد.

ملاحظة : الريبو الحالي مخصص لـ azure-storage-blob<=2.1.0، وقد تؤدي الترقية إلى الإصدار 12.0.0 إلى كسر التعليمات البرمجية الحالية لديك.

يوفر هذا المشروع مكتبة عميل في Python تجعل من السهل استهلاك خدمات Microsoft Azure Storage. للحصول على الوثائق، يرجى مراجعة مركز مطوري Microsoft Azure Python ومرجع واجهة برمجة التطبيقات (API) الخاص بنا (متوفر أيضًا على readthedocs).

إذا كنت تبحث عن مكتبات Service Bus أو Azure Management، فيرجى زيارة https://github.com/Azure/azure-sdk-for-python.

التوافق

هام : إذا كان لديك إصدار سابق من حزمة azure (الإصدار < 1.0)، فيجب عليك إلغاء تثبيته قبل تثبيت هذه الحزمة.

يمكنك التحقق من الإصدار باستخدام النقطة:

pip freeze

إذا رأيت azure==0.11.0 (أو أي إصدار أقل من 1.0)، فقم بإلغاء تثبيته أولاً ثم تثبيته مرة أخرى:

pip uninstall azure
pip install azure

إذا كنت تقوم بالترقية من إصدار أقدم من 0.30.0، فراجع مستند الترقية، ونماذج الاستخدام في دليل العينات، وChangeLog وBreakingChanges.

إذا كنت تواجه مشكلات في تثبيت مساحة تخزين azure على تطبيقات Azure Web Apps، فقد تساعدك ترقية النقطة.

هام : إذا كان لديك إصدار سابق من حزمة azure-storage (الإصدار <= 0.36.0)، فيجب عليك إلغاء تثبيته قبل تثبيت الحزم المقسمة الجديدة.

يمكنك التحقق من الإصدار باستخدام النقطة:

pip freeze

إذا رأيت azure-storage==0.36.0 (أو أي إصدار أقل من 0.36.0)، فقم بإلغاء تثبيته أولاً:

pip uninstall azure-storage

سمات

• فقاعة
  • إنشاء/قراءة/تحديث/حذف الحاويات
  • إنشاء/قراءة/تحديث/حذف النقط
  • عمليات النقطة المتقدمة
• طابور
  • إنشاء/حذف قوائم الانتظار
  • إدراج/نظرة خاطفة على رسائل قائمة الانتظار
  • عمليات الانتظار المتقدمة
• ملفات
  • إنشاء/تحديث/حذف المشاركات
  • إنشاء/تحديث/حذف الدلائل
  • إنشاء/قراءة/تحديث/حذف الملفات
  • عمليات الملفات المتقدمة

ابدء

تحميل

يتكون Azure Storage SDK لـ Python من 5 حزم:

• أزور-التخزين-blob
  • يحتوي على واجهات برمجة التطبيقات لخدمة blob.
• ملف تخزين أزور
  • يحتوي على واجهات برمجة التطبيقات لخدمة الملفات.
• قائمة انتظار التخزين اللازوردية
  • يحتوي على واجهات برمجة التطبيقات لخدمة قائمة الانتظار.
• التخزين اللازوردي المشترك
  • يحتوي على رمز مشترك مشترك بين blob والملف وقائمة الانتظار.
• أزور-التخزين-nspkg
  • يمتلك مساحة الاسم azure.storage، ويجب ألا يستخدمها المستخدم مباشرة.

ملاحظة : قبل الإصدار 0.36.0 ويتضمنه، كانت هناك حزمة واحدة (وحدة تخزين azure) تحتوي على جميع الخدمات. لم يعد مدعومًا، ويجب على المستخدمين تثبيت حزم الخدمات الثلاثة المذكورة مسبقًا بشكل فردي، حسب الحاجة. بالإضافة إلى ذلك، لم تعد حزمة الجدول يتم إصدارها ضمن مساحة الاسم azure-storage، يرجى الرجوع إلى cosmosdb.

الخيار 1: عبر PyPi

للتثبيت عبر Python Package Index (PyPI)، اكتب:

 تثبيت النقطة azure-storage-blob
نقطة تثبيت ملف تخزين أزور
تثبيت النقطة في قائمة انتظار تخزين azure

الخيار 2: المصدر عبر Git

للحصول على الكود المصدري لـ SDK عبر git، فقط اكتب:

 بوابة استنساخ git://github.com/Azure/azure-storage-python.git

cd ./azure-storage-python/azure-storage-nspkg
تثبيت بيثون setup.py

cd ../azure-storage-common
تثبيت بيثون setup.py

cd ../azure-storage-blob
تثبيت بيثون setup.py

استبدل azure-storage-blob بملف azure-storage أو azure-storage-queue لتثبيت الخدمات الأخرى.

الخيار 3: مصدر الرمز البريدي

قم بتنزيل ملف مضغوط من الكود عبر GitHub أو PyPi. ثم اتبع نفس التعليمات في الخيار 2.

الحد الأدنى من المتطلبات

• بايثون 2.7، 3.3-3.7.
• راجع setup.py لمعرفة التبعيات

الاستخدام

لاستخدام SDK هذا للاتصال بخدمات تخزين Microsoft Azure، يجب عليك أولاً إنشاء حساب.

التسجيل

لتسهيل عملية التصحيح، يوصى بتشغيل التسجيل للمسجل المسمى "azure.storage". فيما يلي مثالان للتكوينات:

 # Basic configuration: configure the root logger, including 'azure.storage'
logging . basicConfig ( format = '%(asctime)s %(name)-20s %(levelname)-5s %(message)s' , level = logging . INFO )

 # More advanced configuration allowing more control
logger = logging . getLogger ( 'azure.storage' )
handler = logging . StreamHandler ()
formatter = logging . Formatter ( '%(asctime)s %(name)-20s %(levelname)-5s %(message)s' )
handler . setFormatter ( formatter )
logger . addHandler ( handler )
logger . setLevel ( logging . INFO )

إليك كيفية استخدام مستويات التسجيل، ومن المستحسن استخدام INFO:

• التصحيح: سجل السلاسل للتوقيع
• معلومات: تسجيل الطلبات والاستجابات الصادرة، بالإضافة إلى محاولات إعادة المحاولة
• تحذير: غير مستخدم
• خطأ: سجل المكالمات التي ما زالت تفشل بعد كل المحاولات

نموذج التعليمات البرمجية

راجع دليل العينات للتعرف على نماذج استخدام الكائنات الثنائية الكبيرة وقائمة الانتظار والملفات.

هل تحتاج إلى مساعدة؟

تأكد من مراجعة منتديات مطوري Microsoft Azure على MSDN أو منتديات المطورين على Stack Overflow إذا كانت لديك مشكلة في الكود المقدم.

المساهمة بالكود أو تقديم الملاحظات

إذا كنت تريد أن تصبح مساهمًا نشطًا في هذا المشروع، فيرجى اتباع الإرشادات الواردة في إرشادات المساهمة في مشاريع Azure. يمكنك العثور على مزيد من التفاصيل حول المساهمة في مستند CONTRIBUTING.md.

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

يتعلم أكثر

• مركز مطور بايثون
• خدمة تخزين أزور
• مدونة فريق التخزين Azure
• مرجع واجهة برمجة التطبيقات