StorageStreamDownloader Classe

  • Riferimento

Oggetto di streaming da scaricare da Archiviazione di Azure.

Ereditarietà
Generic
StorageStreamDownloader

Costruttore

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)

Parametri

Nome Descrizione
clients
valore predefinito: None
config
valore predefinito: None
start_range
valore predefinito: None
end_range
valore predefinito: None
validate_content
valore predefinito: None
encryption_options
valore predefinito: None
max_concurrency
valore predefinito: 1
name
valore predefinito: None
container
valore predefinito: None
encoding
valore predefinito: None
download_cls
valore predefinito: None

Variabili

Nome Descrizione
name
str

Nome del BLOB da scaricare.
container
str

Nome del contenitore in cui si trova il BLOB.
properties
BlobProperties

Proprietà del BLOB da scaricare. Se viene scaricato solo un intervallo di dati, queste verranno riflesse nelle proprietà.
size
int

Dimensioni dei dati totali nel flusso. Questo sarà l'intervallo di byte, se specificato, altrimenti la dimensione totale del BLOB.

Metodi

chunks

Scorrere i blocchi nel flusso di download.
content_as_bytes

DEPRECATO: scaricare il contenuto di questo file.

Questa operazione viene bloccata fino a quando non vengono scaricati tutti i dati.

Questo metodo è deprecato, usare invece func:readall .
content_as_text

DEPRECATO: scaricare il contenuto di questo BLOB e decodificare come testo.

Questa operazione viene bloccata fino a quando non vengono scaricati tutti i dati.

Questo metodo è deprecato, usare invece func:readall .
download_to_stream

DEPRECATO: scaricare il contenuto di questo BLOB in un flusso.

Questo metodo è deprecato, usare invece func:readinto .
read

Legge i byte fino alle dimensioni del flusso e li restituisce. Se size non è specificato o è -1, tutti i byte verranno letti.
readall

Leggere l'intero contenuto di questo BLOB. Questa operazione viene bloccata fino a quando non vengono scaricati tutti i dati.
readinto

Scaricare il contenuto di questo BLOB in un flusso.

chunks

Scorrere i blocchi nel flusso di download.

chunks() -> AsyncIterator[bytes]

Restituisce

Tipo Descrizione
AsyncIterator[bytes]

Iteratore asincrono dei blocchi nel flusso di download.

content_as_bytes

DEPRECATO: scaricare il contenuto di questo file.

Questa operazione viene bloccata fino a quando non vengono scaricati tutti i dati.

Questo metodo è deprecato, usare invece func:readall .

async content_as_bytes(max_concurrency=1)

Parametri

Nome Descrizione
max_concurrency
int

Numero di connessioni parallele da scaricare.

valore predefinito: 1

Restituisce

Tipo Descrizione
bytes

Contenuto del file come byte.

content_as_text

DEPRECATO: scaricare il contenuto di questo BLOB e decodificare come testo.

Questa operazione viene bloccata fino a quando non vengono scaricati tutti i dati.

Questo metodo è deprecato, usare invece func:readall .

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

Parametri

Nome Descrizione
max_concurrency
int

Numero di connessioni parallele da scaricare.

valore predefinito: 1
encoding
str

Testare la codifica per decodificare i byte scaricati. L'impostazione predefinita è UTF-8.

valore predefinito: UTF-8

Restituisce

Tipo Descrizione
str

Contenuto del file come str.

download_to_stream

DEPRECATO: scaricare il contenuto di questo BLOB in un flusso.

Questo metodo è deprecato, usare invece func:readinto .

async download_to_stream(stream, max_concurrency=1)

Parametri

Nome Descrizione
stream
Necessario
IO[<xref:T>]

Flusso in cui eseguire il download. Può trattarsi di un handle di file aperto o di qualsiasi flusso scrivibile. Il flusso deve essere ricercabile se il download usa più di una connessione parallela.
max_concurrency
int

Numero di connessioni parallele da scaricare.

valore predefinito: 1

Restituisce

Tipo Descrizione
Any

Proprietà del BLOB scaricato.

read

Legge i byte fino alle dimensioni del flusso e li restituisce. Se size non è specificato o è -1, tutti i byte verranno letti.

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

Parametri

Nome Descrizione
size
Optional[int]

Numero di byte da scaricare dal flusso. Lasciare non specificato o impostare su -1 per scaricare tutti i byte.

valore predefinito: -1

Restituisce

Tipo Descrizione
<xref:T>

Dati richiesti come byte o stringa se è stata specificata la codifica. Se il valore restituito è vuoto, non sono presenti altri dati da leggere.

readall

Leggere l'intero contenuto di questo BLOB. Questa operazione viene bloccata fino a quando non vengono scaricati tutti i dati.

async readall() -> T

Restituisce

Tipo Descrizione
<xref:T>

Dati richiesti come byte o stringa se è stata specificata la codifica.

readinto

Scaricare il contenuto di questo BLOB in un flusso.

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

Parametri

Nome Descrizione
stream
Necessario
IO[bytes]

Flusso in cui eseguire il download. Può trattarsi di un handle di file aperto o di qualsiasi flusso scrivibile. Il flusso deve essere ricercabile se il download usa più di una connessione parallela.

Restituisce

Tipo Descrizione
int

Numero di byte letti.