Partilhar via

PortDataReference Classe

Modela dados associados a uma saída de um StepRun concluído.

Um objeto PortDataReference pode ser usado para baixar os dados de saída que foram produzidos por um StepRunarquivo . Ele também pode ser usado como uma entrada de etapa em um futuro Pipeline.

Inicialize PortDataReference.

Construtor

PortDataReference(context, pipeline_run_id, data_reference, step_run=None)

Parâmetros

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

O objeto de contexto gráfico.
pipeline_run_id
Necessário
str

O id da execução do pipeline que produziu a saída.
data_reference
Necessário
DataReference

O objeto de referência de dados.
step_run
StepRun

O objeto StepRun que produziu os dados.

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

O objeto de contexto gráfico.
pipeline_run_id
Necessário
str

O id da execução do pipeline que produziu a saída.
data_reference
Necessário
DataReference

O objeto de referência de dados.
step_run
Necessário
StepRun

O objeto StepRun que produziu os dados.

Observações

Um PortDataReference aponta para dados que foram produzidos por um StepRunarquivo .

Obtenha um PortDataReference de um PipelineRun e baixe os dados de saída da seguinte maneira:


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

Um PortDataReference pode ser usado como uma entrada para uma etapa em um Pipeline, semelhante ao uso de um DataReferencearquivo .

Um exemplo para usar um PortDataReference como uma entrada de etapa é o seguinte:


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

Neste exemplo, o Pipeline recém-construído usará a saída que foi criada pelo PipelineRun concluído como uma entrada para a etapa do trem.

Métodos

as_download

Consuma o PortDataReference como uma entrada de etapa através do modo "download".
as_input

Crie um InputPortBinding e especifique um nome de entrada (mas use o modo padrão).
as_mount

Consuma o PortDataReference como uma entrada de etapa através do modo "mount".
create_input_binding

Crie uma associação de entrada com este PortDataReference como origem.
download

Faça o download dos dados representados pelo PortDataReference.

as_download

Consuma o PortDataReference como uma entrada de etapa através do modo "download".

as_download(input_name=None, path_on_compute=None, overwrite=None)

Parâmetros

Name Description
input_name
str

Especifique um nome para essa entrada.

Default value: None
path_on_compute
str

O caminho no cálculo para o qual baixar os dados.

Default value: None
overwrite
bool

Use para indicar se os dados existentes devem ser substituídos.

Default value: None

Devoluções

Tipo Description
InputPortBinding

O InputPortBinding com este PortDataReference como fonte.

as_input

Crie um InputPortBinding e especifique um nome de entrada (mas use o modo padrão).

as_input(input_name)

Parâmetros

Name Description
input_name
Necessário
str

Use para especificar um nome para essa entrada.

Devoluções

Tipo Description
InputPortBinding

O InputPortBinding com este PortDataReference como fonte.

as_mount

Consuma o PortDataReference como uma entrada de etapa através do modo "mount".

as_mount(input_name=None)

Parâmetros

Name Description
input_name
str

Use para especificar um nome para essa entrada.

Default value: None

Devoluções

Tipo Description
InputPortBinding

O InputPortBinding com este PortDataReference como fonte.

create_input_binding

Crie uma associação de entrada com este PortDataReference como origem.

create_input_binding(input_name=None, mode=None, path_on_compute=None, overwrite=None)

Parâmetros

Name Description
input_name
str

O nome da entrada.

Default value: None
mode
str

O modo de acesso ao PortDataReference ("mount" ou "download").

Default value: None
path_on_compute
str

Para o modo de "download", o caminho no cálculo dos dados residirá.

Default value: None
overwrite
bool

Para o modo de "download", substitua os dados existentes.

Default value: None

Devoluções

Tipo Description
InputPortBinding

O InputPortBinding com este PortDataReference como fonte.

download

Faça o download dos dados representados pelo PortDataReference.

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

Parâmetros

Name Description
local_path
Necessário
str

Caminho local para download.
overwrite
bool

Se true, substitua o arquivo existente, o padrão é False.

Default value: None
show_progress
bool

Mostrar o progresso do download no console, o padrão é True.

Default value: None

Devoluções

Tipo Description
int

O número de arquivos baixados com êxito.

Atributos

datastore

Obtenha o Datastore associado ao PortDataReference.

Devoluções

Tipo Description
Datastore

O objeto datastore.

datastore_name

Obtenha o nome do Datastore associado ao PortDataReference.

Devoluções

Tipo Description
str

O nome do armazenamento de dados.

name

Obtenha o nome desta referência de dados.

Devoluções

Tipo Description
str

O nome da referência de dados.

path_on_datastore

Obtenha o caminho no armazenamento de dados para o PortDataReference.

Devoluções

Tipo Description
str

O caminho no armazenamento de dados.