Aracılığıyla paylaş


OutputPortBinding Sınıf

İşlem hattı adımının adlandırılmış çıkışını tanımlar.

OutputPortBinding, bir adımla oluşturulacak veri türünü ve verilerin nasıl üretileceğini belirtmek için kullanılabilir. Adım çıkışının başka bir adımın gerekli bir girişi olduğunu belirtmek için ile InputPortBinding birlikte kullanılabilir.

OutputPortBinding'i başlatın.

Devralma
builtins.object
OutputPortBinding

Oluşturucu

OutputPortBinding(name, datastore=None, output_name=None, bind_mode='mount', path_on_compute=None, is_directory=None, overwrite=None, data_type=None, pipeline_output_name=None, training_output=None, dataset_registration=None, dataset_output=None)

Parametreler

Name Description
name
Gerekli
str

Yalnızca harf, rakam ve alt çizgi içerebilen OutputPortBinding nesnesinin adı.

datastore

PipelineData'nın bulunacağı veri deposu.

varsayılan değer: None
output_name
str

Hiçbiri adı kullanılıyorsa çıkışın adı. Yalnızca harf, rakam ve alt çizgi içerebilir.

varsayılan değer: None
bind_mode
str

Oluşturma adımının verilere erişmek için "karşıya yükleme" veya "bağlama" veya "hdfs" yöntemini kullanıp kullanmayacağını belirtir.

varsayılan değer: mount
path_on_compute
str

"Karşıya yükleme" modu için modülün çıkışı yazdığı yol.

varsayılan değer: None
is_directory

Çıktının bir dizin mi yoksa tek bir dosya mı olduğu.

varsayılan değer: None
overwrite

"Karşıya yükleme" modu için mevcut verilerin üzerine yazıp yazılmayacağı.

varsayılan değer: None
data_type
str

İsteğe bağlı. Veri türü, beklenen çıktı türünü belirtmek ve tüketen adımların verileri nasıl kullanması gerektiğini ayrıntılı olarak belirtmek için kullanılabilir. Kullanıcı tanımlı herhangi bir dize olabilir.

varsayılan değer: None
pipeline_output_name
str

Sağlanırsa, bu çıkış PipelineRun.get_pipeline_output() kullanılarak kullanılabilir. İşlem hattı çıkış adları işlem hattında benzersiz olmalıdır.

varsayılan değer: None
training_output

Eğitim sonucunun çıkışını tanımlar. Bu yalnızca Ölçümler ve Model gibi farklı çıkış türleriyle sonuçlanan belirli eğitimler için gereklidir. Örneğin ölçümler AutoMLStep ve model sonuçları. Ayrıca, en iyi modeli elde etmek için kullanılan belirli eğitim yinelemesini veya ölçümü de tanımlayabilirsiniz. için HyperDriveStepçıkışa dahil edilecek belirli model dosyalarını da tanımlayabilirsiniz.

varsayılan değer: None
dataset_registration

İsteğe bağlı. Bu bir iç parametredir. Bunun yerine PipelineData.as_dataset kullanmanız gerekir.

varsayılan değer: None
dataset_output

İsteğe bağlı. Bu bir iç parametredir. OutputFileDatasetConfig intead kullanmanız gerekir.

varsayılan değer: None
name
Gerekli
str

Yalnızca harf, rakam ve alt çizgi içerebilen OutputPortBinding nesnesinin adı.

datastore
Gerekli

PipelineData'nın bulunacağı veri deposu.

output_name
Gerekli
str

Hiçbiri adı kullanılıyorsa çıkışın adı. Yalnızca harf, rakam ve alt çizgi içerebilir.

bind_mode
Gerekli
str

Oluşturma adımının verilere erişmek için "karşıya yükleme" veya "bağlama" veya "hdfs" yöntemini kullanıp kullanmayacağını belirtir.

path_on_compute
Gerekli
str

"Karşıya yükleme" modu için modülün çıkışı yazdığı yol.

is_directory
Gerekli

çıkış bir dizin ise

overwrite
Gerekli

"Karşıya yükleme" modu için mevcut verilerin üzerine yazıp yazılmayacağı.

data_type
Gerekli
str

