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

context

<xref:azureml.pipeline.core._GraphContext>

Vereist

Het contextobject van de grafiek.

pipeline_run_id

str

Vereist

De id van de pijplijnuitvoering die de uitvoer heeft geproduceerd.

data_reference

DataReference

Vereist

Het gegevensverwijzingsobject.

step_run

StepRun

standaardwaarde: None

Het StepRun-object dat de gegevens heeft geproduceerd.

context

<xref:azureml.pipeline.core._GraphContext>

Vereist

Het contextobject van de grafiek.

pipeline_run_id

str

Vereist

De id van de pijplijnuitvoering die de uitvoer heeft geproduceerd.

data_reference

DataReference

Vereist

Het gegevensverwijzingsobject.

step_run

StepRun

Vereist

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

input_name

str

standaardwaarde: None

Geef een naam op voor deze invoer.

path_on_compute

str

standaardwaarde: None

Het pad op de berekening waar de gegevens naar moeten worden gedownload.

overwrite

bool

standaardwaarde: None

Gebruik deze optie om aan te geven of bestaande gegevens moeten worden overschreven.

Retouren

De InputPortBinding met deze PortDataReference als bron.

Retourtype

InputPortBinding

as_input

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

as_input(input_name)

Parameters

input_name

str

Vereist

Gebruik om een naam op te geven voor deze invoer.

Retouren

De InputPortBinding met deze PortDataReference als bron.

Retourtype

InputPortBinding

as_mount

Gebruik portDataReference als een stapinvoer via de koppelingsmodus.

as_mount(input_name=None)

Parameters

input_name

str

standaardwaarde: None

Gebruik om een naam op te geven voor deze invoer.

Retouren

De InputPortBinding met deze PortDataReference als bron.

Retourtype

InputPortBinding

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

input_name

str

standaardwaarde: None

De naam van de invoer.

mode

str

standaardwaarde: None

De modus voor toegang tot PortDataReference ('koppelen' of 'downloaden').

path_on_compute

str

standaardwaarde: None

Voor de 'download'-modus wordt het pad op de berekening van de gegevens opgeslagen.

overwrite

bool

standaardwaarde: None

Voor de 'downloadmodus', of bestaande gegevens moeten worden overschreven.

Retouren

De InputPortBinding met deze PortDataReference als bron.

Retourtype

InputPortBinding

download

Download de gegevens die worden vertegenwoordigd door portDataReference.

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

Parameters

local_path

str

Vereist

Lokaal pad om naar te downloaden.

overwrite

bool

standaardwaarde: None

Als dit waar is, overschrijft u het bestaande bestand. De standaardinstelling is Onwaar.

show_progress

bool

standaardwaarde: None

De voortgang van het downloaden weergeven in de console, standaard ingesteld op True.

Retouren

Het aantal bestanden dat is gedownload.

Retourtype

int

Kenmerken

datastore

Haal het gegevensarchief op dat is gekoppeld aan de PortDataReference.

Retouren

Het gegevensarchiefobject.

Retourtype

Datastore

datastore_name

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

Retouren

De naam van het gegevensarchief.

Retourtype

str

name

Haal de naam van deze gegevensreferentie op.

Retouren

De naam van de gegevensreferentie.

Retourtype

str

path_on_datastore

Haal het pad op in het gegevensarchief voor PortDataReference.

Retouren

Het pad naar het gegevensarchief.

Retourtype

str