PortDataReference Osztály
Egy befejezett StepRun kimenetéhez társított adatokat modellel.
PortDataReference objektummal töltheti le azokat a kimeneti adatokat, amelyeket egy StepRun. Lépésbemenetként is használható a jövőbeli folyamatokban.
A PortDataReference inicializálása.
- Öröklődés
-
builtins.objectPortDataReference
Konstruktor
PortDataReference(context, pipeline_run_id, data_reference, step_run=None)
Paraméterek
Name | Description |
---|---|
context
Kötelező
|
<xref:azureml.pipeline.core._GraphContext>
A gráfkörnyezet objektuma. |
pipeline_run_id
Kötelező
|
A kimenetet előállító folyamatfuttatás azonosítója. |
data_reference
Kötelező
|
Az adathivatkozási objektum. |
step_run
|
Az adatokat előállító StepRun objektum. Alapértelmezett érték: None
|
context
Kötelező
|
<xref:azureml.pipeline.core._GraphContext>
A gráfkörnyezet objektuma. |
pipeline_run_id
Kötelező
|
A kimenetet előállító folyamatfuttatás azonosítója. |
data_reference
Kötelező
|
Az adathivatkozási objektum. |
step_run
Kötelező
|
Az adatokat előállító StepRun objektum. |
Megjegyzések
A PortDataReference a befejezett StepRunadatokra mutat.
PortDataReference lekérése egy PipelineRun fájlból, és töltse le a kimeneti adatokat az alábbiak szerint:
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")
A PortDataReference egy lépés Pipelinebemeneteként is használható, hasonlóan a következőhöz: DataReference.
Példa a PortDataReference lépésbemenetként való használatára:
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])
Ebben a példában az újonnan létrehozott folyamat a befejezett PipelineRun által létrehozott kimenetet fogja használni a betanulási lépés bemeneteként.
Metódusok
as_download |
Használja a PortDataReference-t lépésbemenetként a "letöltési" módban. |
as_input |
Hozzon létre egy InputPortBindinget, és adjon meg egy bemeneti nevet (de használja az alapértelmezett módot). |
as_mount |
Használja a PortDataReference-t lépésbemenetként a "csatlakoztatási" módban. |
create_input_binding |
Hozzon létre bemeneti kötést ezzel a PortDataReference paranccsal forrásként. |
download |
Töltse le a PortDataReference által képviselt adatokat. |
as_download
Használja a PortDataReference-t lépésbemenetként a "letöltési" módban.
as_download(input_name=None, path_on_compute=None, overwrite=None)
Paraméterek
Name | Description |
---|---|
input_name
|
Adja meg a bemenet nevét. Alapértelmezett érték: None
|
path_on_compute
|
A számítási útvonal, a amelyre az adatokat le szeretné tölteni. Alapértelmezett érték: None
|
overwrite
|
A használatával jelezheti, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
Az InputPortBinding ezzel a PortDataReference-vel forrásként. |
as_input
Hozzon létre egy InputPortBindinget, és adjon meg egy bemeneti nevet (de használja az alapértelmezett módot).
as_input(input_name)
Paraméterek
Name | Description |
---|---|
input_name
Kötelező
|
A bemenet nevének megadására használható. |
Válaszok
Típus | Description |
---|---|
Az InputPortBinding ezzel a PortDataReference-vel forrásként. |
as_mount
Használja a PortDataReference-t lépésbemenetként a "csatlakoztatási" módban.
as_mount(input_name=None)
Paraméterek
Name | Description |
---|---|
input_name
|
A bemenet nevének megadására használható. Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
Az InputPortBinding ezzel a PortDataReference-vel forrásként. |
create_input_binding
Hozzon létre bemeneti kötést ezzel a PortDataReference paranccsal forrásként.
create_input_binding(input_name=None, mode=None, path_on_compute=None, overwrite=None)
Paraméterek
Name | Description |
---|---|
input_name
|
A bemenet neve. Alapértelmezett érték: None
|
mode
|
A PortDataReference elérésének módja ("csatlakoztatás" vagy "letöltés"). Alapértelmezett érték: None
|
path_on_compute
|
A "letöltési" mód esetében az adatok számítási útvonala fog elhelyezkedni. Alapértelmezett érték: None
|
overwrite
|
A "letöltési" mód esetében adja meg, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
Az InputPortBinding ezzel a PortDataReference-vel forrásként. |
download
Töltse le a PortDataReference által képviselt adatokat.
download(local_path, overwrite=None, show_progress=None)
Paraméterek
Name | Description |
---|---|
local_path
Kötelező
|
A helyi elérési út, amelyre le kell tölteni. |
overwrite
|
Ha igaz, írja felül a meglévő fájlt, alapértelmezés szerint Hamis. Alapértelmezett érték: None
|
show_progress
|
A letöltési folyamat megjelenítése a konzolon, alapértelmezés szerint Igaz értékre. Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
A sikeresen letöltött fájlok száma. |
Attribútumok
datastore
Kérje le a PortDataReference-hez társított adattárat.
Válaszok
Típus | Description |
---|---|
Az adattár objektuma. |
datastore_name
Kérje le a PortDataReference-hez társított adattár nevét.
Válaszok
Típus | Description |
---|---|
Az adattár neve. |
name
path_on_datastore
Kérje le a PortDataReference adattárolójának elérési útját.
Válaszok
Típus | Description |
---|---|
Az adattár elérési útja. |