PortDataReference Kelas

Model data yang terkait dengan output dari StepRun yang telah selesai.

Objek PortDataReference dapat digunakan untuk mengunduh data output yang dibuat oleh StepRun. Ini juga dapat digunakan sebagai input langkah di Alur masa mendatang.

Menginisialisasi PortDataReference.

Warisan

builtins.object

PortDataReference

Konstruktor

PortDataReference(context, pipeline_run_id, data_reference, step_run=None)

Parameter

Nama	Deskripsi
context Diperlukan	<xref:azureml.pipeline.core._GraphContext> Objek konteks grafik.
pipeline_run_id Diperlukan	str Id dari eksekusi alur yang menghasilkan output.
data_reference Diperlukan	DataReference Objek referensi data.
step_run	StepRun Objek StepRun yang menghasilkan data. nilai default: None
context Diperlukan	<xref:azureml.pipeline.core._GraphContext> Objek konteks grafik.
pipeline_run_id Diperlukan	str Id dari eksekusi alur yang menghasilkan output.
data_reference Diperlukan	DataReference Objek referensi data.
step_run Diperlukan	StepRun Objek StepRun yang menghasilkan data.

Keterangan

PortDataReference menunjuk ke data yang dihasilkan oleh StepRun yang lengkap.

Dapatkan PortDataReference dari PipelineRun dan unduh data output sebagai berikut:

   from azureml.pipeline.core import PipelineRun, StepRun, PortDataReference

   pipeline_run = PipelineRun(experiment, "<pipeline_run_id>")
   step_run = pipeline_run.find_step_run("<node_name>")[0]
   port_data_reference = step_run.get_output_data("<output_name>")
   port_data_reference.download(local_path="path")

PortDataReference dapat digunakan sebagai input ke langkah dalam Pipeline, mirip dengan penggunaan DataReference.

Contoh penggunaan PortDataReference sebagai input langkah adalah sebagai berikut:

   from azureml.pipeline.core import PortDataReference, Pipeline, PipelineRun
   from azureml.pipeline.steps import PythonScriptStep

   pipeline_run = PipelineRun(experiment, "<pipeline_run_id>")
   step_run = pipeline_run.find_step_run("<node_name>")[0]
   port_data_reference = step_run.get_output_data("<output_name>")

   step_1 = PythonScriptStep(
       name='train',
       script_name="train.py",
       compute_target=compute,
       arguments=["--input", port_data_reference],
       inputs=[port_data_reference]
   )

   pipeline = Pipeline(workspace=workspace, steps=[step_1])

Dalam contoh ini, Alur yang baru dibangun akan menggunakan output yang dibuat oleh PipelineRun yang telah selesai sebagai input ke langkah pelatihan.

Metode

as_download	Konsumsi PortDataReference sebagai input langkah melalui mode "unduh".
as_input	Buat InputPortBinding dan tentukan nama input (tetapi gunakan mode default).
as_mount	Konsumsi PortDataReference sebagai input langkah melalui mode "pasang".
create_input_binding	Buat pengikatan input dengan PortDataReference ini sebagai sumbernya.
download	Unduh data yang ditunjukkan dengan PortDataReference.

as_download

Konsumsi PortDataReference sebagai input langkah melalui mode "unduh".

as_download(input_name=None, path_on_compute=None, overwrite=None)

Parameter

Nama	Deskripsi
input_name	str Tentukan nama untuk input ini. nilai default: None
path_on_compute	str Jalur pada komputasi untuk mengunduh data. nilai default: None
overwrite	bool Gunakan untuk menunjukkan apakah akan menimpa data yang ada. nilai default: None

Mengembalikan

Jenis	Deskripsi
InputPortBinding	InputPortBinding dengan PortDataReference ini sebagai sumbernya.

as_input

Buat InputPortBinding dan tentukan nama input (tetapi gunakan mode default).

as_input(input_name)

Parameter

Nama	Deskripsi
input_name Diperlukan	str Gunakan untuk menentukan nama untuk input ini.

Mengembalikan

Jenis	Deskripsi
InputPortBinding	InputPortBinding dengan PortDataReference ini sebagai sumbernya.

as_mount

Konsumsi PortDataReference sebagai input langkah melalui mode "pasang".

as_mount(input_name=None)

Parameter

Nama	Deskripsi
input_name	str Gunakan untuk menentukan nama untuk input ini. nilai default: None

Mengembalikan

Jenis	Deskripsi
InputPortBinding	InputPortBinding dengan PortDataReference ini sebagai sumbernya.

create_input_binding

Buat pengikatan input dengan PortDataReference ini sebagai sumbernya.

create_input_binding(input_name=None, mode=None, path_on_compute=None, overwrite=None)

Parameter

Nama	Deskripsi
input_name	str Nama input. nilai default: None
mode	str Mode untuk mengakses PortDataReference ("pasang" atau "unduh"). nilai default: None
path_on_compute	str Untuk mode "unduh", jalur pada komputasi data akan berada. nilai default: None
overwrite	bool Untuk mode "unduh", apakah akan menimpa data yang ada. nilai default: None

Mengembalikan

Jenis	Deskripsi
InputPortBinding	InputPortBinding dengan PortDataReference ini sebagai sumbernya.

download

Unduh data yang ditunjukkan dengan PortDataReference.

download(local_path, overwrite=None, show_progress=None)

Parameter

Nama	Deskripsi
local_path Diperlukan	str Jalur lokal untuk mengunduh.
overwrite	bool Jika true, timpa file yang ada, default ke False. nilai default: None
show_progress	bool Tampilkan kemajuan unduhan di konsol, default ke True. nilai default: None

Mengembalikan

Jenis	Deskripsi
int	Jumlah file yang berhasil diunduh.

Atribut

datastore

Dapatkan Datastore yang terkait dengan PortDataReference.

Mengembalikan

Jenis	Deskripsi
Datastore	Objek datastore.

datastore_name

Dapatkan nama Datastore yang terkait dengan PortDataReference.

Mengembalikan

Jenis	Deskripsi
str	Nama datastore.

name

Dapatkan nama referensi data ini.

Mengembalikan

Jenis	Deskripsi
str	Nama referensi data.

path_on_datastore

Dapatkan jalur di datastore untuk PortDataReference.

Mengembalikan

Jenis	Deskripsi
str	Jalur di datastore.