InputPortBinding Osztály

Egy forrás és egy folyamatlépés bemenete közötti kötést definiál.

Az InputPortBinding egy lépés bemeneteként használható. A forrás lehet egy PipelineData, PortDataReference, DataReference, PipelineDatasetvagy OutputPortBinding.

Az InputPortBinding akkor hasznos, ha megadja a lépésbemenet nevét, ha az eltér a kötési objektum nevével (azaz az ismétlődő bemeneti/kimeneti nevek elkerülése érdekében, vagy azért, mert a lépésszkriptnek szüksége van egy bemeneti névre). A bemenetek bind_mode PythonScriptStep is megadható.

Inicializálja az InputPortBindinget.

Konstruktor

InputPortBinding(name, bind_object=None, bind_mode='mount', path_on_compute=None, overwrite=None, is_resource=False, additional_transformations=None, **kwargs)

Paraméterek

Name	Description
name Kötelező	str A kötéshez használt bemeneti port neve, amely csak betűket, számjegyeket és aláhúzásjeleket tartalmazhat.
bind_object	Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset] A bemeneti porthoz kötéshez használt objektum. Alapértelmezett érték: None
bind_mode	str Megadja, hogy a felhasználó lépés a "download" vagy a "mount" metódust használja-e az adatok eléréséhez. Alapértelmezett érték: mount
path_on_compute	str A "letöltési" mód esetében a lépés által használt helyi elérési út fogja beolvasni az adatokat. Alapértelmezett érték: None
overwrite	bool A "letöltés" mód esetében adja meg, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: None
is_resource	bool Jelzi, hogy a bemenet erőforrás-e. A rendszer letölti az erőforrásokat a szkriptmappába, és módot ad a szkript futásidejű viselkedésének módosítására. Alapértelmezett érték: False
additional_transformations	<xref:azureml.dataprep.Dataflow> A bemenetre alkalmazandó további átalakítások. Ez csak akkor lesz alkalmazva, ha az előző lépés kimenete egy Azure Machine Learning-adatkészlet. Alapértelmezett érték: None
name Kötelező	str A kötéshez használt bemeneti port neve, amely csak betűket, számjegyeket és aláhúzásjeleket tartalmazhat.
bind_object Kötelező	Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset] A bemeneti porthoz kötéshez használt objektum.
bind_mode Kötelező	str Megadja, hogy a fogyasztó lépés a "download" vagy a "mount" vagy a "direct" metódust használja-e az adatok eléréséhez.
path_on_compute Kötelező	str A "letöltési" mód esetében a lépés által használt helyi elérési út fogja beolvasni az adatokat.
overwrite Kötelező	bool A "letöltés" mód esetében adja meg, hogy felülírja-e a meglévő adatokat.
is_resource Kötelező	bool Adja meg, hogy a bemenet erőforrás-e. A rendszer letölti az erőforrásokat a szkriptmappába, és módot ad a szkript futásidejű viselkedésének módosítására.
additional_transformations Kötelező	<xref:azureml.dataprep.Dataflow> A bemenetre alkalmazandó további átalakítások. Ez csak akkor lesz alkalmazva, ha az előző lépés kimenete egy Azure Machine Learning-adatkészlet.

Megjegyzések

Az InputPortBinding egy folyamat adatfüggőségeinek megadására szolgál, amely egy olyan bemenetet jelöl, amelyet egy lépés végrehajtáshoz igényel. Az InputPortBindings rendelkezik egy bind_object nevű forrással, amely meghatározza a bemeneti adatok létrehozásának módját.

PipelineData és OutputPortBinding az InputPortBinding bind_object ként is használható annak megadásához, hogy a lépés bemenetét a folyamat egy másik lépése hozza létre.

Egy folyamat InputPortBinding és PipelineData használatával történő létrehozására az alábbi példa látható:

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

   step_1_output = PipelineData("output", datastore=datastore, output_mode="mount")

   step_1 = PythonScriptStep(
       name='prepare data',
       script_name="prepare_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])

Ebben a példában a "betanítás" lépéshez bemenetként az "adatok előkészítése" lépés kimenete szükséges.

PortDataReference, DataReferencevagy PipelineDataset az InputPortBinding bind_object ként is használható annak megadásához, hogy a lépés bemenete már létezik egy megadott helyen.

Az InputPortBinding és a DataReference használatával létrehozhat egy folyamatot az alábbiak szerint:

   from azureml.data.data_reference import DataReference
   from azureml.pipeline.core import InputPortBinding, Pipeline
   from azureml.pipeline.steps import PythonScriptStep

   data_reference = DataReference(datastore=datastore, path_on_datastore='sample_data.txt', mode="mount")
   step_1_input = InputPortBinding("input", bind_object=data_reference)

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

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

Ebben a példában a "betanítás" lépéshez a DataReference által bemenetként megadott "sample_data.txt" fájl szükséges.

Metódusok

as_resource	Szerezze be az erőforrásként használható duplikált bemeneti portkötést.
get_bind_object_data_type	A kötési objektum adattípusának lekérése.
get_bind_object_name	Kérje le a kötési objektum nevét.

as_resource

Szerezze be az erőforrásként használható duplikált bemeneti portkötést.

as_resource()

Válaszok

Típus	Description
InputPortBinding	Az InputPortBinding és is_resource tulajdonság értéke Igaz.

get_bind_object_data_type

A kötési objektum adattípusának lekérése.

get_bind_object_data_type()

Válaszok

Típus	Description
str	Az adattípus neve.

get_bind_object_name

Kérje le a kötési objektum nevét.

get_bind_object_name()

Válaszok

Típus	Description
str	A kötési objektum neve.

Attribútumok

additional_transformations

Kérje le a bemeneti adatokra alkalmazandó további átalakításokat.

Válaszok

Típus	Description
<xref:azureml.dataprep.Dataflow>	A bemeneti adatokra alkalmazandó további átalakítások.

bind_mode

Szerezze be a "letöltés" vagy a "csatlakoztatás" vagy a "közvetlen", "hdfs" módot, amelyet a felhasználó lépés használ az adatok eléréséhez.

Válaszok

Típus	Description
str	A kötési mód ("letöltés" vagy "csatlakoztatás" vagy "közvetlen" vagy "hdfs").

bind_object

Szerezze be azt az objektumot, amelyhez az InputPort hozzá lesz kötve.

Válaszok

Típus	Description
Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]	A kötési objektum.

data_reference_name

Kérje le az InputPortBindinghez társított adathivatkozás nevét.

Válaszok

Típus	Description
str	Az adathivatkozás neve.

data_type

A bemeneti adatok típusának lekérése.

Válaszok

Típus	Description
str	Az adattípus tulajdonság.

is_resource

Megtudhatja, hogy a bemenet erőforrás-e.

Válaszok

Típus	Description
bool	Erőforrás bemenete.

name

A bemeneti port kötésének neve.

Válaszok

Típus	Description
str	A név.

overwrite

A "letöltés" mód esetében adja meg, hogy felülírja-e a meglévő adatokat.

Válaszok

Típus	Description
bool	A felülírás tulajdonság.

path_on_compute

Kérje le a helyi elérési utat, amelyből a lépés felolvassa az adatokat.

Válaszok

Típus	Description
str	A számítási útvonal.