StorageStreamDownloader الفصل

كائن دفق لتنزيله من Azure Storage.

توريث
StorageStreamDownloader

الدالمنشئ

StorageStreamDownloader(clients=None, config=None, start_range=None, end_range=None, validate_content=None, encryption_options=None, max_concurrency=1, name=None, container=None, encoding=None, download_cls=None, **kwargs)

المعلمات

الاسم الوصف
clients
القيمة الافتراضية: None
config
القيمة الافتراضية: None
start_range
القيمة الافتراضية: None
end_range
القيمة الافتراضية: None
validate_content
القيمة الافتراضية: None
encryption_options
القيمة الافتراضية: None
max_concurrency
القيمة الافتراضية: 1
name
القيمة الافتراضية: None
container
القيمة الافتراضية: None
encoding
القيمة الافتراضية: None
download_cls
القيمة الافتراضية: None

المتغيرات

الاسم الوصف
name
str

اسم الكائن الثنائي كبير الحجم الذي يتم تنزيله.

container
str

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

properties

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

size
int

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

الأساليب

chunks

التكرار عبر الأجزاء في دفق التنزيل.

content_as_bytes

مهمل: قم بتنزيل محتويات هذا الملف.

يتم حظر هذه العملية حتى يتم تنزيل جميع البيانات.

تم إهمال هذا الأسلوب، استخدم func:readall بدلا من ذلك.

content_as_text

مهمل: قم بتنزيل محتويات هذا الكائن الثنائي كبير الحجم، وفك ترميزه كنص.

يتم حظر هذه العملية حتى يتم تنزيل جميع البيانات.

تم إهمال هذا الأسلوب، استخدم func:readall بدلا من ذلك.

download_to_stream

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

تم إهمال هذا الأسلوب، استخدم func:readinto بدلا من ذلك.

read

اقرأ ما يصل إلى حجم وحدات البايت من الدفق وأرجعها. إذا كان الحجم غير محدد أو -1، فستتم قراءة جميع وحدات البايت.

readall

اقرأ محتويات هذا الكائن الثنائي كبير الحجم بالكامل. يتم حظر هذه العملية حتى يتم تنزيل جميع البيانات.

readinto

قم بتنزيل محتويات هذا الملف إلى دفق.

chunks

التكرار عبر الأجزاء في دفق التنزيل.

chunks() -> Iterator[bytes]

المرتجعات

النوع الوصف

مكرر للأجزاء في دفق التنزيل.

content_as_bytes

مهمل: قم بتنزيل محتويات هذا الملف.

يتم حظر هذه العملية حتى يتم تنزيل جميع البيانات.

تم إهمال هذا الأسلوب، استخدم func:readall بدلا من ذلك.

content_as_bytes(max_concurrency=1)

المعلمات

الاسم الوصف
max_concurrency
int

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

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

المرتجعات

النوع الوصف

محتويات الملف كوحدات بايت.

content_as_text

مهمل: قم بتنزيل محتويات هذا الكائن الثنائي كبير الحجم، وفك ترميزه كنص.

يتم حظر هذه العملية حتى يتم تنزيل جميع البيانات.

تم إهمال هذا الأسلوب، استخدم func:readall بدلا من ذلك.

content_as_text(max_concurrency=1, encoding='UTF-8')

المعلمات

الاسم الوصف
max_concurrency
int

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

القيمة الافتراضية: 1
encoding
str

اختبر الترميز لفك تشفير وحدات البايت التي تم تنزيلها. الإعداد الافتراضي هو UTF-8.

القيمة الافتراضية: UTF-8

المرتجعات

النوع الوصف
str

محتوى الملف ك str.

download_to_stream

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

تم إهمال هذا الأسلوب، استخدم func:readinto بدلا من ذلك.

download_to_stream(stream, max_concurrency=1)

المعلمات

الاسم الوصف
stream
مطلوب
IO[<xref:T>]

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

max_concurrency
int

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

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

المرتجعات

النوع الوصف
Any

خصائص الكائن الثنائي كبير الحجم الذي تم تنزيله.

read

اقرأ ما يصل إلى حجم وحدات البايت من الدفق وأرجعها. إذا كان الحجم غير محدد أو -1، فستتم قراءة جميع وحدات البايت.

read(size: int | None = -1) -> T

المعلمات

الاسم الوصف
size

عدد وحدات البايت المراد تنزيلها من الدفق. اترك غير محدد أو قم بتعيينه إلى -1 لتنزيل جميع وحدات البايت.

القيمة الافتراضية: -1

المرتجعات

النوع الوصف
<xref:T>

البيانات المطلوبة كوحدات بايت أو سلسلة إذا تم تحديد الترميز. إذا كانت القيمة المرجعة فارغة، فلا توجد بيانات إضافية للقراءة.

readall

اقرأ محتويات هذا الكائن الثنائي كبير الحجم بالكامل. يتم حظر هذه العملية حتى يتم تنزيل جميع البيانات.

readall() -> T

المرتجعات

النوع الوصف
<xref:T>

البيانات المطلوبة كوحدات بايت أو سلسلة إذا تم تحديد الترميز.

readinto

قم بتنزيل محتويات هذا الملف إلى دفق.

readinto(stream: IO[bytes]) -> int

المعلمات

الاسم الوصف
stream
مطلوب

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

المرتجعات

النوع الوصف
int

عدد البايت المقروء.