AzureBlobDatastore 클래스

  • 참조

Azure Blob Storage에 대한 연결 정보를 저장하는 데이터 저장소를 나타냅니다.

이 클래스를 직접 사용하면 안 됩니다. 이 유형의 데이터 저장소를 만들려면 데이터 저장소의 register_azure_blob_container 메서드를 사용합니다.

참고: 데이터 저장소를 사용하여 데이터에 액세스하는 경우 데이터 저장소에 등록된 자격 증명에 따라 해당 데이터에 액세스할 수 있는 권한이 있어야 합니다.

새 Azure Blob Datastore를 초기화합니다.

상속
AbstractAzureStorageDatastore
AzureBlobDatastore

생성자

AzureBlobDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint=None, request_session=None, workspace_msi_has_access=False, subscription_id=None, resource_group=None, service_data_access_auth_identity=None)

매개 변수

workspace
Workspace
필수

이 데이터 저장소가 속한 작업 영역입니다.

name
str
필수

데이터 저장소의 이름입니다. 영숫자 또는 - 또는 _만 포함할 수 있습니다.

container_name
str
필수

Blob 컨테이너 이름입니다.

account_name
str
필수

스토리지 계정 이름입니다.

sas_token
str, <xref:optional>
기본값: None

이 컨테이너에 액세스하기 위한 SAS 토큰입니다. 기본값은 None입니다.

account_key
str, <xref:optional>
기본값: None

스토리지 계정 키입니다. 기본값은 None입니다.

protocol
str, <xref:optional>
기본값: None

스토리지 계정에 연결하는 데 사용할 프로토콜입니다. None인 경우 기본값은 https입니다.

endpoint
str, <xref:optional>
기본값: None

Blob 컨테이너의 엔드포인트입니다. None인 경우 기본값은 core.windows.net입니다.

request_session
<xref:requests.Session>, <xref:optional>
기본값: None

http 요청에 사용할 세션 개체입니다. 기본값은 None입니다.

workspace
Workspace
필수

이 데이터 저장소가 속한 작업 영역입니다.

name
str
필수

데이터 저장소의 이름입니다. 영숫자 또는 - 또는 _만 포함할 수 있습니다.

container_name
str
필수

Blob 컨테이너 이름입니다.

account_name
str
필수

스토리지 계정 이름입니다.

sas_token
str, <xref:optional>
필수

이 컨테이너에 액세스하기 위한 SAS 토큰입니다. 기본값은 None입니다.

account_key
str, <xref:optional>
필수

스토리지 계정 키입니다. 기본값은 None입니다.

protocol
str, <xref:optional>
필수

스토리지 계정에 연결하는 데 사용할 프로토콜입니다. None인 경우 기본값은 https입니다.

endpoint
str, <xref:optional>
필수

Blob 컨테이너의 엔드포인트입니다. None이면 기본값은 core.windows.net입니다.

request_session
<xref:requests.Session>, <xref:optional>
필수

http 요청에 사용할 세션 개체입니다. 기본값은 None입니다.

workspace_msi_has_access
bool, <xref:optional>
기본값: False

작업 영역 MSI가 이 스토리지 계정에 액세스할 수 있는지 여부입니다. (사용되지 않음)

subscription_id
str, <xref:optional>
기본값: None

스토리지 계정의 구독 ID입니다.

resource_group
str, <xref:optional>
기본값: None

스토리지 계정의 리소스 그룹입니다.

service_data_access_auth_identity
str 또는 <xref:_restclient.models.ServiceDataAccessAuthIdentity>
기본값: None

고객의 스토리지에 대한 서비스 데이터 액세스를 인증하는 데 사용할 ID를 나타냅니다. 가능한 값은 ‘None’, ‘WorkspaceSystemAssignedIdentity’, ‘WorkspaceUserAssignedIdentity’입니다.

메서드

download

Blob 컨테이너에서 로컬 파일 시스템으로 데이터를 다운로드합니다.
upload

이 데이터 저장소가 가리키는 Blob 컨테이너에 로컬 파일 시스템의 데이터를 업로드합니다.

참고: 이 메서드가 작동하려면 데이터 저장소 개체에 계정 키 또는 SAS 토큰 속성이 채워져 있어야 합니다. 데이터 저장소 개체에 어떤 형식의 자격 증명도 포함되어 있지 않으면 이 메서드가 실패합니다. 또한 이 메서드는 더 이상 사용되지 않으며 나중에 제거될 수 있습니다. Dataset.File.upload_directory 메서드를 사용하여 로컬 디렉터리에서 파일을 업로드하고 단일 메서드 호출에서 FileDataset를 만드는 것이 좋습니다.
upload_files

