InputPortBinding Třída

Definuje vazbu ze zdroje na vstup kroku kanálu.

InputPortBinding lze použít jako vstup kroku. Zdrojem může být PipelineData, , PortDataReference DataReference, PipelineDatasetnebo OutputPortBinding.

InputPortBinding je užitečné zadat název vstupu kroku, pokud by se měl lišit od názvu objektu bind (tj. aby nedocházelo k duplicitním názvům vstupu a výstupu, nebo protože skript kroku potřebuje vstup, aby měl určitý název). Dá se také použít k určení bind_mode pro PythonScriptStep vstupy.

Inicializace InputPortBinding

Konstruktor

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

Parametry

Name	Description
name Vyžadováno	str Název vstupního portu pro vazbu, který může obsahovat pouze písmena, číslice a podtržítka.
bind_object	Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset] Objekt, který se má svázat se vstupním portem. Default value: None
bind_mode	str Určuje, jestli spotřebovaný krok použije metodu "download" nebo "mount" pro přístup k datům. Default value: mount
path_on_compute	str V případě režimu stahování se místní cesta, ze které krok načte data. Default value: None
overwrite	bool V případě režimu stažení určete, jestli se mají přepsat existující data. Default value: None
is_resource	bool Označuje, jestli je vstup prostředkem. Prostředky se stáhnou do složky skriptu a poskytují způsob, jak změnit chování skriptu za běhu. Default value: False
additional_transformations	<xref:azureml.dataprep.Dataflow> Další transformace, které se použijí na vstup. Použije se jenom v případě, že výstupem předchozího kroku je datová sada Azure Machine Learning. Default value: None
name Vyžadováno	str Název vstupního portu pro vazbu, který může obsahovat pouze písmena, číslice a podtržítka.
bind_object Vyžadováno	Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset] Objekt, který se má svázat se vstupním portem.
bind_mode Vyžadováno	str Určuje, jestli spotřeba použije pro přístup k datům metodu "download" nebo "mount" nebo "direct".
path_on_compute Vyžadováno	str V případě režimu stahování se místní cesta, ze které krok načte data.
overwrite Vyžadováno	bool V případě režimu stažení určete, jestli se mají přepsat existující data.
is_resource Vyžadováno	bool Určuje, jestli je vstup prostředkem. Prostředky se stáhnou do složky skriptu a poskytují způsob, jak změnit chování skriptu za běhu.
additional_transformations Vyžadováno	<xref:azureml.dataprep.Dataflow> Další transformace, které se použijí na vstup. Použije se jenom v případě, že výstupem předchozího kroku je datová sada Azure Machine Learning.

Poznámky

InputPortBinding se používá k určení závislostí dat v kanálu, představuje vstup, který krok vyžaduje ke spuštění. InputPortBindings mají zdroj, který se nazývá bind_object, který určuje způsob vytváření vstupních dat.

PipelineData a OutputPortBinding lze ji použít jako bind_object pro InputPortBinding k určení, že vstup kroku bude vytvořen dalším krokem v kanálu.

Příklad sestavení kanálu pomocí InputPortBinding a PipelineData je následující:


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

V tomto příkladu krok "train" vyžaduje výstup kroku přípravy dat jako vstup.

PortDataReference, DataReferencenebo PipelineDataset lze použít jako bind_object pro InputPortBinding určit, že vstup kroku již existuje v zadaném umístění.

Příklad sestavení kanálu pomocí InputPortBinding a DataReference je následující:


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

V tomto příkladu krok "train" vyžaduje soubor "sample_data.txt" určený DataReference jako vstup.

Metody

as_resource	Získejte duplicitní vstupní vazbu portu, kterou lze použít jako prostředek.
get_bind_object_data_type	Získejte datový typ objektu bind.
get_bind_object_name	Získejte název objektu bind.

as_resource

Získejte duplicitní vstupní vazbu portu, kterou lze použít jako prostředek.

as_resource()

Návraty

Typ	Description
InputPortBinding	InputPortBinding s is_resource vlastnost nastavena True.

get_bind_object_data_type

Získejte datový typ objektu bind.

get_bind_object_data_type()

Návraty

Typ	Description
str	Název datového typu.

get_bind_object_name

Získejte název objektu bind.

get_bind_object_name()

Návraty

Typ	Description
str	Název objektu vazby.

Atributy

additional_transformations

Získejte další transformace, které se použijí na vstupní data.

Návraty

Typ	Description
<xref:azureml.dataprep.Dataflow>	Další transformace, které se použijí na vstupní data.

bind_mode

Získejte režim ("download" nebo "mount" nebo "direct", "hdfs") krok, který se použije pro přístup k datům.

Návraty

Typ	Description
str	Režim vazby ("download" nebo "mount" nebo "direct" nebo "hdfs").

bind_object

Získejte objekt InputPort bude vázán na.

Návraty

Typ	Description
Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]	Objekt vazby.

data_reference_name

Získejte název odkazu na data přidružená k InputPortBinding.

Návraty

Typ	Description
str	Název odkazu na data.

data_type

Získejte typ vstupních dat.

Návraty

Typ	Description
str	Vlastnost datového typu.

is_resource

Získejte, jestli je vstup prostředkem.

Návraty

Typ	Description
bool	Je vstupní prostředek.

name

Název vazby vstupního portu

Návraty

Typ	Description
str	Název.

overwrite

V případě režimu stažení určete, jestli se mají přepsat existující data.

Návraty

Typ	Description
bool	Vlastnost přepsání.

path_on_compute

Získejte místní cestu, ze které krok načte data.

Návraty

Typ	Description
str	Cesta k výpočetním prostředkům.

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

InputPortBinding Třída

Konstruktor

Parametry

Poznámky

Metody

as_resource

Návraty

get_bind_object_data_type

Návraty

get_bind_object_name

Návraty

Atributy

additional_transformations

Návraty

bind_mode

Návraty

bind_object

Návraty

data_reference_name

Návraty

data_type

Návraty

is_resource

Návraty

name

Návraty

overwrite

Návraty

path_on_compute

Návraty

Váš názor