AzureFileDatastore Kelas

Mewakili datastore yang menyimpan informasi sambungan ke penyimpanan Azure Blob.

Anda tidak harus bekerja dengan kelas ini secara langsung. Untuk membuat penyimpanan data jenis ini, gunakan metode register_azure_file_share dari Penyimpanan Data.

Catatan: Saat menggunakan penyimpanan data untuk mengakses data, Anda harus memiliki izin untuk mengakses data tersebut, yang bergantung pada informasi masuk yang terdaftar di penyimpanan data.

Menginisialisasi Azure File Share Datastore baru.

Warisan

AbstractAzureStorageDatastore

AzureFileDatastore

Konstruktor

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

Parameter

workspace

Workspace

Diperlukan

Ruang kerja tempat penyimpanan data ini berada.

name

str

Diperlukan

Nama datastore. Nama hanya boleh berisi karakter alfanumerik atau - atau _.

container_name

str

Diperlukan

Nama file bersama

account_name

str

Diperlukan

Nama akun penyimpanan

sas_token

str, <xref:optional>

nilai default: None

Token SAS untuk mengakses kontainer ini. Default Tidak Ada.

account_key

str, <xref:optional>

nilai default: None

Kunci akun penyimpanan. Default Tidak Ada.

protocol

str, <xref:optional>

nilai default: None

Protokol yang digunakan untuk terhubung ke akun penyimpanan. Jika None, default ke https.

endpoint

str, <xref:optional>

nilai default: core.windows.net

Titik akhir kontainer blob. Jika None, default ke core.windows.net.

request_session

<xref:requests.sessions.Session>, <xref:optional>

nilai default: None

objek sesi yang akan digunakan untuk permintaan http. Default Tidak Ada.

workspace

Workspace

Diperlukan

Ruang kerja tempat penyimpanan data ini berada.

name

str

Diperlukan

Nama datastore. Nama hanya boleh berisi karakter alfanumerik atau - atau _.

container_name

str

Diperlukan

Nama file bersama

account_name

str

Diperlukan

Nama akun penyimpanan

sas_token

str, <xref:optional>

Diperlukan

Token SAS untuk mengakses kontainer ini. Default Tidak Ada.

account_key

str, <xref:optional>

Diperlukan

Kunci akun penyimpanan. Default Tidak Ada.

protocol

str, <xref:optional>

Diperlukan

Protokol yang digunakan untuk terhubung ke akun penyimpanan. Jika None, default ke https.

endpoint

str, <xref:optional>

Diperlukan

Titik akhir kontainer blob. Jika None, default ke core.windows.net.

request_session

<xref:requests.sessions.Session>, <xref:optional>

Diperlukan

objek sesi yang akan digunakan untuk permintaan http. Default Tidak Ada.

Metode

download	Unduh data dari file bersama ke sistem file lokal.
upload	Unggah data dari sistem file lokal ke berbagi file yang ditunjukkan oleh datastore ini. Catatan: Agar metode ini berfungsi, objek penyimpanan data harus memiliki kunci akun atau properti token SAS yang diisi. Jika objek penyimpanan data tidak berisi bentuk info masuk apa pun, metode ini akan gagal. Selain itu, metode ini tidak digunakan lagi, dapat dihapus di masa mendatang. Kami sarankan Anda menggunakan metode Dataset.File.upload_directory untuk mengunggah file Anda dari direktori lokal dan membuat FileDataset dalam satu panggilan metode.
upload_files	Unggah data dari sistem file lokal ke berbagi file yang ditunjukkan oleh datastore ini. Catatan: Metode ini tidak digunakan lagi dan tidak akan lagi didukung. Sarankan untuk menggunakan FileDatasetFactory.upload_directory sebagai gantinya.

download

Unduh data dari file bersama ke sistem file lokal.

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

Parameter

target_path

str

Diperlukan

Direktori lokal untuk mengunduh file.

prefix

str, <xref:optional>

nilai default: None

Jalur ke folder di file bersama untuk diunduh. Jika diatur ke None, Azure Machine Learning akan mengunduh semua yang ada di file bersama.

overwrite

bool, <xref:optional>

nilai default: False

Menunjukkan apakah akan menimpa file yang ada.

show_progress

bool, <xref:optional>

nilai default: True

Menunjukkan apakah akan menampilkan kemajuan unduhan di konsol.

Mengembalikan

Jumlah file yang berhasil diunduh.

Tipe hasil

int

upload

Unggah data dari sistem file lokal ke berbagi file yang ditunjukkan oleh datastore ini.

Catatan: Agar metode ini berfungsi, objek penyimpanan data harus memiliki kunci akun atau properti token SAS yang diisi. Jika objek penyimpanan data tidak berisi bentuk info masuk apa pun, metode ini akan gagal. Selain itu, metode ini tidak digunakan lagi, dapat dihapus di masa mendatang. Kami sarankan Anda menggunakan metode Dataset.File.upload_directory untuk mengunggah file Anda dari direktori lokal dan membuat FileDataset dalam satu panggilan metode.

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

Parameter

src_dir

str

Diperlukan

Direktori lokal yang akan diunggah.

target_path

str

Diperlukan

Lokasi dalam file bersama untuk pengunggahan. Jika None, maka unggah ke root.

overwrite

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menimpa file yang ada.

show_progress

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menampilkan kemajuan unggahan di konsol.

Mengembalikan

Instans DataReference untuk jalur target yang diunggah.

Tipe hasil

DataReference

upload_files

Unggah data dari sistem file lokal ke berbagi file yang ditunjukkan oleh datastore ini.

Catatan: Metode ini tidak digunakan lagi dan tidak akan lagi didukung. Sarankan untuk menggunakan FileDatasetFactory.upload_directory sebagai gantinya.

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

Parameter

files

list[str]

Diperlukan

Daftar jalur absolut file untuk diunggah.

relative_root

str, <xref:optional>

Diperlukan

Jalur dasar yang digunakan untuk menentukan jalur file dalam file bersama. Misalnya, jika Anda mengunggah /path/to/file.txt, dan menentukan jalur dasar menjadi /path, ketika file.txt diunggah ke file bersama, ini akan memiliki jalur /to/file.txt. Jika target_path juga ditentukan, maka ini akan digunakan sebagai awalan untuk jalur turunan dari atas. Jalur dasar harus menjadi jalur umum dari semua file, jika tidak, pengecualian akan dibuat. Default adalah None, yang akan menemukan jalur umum.

target_path

str, <xref:optional>

Diperlukan

Lokasi dalam file bersama untuk tujuan pengunggahan data. Defaultnya adalah None, root.

overwrite

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menimpa file yang ada.

show_progress

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menampilkan kemajuan unggahan di konsol.

Mengembalikan

Instans DataReference untuk jalur target yang diunggah.

Tipe hasil

DataReference