Condividi tramite


StorageStreamDownloader Classe

Oggetto di streaming da scaricare da Archiviazione di Azure.

Ereditarietà
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 scaricato.

container
str

Nome del contenitore in cui è il BLOB.

properties

Proprietà del BLOB scaricato. Se vengono scaricati solo un intervallo di dati, questa verrà riflessa 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

Eseguire l'iterazione dei blocchi nel flusso di download.

content_as_bytes

DEPRECATO: scaricare il contenuto di questo file.

Questa operazione viene bloccata finché 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 finché 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

Leggere fino alle dimensioni dei byte dal flusso e restituirli. Se le dimensioni non sono specificate o sono -1, tutti i byte verranno letti.

readall

Leggere l'intero contenuto di questo BLOB. Questa operazione viene bloccata finché non vengono scaricati tutti i dati.

readinto

Scaricare il contenuto di questo file in un flusso.

chunks

Eseguire l'iterazione dei blocchi nel flusso di download.

chunks() -> Iterator[bytes]

Restituisce

Tipo Descrizione

Iteratore dei blocchi nel flusso di download.

content_as_bytes

DEPRECATO: scaricare il contenuto di questo file.

Questa operazione viene bloccata finché non vengono scaricati tutti i dati.

Questo metodo è deprecato, usare invece func:readall .

content_as_bytes(max_concurrency=1)

Parametri

Nome Descrizione
max_concurrency
int

Numero di connessioni parallele con cui scaricare.

valore predefinito: 1

Restituisce

Tipo Descrizione

Contenuto del file come byte.

content_as_text

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

Questa operazione viene bloccata finché non vengono scaricati tutti i dati.

Questo metodo è deprecato, usare invece func:readall .

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

Parametri

Nome Descrizione
max_concurrency
int

Numero di connessioni parallele con cui 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 .

download_to_stream(stream, max_concurrency=1)

Parametri

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

Flusso da scaricare. Può trattarsi di un handle file aperto o di qualsiasi flusso scrivibile. Il flusso deve essere cercato se il download usa più connessioni parallele.

max_concurrency
int

Numero di connessioni parallele con cui scaricare.

valore predefinito: 1

Restituisce

Tipo Descrizione
Any

Proprietà del BLOB scaricato.

read

Leggere fino alle dimensioni dei byte dal flusso e restituirli. Se le dimensioni non sono specificate o sono -1, tutti i byte verranno letti.

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

Parametri

Nome Descrizione
size

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

valore predefinito: -1

Restituisce

Tipo Descrizione
<xref:T>

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

readall

Leggere l'intero contenuto di questo BLOB. Questa operazione viene bloccata finché non vengono scaricati tutti i dati.

readall() -> T

Restituisce

Tipo Descrizione
<xref:T>

I dati richiesti come byte o una stringa se la codifica è stata specificata.

readinto

Scaricare il contenuto di questo file in un flusso.

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

Parametri

Nome Descrizione
stream
Necessario

Flusso da scaricare. Può trattarsi di un handle file aperto o di qualsiasi flusso scrivibile. Il flusso deve essere cercato se il download usa più connessioni parallele.

Restituisce

Tipo Descrizione
int

Numero di byte letti.