PortDataReference Osztály

Egy befejezett StepRun kimenetéhez társított adatok modellezése.

PortDataReference objektummal töltheti le azokat a kimeneti adatokat, amelyeket egy StepRun. A jövőbeli folyamatok lépésbemeneteként is használható.

A PortDataReference inicializálása.

Konstruktor

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

Paraméterek

Name	Description
context Kötelező	<xref:azureml.pipeline.core._GraphContext> A gráfkörnyezet objektuma.
pipeline_run_id Kötelező	str A kimenetet előállító folyamatfuttatás azonosítója.
data_reference Kötelező	DataReference Az adathivatkozási objektum.
step_run	StepRun Az adatokat előállító StepRun objektum. Alapértelmezett érték: None
context Kötelező	<xref:azureml.pipeline.core._GraphContext> A gráfkörnyezet objektuma.
pipeline_run_id Kötelező	str A kimenetet előállító folyamatfuttatás azonosítója.
data_reference Kötelező	DataReference Az adathivatkozási objektum.
step_run Kötelező	StepRun Az adatokat előállító StepRun objektum.

Megjegyzések

A PortDataReference a befejezett StepRunadatokra mutat.

PortDataReference lekérése egy PipelineRun fájlból, és töltse le a kimeneti adatokat az alábbiak szerint:

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

A PortDataReference egy lépés bemeneteként használható, hasonlóan egy adott lépéshezPipelineDataReference.

Példa a PortDataReference lépésbemenetként való használatára:

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

Ebben a példában az újonnan létrehozott folyamat a befejezett PipelineRun által létrehozott kimenetet fogja használni a betanítási lépés bemeneteként.

Metódusok

as_download	Használja a PortDataReference-t lépésbemenetként a "letöltési" módban.
as_input	Hozzon létre egy InputPortBindinget, és adjon meg egy bemeneti nevet (de használja az alapértelmezett módot).
as_mount	Használja a PortDataReference-t lépésbemenetként a "csatlakoztatási" módban.
create_input_binding	Hozzon létre bemeneti kötést ezzel a PortDataReference-lel forrásként.
download	Töltse le a PortDataReference által képviselt adatokat.

as_download

Használja a PortDataReference-t lépésbemenetként a "letöltési" módban.

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

Paraméterek

Name	Description
input_name	str Adja meg a bemenet nevét. Alapértelmezett érték: None
path_on_compute	str A számítás elérési útja az adatok letöltéséhez. Alapértelmezett érték: None
overwrite	bool Azt jelzi, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: None

Válaszok

Típus	Description
InputPortBinding	Az InputPortBinding és ez a PortDataReference lesz a forrás.

as_input

Hozzon létre egy InputPortBindinget, és adjon meg egy bemeneti nevet (de használja az alapértelmezett módot).

as_input(input_name)

Paraméterek

Name	Description
input_name Kötelező	str A bemenet nevének megadására használható.

Válaszok

Típus	Description
InputPortBinding	Az InputPortBinding és ez a PortDataReference lesz a forrás.

as_mount

Használja a PortDataReference-t lépésbemenetként a "csatlakoztatási" módban.

as_mount(input_name=None)

Paraméterek

Name	Description
input_name	str A bemenet nevének megadására használható. Alapértelmezett érték: None

Válaszok

Típus	Description
InputPortBinding	Az InputPortBinding és ez a PortDataReference lesz a forrás.

create_input_binding

Hozzon létre bemeneti kötést ezzel a PortDataReference-lel forrásként.

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

Paraméterek

Name	Description
input_name	str A bemenet neve. Alapértelmezett érték: None
mode	str A PortDataReference elérésének módja ("csatlakoztatás" vagy "letöltés"). Alapértelmezett érték: None
path_on_compute	str A "letöltési" mód esetében az adatok a számítási útvonalon lesznek elhelyezve. Alapértelmezett érték: None
overwrite	bool A "letöltési" mód esetében, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: None

Válaszok

Típus	Description
InputPortBinding	Az InputPortBinding és ez a PortDataReference lesz a forrás.

download

Töltse le a PortDataReference által képviselt adatokat.

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

Paraméterek

Name	Description
local_path Kötelező	str A letöltés helyi elérési útja.
overwrite	bool Ha igaz, írja felül a meglévő fájlt, alapértelmezés szerint Hamis. Alapértelmezett érték: None
show_progress	bool A letöltés előrehaladásának megjelenítése a konzolon, alapértelmezés szerint Igaz értékre. Alapértelmezett érték: None

Válaszok

Típus	Description
int	A sikeresen letöltött fájlok száma.

Attribútumok

datastore

Kérje le a PortDataReference-hez társított adattárat.

Válaszok

Típus	Description
Datastore	Az adattár-objektum.

datastore_name

Kérje le a PortDataReference-hez társított adattár nevét.

Válaszok

Típus	Description
str	Az adattár neve.

name

Kérje le ennek az adathivatkozásnak a nevét.

Válaszok

Típus	Description
str	Az adathivatkozás neve.

path_on_datastore

Kérje le a PortDataReference adattárának elérési útját.

Válaszok

Típus	Description
str	Az adattár elérési útja.