PortDataReference Classe

Modella i dati associati a un output di un stepRun completato.

È possibile utilizzare un oggetto PortDataReference per scaricare i dati di output generati da un oggetto StepRun. Può anche essere usato come input in un passaggio in una pipeline futura.

Inizializzare PortDataReference.

Ereditarietà

builtins.object

PortDataReference

Costruttore

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

Parametri

Nome	Descrizione
context Necessario	<xref:azureml.pipeline.core._GraphContext> Oggetto contesto del grafo.
pipeline_run_id Necessario	str ID dell'esecuzione della pipeline che ha prodotto l'output.
data_reference Necessario	DataReference Oggetto di riferimento dati.
step_run	StepRun Oggetto StepRun che ha prodotto i dati. Valore predefinito: None
context Necessario	<xref:azureml.pipeline.core._GraphContext> Oggetto contesto del grafo.
pipeline_run_id Necessario	str ID dell'esecuzione della pipeline che ha prodotto l'output.
data_reference Necessario	DataReference Oggetto di riferimento dati.
step_run Necessario	StepRun Oggetto StepRun che ha prodotto i dati.

Commenti

PortDataReference punta ai dati prodotti da un oggetto completato StepRun.

Ottenere portDataReference da un PipelineRun oggetto e scaricare i dati di output come indicato di seguito:

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

Un oggetto PortDataReference può essere usato come input per un passaggio in un Pipelineoggetto , simile all'uso di un oggetto DataReference.

Un esempio di utilizzo di PortDataReference come input di passaggio è il seguente:

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

In questo esempio, la pipeline appena costruita userà l'output creato dall'oggetto PipelineRun completato come input per il passaggio di training.

Metodi

as_download	Utilizzare PortDataReference come input di passaggio tramite la modalità di download.
as_input	Creare un inputPortBinding e specificare un nome di input (ma usare la modalità predefinita).
as_mount	Utilizzare PortDataReference come input di passaggio tramite la modalità di montaggio.
create_input_binding	Creare un'associazione di input con portDataReference come origine.
download	Scaricare i dati rappresentati da PortDataReference.

as_download

Utilizzare PortDataReference come input di passaggio tramite la modalità di download.

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

Parametri

Nome	Descrizione
input_name	str Specificare un nome per questo input. Valore predefinito: None
path_on_compute	str Percorso nel calcolo in cui scaricare i dati. Valore predefinito: None
overwrite	bool Utilizzare per indicare se sovrascrivere i dati esistenti. Valore predefinito: None

Restituisce

Tipo	Descrizione
InputPortBinding	InputPortBinding con portDataReference come origine.

as_input

Creare un inputPortBinding e specificare un nome di input (ma usare la modalità predefinita).

as_input(input_name)

Parametri

Nome	Descrizione
input_name Necessario	str Usare per specificare un nome per questo input.

Restituisce

Tipo	Descrizione
InputPortBinding	InputPortBinding con portDataReference come origine.

as_mount

Utilizzare PortDataReference come input di passaggio tramite la modalità di montaggio.

as_mount(input_name=None)

Parametri

Nome	Descrizione
input_name	str Usare per specificare un nome per questo input. Valore predefinito: None

Restituisce

Tipo	Descrizione
InputPortBinding	InputPortBinding con portDataReference come origine.

create_input_binding

Creare un'associazione di input con portDataReference come origine.

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

Parametri

Nome	Descrizione
input_name	str Nome dell'input. Valore predefinito: None
mode	str Modalità di accesso a PortDataReference ("mount" o "download"). Valore predefinito: None
path_on_compute	str Per la modalità di download, il percorso nel calcolo dei dati risiederà. Valore predefinito: None
overwrite	bool Per la modalità "download", se sovrascrivere i dati esistenti. Valore predefinito: None

Restituisce

Tipo	Descrizione
InputPortBinding	InputPortBinding con portDataReference come origine.

download

Scaricare i dati rappresentati da PortDataReference.

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

Parametri

Nome	Descrizione
local_path Necessario	str Percorso locale in cui eseguire il download.
overwrite	bool Se true, sovrascrivere il file esistente, il valore predefinito è False. Valore predefinito: None
show_progress	bool Mostra lo stato di avanzamento del download nella console, il valore predefinito è True. Valore predefinito: None

Restituisce

Tipo	Descrizione
int	Numero di file scaricati correttamente.

Attributi

datastore

Ottiene l'archivio dati associato a PortDataReference.

Restituisce

Tipo	Descrizione
Datastore	Oggetto archivio dati.

datastore_name

Ottenere il nome dell'archivio dati associato a PortDataReference.

Restituisce

Tipo	Descrizione
str	Nome dell'archivio dati.

name

Ottenere il nome di questo riferimento ai dati.

Restituisce

Tipo	Descrizione
str	Nome del riferimento ai dati.

path_on_datastore

Ottenere il percorso nell'archivio dati per PortDataReference.

Restituisce

Tipo	Descrizione
str	Percorso nell'archivio dati.