PortDataReference 類別

參考

建立與已完成 StepRun 輸出相關聯的模型資料。

PortDataReference 物件可用來下載所產生的 StepRun 輸出資料。它也可作為未來管線中的步驟輸入。

初始化 PortDataReference。

繼承: builtins.object

PortDataReference

建構函式

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

參數

名稱	Description
context 必要	<xref:azureml.pipeline.core._GraphContext> 圖形內容物件。
pipeline_run_id 必要	str 產生輸出之管線執行的識別碼。
data_reference 必要	DataReference 資料參考物件。
step_run	StepRun 產生資料的 StepRun 物件。預設值: None
context 必要	<xref:azureml.pipeline.core._GraphContext> 圖形內容物件。
pipeline_run_id 必要	str 產生輸出之管線執行的識別碼。
data_reference 必要	DataReference 資料參考物件。
step_run 必要	StepRun 產生資料的 StepRun 物件。

備註

PortDataReference 指向已完成 StepRun 所產生的資料。

從 PipelineRun 取得 PortDataReference 並下載輸出資料，如下所示：


   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 可作為中 Pipeline 步驟的輸入，類似于使用 DataReference 。

使用 PortDataReference 作為步驟輸入的範例如下：


   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])

在此範例中，新建構的 Pipeline 會使用已完成 PipelineRun 所建立的輸出作為定型步驟的輸入。

方法

as_download	透過「下載」模式，使用 PortDataReference 作為步驟輸入。
as_input	建立 InputPortBinding 並指定輸入名稱 (，但使用預設模式) 。
as_mount	透過「掛接」模式，使用 PortDataReference 作為步驟輸入。
create_input_binding	使用此 PortDataReference 作為來源建立輸入系結。
download	下載 PortDataReference 所代表的資料。

as_download

透過「下載」模式，使用 PortDataReference 作為步驟輸入。

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

參數

名稱	Description
input_name	str 指定此輸入的名稱。預設值: None
path_on_compute	str 要下載資料之計算的路徑。預設值: None
overwrite	bool 使用來指出是否要覆寫現有的資料。預設值: None

傳回

類型	Description
InputPortBinding	使用這個 PortDataReference 作為來源的 InputPortBinding。

as_input

建立 InputPortBinding 並指定輸入名稱 (，但使用預設模式) 。

as_input(input_name)

參數

名稱	Description
input_name 必要	str 使用來指定此輸入的名稱。

傳回

類型	Description
InputPortBinding	使用這個 PortDataReference 作為來源的 InputPortBinding。

as_mount

透過「掛接」模式，使用 PortDataReference 作為步驟輸入。

as_mount(input_name=None)

參數

名稱	Description
input_name	str 使用來指定此輸入的名稱。預設值: None

傳回

類型	Description
InputPortBinding	使用這個 PortDataReference 作為來源的 InputPortBinding。

create_input_binding

使用此 PortDataReference 作為來源建立輸入系結。

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

參數

名稱	Description
input_name	str 輸入的名稱。預設值: None
mode	str 存取 PortDataReference (「mount」或「download」) 的模式。預設值: None
path_on_compute	str 針對「下載」模式，資料將位於計算上的路徑。預設值: None
overwrite	bool 針對「下載」模式，是否要覆寫現有的資料。預設值: None

傳回

類型	Description
InputPortBinding	使用這個 PortDataReference 作為來源的 InputPortBinding。

download

下載 PortDataReference 所代表的資料。

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

參數

名稱	Description
local_path 必要	str 要下載到的本機路徑。
overwrite	bool 如果為 true，請覆寫現有的檔案，預設值為 False。預設值: None
show_progress	bool 在主控台中顯示下載進度，預設為 True。預設值: None

傳回

類型	Description
int	已成功下載的檔案數目。

屬性

datastore

取得與 PortDataReference 相關聯的資料存放區。

傳回

類型	Description
Datastore	資料存放區物件。

datastore_name

取得與 PortDataReference 相關聯的資料存放區名稱。

傳回

類型	Description
str	資料存放區名稱。

name

取得此資料參考的名稱。

傳回

類型	Description
str	資料參考名稱。

path_on_datastore

取得 PortDataReference 的資料存放區路徑。

傳回

類型	Description
str	資料存放區上的路徑。

共用方式為