PortDataReference Klass

Modellerar data som är associerade med utdata från en slutförd StepRun.

Ett PortDataReference-objekt kan användas för att ladda ned utdata som skapades av en StepRun. Den kan också användas som stegindata i en framtida pipeline.

Initiera PortDataReference.

Arv

builtins.object

PortDataReference

Konstruktor

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

Parametrar

Name	Description
context Obligatorisk	<xref:azureml.pipeline.core._GraphContext> Grafkontextobjektet.
pipeline_run_id Obligatorisk	str ID:t för pipelinekörningen som genererade utdata.
data_reference Obligatorisk	DataReference Datareferensobjektet.
step_run	StepRun StepRun-objektet som skapade data. Standardvärde: None
context Obligatorisk	<xref:azureml.pipeline.core._GraphContext> Grafkontextobjektet.
pipeline_run_id Obligatorisk	str ID:t för pipelinekörningen som genererade utdata.
data_reference Obligatorisk	DataReference Datareferensobjektet.
step_run Obligatorisk	StepRun StepRun-objektet som skapade data.

Kommentarer

En PortDataReference pekar på data som har skapats av en slutförd StepRun.

Hämta en PortDataReference från en PipelineRun och ladda ned utdata enligt följande:

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

En PortDataReference kan användas som indata till ett steg i ett Pipeline, ungefär som med hjälp av en DataReference.

Ett exempel på hur du använder en PortDataReference som stegindata är följande:

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

I det här exemplet använder den nyligen konstruerade pipelinen utdata som skapades av den slutförda PipelineRun som indata till tågsteget.

Metoder

as_download	Använd PortDataReference som ett steg som indata via nedladdningsläget.
as_input	Skapa en InputPortBinding och ange ett indatanamn (men använd standardläge).
as_mount	Använd PortDataReference som ett steg som indata via "monteringsläget".
create_input_binding	Skapa indatabindning med denna PortDataReference som källa.
download	Ladda ned data som representeras av PortDataReference.

as_download

Använd PortDataReference som ett steg som indata via nedladdningsläget.

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

Parametrar

Name	Description
input_name	str Ange ett namn för den här indatan. Standardvärde: None
path_on_compute	str Sökvägen till beräkningen som data ska laddas ned till. Standardvärde: None
overwrite	bool Används för att ange om befintliga data ska skrivas över. Standardvärde: None

Returer

Typ	Description
InputPortBinding	InputPortBinding med denna PortDataReference som källa.

as_input

Skapa en InputPortBinding och ange ett indatanamn (men använd standardläge).

as_input(input_name)

Parametrar

Name	Description
input_name Obligatorisk	str Använd för att ange ett namn för den här indatan.

Returer

Typ	Description
InputPortBinding	InputPortBinding med denna PortDataReference som källa.

as_mount

Använd PortDataReference som ett steg som indata via "monteringsläget".

as_mount(input_name=None)

Parametrar

Name	Description
input_name	str Använd för att ange ett namn för den här indatan. Standardvärde: None

Returer

Typ	Description
InputPortBinding	InputPortBinding med denna PortDataReference som källa.

create_input_binding

Skapa indatabindning med denna PortDataReference som källa.

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

Parametrar

Name	Description
input_name	str Namnet på indata. Standardvärde: None
mode	str Läget för att komma åt PortDataReference ("mount" eller "download"). Standardvärde: None
path_on_compute	str I läget "ladda ned" finns sökvägen för beräkningen av data. Standardvärde: None
overwrite	bool Om du vill skriva över befintliga data för "nedladdningsläge". Standardvärde: None

Returer

Typ	Description
InputPortBinding	InputPortBinding med denna PortDataReference som källa.

download

Ladda ned data som representeras av PortDataReference.

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

Parametrar

Name	Description
local_path Obligatorisk	str Lokal sökväg att ladda ned till.
overwrite	bool Om det är sant skriver du över befintlig fil, standardvärdet Falskt. Standardvärde: None
show_progress	bool Visa förloppet för nedladdningen i konsolen, standardvärdet Är sant. Standardvärde: None

Returer

Typ	Description
int	Antalet filer som har laddats ned.

Attribut

datastore

Hämta det datalager som är associerat med PortDataReference.

Returer

Typ	Description
Datastore	Datalagerobjektet.

datastore_name

Hämta namnet på det datalager som är associerat med PortDataReference.

Returer

Typ	Description
str	Datalagernamnet.

name

Hämta namnet på den här datareferensen.

Returer

Typ	Description
str	Datareferensnamnet.

path_on_datastore

Hämta sökvägen till datalager för PortDataReference.

Returer

Typ	Description
str	Sökvägen till datalager.