PortDataReference Třída

Modeluje data přidružená k výstupu dokončeného spuštění kroku.

Objekt PortDataReference lze použít ke stažení výstupních dat vytvořených objektem StepRun. Můžete ho také použít jako krokový vstup v budoucím kanálu.

Inicializujte PortDataReference.

Dědičnost

builtins.object

PortDataReference

Konstruktor

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

Parametry

context

<xref:azureml.pipeline.core._GraphContext>

Vyžadováno

Objekt kontextu grafu.

pipeline_run_id

str

Vyžadováno

ID spuštění kanálu, ze kterého byl výstup vytvořen.

data_reference

DataReference

Vyžadováno

Objekt odkazu na data.

step_run

StepRun

výchozí hodnota: None

Objekt StepRun, který vytvořil data.

context

<xref:azureml.pipeline.core._GraphContext>

Vyžadováno

Objekt kontextu grafu.

pipeline_run_id

str

Vyžadováno

ID spuštění kanálu, ze kterého byl výstup vytvořen.

data_reference

DataReference

Vyžadováno

Objekt odkazu na data.

step_run

StepRun

Vyžadováno

Objekt StepRun, který vytvořil data.

Poznámky

PortDataReference odkazuje na data vytvořená dokončeným StepRun.

Získejte PortDataReference z PipelineRun a stáhněte výstupní data následujícím způsobem:

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

Parametr PortDataReference lze použít jako vstup pro krok v objektu Pipeline, podobně jako při použití DataReference.

Příklad použití parametru PortDataReference jako krokového vstupu:

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

V tomto příkladu bude nově vytvořený kanál používat výstup vytvořený dokončeným spuštěním kanálu jako vstup do kroku trénování.

Metody

as_download	Použijte PortDataReference jako krokový vstup v režimu stahování.
as_input	Vytvořte InputPortBinding a zadejte název vstupu (ale použijte výchozí režim).
as_mount	Použití parametru PortDataReference jako krokového vstupu v režimu připojení.
create_input_binding	Vytvořte vstupní vazbu s tímto portemDataReference jako zdrojem.
download	Stáhněte si data reprezentovaná parametrem PortDataReference.

as_download

Použijte PortDataReference jako krokový vstup v režimu stahování.

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

Parametry

input_name

str

výchozí hodnota: None

Zadejte název tohoto vstupu.

path_on_compute

str

výchozí hodnota: None

Cesta na výpočetním prostředí, do které se mají data stáhnout.

overwrite

bool

výchozí hodnota: None

Slouží k označení, jestli se mají přepsat existující data.

Návraty

InputPortBinding s tímto PortDataReference jako zdrojem.

Návratový typ

InputPortBinding

as_input

Vytvořte InputPortBinding a zadejte název vstupu (ale použijte výchozí režim).

as_input(input_name)

Parametry

input_name

str

Vyžadováno

Slouží k zadání názvu pro tento vstup.

Návraty

InputPortBinding s tímto PortDataReference jako zdrojem.

Návratový typ

InputPortBinding

as_mount

Použití parametru PortDataReference jako krokového vstupu v režimu připojení.

as_mount(input_name=None)

Parametry

input_name

str

výchozí hodnota: None

Slouží k zadání názvu pro tento vstup.

Návraty

InputPortBinding s tímto PortDataReference jako zdrojem.

Návratový typ

InputPortBinding

create_input_binding

Vytvořte vstupní vazbu s tímto portemDataReference jako zdrojem.

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

Parametry

input_name

str

výchozí hodnota: None

Název vstupu.

mode

str

výchozí hodnota: None

Režim pro přístup k PortDataReference (připojit nebo stáhnout).

path_on_compute

str

výchozí hodnota: None

V režimu stahování se bude nacházet cesta ve výpočetním prostředí, ve kterém se data nacházejí.

overwrite

bool

výchozí hodnota: None

V režimu stahování určuje, jestli se mají přepsat existující data.

Návraty

InputPortBinding s tímto PortDataReference jako zdrojem.

Návratový typ

InputPortBinding

download

Stáhněte si data reprezentovaná parametrem PortDataReference.

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

Parametry

local_path

str

Vyžadováno

Místní cesta ke stažení.

overwrite

bool

výchozí hodnota: None

Pokud je hodnota true, přepsat existující soubor, výchozí hodnota je False.

show_progress

bool

výchozí hodnota: None

Zobrazí průběh stahování v konzole, výchozí hodnota je True.

Návraty

Počet úspěšně stažených souborů.

Návratový typ

int

Atributy

datastore

Získejte úložiště dat přidružené k PortDataReference.

Návraty

Objekt úložiště dat.

Návratový typ

Datastore

datastore_name

Získejte název úložiště dat přidruženého k PortDataReference.

Návraty

Název úložiště dat.

Návratový typ

str

name

Získejte název tohoto odkazu na data.

Návraty

Název odkazu na data.

Návratový typ

str

path_on_datastore

Získejte cestu k úložišti dat pro PortDataReference.

Návraty

Cesta k úložišti dat.

Návratový typ

str