PortDataReference Sınıf

  • Başvuru

Tamamlanmış bir StepRun çıkışıyla ilişkili verileri modeller.

PortDataReference nesnesi, tarafından StepRunoluşturulan çıkış verilerini indirmek için kullanılabilir. Gelecekteki bir İşlem Hattında adım girişi olarak da kullanılabilir.

PortDataReference'ı başlatın.

Devralma
builtins.object
PortDataReference

Oluşturucu

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

Parametreler

Name Description
context
Gerekli
<xref:azureml.pipeline.core._GraphContext>

Graf bağlam nesnesi.
pipeline_run_id
Gerekli
str

Çıkışı oluşturan işlem hattı çalıştırmasının kimliği.
data_reference
Gerekli
DataReference

Veri başvuru nesnesi.
step_run
StepRun

Verileri oluşturan StepRun nesnesi.

Default value: None
context
Gerekli
<xref:azureml.pipeline.core._GraphContext>

Graf bağlam nesnesi.
pipeline_run_id
Gerekli
str

Çıkışı oluşturan işlem hattı çalıştırmasının kimliği.
data_reference
Gerekli
DataReference

Veri başvuru nesnesi.
step_run
Gerekli
StepRun

Verileri oluşturan StepRun nesnesi.

Açıklamalar

PortDataReference, tamamlanmış StepRunbir tarafından üretilen verilere işaret etmektedir.

adresinden PipelineRun bir PortDataReference alın ve çıkış verilerini aşağıdaki gibi indirin:


   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, kullanmaya benzer şekilde içindeki Pipelinebir adıma DataReferencegiriş olarak kullanılabilir.

PortDataReference'ı adım girişi olarak kullanma örneği aşağıdaki gibidir:


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

Bu örnekte, yeni oluşturulan İşlem Hattı, tamamlanan PipelineRun tarafından oluşturulan çıkışı tren adımına giriş olarak kullanır.

Yöntemler

as_download

PortDataReference'ı "indirme" modunda adım girişi olarak kullanın.
as_input

InputPortBinding oluşturun ve bir giriş adı belirtin (ancak varsayılan modu kullanın).
as_mount

"Bağlama" modunda adım girişi olarak PortDataReference kullanın.
create_input_binding

Kaynak olarak bu PortDataReference ile giriş bağlaması oluşturun.
download

PortDataReference tarafından temsil edilen verileri indirin.

as_download

PortDataReference'ı "indirme" modunda adım girişi olarak kullanın.

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

Parametreler

Name Description
input_name
str

Bu giriş için bir ad belirtin.

Default value: None
path_on_compute
str

verilerin indirilmesi için işlemdeki yol.

Default value: None
overwrite
bool

Varolan verilerin üzerine yazılıp yazılmayacağını belirtmek için kullanın.

Default value: None

Döndürülenler

Tür Description
InputPortBinding

Kaynak olarak bu PortDataReference ile InputPortBinding.

as_input

InputPortBinding oluşturun ve bir giriş adı belirtin (ancak varsayılan modu kullanın).

as_input(input_name)

Parametreler

Name Description
input_name
Gerekli
str

Bu giriş için bir ad belirtmek için kullanın.

Döndürülenler

Tür Description
InputPortBinding

Kaynak olarak bu PortDataReference ile InputPortBinding.

as_mount

"Bağlama" modunda adım girişi olarak PortDataReference kullanın.

as_mount(input_name=None)

Parametreler

Name Description
input_name
str

Bu giriş için bir ad belirtmek için kullanın.

Default value: None

Döndürülenler

Tür Description
InputPortBinding

Kaynak olarak bu PortDataReference ile InputPortBinding.

create_input_binding

Kaynak olarak bu PortDataReference ile giriş bağlaması oluşturun.

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

Parametreler

Name Description
input_name
str

Girişin adı.

Default value: None
mode
str

PortDataReference("mount" veya "download") erişim modu.

Default value: None
path_on_compute
str

"İndirme" modu için, işlemdeki veri yolu bulunur.

Default value: None
overwrite
bool

"İndirme" modu için, mevcut verilerin üzerine yazıp yazılmayacağı.

Default value: None

Döndürülenler

Tür Description
InputPortBinding

Kaynak olarak bu PortDataReference ile InputPortBinding.

download

PortDataReference tarafından temsil edilen verileri indirin.

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

Parametreler

Name Description
local_path
Gerekli
str

İndirilmesi gereken yerel yol.
overwrite
bool

True ise, var olan dosyanın üzerine yaz, varsayılan olarak False olur.

Default value: None
show_progress
bool

İndirme işleminin ilerleme durumunu konsolda göster, varsayılan değer True'dır.

Default value: None

Döndürülenler

Tür Description
int

Başarıyla indirilen dosyaların sayısı.

Öznitelikler

datastore

PortDataReference ile ilişkili Datastore'yi alın.

Döndürülenler

Tür Description
Datastore

Veri deposu nesnesi.

datastore_name

PortDataReference ile ilişkili Veri deposunun adını alın.

Döndürülenler

Tür Description
str

Veri deposu adı.

name

Bu veri başvurusunun adını alın.

Döndürülenler

Tür Description
str

Veri başvuru adı.

path_on_datastore

PortDataReference için veri deposundaki yolu alın.

Döndürülenler

Tür Description
str

Veri deposundaki yol.