Condividi tramite

InputPortBinding Classe

  • Riferimento

Definisce un'associazione da un'origine a un input di un passaggio della pipeline.

Un InputPortBinding può essere usato come input per un passaggio. L'origine può essere un PipelineDataoggetto , PortDataReference, DataReference, PipelineDataseto OutputPortBinding.

InputPortBinding è utile per specificare il nome dell'input del passaggio, se deve essere diverso dal nome dell'oggetto bind, ad esempio per evitare nomi di input/output duplicati o perché lo script di passaggio necessita di un input per avere un determinato nome. Può essere usato anche per specificare il bind_mode per PythonScriptStep gli input.

Inizializzare InputPortBinding.

Ereditarietà
builtins.object
InputPortBinding

Costruttore

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

Parametri

Nome Descrizione
name
Necessario
str

Nome della porta di input da associare, che può contenere solo lettere, cifre e caratteri di sottolineatura.
bind_object
Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]

Oggetto da associare alla porta di input.

valore predefinito: None
bind_mode
str

Specifica se il passaggio di utilizzo userà il metodo "download" o "montaggio" per accedere ai dati.

valore predefinito: mount
path_on_compute
str

Per la modalità "download", il percorso locale del passaggio leggerà i dati da.

valore predefinito: None
overwrite
bool

Per la modalità "download", indicare se sovrascrivere i dati esistenti.

valore predefinito: None
is_resource
bool

Indica se l'input è una risorsa. Le risorse vengono scaricate nella cartella script e consentono di modificare il comportamento dello script in fase di esecuzione.

valore predefinito: False
additional_transformations
<xref:azureml.dataprep.Dataflow>

Trasformazioni aggiuntive da applicare all'input. Questa operazione verrà applicata solo se l'output del passaggio precedente è un set di dati di Azure Machine Learning.

valore predefinito: None
name
Necessario
str

Nome della porta di input da associare, che può contenere solo lettere, cifre e caratteri di sottolineatura.
bind_object
Necessario
Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]

Oggetto da associare alla porta di input.
bind_mode
Necessario
str

Specifica se il passaggio di utilizzo userà il metodo "download" o "montaggio" o "diretto" per accedere ai dati.
path_on_compute
Necessario
str

Per la modalità "download", il percorso locale del passaggio leggerà i dati da.
overwrite
Necessario
bool

Per la modalità "download", indicare se sovrascrivere i dati esistenti.
is_resource
Necessario
bool

Indica se l'input è una risorsa. Le risorse vengono scaricate nella cartella script e consentono di modificare il comportamento dello script in fase di esecuzione.
additional_transformations
Necessario
<xref:azureml.dataprep.Dataflow>

Trasformazioni aggiuntive da applicare all'input. Questa operazione verrà applicata solo se l'output del passaggio precedente è un set di dati di Azure Machine Learning.

Commenti

InputPortBinding viene usato per specificare le dipendenze dei dati in una pipeline, rappresenta un input che richiede un passaggio per l'esecuzione. InputPortBindings ha un'origine, denominata bind_object, che specifica il modo in cui vengono generati i dati di input.

PipelineData e OutputPortBinding può essere usato come bind_object per un InputPortBinding per specificare che l'input al passaggio verrà generato da un altro passaggio della pipeline.

Un esempio per creare una pipeline usando InputPortBinding e PipelineData è il seguente:


   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 questo esempio il passaggio "training" richiede l'output del passaggio "Prepara dati" come input.

PortDataReference, DataReferenceo PipelineDataset può essere usato come bind_object per un InputPortBinding per specificare che l'input al passaggio esiste già in un percorso specificato.

Un esempio per creare una pipeline usando InputPortBinding e DataReference è il seguente:


   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 questo esempio il passaggio "train" richiede il file "sample_data.txt" specificato da DataReference come input.

Metodi

as_resource

Ottenere un'associazione di porta di input duplicata che può essere usata come risorsa.
get_bind_object_data_type

Ottenere il tipo di dati dell'oggetto bind.
get_bind_object_name

Ottenere il nome dell'oggetto bind.

as_resource

Ottenere un'associazione di porta di input duplicata che può essere usata come risorsa.

as_resource()

Restituisce

Tipo Descrizione
InputPortBinding

InputPortBinding con la proprietà is_resource impostare un valore True.

get_bind_object_data_type

Ottenere il tipo di dati dell'oggetto bind.

get_bind_object_data_type()

Restituisce

Tipo Descrizione
str

Nome del tipo di dati.

get_bind_object_name

Ottenere il nome dell'oggetto bind.

get_bind_object_name()

Restituisce

Tipo Descrizione
str

Nome dell'oggetto bind.

Attributi

additional_transformations

Ottenere le trasformazioni aggiuntive da applicare ai dati di input.

Restituisce

Tipo Descrizione
<xref:azureml.dataprep.Dataflow>

Trasformazioni aggiuntive da applicare ai dati di input.

bind_mode

Ottenere la modalità ("download" o "montaggio" o "direct", "hdfs") il passaggio di utilizzo userà per accedere ai dati.

Restituisce

Tipo Descrizione
str

Modalità di associazione ("download" o "montaggio" o "direct" o "hdfs").

bind_object

Ottenere l'oggetto a cui verrà associato InputPort.

Restituisce

Tipo Descrizione
Union[PortDataReference, DataReference, PipelineData, OutputPortBinding, PipelineDataset]

Oggetto bind.

data_reference_name

Ottenere il nome del riferimento ai dati associati all'oggetto InputPortBinding.

Restituisce

Tipo Descrizione
str

Nome di riferimento dei dati.

data_type

Ottenere il tipo di dati di input.

Restituisce

Tipo Descrizione
str

Proprietà tipo di dati.

is_resource

Ottenere se l'input è una risorsa.

Restituisce

Tipo Descrizione
bool

Input di una risorsa.

name

Nome dell'associazione porta di input.

Restituisce

Tipo Descrizione
str

Nome.

overwrite

Per la modalità "download", indicare se sovrascrivere i dati esistenti.

Restituisce

Tipo Descrizione
bool

Proprietà sovrascrivere.

path_on_compute

Ottenere il percorso locale da cui verranno letti i dati.

Restituisce

Tipo Descrizione
str

Percorso sul calcolo.