PortDataReference Класс

  • Ссылка

Моделирует данные, связанные с выходными данными завершенного StepRun.

Объект PortDataReference можно использовать для загрузки выходных данных, созданных с помощью StepRun. Его также можно использовать в качестве входных данных этапа в будущем конвейере.

Инициализация PortDataReference.

Наследование
builtins.object
PortDataReference

Конструктор

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

Параметры

context
<xref:azureml.pipeline.core._GraphContext>
Обязательно

Объект контекста графа.

pipeline_run_id
str
Обязательно

Идентификатор выполнения конвейера, в рамках которого выданы выходные данные.

data_reference
DataReference
Обязательно

Объект ссылки на данные.

step_run
StepRun
значение по умолчанию: None

Объект StepRun, который создал данные.

context
<xref:azureml.pipeline.core._GraphContext>
Обязательно

Объект контекста графа.

pipeline_run_id
str
Обязательно

Идентификатор выполнения конвейера, в рамках которого выданы выходные данные.

data_reference
DataReference
Обязательно

Объект ссылки на данные.

step_run
StepRun
Обязательно

Объект StepRun, который создал данные.

Комментарии

Объект PortDataReference указывает на данные, созданные завершенным StepRun.

Получение PortDataReference из PipelineRun и загрузка выходных данных следующим образом:


   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 можно использовать как входные данные для этапа в Pipeline, аналогично применению DataReference.

Пример использования PortDataReference в качестве входных данных этапа выглядит следующим образом:


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

В этом примере вновь сконструированный конвейер будет использовать выходные данные, созданные завершенным PipelineRun, в качестве входных данных для этапа обучения.

Методы

as_download

Использование PortDataReference как входных данных этапа в режиме загрузки.
as_input

Создание InputPortBinding и указание имени входных данных (но используется режим по умолчанию).
as_mount

Использование PortDataReference в качестве входных данных этапа в режиме подключения.
create_input_binding

Создание привязки входных данных с этим PortDataReference в качестве источника.
download

Загрузка данных, представленных PortDataReference.

as_download

Использование PortDataReference как входных данных этапа в режиме загрузки.

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

Параметры

input_name
str
значение по умолчанию: None

Указание имени для этих входных данных.

path_on_compute
str
значение по умолчанию: None

Путь к вычислительному ресурсу, в который нужно загрузить данные.

overwrite
bool
значение по умолчанию: None

Позволяет указать, следует ли перезаписывать существующие данные.

Возвращаемое значение

InputPortBinding с этим PortDataReference в качестве источника.

Возвращаемый тип

InputPortBinding

as_input

Создание InputPortBinding и указание имени входных данных (но используется режим по умолчанию).

as_input(input_name)

Параметры

input_name
str
Обязательно

Указание имени для этих входных данных.

Возвращаемое значение

InputPortBinding с этим PortDataReference в качестве источника.

Возвращаемый тип

InputPortBinding

as_mount

Использование PortDataReference в качестве входных данных этапа в режиме подключения.

as_mount(input_name=None)

Параметры

input_name
str
значение по умолчанию: None

Указание имени для этих входных данных.

Возвращаемое значение

InputPortBinding с этим PortDataReference в качестве источника.

Возвращаемый тип

InputPortBinding

create_input_binding

Создание привязки входных данных с этим PortDataReference в качестве источника.

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

Параметры

input_name
str
значение по умолчанию: None

Имя входа.

mode
str
значение по умолчанию: None

Режим для доступа к PortDataReference (подключение или загрузка).

path_on_compute
str
значение по умолчанию: None

Для режима загрузки путь к вычислительному ресурсу, в котором будут размещаться данные.

overwrite
bool
значение по умолчанию: None

Для режима загрузки указывает, следует ли перезаписывать существующие данные.

Возвращаемое значение

InputPortBinding с этим PortDataReference в качестве источника.

Возвращаемый тип

InputPortBinding

download

Загрузка данных, представленных PortDataReference.

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

Параметры

local_path
str
Обязательно

Локальный путь для загрузки.

overwrite
bool
значение по умолчанию: None

Если задано значение True, то существующий файл будет перезаписываться. По умолчанию используется значение False.

show_progress
bool
значение по умолчанию: None

Отображение хода загрузки в консоли. По умолчанию используется значение True.

Возвращаемое значение

Количество успешно загруженных файлов.

Возвращаемый тип

int

Атрибуты

datastore

Получение хранилища данных, связанного с PortDataReference.

Возвращаемое значение

Объект хранилища данных.

Возвращаемый тип

Datastore

datastore_name

Получение имени хранилища данных, связанного с PortDataReference.

Возвращаемое значение

Имя хранилища данных.

Возвращаемый тип

str

name

Получение имени этой ссылки на данные.

Возвращаемое значение

Имя ссылки на данные.

Возвращаемый тип

str

path_on_datastore

Получение пути к хранилищу данных для PortDataReference.

Возвращаемое значение

Путь к хранилищу данных.

Возвращаемый тип

str