İsteğe bağlı. Veri türü, beklenen çıktı türünü belirtmek ve tüketen adımların verileri nasıl kullanması gerektiğini ayrıntılı olarak belirtmek için kullanılabilir. Kullanıcı tanımlı herhangi bir dize olabilir.

pipeline_output_name
Gerekli
str

Sağlanırsa, bu çıkış PipelineRun.get_pipeline_output() kullanılarak kullanılabilir. İşlem hattı çıkış adları işlem hattında benzersiz olmalıdır.

training_output
Gerekli

Eğitim sonucunun çıkışını tanımlar. Bu yalnızca Ölçümler ve Model gibi farklı çıkış türleriyle sonuçlanan belirli eğitimler için gereklidir. Örneğin ölçümler AutoMLStep ve model sonuçları. Ayrıca, en iyi modeli elde etmek için kullanılan belirli eğitim yinelemesini veya ölçümü de tanımlayabilirsiniz. için HyperDriveStepçıkışa dahil edilecek belirli model dosyalarını da tanımlayabilirsiniz.

dataset_registration
Gerekli

İsteğe bağlı. Bu bir iç parametredir. Bunun yerine PipelineData.as_dataset kullanmanız gerekir.

dataset_output
Gerekli

İsteğe bağlı. Bu bir iç parametredir. OutputFileDatasetConfig intead kullanmanız gerekir.

Açıklamalar

OutputPortBinding, adım girişlerini ve çıkışlarını belirtmek için bir İşlem Hattı oluştururken olduğu gibi PipelineData benzer bir şekilde kullanılabilir. Fark şudur: OutputPortBinding'in başka bir adıma giriş olarak kullanılabilmesi için ile InputPortBinding kullanılması gerekir.

OutputPortBinding ile İşlem Hattı oluşturma örneği aşağıdaki gibidir:


   from azureml.pipeline.core import OutputPortBinding, InputPortBinding, Pipeline
   from azureml.pipeline.steps import PythonScriptStep

   step_1_output = OutputPortBinding("output", datastore=datastore)

   step_1 = PythonScriptStep(
       name='process data',
       script_name="process_data.py",
       compute_target=compute,
       arguments=["--output", step_1_output],
       outputs=[step_1_output]
   )

   step_2_input = InputPortBinding("input", bind_object=step_1_output)

   step_2 = PythonScriptStep(
       name='train',
       script_name="train.py",
       compute_target=compute,
       arguments=["--input", step_2_input],
       inputs=[step_2_input]
   )

   pipeline = Pipeline(workspace=workspace, steps=[step_1, step_2])

Bu işlem hattı iki adımlı bir işlem hattı oluşturur. İşlem adımı önce yürütülür, ardından tamamlandıktan sonra eğitim adımı yürütülür. Azure ML, OutputPortBinding nesnesi tarafından açıklandığı gibi işlem adımı tarafından üretilen çıkışı eğitme adımına sağlar.

Öznitelikler

bind_mode

Oluşturma adımının verileri oluşturmak için kullanacağı modu ("karşıya yükleme" veya "bağlama" veya "hdfs") alın.

Döndürülenler

Tür Description
str

Bağlama modu.

data_type

Oluşturulacak veri türünü alın.

Döndürülenler

Tür Description
str

Veri türü adı.

dataset_registration

Veri kümesi kayıt bilgilerini alın.

Döndürülenler

Tür Description

Veri kümesi kayıt bilgileri.

datastore

PipelineData'nın bulunacağı veri deposu.

Döndürülenler

Tür Description

Datastore nesnesi.

is_directory

Çıkışın bir dizin olup olmadığı.

Döndürülenler

Tür Description

is_directory

name

OutputPortBinding nesnesinin adı.

Döndürülenler

Tür Description
str

Ad.

overwrite

"Karşıya yükleme" modu için mevcut verilerin üzerine yazılıp yazılmayacağını belirtin.

Döndürülenler

Tür Description

_Üzerine

path_on_compute

"Karşıya yükleme" modu için modülün çıkışı yazdığı yol.

Döndürülenler

Tür Description
str

path_on_compute

pipeline_output_name

Bu OutputPortBinding'e karşılık gelen işlem hattı çıkışının adını alın.

Döndürülenler

Tür Description
str

İşlem hattı çıkış adı.

training_output

Eğitim çıktısı alın.

Döndürülenler

Tür Description

Eğitim çıkışı