Partilhar via


PipelineDraft Classe

Representa um pipeline mutável que pode ser utilizado para submeter execuções e criar Pipelines Publicados.

Utilize PipelineDrafts para iterar em Pipelines. Os PipelineDrafts podem ser criados de raiz, outro PipelineDraft ou pipelines existentes: Pipeline, PublishedPipelineou PipelineRun.

Inicializar PipelineDraft.

Herança
builtins.object
PipelineDraft

Construtor

PipelineDraft(workspace, id, name=None, description=None, experiment_name=None, tags=None, properties=None, graph_draft_id=None, parent_pipeline_id=None, parent_pipeline_run_id=None, parent_step_run_ids=None, parent_pipeline_draft_id=None, last_submitted_pipeline_run_id=None, _pipeline_draft_provider=None)

Parâmetros

Name Description
workspace
Necessário

O objeto da área de trabalho para este PipelineDraft.

id
Necessário
str

O ID do PipelineDraft.

name
Necessário
str

O nome do PipelineDraft.

description
Necessário
str

A descrição do PipelineDraft.

experiment_name
Necessário
str

O nome da experimentação do PipelineDraft.

tags
Necessário

Um dicionário de etiquetas opcional para o PipelineDraft.

properties
Necessário

Um dicionário de propriedades opcional para o PipelineDraft.

graph_draft_id
Necessário
str

O ID do rascunho do gráfico associado ao PipelineDraft.

parent_pipeline_id
Necessário
str

O ID do elemento principal PublishedPipeline.

parent_pipeline_run_id
Necessário
str

O ID do PipelineRun principal.

parent_step_run_ids
Necessário

Uma lista dos IDs stepRun do PipelineRun principal.

parent_pipeline_draft_id
Necessário
str

O ID do PipelineDraft principal.

last_submitted_pipeline_run_id
Necessário
str

O ID do último PipelineRun submetido.

_pipeline_draft_provider
Necessário
<xref:azureml.pipeline.core._aeva_provider._AevaPipelineDraftProvider>

(Apenas utilização interna.) O fornecedor PipelineDraft.

workspace
Necessário

Objeto área de trabalho para este PipelineDraft.

id
Necessário
str

O ID do PipelineDraft.

name
Necessário
str

O nome do PipelineDraft.

description
Necessário
str

A descrição do PipelineDraft.

experiment_name
Necessário
str

O nome da experimentação do PipelineDraft.

tags
Necessário

Dicionário etiquetas para o PipelineDraft.

properties
Necessário

Dicionário de propriedades do PipelineDraft.

graph_draft_id
Necessário
str

O ID do rascunho do gráfico associado ao PipelineDraft.

parent_pipeline_id
Necessário
str

O ID do elemento principal PublishedPipeline.

parent_pipeline_run_id
Necessário
str

O ID do PipelineRun principal.

parent_step_run_ids
Necessário

Uma lista dos IDs stepRun do PipelineRun principal.

parent_pipeline_draft_id
Necessário
str

O ID do PipelineDraft principal.

last_submitted_pipeline_run_id
Necessário
str

O ID do último PipelineRun submetido.

_pipeline_draft_provider
Necessário
<xref:azureml.pipeline.core._aeva_provider._AevaPipelineDraftProvider>

O fornecedor PipelineDraft.

Observações

Um PipelineDraft pode ser criado a partir de um Pipeline com a create função . Segue-se um exemplo:


   from azureml.pipeline.core import Pipeline, PipelineDraft
   from azureml.pipeline.steps import PythonScriptStep

   train_step = PythonScriptStep(name="Training_Step",
                                 script_name="train.py",
                                 compute_target=aml_compute_target,
                                 source_directory=".")
   pipeline = Pipeline(workspace=ws, steps=[train_step])
   pipeline_draft = PipelineDraft.create(workspace=ws,
                                         name="TestPipelineDraft",
                                         description="draft description",
                                         experiment_name="helloworld",
                                         pipeline=pipeline,
                                         continue_on_step_failure=True,
                                         tags={'dev': 'true'},
                                         properties={'train': 'value'})

