Partilhar via


OutputPortBinding Classe

Define uma saída nomeada de uma etapa de pipeline.

OutputPortBinding pode ser usado para especificar o tipo de dados que serão produzidos por uma etapa e como os dados serão produzidos. Ele pode ser usado com InputPortBinding para especificar que a saída da etapa é uma entrada necessária de outra etapa.

Inicialize OutputPortBinding.

Construtor

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)

Parâmetros

Name Description
name
Necessário
str

Nome do objeto OutputPortBinding, que pode conter apenas letras, dígitos e sublinhados.

datastore

Armazenamento de dados no qual o PipelineData residirá.

Default value: None
output_name
str

Nome da saída, se Nenhum nome for usado. Pode conter apenas letras, dígitos e sublinhados.

Default value: None
bind_mode
str

Especifica se a etapa de produção usará o método "upload" ou "mount" ou "hdfs" para acessar os dados.

Default value: mount
path_on_compute
str

Para o modo "upload", o caminho no qual o módulo grava a saída.

Default value: None
is_directory

Se a saída é um diretório ou um único arquivo.

Default value: None
overwrite

Para o modo "upload", se os dados existentes devem ser substituídos.

Default value: None
data_type
str

Opcional. O tipo de dados pode ser usado para especificar o tipo esperado da saída e para detalhar como as etapas de consumo devem usar os dados. Pode ser qualquer cadeia de caracteres definida pelo usuário.

Default value: None
pipeline_output_name
str

Se fornecida, essa saída estará disponível usando PipelineRun.get_pipeline_output(). Os nomes de saída do pipeline devem ser exclusivos no pipeline.

Default value: None
training_output

Define a saída para o resultado do treinamento. Isso é necessário apenas para treinamentos específicos que resultam em diferentes tipos de saídas, como Métricas e Modelo. Por exemplo, AutoMLStep resultados em métricas e modelo. Você também pode definir iteração de treinamento específica ou métrica usada para obter o melhor modelo. Para HyperDriveStepo , você também pode definir os arquivos de modelo específicos a serem incluídos na saída.

Default value: None
dataset_registration

Opcional. Este é um parâmetro interno. Em vez disso, deve utilizar PipelineData.as_dataset.

Default value: None
dataset_output

Opcional. Este é um parâmetro interno. Você deve estar usando OutputFileDatasetConfig intead.

Default value: None
name
Necessário
str

Nome do objeto OutputPortBinding, que pode conter apenas letras, dígitos e sublinhados.

datastore
Necessário

Armazenamento de dados no qual o PipelineData residirá.

output_name
Necessário
str

Nome da saída, se Nenhum nome for usado. Só pode conter letras, dígitos e sublinhados.

bind_mode
Necessário
str

Especifica se a etapa de produção usará o método "upload" ou "mount" ou "hdfs" para acessar os dados.

path_on_compute
Necessário
str

Para o modo "upload", o caminho no qual o módulo grava a saída.

is_directory
Necessário

se a saída for um diretório

overwrite
Necessário

Para o modo "upload", se os dados existentes devem ser substituídos.

data_type
Necessário
str

Opcional. O tipo de dados pode ser usado para especificar o tipo esperado da saída e para detalhar como as etapas de consumo devem usar os dados. Pode ser qualquer cadeia de caracteres definida pelo usuário.

pipeline_output_name
Necessário
str

Se fornecida, essa saída estará disponível usando PipelineRun.get_pipeline_output(). Os nomes de saída do pipeline devem ser exclusivos no pipeline.

training_output
Necessário

Define a saída para o resultado do treinamento. Isso é necessário apenas para treinamentos específicos que resultam em diferentes tipos de saídas, como Métricas e Modelo. Por exemplo, AutoMLStep resultados em métricas e modelo. Você também pode definir iteração de treinamento específica ou métrica usada para obter o melhor modelo. Para HyperDriveStepo , você também pode definir os arquivos de modelo específicos a serem incluídos na saída.

dataset_registration
Necessário

Opcional. Este é um parâmetro interno. Em vez disso, deve utilizar PipelineData.as_dataset.

dataset_output
Necessário

Opcional. Este é um parâmetro interno. Você deve estar usando OutputFileDatasetConfig intead.

Observações

OutputPortBinding pode ser usado de maneira semelhante à PipelineData criação de um Pipeline para especificar entradas e saídas de etapas. A diferença é que OutputPortBinding precisa ser usado para InputPortBinding ser consumido como uma entrada para outra etapa.

Um exemplo para construir um Pipeline com OutputPortBinding é o seguinte:


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

Isso criará um Pipeline com duas etapas. A etapa do processo será executada primeiro, depois de concluída, a etapa do trem será executada. O Azure ML fornecerá a saída produzida pela etapa do processo, conforme descrito pelo objeto OutputPortBinding, para a etapa do trem.

Atributos

bind_mode

Obtenha o modo ("upload" ou "mount" ou "hdfs") que a etapa de produção usará para criar os dados.

Devoluções

Tipo Description
str

O modo de ligação.

data_type

Obtenha o tipo de dados que serão produzidos.

Devoluções

Tipo Description
str

O nome do tipo de dados.

dataset_registration

Obtenha as informações de registro do conjunto de dados.

Devoluções

Tipo Description

As informações de registro do conjunto de dados.

datastore

Armazenamento de dados no qual o PipelineData residirá.

Devoluções

Tipo Description

O objeto Datastore.

is_directory

Se a saída é um diretório.

Devoluções

Tipo Description

is_directory

name

Nome do objeto OutputPortBinding.

Devoluções

Tipo Description
str

O nome.

overwrite

Para o modo "upload", indique se deseja substituir os dados existentes.

Devoluções

Tipo Description

_overwrite

path_on_compute

Para o modo "upload", o caminho no qual o módulo grava a saída.

Devoluções

Tipo Description
str

path_on_compute

pipeline_output_name

Obtenha o nome da saída do pipeline correspondente a este OutputPortBinding.

Devoluções

Tipo Description
str

O nome de saída do pipeline.

training_output

Obtenha resultados de treinamento.

Devoluções

Tipo Description

Resultados da formação