AzureFileDatastore 클래스

  • 참조

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

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

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

새 Azure 파일 공유 데이터 저장소를 초기화합니다.

상속
AbstractAzureStorageDatastore
AzureFileDatastore

생성자

AzureFileDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint='core.windows.net', request_session=None)

매개 변수

workspace
Workspace
필수

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

name
str
필수

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

container_name
str
필수

파일 공유 이름

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>
기본값: core.windows.net

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

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

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

workspace
Workspace
필수

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

name
str
필수

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

container_name
str
필수

파일 공유 이름

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.sessions.Session>, <xref:optional>
필수

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

메서드

download

파일 공유에서 로컬 파일 시스템으로 데이터를 다운로드합니다.
upload

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

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

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

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

download

파일 공유에서 로컬 파일 시스템으로 데이터를 다운로드합니다.

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

매개 변수

target_path
str
필수

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

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

다운로드할 파일 공유의 폴더 경로입니다. None으로 설정하면 Azure Machine Learning에서는 파일 공유의 모든 항목을 다운로드합니다.

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

기존 파일을 덮어쓸지 여부를 나타냅니다.

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

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

반환

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

반환 형식

int

upload

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

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

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

매개 변수

src_dir
str
필수

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

target_path
str
필수

업로드할 파일 공유의 위치입니다. None이면 루트에 업로드합니다.

overwrite
bool, <xref:optional>
필수

기존 파일을 덮어쓸지 여부를 나타냅니다.

show_progress
bool, <xref:optional>
필수

콘솔에서 업로드 진행률을 표시할지 여부를 나타냅니다.

반환

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

반환 형식

DataReference

upload_files

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

참고: 이 메서드는 사용되지 않으며 더 이상 지원되지 않습니다. 대신 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>
필수

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

target_path
str, <xref:optional>
필수

데이터를 업로드할 파일 공유의 위치입니다. 기본값은 루트인 None입니다.

overwrite
bool, <xref:optional>
필수

기존 파일을 덮어쓸지 여부를 나타냅니다.

show_progress
bool, <xref:optional>
필수

콘솔에서 업로드 진행률을 표시할지 여부를 나타냅니다.

반환

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

반환 형식

DataReference