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.objectPortDataReference
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
|
Id dari eksekusi alur yang menghasilkan output. |
data_reference
Diperlukan
|
Objek referensi data. |
step_run
|
Objek StepRun yang menghasilkan data. nilai default: None
|
context
Diperlukan
|
<xref:azureml.pipeline.core._GraphContext>
Objek konteks grafik. |
pipeline_run_id
Diperlukan
|
Id dari eksekusi alur yang menghasilkan output. |
data_reference
Diperlukan
|
Objek referensi data. |
step_run
Diperlukan
|
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
|
Tentukan nama untuk input ini. nilai default: None
|
path_on_compute
|
Jalur pada komputasi untuk mengunduh data. nilai default: None
|
overwrite
|
Gunakan untuk menunjukkan apakah akan menimpa data yang ada. nilai default: None
|
Mengembalikan
Jenis | Deskripsi |
---|---|
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
|
Gunakan untuk menentukan nama untuk input ini. |
Mengembalikan
Jenis | Deskripsi |
---|---|
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
|
Gunakan untuk menentukan nama untuk input ini. nilai default: None
|
Mengembalikan
Jenis | Deskripsi |
---|---|
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
|
Nama input. nilai default: None
|
mode
|
Mode untuk mengakses PortDataReference ("pasang" atau "unduh"). nilai default: None
|
path_on_compute
|
Untuk mode "unduh", jalur pada komputasi data akan berada. nilai default: None
|
overwrite
|
Untuk mode "unduh", apakah akan menimpa data yang ada. nilai default: None
|
Mengembalikan
Jenis | Deskripsi |
---|---|
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
|
Jalur lokal untuk mengunduh. |
overwrite
|
Jika true, timpa file yang ada, default ke False. nilai default: None
|
show_progress
|
Tampilkan kemajuan unduhan di konsol, default ke True. nilai default: None
|
Mengembalikan
Jenis | Deskripsi |
---|---|
Jumlah file yang berhasil diunduh. |
Atribut
datastore
Dapatkan Datastore yang terkait dengan PortDataReference.
Mengembalikan
Jenis | Deskripsi |
---|---|
Objek datastore. |
datastore_name
Dapatkan nama Datastore yang terkait dengan PortDataReference.
Mengembalikan
Jenis | Deskripsi |
---|---|
Nama datastore. |
name
path_on_datastore
Dapatkan jalur di datastore untuk PortDataReference.
Mengembalikan
Jenis | Deskripsi |
---|---|
Jalur di datastore. |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk