PortDataReference 클래스

완료된 StepRun의 출력과 연결된 데이터를 모델화합니다.

PortDataReference 개체를 사용하여 에 의해 StepRun생성된 출력 데이터를 다운로드할 수 있습니다. 이후 파이프라인에서 단계 입력으로 사용할 수도 있습니다.

PortDataReference를 초기화합니다.

생성자

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

매개 변수

Name	Description
context 필수	<xref:azureml.pipeline.core._GraphContext> 그래프 컨텍스트 개체입니다.
pipeline_run_id 필수	str 출력을 생성한 파이프라인 실행의 ID입니다.
data_reference 필수	DataReference 데이터 참조 개체입니다.
step_run	StepRun 데이터를 생성한 StepRun 개체입니다. Default value: None
context 필수	<xref:azureml.pipeline.core._GraphContext> 그래프 컨텍스트 개체입니다.
pipeline_run_id 필수	str 출력을 생성한 파이프라인 실행의 ID입니다.
data_reference 필수	DataReference 데이터 참조 개체입니다.
step_run 필수	StepRun 데이터를 생성한 StepRun 개체입니다.

설명

PortDataReference는 완료된 데이터에 의해 생성된 데이터를 가리킵니다 StepRun.

에서 PortDataReference를 PipelineRun 가져와 다음과 같이 출력 데이터를 다운로드합니다.

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

이 예제에서 새로 생성된 파이프라인은 완료된 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)

매개 변수

Name	Description
input_name	str 이 입력의 이름을 지정합니다. Default value: None
path_on_compute	str 데이터를 다운로드할 컴퓨팅의 경로입니다. Default value: None
overwrite	bool 기존 데이터를 덮어쓸지 여부를 나타내는 데 사용합니다. Default value: None

반환

형식	Description
InputPortBinding	이 PortDataReference를 원본으로 사용한 InputPortBinding입니다.

as_input

InputPortBinding을 만들고 입력 이름을 지정합니다(기본 모드 사용).

as_input(input_name)

매개 변수

Name	Description
input_name 필수	str 이 입력의 이름을 지정하는 데 사용합니다.

반환

형식	Description
InputPortBinding	이 PortDataReference를 원본으로 사용한 InputPortBinding입니다.

as_mount

"탑재" 모드를 통해 PortDataReference를 단계 입력으로 사용합니다.

as_mount(input_name=None)

매개 변수

Name	Description
input_name	str 이 입력의 이름을 지정하는 데 사용합니다. Default value: None

반환

형식	Description
InputPortBinding	이 PortDataReference를 원본으로 사용한 InputPortBinding입니다.

create_input_binding

이 PortDataReference를 원본으로 사용하여 입력 바인딩을 만듭니다.

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

매개 변수

Name	Description
input_name	str 입력의 이름입니다. Default value: None
mode	str PortDataReference에 액세스하는 모드입니다("탑재" 또는 "다운로드"). Default value: None
path_on_compute	str "다운로드" 모드의 경우 컴퓨팅의 경로는 데이터가 상주합니다. Default value: None
overwrite	bool "다운로드" 모드의 경우 기존 데이터를 덮어쓸지 여부입니다. Default value: None

반환

형식	Description
InputPortBinding	이 PortDataReference를 원본으로 사용한 InputPortBinding입니다.

download

PortDataReference가 나타내는 데이터를 다운로드합니다.

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

매개 변수

Name	Description
local_path 필수	str 다운로드할 로컬 경로입니다.
overwrite	bool true이면 기존 파일을 덮어쓰고 기본값은 False입니다. Default value: None
show_progress	bool 콘솔에서 다운로드 진행률을 표시합니다. 기본값은 True입니다. Default value: None

반환

형식	Description
int	성공적으로 다운로드된 파일 수입니다.

특성

datastore

PortDataReference와 연결된 데이터 저장소를 가져옵니다.

반환

형식	Description
Datastore	데이터 저장소 개체입니다.

datastore_name

PortDataReference와 연결된 데이터 저장소의 이름을 가져옵니다.

반환

형식	Description
str	데이터 저장소 이름입니다.

name

이 데이터 참조의 이름을 가져옵니다.

반환

형식	Description
str	데이터 참조 이름입니다.

path_on_datastore

PortDataReference에 대한 데이터 저장소의 경로를 가져옵니다.

반환

형식	Description
str	데이터 저장소의 경로입니다.