次の方法で共有

AzureFileDatastore クラス

  • リファレンス

Azure File Storage への接続情報を保存するデータストアを表します。

このクラスを直接操作することはできません。 この種類のデータストアを作成するには、Datastore の 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 メソッドを使用してローカル ディレクトリからファイルをアップロードし、1 回のメソッド呼び出しで 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 メソッドを使用してローカル ディレクトリからファイルをアップロードし、1 回のメソッド呼び出しで 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 も指定した場合は、上の派生パスのプレフィックスとして使用されます。 ベース パスは、すべてのファイルの共通パスである必要があります。そうしないと、例外がスローされます。 既定値は None で、これは共通パスを検索します。

target_path
str, <xref:optional>
必須

データのアップロード先であるファイル共有内の場所。 既定値は None でルートです。

overwrite
bool, <xref:optional>
必須

既存のファイルを上書きするかどうかを示します。

show_progress
bool, <xref:optional>
必須

コンソールにアップロードの進行状況を表示するかどうかを示します。

戻り値

アップロードされたターゲット パスの DataReference インスタンス。

の戻り値の型 :

DataReference