OutputPortBinding Sınıf

  • Başvuru

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

OutputPortBinding, bir adım tarafından 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
Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore]

PipelineData'nın bulunacağı veri deposu.

Default value: None
output_name
str

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

Default value: None
bind_mode
str

Oluşturan adımın verilere erişmek için "upload" veya "mount" veya "hdfs" yöntemini kullanıp kullanmayacağını belirtir.

Default value: mount
path_on_compute
str

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

Default value: None
is_directory
bool

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

Default value: None
overwrite
bool

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

Default value: 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.

Default value: 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.

Default value: None
training_output
TrainingOutput

Eğitim sonucu için çıkışı 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 eklenecek belirli model dosyalarını da tanımlayabilirsiniz.

Default value: None
dataset_registration
DatasetRegistration

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

Default value: None
dataset_output
OutputDatasetConfig

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

Default value: None
name
Gerekli
str

Yalnızca harf, rakam ve alt çizgi içerebilen OutputPortBinding nesnesinin adı.
datastore
Gerekli
Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore]

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şturan adımın verilere erişmek için "upload" veya "mount" 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
bool

çıkış bir dizinse
overwrite
Gerekli
bool

"Karşıya yükleme" modu için, var olan 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
TrainingOutput

Eğitim sonucu için çıkışı 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 eklenecek belirli model dosyalarını da tanımlayabilirsiniz.
dataset_registration
Gerekli
DatasetRegistration

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

İ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 üzere 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ılması için birlikte 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ımla oluşturulur. İşlem adımı önce yürütülür, ardından tamamlandıktan sonra tren 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
DatasetRegistration

Veri kümesi kayıt bilgileri.

datastore

PipelineData'nın bulunacağı veri deposu.

Döndürülenler

Tür Description
Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore]

Datastore nesnesi.

is_directory

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

Döndürülenler

Tür Description
bool

is_directory

name

OutputPortBinding nesnesinin adı.

Döndürülenler

Tür Description
str

Ad.

overwrite

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

Döndürülenler

Tür Description
bool

_Ü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
TrainingOutput

Eğitim çıkışı