O parâmetro de pipeline PipelineDraft.create()também pode ser um PublishedPipeline, PipelineRunou outro PipelineDraft.

Para submeter uma execução a partir de um PipelineDraft, utilize o submit_run método :


   pipeline_run = pipeline_draft.submit_run()

Para atualizar um PipelineDraft, utilize o update método . A função update() de um rascunho de pipeline pode ser utilizada para atualizar o nome, descrição, nome da experimentação, atribuições de parâmetros do pipeline, continuar na definição de falha do passo e Pipeline associado ao PipelineDraft.


   new_train_step = PythonScriptStep(name="New_Training_Step",
                                     script_name="train.py",
                                     compute_target=aml_compute_target,
                                     source_directory=source_directory)

   new_pipeline = Pipeline(workspace=ws, steps=[new_train_step])

   pipeline_draft.update(name="UpdatedPipelineDraft",
                         description="has updated train step",
                         pipeline=new_pipeline)

Métodos

create

Criar um PipelineDraft.

delete

Elimine o PipelineDraft.

get

Obtenha o PipelineDraft com o ID especificado.

get_graph

Obtenha o gráfico associado ao PipelineDraft.

list

Obtenha todos os rascunhos de pipeline numa área de trabalho.

publish

Publique uma PublishedPipeline a partir do PipelineDraft.

save

Guarde o YAML pipelineDraft num ficheiro.

submit_run

Submeta um PipelineRun a partir do PipelineDraft.

update

Atualizar um PipelineDraft.

Os campos fornecidos serão atualizados.

create

Criar um PipelineDraft.

static create(workspace, pipeline, name=None, description=None, experiment_name=None, pipeline_parameters=None, continue_on_step_failure=None, tags=None, properties=None, _workflow_provider=None, _service_endpoint=None)

Parâmetros

Name Description
workspace
Necessário

O objeto de área de trabalho a que este PipelineDraft pertencerá.

pipeline
Necessário

O pipeline ou pipeline publicado.

name
str

O nome do PipelineDraft; só é necessário ao criar a partir de um Pipeline.

Default value: None
description
str

A descrição do PipelineDraft; só é necessário ao criar a partir de um Pipeline.

Default value: None
experiment_name
str

O nome da experimentação do PipelineDraft; só é necessário ao criar a partir de um Pipeline.

Default value: None
pipeline_parameters

Um dicionário opcional de atribuições de parâmetros de pipeline para o PipelineDraft; só é necessário ao criar a partir de um Pipeline.

Default value: None
continue_on_step_failure

Indica se deve continuar uma Execução de Pipeline quando uma execução de passo falha na definição pipelineDraft; só é necessário ao criar a partir de um Pipeline.

Default value: None
tags

Um dicionário de etiquetas opcionais para o PipelineDraft, apenas necessário ao criar a partir de um Pipeline.

Default value: None
properties

Dicionário de propriedades opcionais para o PipelineDraft, apenas necessário ao criar a partir de um Pipeline.

Default value: None
_service_endpoint
str

O ponto final de serviço.

Default value: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Devoluções

Tipo Description

O PipelineDraft criado.

delete

Elimine o PipelineDraft.

delete(_workflow_provider=None)

Parâmetros

Name Description
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

get

Obtenha o PipelineDraft com o ID especificado.

static get(workspace, id, _workflow_provider=None, _service_endpoint=None)

Parâmetros

Name Description
workspace
Necessário

A área de trabalho na qual o PipelineDraft foi criado.

id
Necessário
str

O ID do PipelineDraft.

_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None
_service_endpoint
str

O ponto final de serviço.

Default value: None

Devoluções

Tipo Description

Objeto PipelineDraft

