Compartir a través de

PortDataReference Clase

Modela los datos asociados a una salida de un StepRun completado.

Un objeto PortDataReference se puede usar para descargar los datos de salida generados por .StepRun También se puede usar como entrada de paso en una canalización futura.

Inicialice PortDataReference.

Constructor

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

Parámetros

Nombre Description
context
Requerido
<xref:azureml.pipeline.core._GraphContext>

Objeto de contexto del grafo.
pipeline_run_id
Requerido
str

Identificador de la ejecución de la canalización que generó la salida.
data_reference
Requerido
DataReference

Objeto de referencia de datos.
step_run
StepRun

Objeto StepRun que generó los datos.

Valor predeterminado: None
context
Requerido
<xref:azureml.pipeline.core._GraphContext>

Objeto de contexto del grafo.
pipeline_run_id
Requerido
str

Identificador de la ejecución de la canalización que generó la salida.
data_reference
Requerido
DataReference

Objeto de referencia de datos.
step_run
Requerido
StepRun

Objeto StepRun que generó los datos.

Comentarios

Una clase PortDataReference apunta a los datos producidos por un completado StepRun.

Obtenga una clase PortDataReference de y PipelineRun descargue los datos de salida de la siguiente manera:


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

Una clase PortDataReference se puede usar como entrada para un paso de , Pipelinesimilar al uso de .DataReference

Un ejemplo para usar portDataReference como entrada de paso es el siguiente:


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

En este ejemplo, la canalización recién construida usará la salida creada por pipelineRun completada como entrada para el paso de entrenamiento.

Métodos

as_download

Consuma PortDataReference como entrada de paso a través del modo de "descarga".
as_input

Cree un inputPortBinding y especifique un nombre de entrada (pero use el modo predeterminado).
as_mount

Consuma PortDataReference como entrada de paso a través del modo de "montaje".
create_input_binding

Cree un enlace de entrada con este PortDataReference como origen.
download

Descargue los datos representados por PortDataReference.

as_download

Consuma PortDataReference como entrada de paso a través del modo de "descarga".

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

Parámetros

Nombre Description
input_name
str

Especifique un nombre para esta entrada.

Valor predeterminado: None
path_on_compute
str

Ruta de acceso del proceso en la que se van a descargar los datos.

Valor predeterminado: None
overwrite
bool

Use para indicar si se deben sobrescribir los datos existentes.

Valor predeterminado: None

Devoluciones

Tipo Description
InputPortBinding

InputPortBinding con portDataReference como origen.

as_input

Cree un inputPortBinding y especifique un nombre de entrada (pero use el modo predeterminado).

as_input(input_name)

Parámetros

Nombre Description
input_name
Requerido
str

Use para especificar un nombre para esta entrada.

Devoluciones

Tipo Description
InputPortBinding

InputPortBinding con portDataReference como origen.

as_mount

Consuma PortDataReference como entrada de paso a través del modo de "montaje".

as_mount(input_name=None)

Parámetros

Nombre Description
input_name
str

Use para especificar un nombre para esta entrada.

Valor predeterminado: None

Devoluciones

Tipo Description
InputPortBinding

InputPortBinding con portDataReference como origen.

create_input_binding

Cree un enlace de entrada con este PortDataReference como origen.

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

Parámetros

Nombre Description
input_name
str

Nombre de la entrada.

Valor predeterminado: None
mode
str

Modo para acceder a PortDataReference ("montar" o "descargar").

Valor predeterminado: None
path_on_compute
str

Para el modo de "descarga", la ruta de acceso del proceso residirán los datos.

Valor predeterminado: None
overwrite
bool

Para el modo de "descarga", si se van a sobrescribir los datos existentes.

Valor predeterminado: None

Devoluciones

Tipo Description
InputPortBinding

InputPortBinding con portDataReference como origen.

download

Descargue los datos representados por PortDataReference.

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

Parámetros

Nombre Description
local_path
Requerido
str

Ruta de acceso local a la que se va a descargar.
overwrite
bool

Si es true, sobrescribir el archivo existente, el valor predeterminado es False.

Valor predeterminado: None
show_progress
bool

Mostrar el progreso de la descarga en la consola, el valor predeterminado es True.

Valor predeterminado: None

Devoluciones

Tipo Description
int

Número de archivos descargados correctamente.

Atributos

datastore

Obtenga el almacén de datos asociado a PortDataReference.

Devoluciones

Tipo Description
Datastore

Objeto de almacén de datos.

datastore_name

Obtenga el nombre del almacén de datos asociado a PortDataReference.

Devoluciones

Tipo Description
str

Nombre del almacén de datos.

name

Obtenga el nombre de esta referencia de datos.

Devoluciones

Tipo Description
str

Nombre de referencia de datos.

path_on_datastore

Obtenga la ruta de acceso en el almacén de datos de PortDataReference.

Devoluciones

Tipo Description
str

Ruta de acceso en el almacén de datos.