PortDataReference Sınıf

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. varsayılan değer: 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. varsayılan değer: None
path_on_compute	str verilerin indirilmesi için işlemdeki yol. varsayılan değer: None
overwrite	bool Varolan verilerin üzerine yazılıp yazılmayacağını belirtmek için kullanın. varsayılan değer: 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. varsayılan değer: 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ı. varsayılan değer: None
mode	str PortDataReference("mount" veya "download") erişim modu. varsayılan değer: None
path_on_compute	str "İndirme" modu için, işlemdeki veri yolu bulunur. varsayılan değer: None
overwrite	bool "İndirme" modu için, mevcut verilerin üzerine yazıp yazılmayacağı. varsayılan değer: 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. varsayılan değer: None
show_progress	bool İndirme işleminin ilerleme durumunu konsolda göster, varsayılan değer True'dır. varsayılan değer: 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.