PortDataReference Osztály

Egy befejezett StepRun kimenetéhez társított adatokat modellel.

PortDataReference objektummal töltheti le azokat a kimeneti adatokat, amelyeket egy StepRun. Lépésbemenetként is használható a jövőbeli folyamatokban.

A PortDataReference inicializálása.

Öröklődés

builtins.object

PortDataReference

Konstruktor

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

Paraméterek

context

<xref:azureml.pipeline.core._GraphContext>

Kötelező

A gráfkörnyezet objektuma.

pipeline_run_id

str

Kötelező

A kimenetet előállító folyamatfuttatás azonosítója.

data_reference

DataReference

Kötelező

Az adathivatkozási objektum.

step_run

StepRun

alapértelmezett érték: None

Az adatokat előállító StepRun objektum.

context

<xref:azureml.pipeline.core._GraphContext>

Kötelező

A gráfkörnyezet objektuma.

pipeline_run_id

str

Kötelező

A kimenetet előállító folyamatfuttatás azonosítója.

data_reference

DataReference

Kötelező

Az adathivatkozási objektum.

step_run

StepRun

Kötelező

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 Pipelinebemeneteként is használható, hasonlóan a következőhöz: DataReference.

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 betanulá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 paranccsal 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

input_name

str

alapértelmezett érték: None

Adja meg a bemenet nevét.

path_on_compute

str

alapértelmezett érték: None

A számítási útvonal, a amelyre az adatokat le szeretné tölteni.

overwrite

bool

alapértelmezett érték: None

A használatával jelezheti, hogy felülírja-e a meglévő adatokat.

Válaszok

Az InputPortBinding ezzel a PortDataReference-vel forrásként.

Visszatérési típus

InputPortBinding

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

input_name

str

Kötelező

A bemenet nevének megadására használható.

Válaszok

Az InputPortBinding ezzel a PortDataReference-vel forrásként.

Visszatérési típus

InputPortBinding

as_mount

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

as_mount(input_name=None)

Paraméterek

input_name

str

alapértelmezett érték: None

A bemenet nevének megadására használható.

Válaszok

Az InputPortBinding ezzel a PortDataReference-vel forrásként.

Visszatérési típus

InputPortBinding

create_input_binding

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

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

Paraméterek

input_name

str

alapértelmezett érték: None

A bemenet neve.

mode

str

alapértelmezett érték: None

A PortDataReference elérésének módja ("csatlakoztatás" vagy "letöltés").

path_on_compute

str

alapértelmezett érték: None

A "letöltési" mód esetében az adatok számítási útvonala fog elhelyezkedni.

overwrite

bool

alapértelmezett érték: None

A "letöltési" mód esetében adja meg, hogy felülírja-e a meglévő adatokat.

Válaszok

Az InputPortBinding ezzel a PortDataReference-vel forrásként.

Visszatérési típus

InputPortBinding

download

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

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

Paraméterek

local_path

str

Kötelező

A helyi elérési út, amelyre le kell tölteni.

overwrite

bool

alapértelmezett érték: None

Ha igaz, írja felül a meglévő fájlt, alapértelmezés szerint Hamis.

show_progress

bool

alapértelmezett érték: None

A letöltési folyamat megjelenítése a konzolon, alapértelmezés szerint Igaz értékre.

Válaszok

A sikeresen letöltött fájlok száma.

Visszatérési típus

int

Attribútumok

datastore

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

Válaszok

Az adattár objektuma.

Visszatérési típus

Datastore

datastore_name

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

Válaszok

Az adattár neve.

Visszatérési típus

str

name

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

Válaszok

Az adathivatkozás neve.

Visszatérési típus

str

path_on_datastore

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

Válaszok

Az adattár elérési útja.

Visszatérési típus

str