다음을 통해 공유

PortDataReference 클래스

  • 참조

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

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

PortDataReference를 초기화합니다.

상속
builtins.object
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에 의해 생성된 데이터를 가리킵니다.

다음과 같이 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는 DataReference를 사용하는 것과 유사하게 Pipeline의 한 단계에 대한 입력으로 사용할 수 있습니다.

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

“download” 모드를 통해 PortDataReference를 단계 입력으로 사용합니다.
as_input

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

“mount” 모드를 통해 PortDataReference를 단계 입력으로 사용합니다.
create_input_binding

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

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

as_download

“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

“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에 액세스하는 모드입니다(“mount” 또는 “download”).

Default value: None
path_on_compute
str

“download” 모드의 경우 데이터가 상주할 컴퓨팅의 경로입니다.

Default value: None
overwrite
bool

“download” 모드의 경우 기존 데이터를 덮어쓸지 여부를 나타냅니다.

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

데이터 저장소의 경로입니다.