다음을 통해 공유


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)

매개 변수

Name Description
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 Description
name
str

다운로드할 Blob의 이름입니다.

container
str

Blob이 있는 컨테이너의 이름입니다.

properties

다운로드할 Blob의 속성입니다. 데이터 범위만 다운로드되는 경우 속성에 반영됩니다.

size
int

스트림의 총 데이터 크기입니다. 지정된 경우 바이트 범위가 되고, 그렇지 않으면 Blob의 총 크기입니다.

메서드

chunks

다운로드 스트림의 청크를 반복합니다.

content_as_bytes

사용되지 않음: 이 파일의 내용을 다운로드합니다.

이 작업은 모든 데이터가 다운로드될 때까지 차단됩니다.

이 메서드는 더 이상 사용되지 않으며 대신 func:readall 을 사용합니다.

content_as_text

사용되지 않음: 이 Blob의 콘텐츠를 다운로드하고 텍스트로 디코딩합니다.

이 작업은 모든 데이터가 다운로드될 때까지 차단됩니다.

이 메서드는 더 이상 사용되지 않으며 대신 func:readall 을 사용합니다.

download_to_stream

사용되지 않음: 이 Blob의 내용을 스트림에 다운로드합니다.

이 메서드는 더 이상 사용되지 않으며 대신 func:readinto 를 사용합니다.

read

스트림에서 최대 크기 바이트를 읽고 반환합니다. 크기가 지정되지 않거나 -1이면 모든 바이트가 읽혀집니다.

readall

이 Blob의 전체 내용을 읽습니다. 이 작업은 모든 데이터가 다운로드될 때까지 차단됩니다.

readinto

이 파일의 내용을 스트림에 다운로드합니다.

chunks

다운로드 스트림의 청크를 반복합니다.

chunks() -> Iterator[bytes]

반환

형식 Description

다운로드 스트림의 청크 반복기입니다.

content_as_bytes

사용되지 않음: 이 파일의 내용을 다운로드합니다.

이 작업은 모든 데이터가 다운로드될 때까지 차단됩니다.

이 메서드는 더 이상 사용되지 않으며 대신 func:readall 을 사용합니다.

content_as_bytes(max_concurrency=1)

매개 변수

Name Description
max_concurrency
int

다운로드할 병렬 연결 수입니다.

기본값: 1

반환

형식 Description

파일의 내용(바이트)입니다.

content_as_text

사용되지 않음: 이 Blob의 콘텐츠를 다운로드하고 텍스트로 디코딩합니다.

이 작업은 모든 데이터가 다운로드될 때까지 차단됩니다.

이 메서드는 더 이상 사용되지 않으며 대신 func:readall 을 사용합니다.

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

매개 변수

Name Description
max_concurrency
int

다운로드할 병렬 연결 수입니다.

기본값: 1
encoding
str

인코딩을 테스트하여 다운로드한 바이트를 디코딩합니다. 기본값은 UTF-8입니다.

기본값: UTF-8

반환

형식 Description
str

str로 파일의 콘텐츠입니다.

download_to_stream

사용되지 않음: 이 Blob의 내용을 스트림에 다운로드합니다.

이 메서드는 더 이상 사용되지 않으며 대신 func:readinto 를 사용합니다.

download_to_stream(stream, max_concurrency=1)

매개 변수

Name Description
stream
필수
IO[<xref:T>]

다운로드할 스트림입니다. 열려 있는 파일 핸들 또는 쓰기 가능한 스트림일 수 있습니다. 다운로드에서 둘 이상의 병렬 연결을 사용하는 경우 스트림을 검색할 수 있어야 합니다.

max_concurrency
int

다운로드할 병렬 연결 수입니다.

기본값: 1

반환

형식 Description
Any

다운로드한 Blob의 속성입니다.

read

스트림에서 최대 크기 바이트를 읽고 반환합니다. 크기가 지정되지 않거나 -1이면 모든 바이트가 읽혀집니다.

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

매개 변수

Name Description
size

스트림에서 다운로드할 바이트 수입니다. 지정되지 않은 상태로 두거나 -1로 설정하여 모든 바이트를 다운로드합니다.

기본값: -1

반환

형식 Description
<xref:T>

인코딩이 지정된 경우 요청된 데이터를 바이트 또는 문자열로 지정합니다. 반환 값이 비어 있으면 읽을 데이터가 더 이상 없습니다.

readall

이 Blob의 전체 내용을 읽습니다. 이 작업은 모든 데이터가 다운로드될 때까지 차단됩니다.

readall() -> T

반환

형식 Description
<xref:T>

인코딩이 지정된 경우 요청된 데이터를 바이트 또는 문자열로 지정합니다.

readinto

이 파일의 내용을 스트림에 다운로드합니다.

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

매개 변수

Name Description
stream
필수

다운로드할 스트림입니다. 열려 있는 파일 핸들 또는 쓰기 가능한 스트림일 수 있습니다. 다운로드에서 둘 이상의 병렬 연결을 사용하는 경우 스트림을 검색할 수 있어야 합니다.

반환

형식 Description
int

읽은 바이트 수입니다.