로컬 파일 시스템에서 이 데이터 저장소가 가리키는 Blob 컨테이너로 데이터를 업로드합니다.

참고: 이 메서드는 사용되지 않으며 더 이상 지원되지 않습니다. 대신 FileDatasetFactory.upload_directory를 사용하는 것이 좋습니다.

download

Blob 컨테이너에서 로컬 파일 시스템으로 데이터를 다운로드합니다.

download(target_path, prefix=None, overwrite=False, show_progress=True)

매개 변수

target_path
str
필수

파일을 다운로드할 로컬 디렉터리입니다.

prefix
str, <xref:optional>
기본값: None

다운로드할 Blob 컨테이너의 폴더 경로입니다. None으로 설정하면 Blob의 모든 항목이 다운로드됩니다. 기본값은 None입니다.

overwrite
bool, <xref:optional>
기본값: False

기존 파일을 덮어쓸지 여부를 나타냅니다. 기본값은 False입니다.

show_progress
bool, <xref:optional>
기본값: True

콘솔에서 다운로드 진행률을 표시할지 여부를 나타냅니다. 기본값은 True입니다.

반환

성공적으로 다운로드된 파일 수입니다.

반환 형식

int

upload

이 데이터 저장소가 가리키는 Blob 컨테이너에 로컬 파일 시스템의 데이터를 업로드합니다.

참고: 이 메서드가 작동하려면 데이터 저장소 개체에 계정 키 또는 SAS 토큰 속성이 채워져 있어야 합니다. 데이터 저장소 개체에 어떤 형식의 자격 증명도 포함되어 있지 않으면 이 메서드가 실패합니다. 또한 이 메서드는 더 이상 사용되지 않으며 나중에 제거될 수 있습니다. Dataset.File.upload_directory 메서드를 사용하여 로컬 디렉터리에서 파일을 업로드하고 단일 메서드 호출에서 FileDataset를 만드는 것이 좋습니다.

upload(src_dir, target_path=None, overwrite=False, show_progress=True)

매개 변수

src_dir
str
필수

업로드할 로컬 디렉터리입니다.

target_path
str
필수

업로드할 Blob 컨테이너의 위치입니다. None이면 루트에 업로드합니다. 기본값은 None입니다.

overwrite
bool, <xref:optional>
필수

기존 파일을 덮어쓸지 여부를 나타냅니다. 기본값은 False입니다.

show_progress
bool, <xref:optional>
필수

콘솔에 업로드 진행 상황을 표시할지 여부를 나타냅니다. 기본값은 True입니다.

반환

업로드된 대상 경로에 대한 DataReference 인스턴스입니다.

반환 형식

DataReference

upload_files

로컬 파일 시스템에서 이 데이터 저장소가 가리키는 Blob 컨테이너로 데이터를 업로드합니다.

참고: 이 메서드는 사용되지 않으며 더 이상 지원되지 않습니다. 대신 FileDatasetFactory.upload_directory를 사용하는 것이 좋습니다.

upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)

매개 변수

files
list[str]
필수

업로드할 파일의 절대 경로 목록입니다.

relative_root
str, <xref:optional>
필수

Blob에 있는 파일의 경로를 결정하는 데 사용되는 루트입니다. 예를 들어 /path/to/file.txt를 업로드하고 기본 경로를 /path로 정의하면 file.txt가 Blob Storage에 업로드될 때 /to/file.txt의 경로가 됩니다. target_path도 제공되면 위에서 파생된 경로의 접두사로 사용됩니다. 기본 경로는 모든 파일의 공통 경로여야 합니다. 그렇지 않으면 예외가 throw됩니다. 기본값은 None으로, 공통 경로를 찾습니다.

target_path
str, <xref:optional>
필수

데이터를 업로드할 Blob 컨테이너의 위치입니다. 기본값은 루트인 None입니다.

overwrite
bool, <xref:optional>
필수

기존 파일을 덮어쓸지 여부를 나타냅니다. 기본값은 False입니다.

show_progress
bool, <xref:optional>
필수

콘솔에 업로드 진행 상황을 표시할지 여부를 나타냅니다. 기본값은 True입니다.

반환

업로드된 대상 경로에 대한 DataReference 인스턴스입니다.

반환 형식

DataReference