ComputeTarget Kelas

Referensi

Kelas induk abstrak untuk semua target komputasi yang dikelola oleh Azure Machine Learning.

Target komputasi adalah sumber daya/lingkungan komputasi yang ditunjuk tempat Anda menjalankan skrip pelatihan atau meng-hosting penyebaran layanan Anda. Lokasi ini mungkin merupakan mesin lokal Anda atau sumber daya komputasi berbasis cloud. Untuk informasi selengkapnya, lihat Apa itu target komputasi di Azure Machine Learning?

Konstruktor Class ComputeTarget.

Ambil representasi cloud dari objek Komputasi yang terkait dengan ruang kerja yang disediakan. Mengembalikan instans kelas anak yang sesuai dengan jenis tertentu dari objek Komputasi yang diambil.

Warisan: ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Objek ruang kerja yang berisi objek Azure Compute yang akan diambil.
name Diperlukan	str Nama objek Azure Compute yang akan diambil.
workspace Diperlukan	Workspace Objek ruang kerja yang berisi objek Azure Compute yang akan diambil.
name Diperlukan	str Nama objek Komputasi yang akan diambil.

Keterangan

Gunakan konstruktor ComputeTarget untuk mengambil representasi cloud objek Azure Compute yang terkait dengan ruang kerja yang disediakan. Konstruktor menampilkan instans dari kelas turunan yang sesuai dengan jenis tertentu dari objek Azure Compute yang diambil. Jika objek Azure Compute tidak ditemukan, ComputeTargetException akan diajukan.

Metode

attach	Lampirkan objek Azure Compute ke ruang kerja menggunakan nama dan informasi konfigurasi yang ditentukan.
create	Penyediaan objek Azure Compute dengan menentukan jenis komputasi dan konfigurasi terkait. Metode ini membuat target komputasi baru, dan tidak melampirkan yang sudah ada.
delete	Hapus objek Azure Compute dari ruang kerjanya yang terkait. Metode abstrak ini diterapkan oleh kelas turunan dari ComputeTarget.
deserialize	Konversi objek JSON menjadi objek Azure Compute.
detach	Lepaskan objek Azure Compute dari ruang kerjanya yang terkait. Metode abstrak ini diterapkan oleh kelas turunan dari ComputeTarget. Objek cloud yang mendasarinya tidak dihapus, hanya asosiasinya yang dihapus.
get_status	Ambil status penyediaan objek Azure Compute saat ini.
list	Cantumkan semua objek ComputeTarget di dalam ruang kerja. Tampilkan daftar objek turunan yang dibuat secara instan yang sesuai dengan jenis Azure Compute tertentu. Objek adalah turunan dari ComputeTarget.
refresh_state	Lakukan pembaruan di tempat dari properti objek. Perbarui properti berdasarkan status objek cloud yang sesuai saat ini. Ini berguna untuk polling manual status komputasi. Metode abstrak ini diterapkan oleh kelas turunan dari ComputeTarget.
serialize	Konversi objek Azure Compute ini menjadi kamus serial JSON.
wait_for_completion	Tunggu hingga operasi penyediaan saat ini selesai di kluster. Metode ini akan menampilkan ComputeTargetException jika terjadi masalah polling objek komputasi.

attach

Lampirkan objek Azure Compute ke ruang kerja menggunakan nama dan informasi konfigurasi yang ditentukan.

static attach(workspace, name, attach_configuration)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Objek ruang kerja tempat objek Azure Compute dilampirkan.
name Diperlukan	str Nama yang akan diasosiasikan dengan objek Azure Compute.
attach_configuration Diperlukan	ComputeTargetAttachConfiguration Objek ComputeTargetAttachConfiguration yang digunakan untuk menentukan jenis objek Azure Compute yang akan dilampirkan, dan cara mengonfigurasinya.

Mengembalikan

Jenis	Deskripsi
ComputeTarget	Instans turunan ComputeTarget yang sesuai dengan jenis objek yang dilampirkan.

