PortDataReference Klasa

Modeluje dane skojarzone z danymi wyjściowymi ukończonego krokuRun.

Obiekt PortDataReference może służyć do pobierania danych wyjściowych utworzonych przez obiekt StepRun. Można go również użyć jako danych wejściowych kroków w przyszłym potoku.

Zainicjuj portDataReference.

Dziedziczenie

builtins.object

PortDataReference

Konstruktor

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

Parametry

Nazwa	Opis
context Wymagane	<xref:azureml.pipeline.core._GraphContext> Obiekt kontekstu grafu.
pipeline_run_id Wymagane	str Identyfikator przebiegu potoku, który wygenerował dane wyjściowe.
data_reference Wymagane	DataReference Obiekt odwołania do danych.
step_run	StepRun Obiekt StepRun, który wygenerował dane. Domyślna wartość: None
context Wymagane	<xref:azureml.pipeline.core._GraphContext> Obiekt kontekstu grafu.
pipeline_run_id Wymagane	str Identyfikator przebiegu potoku, który wygenerował dane wyjściowe.
data_reference Wymagane	DataReference Obiekt odwołania do danych.
step_run Wymagane	StepRun Obiekt StepRun, który wygenerował dane.

Uwagi

PortDataReference wskazuje dane, które zostały wygenerowane przez ukończony StepRunelement .

Pobierz element PortDataReference z elementu PipelineRun i pobierz dane wyjściowe w następujący sposób:

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

PortDataReference można użyć jako danych wejściowych do kroku w Pipelineobiekcie , podobnie jak w przypadku elementu DataReference.

Przykład użycia elementu PortDataReference jako danych wejściowych kroku jest następujący:

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

W tym przykładzie nowo skonstruowany potok będzie używać danych wyjściowych utworzonych przez ukończony PotokRun jako dane wejściowe do kroku trenowania.

Metody

as_download	Korzystaj z parametru PortDataReference jako danych wejściowych krok po trybie pobierania.
as_input	Utwórz właściwość InputPortBinding i określ nazwę wejściową (ale użyj trybu domyślnego).
as_mount	Używanie funkcji PortDataReference jako danych wejściowych kroków za pośrednictwem trybu "instalacji".
create_input_binding	Utwórz powiązanie wejściowe za pomocą tego elementu PortDataReference jako źródła.
download	Pobierz dane reprezentowane przez portDataReference.

as_download

Korzystaj z parametru PortDataReference jako danych wejściowych krok po trybie pobierania.

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

Parametry

Nazwa	Opis
input_name	str Określ nazwę dla tych danych wejściowych. Domyślna wartość: None
path_on_compute	str Ścieżka obliczeniowa do pobrania danych do. Domyślna wartość: None
overwrite	bool Służy do wskazywania, czy zastąpić istniejące dane. Domyślna wartość: None

Zwraca

Typ	Opis
InputPortBinding	Element InputPortBinding z tym portemDataReference jako źródłem.

as_input

Utwórz właściwość InputPortBinding i określ nazwę wejściową (ale użyj trybu domyślnego).

as_input(input_name)

Parametry

Nazwa	Opis
input_name Wymagane	str Użyj polecenia , aby określić nazwę dla tych danych wejściowych.

Zwraca

Typ	Opis
InputPortBinding	Element InputPortBinding z tym portemDataReference jako źródłem.

as_mount

Używanie funkcji PortDataReference jako danych wejściowych kroków za pośrednictwem trybu "instalacji".

as_mount(input_name=None)

Parametry

Nazwa	Opis
input_name	str Użyj polecenia , aby określić nazwę dla tych danych wejściowych. Domyślna wartość: None

Zwraca

Typ	Opis
InputPortBinding	Element InputPortBinding z tym portemDataReference jako źródłem.

create_input_binding

Utwórz powiązanie wejściowe za pomocą tego elementu PortDataReference jako źródła.

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

Parametry

Nazwa	Opis
input_name	str Nazwa danych wejściowych. Domyślna wartość: None
mode	str Tryb uzyskiwania dostępu do elementu PortDataReference ("mount" lub "download"). Domyślna wartość: None
path_on_compute	str W przypadku trybu pobierania ścieżka obliczeniowa, w którym będą przechowywane dane. Domyślna wartość: None
overwrite	bool W przypadku trybu pobierania określ, czy zastąpić istniejące dane. Domyślna wartość: None

Zwraca

Typ	Opis
InputPortBinding	Element InputPortBinding z tym portemDataReference jako źródłem.

download

Pobierz dane reprezentowane przez portDataReference.

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

Parametry

Nazwa	Opis
local_path Wymagane	str Ścieżka lokalna do pobrania.
overwrite	bool Jeśli wartość true, zastąp istniejący plik, domyślnie ma wartość False. Domyślna wartość: None
show_progress	bool Pokaż postęp pobierania w konsoli, domyślnie ma wartość True. Domyślna wartość: None

Zwraca

Typ	Opis
int	Liczba pomyślnie pobranych plików.

Atrybuty

datastore

Pobierz magazyn danych skojarzony z portDataReference.

Zwraca

Typ	Opis
Datastore	Obiekt magazynu danych.

datastore_name

Pobierz nazwę magazynu danych skojarzonego z portDataReference.

Zwraca

Typ	Opis
str	Nazwa magazynu danych.

name

Pobierz nazwę tego odwołania do danych.

Zwraca

Typ	Opis
str	Nazwa odwołania do danych.

path_on_datastore

Pobierz ścieżkę do magazynu danych dla elementu PortDataReference.

Zwraca

Typ	Opis
str	Ścieżka w magazynie danych.