aio الحزمة

الفصول

BlobClient	عميل للتفاعل مع كائن ثنائي كبير الحجم معين، على الرغم من أن هذا الكائن الثنائي كبير الحجم قد لا يكون موجودا بعد.
BlobLeaseClient	إنشاء BlobLeaseClient جديد. يوفر هذا العميل عمليات التأجير على BlobClient أو ContainerClient.
BlobPrefix	قابل للتكبير من خصائص كائن ثنائي كبير الحجم. يتم إرجاعه من walk_blobs عند استخدام محدد. يمكن اعتباره دليلا ظاهريا لكائن ثنائي كبير الحجم.
BlobServiceClient	عميل للتفاعل مع خدمة Blob على مستوى الحساب. يوفر هذا العميل عمليات لاسترداد وتكوين خصائص الحساب بالإضافة إلى قائمة وإنشاء حاويات وحذفها داخل الحساب. بالنسبة للعمليات المتعلقة بحاوية أو كائن ثنائي كبير الحجم محدد، يمكن أيضا استرداد العملاء لهذه الكيانات باستخدام وظائف get_client .
ContainerClient	عميل للتفاعل مع حاوية معينة، على الرغم من أن هذه الحاوية قد لا تكون موجودة بعد. بالنسبة للعمليات المتعلقة بكائن ثنائي كبير الحجم محدد داخل هذه الحاوية، يمكن استرداد عميل كائن ثنائي كبير الحجم باستخدام الدالة get_blob_client .
ExponentialRetry	إعادة المحاولة الأسية. إنشاء كائن إعادة محاولة أسي. يتم استخدام initial_backoff لإعادة المحاولة الأولى. تتم إعادة محاولة عمليات إعادة المحاولة اللاحقة بعد initial_backoff + increment_power^retry_count ثانية. على سبيل المثال، تحدث إعادة المحاولة الأولى بشكل افتراضي بعد 15 ثانية، والثانية بعد (15+3^1) = 18 ثانية، والثالثة بعد (15+3^2) = 24 ثانية.
LinearRetry	إعادة المحاولة الخطية. إنشاء كائن إعادة محاولة خطي.
StorageStreamDownloader	كائن دفق لتنزيله من Azure Storage.

الوظائف

download_blob_from_url

قم بتنزيل محتويات كائن ثنائي كبير الحجم إلى ملف محلي أو دفق.

async download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

المعلمات

blob_url

str

مطلوب

URI الكامل للكائن الثنائي كبير الحجم. يمكن أن يتضمن هذا أيضا رمز SAS المميز.

output

str أو <xref:<xref:writable stream>>

مطلوب

حيث يجب تنزيل البيانات إليه. قد يكون هذا إما مسار ملف للكتابة إليه، أو مؤشر IO مفتوحا للكتابة إليه.

credential

القيمة الافتراضية: None

بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للكائن الثنائي كبير الحجم يحتوي بالفعل على رمز SAS المميز أو كان الكائن الثنائي كبير الحجم عاما. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة

• باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.

overwrite

bool

ما إذا كان يجب الكتابة فوق الملف المحلي إذا كان موجودا بالفعل. القيمة الافتراضية هي False - وفي هذه الحالة سيتم رفع ValueError إذا كان الملف موجودا بالفعل. إذا تم تعيينه إلى True، فسيتم إجراء محاولة للكتابة إلى الملف الموجود. إذا تم تمرير مقبض دفق، يتم تجاهل هذه القيمة.

max_concurrency

int

عدد الاتصالات المتوازية التي يجب تنزيلها.

offset

int

بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. يجب تعيين إذا تم توفير الطول.

length

int

عدد وحدات البايت المراد قراءتها من الدفق. هذا اختياري، ولكن يجب توفيره للأداء الأمثل.

validate_content

bool

إذا كان صحيحا، تحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة، لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.

نوع الإرجاع

None

upload_blob_to_url

تحميل البيانات إلى عنوان URL معين

سيتم تحميل البيانات ككائن ثنائي كبير الحجم للكتلة.

blob_url سلسلة param: عنوان URI الكامل للكائن الثنائي كبير الحجم. يمكن أن يتضمن هذا أيضا رمز SAS المميز.

بيانات المعلمة: البيانات المراد تحميلها. يمكن أن يكون هذا وحدات البايت أو النص أو عنصر قابلا للتكسير أو كائنا يشبه الملف.

نوع البيانات: وحدات البايت أو str أو Iterable

async upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> dict[str, Any]

المعلمات

credential

القيمة الافتراضية: None

بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للكائن الثنائي كبير الحجم يحتوي بالفعل على رمز SAS المميز. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة

• باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.

بيانات اعتماد paramtype: اختياري[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-long

الكلمة الأساسية bool الكتابة فوق: ما إذا كان يجب أن يقوم الكائن الثنائي كبير الحجم الذي سيتم تحميله بالكتابة فوق البيانات الحالية. إذا كان True، فسيستبدل upload_blob_to_url أي بيانات موجودة. إذا تم تعيينها إلى False، فستفشل العملية باستخدام ResourceExistsError.

الكلمة الأساسية int max_concurrency: عدد الاتصالات المتوازية التي يجب تنزيلها.

طول int للكلمة الأساسية: عدد وحدات البايت المراد قراءتها من الدفق. هذا اختياري، ولكن يجب توفيره للأداء الأمثل.

بيانات تعريف الكلمة الأساسية (str,str): أزواج الاسم والقيمة المقترنة ب blob كبيانات تعريف.

الكلمة الأساسية bool validate_content: إذا كان صحيحا، تحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة، لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.

ترميز الكلمة الأساسية str: الترميز لاستخدامه إذا تم توفير النص كإدخال. الإعدادات الافتراضية ل UTF-8.

إرجاع: تم تحديث الكائنات الثنائية كبيرة الحجم لخاصية dict (Etag وآخر تعديل)

rtype: dict(str, Any)

blob_url

data