Pengecualian

Jenis	Deskripsi
ComputeTargetException

Keterangan

Jenis objek yang akan diteruskan ke parameter attach_configuration adalah objek ComputeTargetAttachConfiguration yang dibuat menggunakan fungsi attach_configuration pada salah satu kelas ComputeTarget turunan.

Contoh berikut menunjukkan cara melampirkan akun ADLA ke ruang kerja menggunakan metode attach_configuration AdlaCompute.


   adla_compute_name = 'testadl' # Name to associate with new compute in workspace

   # ADLA account details needed to attach as compute to workspace
   adla_account_name = "<adla_account_name>" # Name of the Azure Data Lake Analytics account
   adla_resource_group = "<adla_resource_group>" # Name of the resource group which contains this account

   try:
       # check if already attached
       adla_compute = AdlaCompute(ws, adla_compute_name)
   except ComputeTargetException:
       print('attaching adla compute...')
       attach_config = AdlaCompute.attach_configuration(resource_group=adla_resource_group, account_name=adla_account_name)
       adla_compute = ComputeTarget.attach(ws, adla_compute_name, attach_config)
       adla_compute.wait_for_completion()

   print("Using ADLA compute:{}".format(adla_compute.cluster_resource_id))
   print("Provisioning state:{}".format(adla_compute.provisioning_state))
   print("Provisioning errors:{}".format(adla_compute.provisioning_errors))

Sampel lengkap tersedia dari https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/machine-learning-pipelines/intro-to-pipelines/aml-pipelines-use-adla-as-compute-target.ipynb

create

Penyediaan objek Azure Compute dengan menentukan jenis komputasi dan konfigurasi terkait.

Metode ini membuat target komputasi baru, dan tidak melampirkan yang sudah ada.

static create(workspace, name, provisioning_configuration)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Objek ruang kerja untuk membuat objek Azure Compute di bawah.
name Diperlukan	str Nama yang akan diasosiasikan dengan objek Azure Compute.
provisioning_configuration Diperlukan	ComputeTargetProvisioningConfiguration Objek ComputeTargetProvisioningConfiguration yang digunakan untuk menentukan jenis objek Azure Compute yang akan disediakan, dan cara mengonfigurasinya.

Mengembalikan

Jenis	Deskripsi
ComputeTarget	Instans turunan ComputeTarget yang sesuai dengan jenis objek yang disediakan.

Pengecualian

Jenis	Deskripsi
ComputeTargetException

Keterangan

Jenis objek yang disediakan ditentukan oleh konfigurasi penyediaan yang disediakan.

Dalam contoh berikut, target komputasi persisten yang disediakan oleh AmlCompute dibuat. Parameter provisioning_configuration dalam contoh ini adalah jenis AmlComputeProvisioningConfiguration.


   from azureml.core.compute import ComputeTarget, AmlCompute
   from azureml.core.compute_target import ComputeTargetException

   # Choose a name for your CPU cluster
   cpu_cluster_name = "cpu-cluster"

   # Verify that cluster does not exist already
   try:
       cpu_cluster = ComputeTarget(workspace=ws, name=cpu_cluster_name)
       print('Found existing cluster, use it.')
   except ComputeTargetException:
       compute_config = AmlCompute.provisioning_configuration(vm_size='STANDARD_D2_V2',
                                                              max_nodes=4)
       cpu_cluster = ComputeTarget.create(ws, cpu_cluster_name, compute_config)

   cpu_cluster.wait_for_completion(show_output=True)

Sampel lengkap tersedia dari https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

delete

Hapus objek Azure Compute dari ruang kerjanya yang terkait.

Metode abstrak ini diterapkan oleh kelas turunan dari ComputeTarget.

abstract delete()

Pengecualian

Jenis	Deskripsi
ComputeTargetException

Keterangan

Jika objek ini dibuat melalui Azure Machine Learning, objek berbasis cloud yang sesuai juga akan dihapus. Jika objek ini dibuat secara eksternal dan hanya dilampirkan ke ruang kerja, metode ini mengajukan pengecualian dan tidak ada yang berubah.

