PortDataReference Klas

Modelgegevens 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 stapinvoer in een toekomstige pijplijn.

Initialiseer PortDataReference.

Constructor

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

Parameters

Name	Description
context Vereist	<xref:azureml.pipeline.core._GraphContext> Het grafiekcontextobject.
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. Default value: None
context Vereist	<xref:azureml.pipeline.core._GraphContext> Het grafiekcontextobject.
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 uit 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 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 treinstap.

Methoden

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

as_download

Gebruik portDataReference als 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. Default value: None
path_on_compute	str Het pad op de berekening om de gegevens naar te downloaden. Default value: None
overwrite	bool Gebruik dit om aan te geven of bestaande gegevens moeten worden overschreven. Default value: 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 Hiermee geeft u een naam op voor deze invoer.

Retouren

Type	Description
InputPortBinding	De InputPortBinding met deze PortDataReference als bron.

as_mount

Gebruik portDataReference als stapinvoer via de koppelingsmodus.

as_mount(input_name=None)

Parameters

Name	Description
input_name	str Hiermee geeft u een naam op voor deze invoer. Default value: None

Retouren

Type	Description
InputPortBinding	De InputPortBinding met deze PortDataReference als bron.

create_input_binding

Maak 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. Default value: None
mode	str De modus voor toegang tot portDataReference ('koppelen' of 'downloaden'). Default value: None
path_on_compute	str Voor de downloadmodus bevindt het pad op de berekening van de gegevens zich. Default value: None
overwrite	bool Voor de downloadmodus moet u bestaande gegevens overschrijven. Default value: 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 het geval is, overschrijft u het bestaande bestand standaard onwaar. Default value: None
show_progress	bool De voortgang van het downloaden in de console weergeven, wordt standaard ingesteld op True. Default value: None

Retouren

Type	Description
int	Het aantal bestanden dat is gedownload.

Kenmerken

datastore

Haal het gegevensarchief op dat is gekoppeld aan portDataReference.

Retouren

Type	Description
Datastore	Het gegevensarchiefobject.

datastore_name

Haal de naam op van het gegevensarchief dat is gekoppeld aan 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 in het gegevensarchief.

Feedback

Is deze pagina nuttig?