get_graph

Obtenha o gráfico associado ao PipelineDraft.

get_graph(_workflow_provider=None)

Parâmetros

Name Description
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Devoluções

Tipo Description

O objeto Graph.

list

Obtenha todos os rascunhos de pipeline numa área de trabalho.

static list(workspace, tags=None, _workflow_provider=None)

Parâmetros

Name Description
workspace
Necessário

A área de trabalho a partir da qual lista rascunhos.

tags

Se especificado, devolve rascunhos correspondentes especificados {"tag": "value"}.

Default value: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Devoluções

Tipo Description

Uma lista de PipelineDraft objetos.

publish

Publique uma PublishedPipeline a partir do PipelineDraft.

publish(_workflow_provider=None)

Parâmetros

Name Description
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Devoluções

Tipo Description

O PublishedPipeline criado.

save

Guarde o YAML pipelineDraft num ficheiro.

save(path=None, _workflow_provider=None)

Parâmetros

Name Description
path
str

O caminho para guardar o YAML. Se o caminho for um diretório, o ficheiro YAML pipelineDraft será guardado em path/pipeline_name.yml. Se caminho for Nenhum, é utilizado o diretório atual.

Default value: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Devoluções

Tipo Description

submit_run

Submeta um PipelineRun a partir do PipelineDraft.

submit_run(_workflow_provider=None)

Parâmetros

Name Description
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Devoluções

Tipo Description

O Pipeline EnviadoExecutar.

update

Atualizar um PipelineDraft.

Os campos fornecidos serão atualizados.

update(pipeline=None, name=None, description=None, experiment_name=None, tags=None, pipeline_parameters=None, continue_on_step_failure=None, _workflow_provider=None)

Parâmetros

Name Description
pipeline

O pipeline atualizado para o rascunho.

Default value: None
name
str

O nome do PipelineDraft.

Default value: None
description
str

A descrição do PipelineDraft.

Default value: None
experiment_name
str

O nome da experimentação do PipelineDraft.

Default value: None
tags

Um dicionário de etiquetas para o PipelineDraft.

Default value: None
pipeline_parameters

As atribuições de parâmetros do pipeline para o PipelineDraft.

Default value: None
continue_on_step_failure

Se pretende continuar PipelineExecutar quando uma execução de passo falha na definição do PipelineDraft.

Default value: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Apenas utilização interna.) O fornecedor de fluxo de trabalho.

Default value: None

Atributos

description

Obtenha a descrição do PipelineDraft.

Devoluções

Tipo Description
str

A cadeia de descrição.

id

Obtenha o ID do PipelineDraft.

Devoluções

Tipo Description
str

O ID.

last_submitted_pipeline_run_id

Obtenha o ID do último PipelineRun submetido do PipelineDraft.

Devoluções

Tipo Description
str

O ID pipelineRun.

name

Introduza o nome do PipelineDraft.

Devoluções

Tipo Description
str

O nome.

parent_pipeline_draft_id

Obtenha o ID do PipelineDraft principal do PipelineDraft.

Devoluções

Tipo Description
str

O ID do PipelineDraft.

parent_pipeline_id

Obtenha o ID do ficheiro PublishedPipeline principal do PipelineDraft.

Devoluções

Tipo Description
str

O ID PublishedPipeline.

parent_pipeline_run_id

Obtenha o ID do PipelineRun principal do PipelineDraft.

Devoluções

Tipo Description
str

O ID pipelineRun.

parent_step_run_ids

Obtenha a lista de IDs de StepRun do PipelineRun principal do PipelineDraft.

Devoluções

Tipo Description

Uma lista de IDs stepRun.

properties

Obtenha as propriedades do PipelineDraft.

Devoluções

Tipo Description

O dicionário de propriedades.

tags

Obtenha as etiquetas do PipelineDraft.

Devoluções

Tipo Description

O dicionário de etiquetas.