PortDataReference Klas

Modelleert gegevens die zijn gekoppeld aan een uitvoer van een voltooide StepRun.

Een PortDataReference-object kan worden gebruikt om de uitvoergegevens te downloaden die zijn geproduceerd door een StepRun. Het kan ook worden gebruikt als een stapinvoer in een toekomstige pijplijn.

Initialiseer PortDataReference.

Overname

builtins.object

PortDataReference

Constructor

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

Parameters

Name	Description
context Vereist	<xref:azureml.pipeline.core._GraphContext> Het contextobject van de grafiek.
pipeline_run_id Vereist	str De id van de pijplijnuitvoering die de uitvoer heeft geproduceerd.
data_reference Vereist	DataReference Het gegevensverwijzingsobject.
step_run	StepRun Het StepRun-object dat de gegevens heeft geproduceerd. standaardwaarde: None
context Vereist	<xref:azureml.pipeline.core._GraphContext> Het contextobject van de grafiek.
pipeline_run_id Vereist	str De id van de pijplijnuitvoering die de uitvoer heeft geproduceerd.
data_reference Vereist	DataReference Het gegevensverwijzingsobject.
step_run Vereist	StepRun Het StepRun-object dat de gegevens heeft geproduceerd.

Opmerkingen

Een PortDataReference verwijst naar gegevens die zijn geproduceerd door een voltooide StepRun.

Haal een PortDataReference op van een PipelineRun en download de uitvoergegevens als volgt:

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

Een PortDataReference kan worden gebruikt als invoer voor een stap in een Pipeline, vergelijkbaar met het gebruik van een DataReference.

Een voorbeeld van het gebruik van een PortDataReference als een stapinvoer is als volgt:

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

In dit voorbeeld gebruikt de zojuist samengestelde pijplijn de uitvoer die is gemaakt door de voltooide PipelineRun als invoer voor de trainstap.

Methoden

as_download	Gebruik portDataReference als een stapinvoer via de downloadmodus.
as_input	Maak een InputPortBinding en geef een invoernaam op (maar gebruik de standaardmodus).
as_mount	Gebruik portDataReference als een stapinvoer via de koppelingsmodus.
create_input_binding	Maak een invoerbinding met deze PortDataReference als bron.
download	Download de gegevens die worden vertegenwoordigd door portDataReference.

as_download

Gebruik portDataReference als een stapinvoer via de downloadmodus.

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

Parameters

Name	Description
input_name	str Geef een naam op voor deze invoer. standaardwaarde: None
path_on_compute	str Het pad op de berekening waar de gegevens naar moeten worden gedownload. standaardwaarde: None
overwrite	bool Gebruik deze optie om aan te geven of bestaande gegevens moeten worden overschreven. standaardwaarde: None

Retouren

Type	Description
InputPortBinding	De InputPortBinding met deze PortDataReference als bron.

as_input

Maak een InputPortBinding en geef een invoernaam op (maar gebruik de standaardmodus).

as_input(input_name)

Parameters

Name	Description
input_name Vereist	str Gebruik om een naam op te geven voor deze invoer.

Retouren

Type	Description
InputPortBinding	De InputPortBinding met deze PortDataReference als bron.

as_mount

Gebruik portDataReference als een stapinvoer via de koppelingsmodus.

as_mount(input_name=None)

Parameters

Name	Description
input_name	str Gebruik om een naam op te geven voor deze invoer. standaardwaarde: None

Retouren

Type	Description
InputPortBinding	De InputPortBinding met deze PortDataReference als bron.

create_input_binding

Maak een invoerbinding met deze PortDataReference als bron.

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

Parameters

Name	Description
input_name	str De naam van de invoer. standaardwaarde: None
mode	str De modus voor toegang tot PortDataReference ('koppelen' of 'downloaden'). standaardwaarde: None
path_on_compute	str Voor de 'download'-modus wordt het pad op de berekening van de gegevens opgeslagen. standaardwaarde: None
overwrite	bool Voor de 'downloadmodus', of bestaande gegevens moeten worden overschreven. standaardwaarde: None

Retouren

Type	Description
InputPortBinding	De InputPortBinding met deze PortDataReference als bron.

download

Download de gegevens die worden vertegenwoordigd door portDataReference.

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

Parameters

Name	Description
local_path Vereist	str Lokaal pad om naar te downloaden.
overwrite	bool Als dit waar is, overschrijft u het bestaande bestand. De standaardinstelling is Onwaar. standaardwaarde: None
show_progress	bool De voortgang van het downloaden weergeven in de console, standaard ingesteld op True. standaardwaarde: None

Retouren

Type	Description
int	Het aantal bestanden dat is gedownload.

Kenmerken

datastore

Haal het gegevensarchief op dat is gekoppeld aan de PortDataReference.

Retouren

Type	Description
Datastore	Het gegevensarchiefobject.

datastore_name

Haal de naam op van het gegevensarchief dat is gekoppeld aan de PortDataReference.

Retouren

Type	Description
str	De naam van het gegevensarchief.

name

Haal de naam van deze gegevensreferentie op.

Retouren

Type	Description
str	De naam van de gegevensreferentie.

path_on_datastore

Haal het pad op in het gegevensarchief voor PortDataReference.

Retouren

Type	Description
str	Het pad naar het gegevensarchief.