deserialize

Konversi objek JSON menjadi objek Azure Compute.

abstract static deserialize(workspace, object_dict)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Objek ruang kerja yang dikaitkan dengan objek Azure Compute.
object_dict Diperlukan	dict Objek JSON yang akan dikonversi menjadi objek Azure Compute.

Mengembalikan

Jenis	Deskripsi
ComputeTarget	Representasi Azure Compute dari objek JSON yang disediakan.

Pengecualian

Jenis	Deskripsi
ComputeTargetException

Keterangan

Mengajukan ComputeTargetException jika ruang kerja yang disediakan bukan ruang kerja yang dikaitkan dengan Azure Compute.

detach

Lepaskan objek Azure Compute dari ruang kerjanya yang terkait.

Metode abstrak ini diterapkan oleh kelas turunan dari ComputeTarget. Objek cloud yang mendasarinya tidak dihapus, hanya asosiasinya yang dihapus.

abstract detach()

Pengecualian

Jenis	Deskripsi
ComputeTargetException

get_status

Ambil status penyediaan objek Azure Compute saat ini.

get_status()

Mengembalikan

Jenis	Deskripsi
str	`provisioning_state` saat ini.

Pengecualian

Jenis	Deskripsi
ComputeTargetException

Keterangan

Nilai yang ditampilkan tercantum dalam Referensi REST API Azure untuk ProvisioningState.

list

Cantumkan semua objek ComputeTarget di dalam ruang kerja.

Tampilkan daftar objek turunan yang dibuat secara instan yang sesuai dengan jenis Azure Compute tertentu. Objek adalah turunan dari ComputeTarget.

static list(workspace)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Objek ruang kerja yang berisi objek yang akan dicantumkan.

Mengembalikan

Jenis	Deskripsi
list[ComputeTarget]	Daftar target komputasi di dalam ruang kerja.

Pengecualian

Jenis	Deskripsi
ComputeTargetException

refresh_state

Lakukan pembaruan di tempat dari properti objek.

Perbarui properti berdasarkan status objek cloud yang sesuai saat ini. Ini berguna untuk polling manual status komputasi.

Metode abstrak ini diterapkan oleh kelas turunan dari ComputeTarget.

abstract refresh_state()

Pengecualian

Jenis	Deskripsi
ComputeTargetException

serialize

Konversi objek Azure Compute ini menjadi kamus serial JSON.

abstract serialize()

Mengembalikan

Jenis	Deskripsi
dict	Representasi JSON dari objek Azure Compute ini.

Pengecualian

Jenis	Deskripsi
ComputeTargetException

wait_for_completion

Tunggu hingga operasi penyediaan saat ini selesai di kluster.

Metode ini akan menampilkan ComputeTargetException jika terjadi masalah polling objek komputasi.

wait_for_completion(show_output=False, is_delete_operation=False)

Parameter

Nama	Deskripsi
show_output	bool Menunjukkan apakah akan memberikan lebih banyak output verbose. Nilai default: False
is_delete_operation	bool Menunjukkan apakah operasi ditujukan untuk menghapus. Nilai default: False

Pengecualian

Jenis	Deskripsi
ComputeTargetException

Bagikan melalui

ComputeTarget Kelas

Konstruktor

Parameter

Keterangan

Metode

attach

Parameter

Mengembalikan

Pengecualian

Keterangan

create

Parameter

Mengembalikan

Pengecualian

Keterangan

delete

Pengecualian

Keterangan

deserialize

Parameter

Mengembalikan

Pengecualian

Keterangan

detach

Pengecualian

get_status

Mengembalikan

Pengecualian

Keterangan

list

Parameter

Mengembalikan

Pengecualian

refresh_state

Pengecualian

serialize

Mengembalikan

Pengecualian

wait_for_completion

Parameter

Pengecualian

Saran dan Komentar

Sumber Daya Tambahan: