PortDataReference Třída

Modely dat přidružených k výstupu dokončeného kroku StepRun.

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

Inicializace ParametrDataReference

Konstruktor

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

Parametry

Name	Description
context Vyžadováno	<xref:azureml.pipeline.core._GraphContext> Kontextový objekt grafu.
pipeline_run_id Vyžadováno	str ID spuštění kanálu, které vytvořilo výstup.
data_reference Vyžadováno	DataReference Objekt odkazu na data.
step_run	StepRun StepRun objekt, který vytvořil data. Default value: None
context Vyžadováno	<xref:azureml.pipeline.core._GraphContext> Kontextový objekt grafu.
pipeline_run_id Vyžadováno	str ID spuštění kanálu, které vytvořilo výstup.
data_reference Vyžadováno	DataReference Objekt odkazu na data.
step_run Vyžadováno	StepRun StepRun objekt, který vytvořil data.

Poznámky

PortDataReference odkazuje na data, která byla vytvořena dokončenou StepRun.

Získejte PortDataReference z PipelineRun výstupních dat a stáhněte je 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")

PortDataReference lze použít jako vstup kroku v Pipelinekroku, podobně jako použití DataReference.

Příklad použití ParametrDataReference jako vstupu kroku je následující:

   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 nově vytvořený kanál použije 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 prostřednictvím režimu stahování.
as_input	Vytvořte InputPortBinding a zadejte název vstupu (ale použijte výchozí režim).
as_mount	Spotřebovávejte portDataReference jako krokový vstup prostřednictvím režimu připojení.
create_input_binding	Vytvořte vstupní vazbu s tímto PortDataReference jako zdrojem.
download	Stáhněte si data reprezentovaná PortDataReference.

as_download

Použijte PortDataReference jako krokový vstup prostřednictvím 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 výpočetních prostředků ke stažení dat. Default value: None
overwrite	bool Slouží k označení, zda chcete 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

Spotřebovávejte portDataReference jako krokový vstup prostřednictvím 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 PortDataReference 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 ("mount" nebo "download"). Default value: None
path_on_compute	str V případě režimu stahování se bude cesta na výpočetních prostředcích nacházet. Default value: None
overwrite	bool V případě režimu "download" určuje, zda chcete 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á 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řepište existující soubor, výchozí hodnota je False. Default value: None
show_progress	bool Umožňuje zobrazit průběh stahování v konzole, výchozí hodnota je True. Default value: None

Návraty

Typ	Description
int	Počet souborů se úspěšně stáhl.

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.