PortDataReference Classe

Modelos de dados associados a uma saída de uma StepRun concluída.

Um objeto PortDataReference pode ser utilizado para transferir os dados de saída produzidos por um StepRun. Também pode ser utilizado como uma entrada de passo num futuro Pipeline.

Inicializar PortDataReference.

Herança

builtins.object

PortDataReference

Construtor

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

Parâmetros

context

<xref:azureml.pipeline.core._GraphContext>

Necessário

O objeto de contexto do gráfico.

pipeline_run_id

str

Necessário

O ID da execução do pipeline que produziu o resultado.

data_reference

DataReference

Necessário

O objeto de referência de dados.

step_run

StepRun

valor predefinido: None

O objeto StepRun que produziu os dados.

context

<xref:azureml.pipeline.core._GraphContext>

Necessário

O objeto de contexto do gráfico.

pipeline_run_id

str

Necessário

O ID da execução do pipeline que produziu o resultado.

data_reference

DataReference

Necessário

O objeto de referência de dados.

step_run

StepRun

Necessário

O objeto StepRun que produziu os dados.

Observações

Uma PortDataReference aponta para dados produzidos por um .StepRun

Obtenha uma PortDataReference a partir de um PipelineRun e transfira os dados de saída da seguinte forma:

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

Uma PortDataReference pode ser utilizada como uma entrada para um passo num Pipeline, semelhante a utilizar um DataReference.

Um exemplo para utilizar um PortDataReference como uma entrada de passo é 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 recentemente construído utilizará a saída que foi criada pelo PipelineRun concluído como uma entrada para o passo de preparação.

Métodos

as_download	Consuma o PortDataReference como uma entrada de passo através do modo de "transferência".
as_input	Crie um InputPortBinding e especifique um nome de entrada (mas utilize o modo predefinido).
as_mount	Consuma o PortDataReference como uma entrada de passo através do modo de "montagem".
create_input_binding	Crie o enlace de entrada com esta PortDataReference como a origem.
download	Transfira os dados representados pela PortDataReference.

as_download

Consuma o PortDataReference como uma entrada de passo através do modo de "transferência".

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

Parâmetros

input_name

str

valor predefinido: None

Especifique um nome para esta entrada.

path_on_compute

str

valor predefinido: None

O caminho na computação para o qual transferir os dados.

overwrite

bool

valor predefinido: None

Utilize para indicar se deve substituir os dados existentes.

Devoluções

O InputPortBinding com esta PortDataReference como a origem.

Tipo de retorno

InputPortBinding

as_input

Crie um InputPortBinding e especifique um nome de entrada (mas utilize o modo predefinido).

as_input(input_name)

Parâmetros

input_name

str

Necessário

Utilize para especificar um nome para esta entrada.

Devoluções

O InputPortBinding com esta PortDataReference como a origem.

Tipo de retorno

InputPortBinding

as_mount

Consuma o PortDataReference como uma entrada de passo através do modo de "montagem".

as_mount(input_name=None)

Parâmetros

input_name

str

valor predefinido: None

Utilize para especificar um nome para esta entrada.

Devoluções

O InputPortBinding com esta PortDataReference como a origem.

Tipo de retorno

InputPortBinding

create_input_binding

Crie o enlace de entrada com esta PortDataReference como a origem.

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

Parâmetros

input_name

str

valor predefinido: None

O nome da entrada.

mode

str

valor predefinido: None

O modo para aceder à PortDataReference ("montagem" ou "download").

path_on_compute

str

valor predefinido: None

Para o modo de "transferência", o caminho na computação dos dados irá residir.

overwrite

bool

valor predefinido: None

Para o modo de "transferência", quer substitua os dados existentes.

Devoluções

O InputPortBinding com esta PortDataReference como a origem.

Tipo de retorno

InputPortBinding

download

Transfira os dados representados pela PortDataReference.

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

Parâmetros

local_path

str

Necessário

Caminho local para o qual transferir.

overwrite

bool

valor predefinido: None

Se for verdadeiro, substitua o ficheiro existente, a predefinição é Falso.

show_progress

bool

valor predefinido: None

Mostrar o progresso da transferência na consola, predefinição para Verdadeiro.

Devoluções

O número de ficheiros transferidos com êxito.

Tipo de retorno

int

Atributos

datastore

Obtenha o Arquivo de Dados associado à PortDataReference.

Devoluções

O objeto arquivo de dados.

Tipo de retorno

Datastore

datastore_name

Obtenha o nome do Arquivo de Dados associado à PortDataReference.

Devoluções

O nome do arquivo de dados.

Tipo de retorno

str

name

Obtenha o nome desta referência de dados.

Devoluções

O nome da referência de dados.

Tipo de retorno

str

path_on_datastore

Obtenha o caminho no arquivo de dados do PortDataReference.

Devoluções

O caminho no arquivo de dados.

Tipo de retorno

str