Partilhar via


EstimatorStep Classe

PRETERIDO. Cria uma etapa de pipeline para ser executada Estimator para o treinamento de modelo do Azure ML.

Crie uma etapa do Pipeline do Azure ML para executar o treinamento do modelo do Estimador para Aprendizado de Máquina.

PRETERIDO. Use o CommandStep em vez disso. Para obter um exemplo , consulte Como executar o treinamento de ML em pipelines com CommandStep.

Construtor

EstimatorStep(name=None, estimator=None, estimator_entry_script_arguments=None, runconfig_pipeline_params=None, inputs=None, outputs=None, compute_target=None, allow_reuse=True, version=None)

Parâmetros

Name Description
name
str

O nome da etapa.

Default value: None
estimator

O objeto estimador associado para esta etapa. Pode ser um estimador pré-configurado, como Chainer, PyTorch, TensorFlowou SKLearn.

Default value: None
estimator_entry_script_arguments

[Obrigatório] Uma lista de argumentos de linha de comando. Se o script de entrada do Estimador não aceitar argumentos de linha de comando, defina esse valor de parâmetro como uma lista vazia.

Default value: None
runconfig_pipeline_params

Uma substituição de propriedades runconfig em tempo de execução usando pares chave-valor, cada um com nome da propriedade runconfig e PipelineParameter para essa propriedade.

Valores suportados: 'NodeCount', 'MpiProcessCountPerNode', 'TensorflowWorkerCount', 'TensorflowParameterServerCount'

Default value: None
inputs

Uma lista de entradas a utilizar.

Default value: None
outputs

Uma lista de objetos PipelineData.

Default value: None
compute_target

[Obrigatório] O destino de computação a ser usado.

Default value: None
allow_reuse

Indica se a etapa deve reutilizar os resultados anteriores ao ser executada novamente com as mesmas configurações. A reutilização está ativada por predefinição. Se o conteúdo da etapa (scripts/dependências), bem como as entradas e os parâmetros permanecerem inalterados, a saída da execução anterior desta etapa será reutilizada. Ao reutilizar a etapa, em vez de enviar o trabalho para computação, os resultados da execução anterior são imediatamente disponibilizados para quaisquer etapas subsequentes. Se você usar conjuntos de dados do Aprendizado de Máquina do Azure como entradas, a reutilização será determinada se a definição do conjunto de dados foi alterada, não se os dados subjacentes foram alterados.

Default value: True
version
str

Uma tag de versão opcional para indicar uma alteração na funcionalidade do módulo.

Default value: None
name
Necessário
str

O nome da etapa.

estimator
Necessário
<xref:Estimator>

O objeto estimador associado para esta etapa. Pode ser um estimador pré-configurado, como Chainer, PyTorch, TensorFlowou SKLearn.

estimator_entry_script_arguments
Necessário
[str]

[Obrigatório] Uma lista de argumentos de linha de comando. Se o script de entrada do Estimador não aceitar argumentos de linha de comando, defina esse valor de parâmetro como uma lista vazia.

runconfig_pipeline_params
Necessário

Uma substituição de propriedades runconfig em tempo de execução usando pares chave-valor, cada um com nome da propriedade runconfig e PipelineParameter para essa propriedade.

Valores suportados: 'NodeCount', 'MpiProcessCountPerNode', 'TensorflowWorkerCount', 'TensorflowParameterServerCount'

inputs
Necessário

Uma lista de entradas a utilizar.

outputs
Necessário

Uma lista de objetos PipelineData.

compute_target
Necessário

[Obrigatório] O destino de computação a ser usado.

allow_reuse
Necessário

Indica se a etapa deve reutilizar os resultados anteriores ao ser executada novamente com as mesmas configurações. A reutilização está ativada por predefinição. Se o conteúdo da etapa (scripts/dependências), bem como as entradas e os parâmetros permanecerem inalterados, a saída da execução anterior desta etapa será reutilizada. Ao reutilizar a etapa, em vez de enviar o trabalho para computação, os resultados da execução anterior são imediatamente disponibilizados para quaisquer etapas subsequentes. Se você usar conjuntos de dados do Aprendizado de Máquina do Azure como entradas, a reutilização será determinada se a definição do conjunto de dados foi alterada, não se os dados subjacentes foram alterados.

version
Necessário
str

versão

Observações

Observe que os argumentos para o script de entrada usado no Estimator objeto devem ser especificados como lista usando o estimator_entry_script_arguments parâmetro ao instanciar um EstimatorStep. O parâmetro script_params Estimator aceita um dicionário. No entanto, estimator_entry_script_argument parâmetro espera argumentos como uma lista.

A inicialização do EstimatorStep envolve a especificação de uma lista de entradas com o inputs parâmetro e você não precisa especificar as entradas com o Estimador, uma exceção será lançada se você fizer isso. Consulte o inputs parâmetro para os tipos de entradas permitidas. Opcionalmente, você também pode especificar quaisquer saídas para a etapa. Consulte o outputs parâmetro para os tipos de saídas permitidas.

A prática recomendada para trabalhar com o EstimatorStep é usar uma pasta separada para scripts e quaisquer arquivos dependentes associados à etapa e especificar essa pasta como a Estimatorsource_directorydo objeto . Fazê-lo tem duas vantagens. Primeiro, ele ajuda a reduzir o tamanho do instantâneo criado para a etapa, pois apenas o que é necessário para a etapa é instantâneo. Em segundo lugar, a saída da etapa de uma execução anterior pode ser reutilizada se não houver alterações no source_directory que desencadearia um reupload do snaphot.

Métodos

create_node

Crie um nó a partir da etapa Estimador e adicione-o ao gráfico especificado.

PRETERIDO. Use o CommandStep em vez disso. Para obter um exemplo , consulte Como executar o treinamento de ML em pipelines com CommandStep.

Este método não se destina a ser utilizado diretamente. Quando um pipeline é instanciado com essa etapa, o Azure ML passa automaticamente os parâmetros necessários por meio desse método para que essa etapa possa ser adicionada a um gráfico de pipeline que representa o fluxo de trabalho.

create_node

Crie um nó a partir da etapa Estimador e adicione-o ao gráfico especificado.

PRETERIDO. Use o CommandStep em vez disso. Para obter um exemplo , consulte Como executar o treinamento de ML em pipelines com CommandStep.

Este método não se destina a ser utilizado diretamente. Quando um pipeline é instanciado com essa etapa, o Azure ML passa automaticamente os parâmetros necessários por meio desse método para que essa etapa possa ser adicionada a um gráfico de pipeline que representa o fluxo de trabalho.

create_node(graph, default_datastore, context)

Parâmetros

Name Description
graph
Necessário

O objeto gráfico ao qual adicionar o nó.

default_datastore
Necessário

O armazenamento de dados padrão.

context
Necessário
<xref:azureml.pipeline.core._GraphContext>

O contexto do gráfico.

Devoluções

Tipo Description

O nó criado.