PortDataReference 클래스

  • 참조

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

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

PortDataReference를 초기화합니다.

상속
builtins.object
PortDataReference

생성자

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

매개 변수

context
<xref:azureml.pipeline.core._GraphContext>
필수

그래프 컨텍스트 개체입니다.

pipeline_run_id
str
필수

출력을 생성한 파이프라인 실행의 ID입니다.

data_reference
DataReference
필수

데이터 참조 개체입니다.

step_run
StepRun
기본값: None

데이터를 생성한 StepRun 개체입니다.

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)

매개 변수

input_name
str
기본값: None

이 입력의 이름을 지정합니다.

path_on_compute
str
기본값: None

데이터를 다운로드할 컴퓨팅의 경로입니다.

overwrite
bool
기본값: None

기존 데이터를 덮어쓸지 여부를 나타내는 데 사용합니다.

반환

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

반환 형식

InputPortBinding

as_input

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

as_input(input_name)

매개 변수

input_name
str
필수

이 입력의 이름을 지정하는 데 사용합니다.

반환

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

반환 형식

InputPortBinding

as_mount

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

as_mount(input_name=None)

매개 변수

input_name
str
기본값: None

이 입력의 이름을 지정하는 데 사용합니다.

반환

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

반환 형식

InputPortBinding

create_input_binding

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

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

매개 변수

input_name
str
기본값: None

입력의 이름입니다.

mode
str
기본값: None

PortDataReference에 액세스하는 모드입니다(“mount” 또는 “download”).

path_on_compute
str
기본값: None

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

overwrite
bool
기본값: None

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

반환

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

반환 형식

InputPortBinding

download

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

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

매개 변수

local_path
str
필수

다운로드할 로컬 경로입니다.

overwrite
bool
기본값: None

True이면 기존 파일을 덮어씁니다. 기본값은 False입니다.

show_progress
bool
기본값: None

콘솔에서 다운로드 진행률을 표시합니다. 기본값은 True입니다.

반환

성공적으로 다운로드된 파일 수입니다.

반환 형식

int

특성

datastore

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

반환

데이터 저장소 개체입니다.

반환 형식

Datastore

datastore_name

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

반환

데이터 저장소 이름입니다.

반환 형식

str

name

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

반환

데이터 참조 이름입니다.

반환 형식

str

path_on_datastore

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

반환

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

반환 형식

str