AzureBlobDatastore Kelas

Mewakili datastore yang menyimpan informasi koneksi ke penyimpanan Azure Blob.

Anda tidak harus bekerja dengan kelas ini secara langsung. Untuk membuat penyimpanan data jenis ini, gunakan metode register_azure_blob_container 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 Blob Datastore baru.

Warisan

AbstractAzureStorageDatastore

AzureBlobDatastore

Konstruktor

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)

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 kontainer blob.

account_name

str

Diperlukan

Nama akun penyimpanan.

sas_token

str, <xref:optional>

nilai default: None

Token SAS untuk mengakses kontainer ini. Default ke Tidak Ada.

account_key

str, <xref:optional>

nilai default: None

Kunci akun penyimpanan. Default ke 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: None

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

request_session

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

nilai default: None

objek sesi yang akan digunakan untuk permintaan http. Default ke 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 kontainer blob.

account_name

str

Diperlukan

Nama akun penyimpanan.

sas_token

str, <xref:optional>

Diperlukan

Token SAS untuk mengakses kontainer ini. Default ke Tidak Ada.

account_key

str, <xref:optional>

Diperlukan

Kunci akun penyimpanan. Default ke 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.Session>, <xref:optional>

Diperlukan

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

workspace_msi_has_access

bool, <xref:optional>

nilai default: False

Apakah MSI Ruang Kerja memiliki akses ke akun penyimpanan ini. (Tidak digunakan lagi)

subscription_id

str, <xref:optional>

nilai default: None

ID langganan akun penyimpanan.

resource_group

str, <xref:optional>

nilai default: None

Grup sumber daya akun penyimpanan.

service_data_access_auth_identity

str atau <xref:_restclient.models.ServiceDataAccessAuthIdentity>

nilai default: None

Menunjukkan identitas mana yang digunakan untuk mengautentikasi akses data layanan ke penyimpanan pelanggan. Kemungkinan nilai meliputi: 'None', 'WorkspaceSystemAssignedIdentity', 'WorkspaceUserAssignedIdentity'

Metode

download	Unduh data dari kontainer blob ke sistem file lokal.
upload	Unggah data dari sistem file lokal ke kontainer blob yang ditunjukkan oleh penyimpanan data 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 kontainer blob 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 kontainer blob ke sistem file lokal.

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

Parameter

target_path

str

Diperlukan

Direktori lokal untuk mengunduh file ke.

prefix

str, <xref:optional>

nilai default: None

Jalur ke folder dalam kontainer blob untuk diunduh. Jika diatur ke Tidak Ada, akan mengunduh semua yang ada di blob. Default ke Tidak Ada.

overwrite

bool, <xref:optional>

nilai default: False

Menunjukkan apakah akan menimpa file yang ada. Default ke False.

show_progress

bool, <xref:optional>

nilai default: True

Menunjukkan apakah akan menampilkan kemajuan unduhan di konsol. Default ke True.

Mengembalikan

Jumlah file yang berhasil diunduh.

Tipe hasil

int

upload

Unggah data dari sistem file lokal ke kontainer blob yang ditunjukkan oleh penyimpanan data 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 untuk diunggah.

target_path

str

Diperlukan

Lokasi dalam kontainer blob untuk diunggah. Jika Tidak Ada, lalu unggah ke root. Default ke Tidak Ada.

overwrite

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menimpa file yang ada. Default ke False.

show_progress

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menampilkan kemajuan unggahan di konsol. Default ke True.

Mengembalikan

Instans DataReference untuk jalur target yang diunggah.

Tipe hasil

DataReference

upload_files

Unggah data dari sistem file lokal ke kontainer blob 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

Root yang digunakan untuk menentukan jalur file dalam blob. Misalnya, jika kita mengunggah /path/to/file.txt, dan kita menentukan jalur dasar menjadi /path, ketika file.txt diunggah ke penyimpanan blob, itu akan memiliki jalur /to/file.txt. Jika target_path juga diberikan, maka itu akan digunakan sebagai awalan untuk jalur turunan dari atas. Jalur dasar harus menjadi jalur umum dari semua file, jika tidak pengecualian akan dilemparkan. Default ke Tidak Ada, yang akan menemukan jalur umum.

target_path

str, <xref:optional>

Diperlukan

Lokasi dalam kontainer blob untuk mengunggah data ke. Default ke Tidak Ada, root.

overwrite

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menimpa file yang ada. Default ke False.

show_progress

bool, <xref:optional>

Diperlukan

Menunjukkan apakah akan menampilkan kemajuan unggahan di konsol. Default ke True.

Mengembalikan

Instans DataReference untuk jalur target yang diunggah.

Tipe hasil

DataReference