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

Name	Description
context Vyžadováno	<xref:azureml.pipeline.core._GraphContext> Objekt kontextu grafu.
pipeline_run_id Vyžadováno	str ID spuštění kanálu, ze kterého byl výstup vytvořen.
data_reference Vyžadováno	DataReference Objekt odkazu na data.
step_run	StepRun Objekt StepRun, který vytvořil data. Default value: None
context Vyžadováno	<xref:azureml.pipeline.core._GraphContext> Objekt kontextu grafu.
pipeline_run_id Vyžadováno	str ID spuštění kanálu, ze kterého byl výstup vytvořen.
data_reference Vyžadováno	DataReference Objekt odkazu na data.
step_run Vyžadováno	StepRun 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

Name	Description
input_name	str Zadejte název tohoto vstupu. Default value: None
path_on_compute	str Cesta na výpočetním prostředí, do které se mají data stáhnout. Default value: None
overwrite	bool Slouží k označení, jestli se mají přepsat existující data. Default value: None

Návraty

Typ	Description
InputPortBinding	InputPortBinding s tímto PortDataReference jako zdrojem.

as_input

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

as_input(input_name)

Parametry

Name	Description
input_name Vyžadováno	str Slouží k zadání názvu pro tento vstup.

Návraty

Typ	Description
InputPortBinding	InputPortBinding s tímto PortDataReference jako zdrojem.

as_mount

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

as_mount(input_name=None)

Parametry

Name	Description
input_name	str Slouží k zadání názvu pro tento vstup. Default value: None

Návraty

Typ	Description
InputPortBinding	InputPortBinding s tímto PortDataReference jako zdrojem.

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

Name	Description
input_name	str Název vstupu. Default value: None
mode	str Režim pro přístup k PortDataReference (připojit nebo stáhnout). Default value: None
path_on_compute	str V režimu stahování se bude nacházet cesta ve výpočetním prostředí, ve kterém se data nacházejí. Default value: None
overwrite	bool V režimu stahování určuje, jestli se mají přepsat existující data. Default value: None

Návraty

Typ	Description
InputPortBinding	InputPortBinding s tímto PortDataReference jako zdrojem.

download

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

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

Parametry

Name	Description
local_path Vyžadováno	str Místní cesta ke stažení.
overwrite	bool Pokud je hodnota true, přepsat existující soubor, výchozí hodnota je False. Default value: None
show_progress	bool Zobrazí průběh stahování v konzole, výchozí hodnota je True. Default value: None

Návraty

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

Atributy

datastore

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

Návraty

Typ	Description
Datastore	Objekt úložiště dat.

datastore_name

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

Návraty

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

name

Získejte název tohoto odkazu na data.

Návraty

Typ	Description
str	Název odkazu na data.

path_on_datastore

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

Návraty

Typ	Description
str	Cesta k úložišti dat.