InputPortBinding Klasse
Definiert eine Bindung von einer Quelle mit einer Eingabe eines Pipelineschritts.
Eine InputPortBinding kann als Eingabe für einen Schritt verwendet werden. Die Quelle kann PipelineData, PortDataReference, DataReference, PipelineDataset oder OutputPortBinding sein.
InputPortBinding ist nützlich, um den Namen der Schritteingabe anzugeben, wenn er sich vom Namen des Bindungsobjekts unterscheiden sollte (d. h. um doppelte Ein-/Ausgabenamen zu vermeiden oder weil das Schrittskript eine Eingabe benötigt, um einen bestimmten Namen zu erhalten). Hiermit kann auch der Bindungsmodus (bind_mode) für PythonScriptStep-Eingaben angegeben werden.
Initialisieren Sie InputPortBinding.
- Vererbung
-
builtins.objectInputPortBinding
Konstruktor
InputPortBinding(name, bind_object=None, bind_mode='mount', path_on_compute=None, overwrite=None, is_resource=False, additional_transformations=None, **kwargs)Parameter
- name
- str
Der Name des zu bindenden Eingabeports, der nur Buchstaben, Ziffern und Unterstriche enthalten darf.
- bind_object
- Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]
Das Objekt, das an den Eingabeport gebunden werden soll.
- bind_mode
- str
Gibt an, ob der Verarbeitungsschritt die Methode „download“ (Herunterladen) oder „mount“ (Einbinden) verwendet, um auf die Daten zuzugreifen.
- path_on_compute
- str
Für den Modus „download“ ist dies der lokale Pfad, aus dem die Daten während des Schritts gelesen werden.
- overwrite
- bool
Gibt für den Modus „download“ an, ob vorhandene Daten überschrieben werden sollen.
- is_resource
- bool
Gibt an, ob die Eingabe eine Ressource ist. Ressourcen werden in den Skriptordner heruntergeladen und bieten eine Möglichkeit, das Verhalten des Skripts zur Laufzeit zu ändern.
- additional_transformations
- <xref:azureml.dataprep.Dataflow>
Zusätzliche Transformationen, die auf die Eingabe angewendet werden sollen. Wird nur angewendet, wenn die Ausgabe des vorherigen Schritts ein Azure Machine Learning-Dataset ist.
- name
- str
Der Name des zu bindenden Eingabeports, der nur Buchstaben, Ziffern und Unterstriche enthalten darf.
- bind_object
- Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]
Das Objekt, das an den Eingabeport gebunden werden soll.
- bind_mode
- str
Gibt an, ob der verwendende Schritt die Methode "download", "mount" oder "direct" für den Zugriff auf die Daten verwendet.
- path_on_compute
- str
Für den Modus „download“ ist dies der lokale Pfad, aus dem die Daten während des Schritts gelesen werden.
- overwrite
- bool
Gibt für den Modus „download“ an, ob vorhandene Daten überschrieben werden sollen.
- is_resource
- bool
Angeben, ob die Eingabe eine Ressource ist. Ressourcen werden in den Skriptordner heruntergeladen und bieten eine Möglichkeit, das Verhalten des Skripts zur Laufzeit zu ändern.
- additional_transformations
- <xref:azureml.dataprep.Dataflow>
Zusätzliche Transformationen, die auf die Eingabe angewendet werden sollen. Wird nur angewendet, wenn die Ausgabe des vorherigen Schritts ein Azure Machine Learning-Dataset ist.
Hinweise
InputPortBinding wird verwendet, um Datenabhängigkeiten in einer Pipeline anzugeben, und stellt eine Eingabe dar, die ein Schritt für die Ausführung benötigt. InputPortBindings verfügen über eine Quelle mit dem Namen „bind_object“, die angibt, wie die Eingabedaten erzeugt werden.
PipelineData und OutputPortBinding können als bind_object für InputPortBinding verwendet werden, um anzugeben, dass die Eingabe für den Schritt von einem anderen Schritt in der Pipeline erzeugt wird.
Ein Beispiel zum Erstellen einer Pipeline mit InputPortBinding und PipelineData lautet wie folgt:
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])
In diesem Beispiel erfordert der Schritt „train“ die Ausgabe des Schritts „prepare data“ als Eingabe.
PortDataReference, DataReference oder PipelineDataset können als bind_object für InputPortBinding verwendet werden, um anzugeben, dass die Eingabe für den Schritt bereits an einem angegebenen Speicherort vorhanden ist.
Ein Beispiel zum Erstellen einer Pipeline mit InputPortBinding und DataReference lautet wie folgt:
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])
In diesem Beispiel erfordert der Schritt „train“ die von DataReference angegebene Datei „sample_data.txt“ als Eingabe.
Methoden
| as_resource |
Ruft eine doppelte Eingabeportbindung ab, die als Ressource verwendet werden kann. |
| get_bind_object_data_type |
Ruft den Datentyp des Bindungsobjekts ab. |
| get_bind_object_name |
Ruft den Namen des Bindungsobjekts ab. |
as_resource
Ruft eine doppelte Eingabeportbindung ab, die als Ressource verwendet werden kann.
as_resource()Gibt zurück
InputPortBinding mit der auf „True“ festgelegten Eigenschaft „is_resource“.
Rückgabetyp
get_bind_object_data_type
Ruft den Datentyp des Bindungsobjekts ab.
get_bind_object_data_type()Gibt zurück
Der Name des Datentyps.
Rückgabetyp
get_bind_object_name
Ruft den Namen des Bindungsobjekts ab.
get_bind_object_name()Gibt zurück
Der Name des Bindungsobjekts.
Rückgabetyp
Attribute
additional_transformations
Ruft die zusätzlichen Transformationen ab, die auf die Eingabedaten angewendet werden sollen.
Gibt zurück
Die zusätzlichen Transformationen, die auf die Eingabedaten angewendet werden sollen.
Rückgabetyp
bind_mode
Ruft den Modus („download“ oder „mount“ oder „direct“ oder „hdfs“) ab, den der Verarbeitungsschritt für den Zugriff auf die Daten verwendet.
Gibt zurück
Der Bindungsmodus („download“ oder „mount“ oder „direct“ oder „hdfs“).
Rückgabetyp
bind_object
Ruft das Objekt ab, an das InputPort gebunden wird.
Gibt zurück
Das Bindungsobjekt.
Rückgabetyp
data_reference_name
Ruft den Namen des Datenverweises ab, der InputPortBinding zugeordnet ist.
Gibt zurück
Der Datenverweisname.
Rückgabetyp
data_type
is_resource
Ruft ab, ob die Eingabe eine Ressource ist.
Gibt zurück
Ob die Eingabe eine Ressource ist.
Rückgabetyp
name
overwrite
Gibt für den Modus „download“ an, ob vorhandene Daten überschrieben werden sollen.
Gibt zurück
Die Eigenschaft „Überschreiben“.
Rückgabetyp
path_on_compute
Ruft den lokalen Pfad ab, aus dem die Daten während des Schritts gelesen werden.
Gibt zurück
Der Pfad auf der Computeressource.
Rückgabetyp
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für