OutputPortBinding Klass

Definierar ett namngivet utdata från ett pipelinesteg.

OutputPortBinding kan användas för att ange vilken typ av data som ska skapas i ett steg och hur data ska skapas. Den kan användas med InputPortBinding för att ange att stegutdata är nödvändiga indata för ett annat steg.

Initiera OutputPortBinding.

Konstruktor

OutputPortBinding(name, datastore=None, output_name=None, bind_mode='mount', path_on_compute=None, is_directory=None, overwrite=None, data_type=None, pipeline_output_name=None, training_output=None, dataset_registration=None, dataset_output=None)

Parametrar

Name	Description
name Obligatorisk	str Namnet på objektet OutputPortBinding, som endast kan innehålla bokstäver, siffror och understreck.
datastore	Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore] Datalager som PipelineData kommer att finnas på. Standardvärde: None
output_name	str Namn på utdata, om Inget namn används. Kan bara innehålla bokstäver, siffror och understreck. Standardvärde: None
bind_mode	str Anger om skapandesteget ska använda metoden "upload" eller "mount" eller "hdfs" för att komma åt data. Standardvärde: mount
path_on_compute	str I läget "ladda upp" skriver modulen utdata till. Standardvärde: None
is_directory	bool Om utdata är en katalog eller en enskild fil. Standardvärde: None
overwrite	bool För "upload"-läge, om du vill skriva över befintliga data. Standardvärde: None
data_type	str Valfritt. Datatypen kan användas för att ange den förväntade typen av utdata och för att beskriva hur användningssteg ska använda data. Kan vara valfri användardefinierad sträng. Standardvärde: None
pipeline_output_name	str Om det tillhandahålls kommer dessa utdata att vara tillgängliga med hjälp av PipelineRun.get_pipeline_output(). Namn på pipelineutdata måste vara unika i pipelinen. Standardvärde: None
training_output	TrainingOutput Definierar utdata för träningsresultat. Detta behövs bara för specifika utbildningar som resulterar i olika typer av utdata, till exempel mått och modell. Till exempel AutoMLStep resulterar i mått och modell. Du kan också definiera specifik tränings iteration eller mått som används för att få bästa modell. För HyperDriveStepkan du också definiera de specifika modellfiler som ska ingå i utdata. Standardvärde: None
dataset_registration	DatasetRegistration Valfritt. Det här är en intern parameter. Du bör använda PipelineData.as_dataset i stället. Standardvärde: None
dataset_output	OutputDatasetConfig Valfritt. Det här är en intern parameter. Du bör använda OutputFileDatasetConfig intead. Standardvärde: None
name Obligatorisk	str Namnet på objektet OutputPortBinding, som endast kan innehålla bokstäver, siffror och understreck.
datastore Obligatorisk	Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore] Datalager som PipelineData kommer att finnas på.
output_name Obligatorisk	str Namn på utdata, om Inget namn används. Kan bara innehålla bokstäver, siffror och understreck.
bind_mode Obligatorisk	str Anger om skapandesteget ska använda metoden "upload" eller "mount" eller "hdfs" för att komma åt data.
path_on_compute Obligatorisk	str I läget "ladda upp" skriver modulen utdata till.
is_directory Obligatorisk	bool om utdata är en katalog
overwrite Obligatorisk	bool För "upload"-läge, om du vill skriva över befintliga data.
data_type Obligatorisk	str Valfritt. Datatypen kan användas för att ange den förväntade typen av utdata och för att beskriva hur användningssteg ska använda data. Kan vara valfri användardefinierad sträng.
pipeline_output_name Obligatorisk	str Om det tillhandahålls kommer dessa utdata att vara tillgängliga med hjälp av PipelineRun.get_pipeline_output(). Namn på pipelineutdata måste vara unika i pipelinen.
training_output Obligatorisk	TrainingOutput Definierar utdata för träningsresultat. Detta behövs bara för specifika utbildningar som resulterar i olika typer av utdata, till exempel mått och modell. Till exempel AutoMLStep resulterar i mått och modell. Du kan också definiera specifik tränings iteration eller mått som används för att få bästa modell. För HyperDriveStepkan du också definiera de specifika modellfiler som ska ingå i utdata.
dataset_registration Obligatorisk	DatasetRegistration Valfritt. Det här är en intern parameter. Du bör använda PipelineData.as_dataset i stället.
dataset_output Obligatorisk	OutputDatasetConfig Valfritt. Det här är en intern parameter. Du bör använda OutputFileDatasetConfig intead.

Kommentarer

OutputPortBinding kan användas på ett liknande sätt som PipelineData när du skapar en pipeline för att ange stegindata och utdata. Skillnaden är att OutputPortBinding måste användas med InputPortBinding för att kunna användas som indata till ett annat steg.

Ett exempel på hur du skapar en pipeline med OutputPortBinding är följande:

   from azureml.pipeline.core import OutputPortBinding, InputPortBinding, Pipeline
   from azureml.pipeline.steps import PythonScriptStep

   step_1_output = OutputPortBinding("output", datastore=datastore)

   step_1 = PythonScriptStep(
       name='process data',
       script_name="process_data.py",
       compute_target=compute,
       arguments=["--output", step_1_output],
       outputs=[step_1_output]
   )

   step_2_input = InputPortBinding("input", bind_object=step_1_output)

   step_2 = PythonScriptStep(
       name='train',
       script_name="train.py",
       compute_target=compute,
       arguments=["--input", step_2_input],
       inputs=[step_2_input]
   )

   pipeline = Pipeline(workspace=workspace, steps=[step_1, step_2])

Detta skapar en pipeline med två steg. Processsteget körs först och sedan körs träningssteget när det har slutförts. Azure ML tillhandahåller utdata från processsteget, enligt beskrivningen i outputPortBinding-objektet, till träningssteget.

Attribut

bind_mode

Hämta läget ("upload" eller "mount" eller "hdfs") som skapandesteget använder för att skapa data.

Returer

Typ	Description
str	Bindningsläget.

data_type

Hämta den typ av data som ska skapas.

Returer

Typ	Description
str	Namnet på datatypen.

dataset_registration

Hämta registreringsinformationen för datamängden.

Returer

Typ	Description
DatasetRegistration	Registreringsinformationen för datamängden.

datastore

Datalager som PipelineData kommer att finnas på.

Returer

Typ	Description
Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore]	Datalagerobjektet.

is_directory

Om utdata är en katalog.

Returer

Typ	Description
bool	is_directory

name

Namnet på objektet OutputPortBinding.

Returer

Typ	Description
str	Namnet.

overwrite

För "uppladdningsläge" anger du om befintliga data ska skrivas över.

Returer

Typ	Description
bool	_overwrite

path_on_compute

I läget "ladda upp" skriver modulen utdata till.

Returer

Typ	Description
str	path_on_compute

pipeline_output_name

Hämta namnet på pipelineutdata som motsvarar den här OutputPortBinding.

Returer

Typ	Description
str	Pipelinens utdatanamn.

training_output

Hämta träningsutdata.

Returer

Typ	Description
TrainingOutput	Träningsutdata