ModuleStep Klasa

Tworzy krok potoku usługi Azure Machine Learning, aby uruchomić określoną wersję modułu.

Module obiekty definiują obliczenia wielokrotnego użytku, takie jak skrypty lub pliki wykonywalne, które mogą być używane w różnych scenariuszach uczenia maszynowego i przez różnych użytkowników. Aby użyć konkretnej wersji modułu w potoku, utwórz modułKrok. Element ModuleStep to krok w potoku, który używa istniejącego ModuleVersionelementu .

Aby zapoznać się z przykładem użycia modułu ModuleStep, zobacz notes https://aka.ms/pl-modulestep.

Utwórz krok potoku usługi Azure ML, aby uruchomić określoną wersję modułu.

Konstruktor

ModuleStep(module=None, version=None, module_version=None, inputs_map=None, outputs_map=None, compute_target=None, runconfig=None, runconfig_pipeline_params=None, arguments=None, params=None, name=None, _workflow_provider=None)

Parametry

Nazwa Opis
module

Moduł używany w kroku. module Podaj parametr lub , module_version ale nie oba.

Domyślna wartość: None
version
str

Wersja modułu używanego w kroku.

Domyślna wartość: None
module_version

ModuleVersion modułu użytego w kroku. module Podaj parametr lub , module_version ale nie oba.

Domyślna wartość: None
inputs_map

Słownik mapujący nazwy definicji portów elementu ModuleVersion na dane wejściowe kroku.

Domyślna wartość: None
outputs_map

Słownik mapujący nazwy definicji portów elementu ModuleVersion na dane wyjściowe kroku.

Domyślna wartość: None
compute_target

Docelowy obiekt obliczeniowy do użycia. Jeśli nie zostanie określony, zostanie użyty element docelowy z konfiguracji runconfig. Może to być obiekt docelowy obliczeniowy lub nazwa ciągu docelowego obiektu obliczeniowego w obszarze roboczym. Opcjonalnie, jeśli docelowy obiekt obliczeniowy nie jest dostępny w czasie tworzenia potoku, możesz określić krotkę ('nazwa docelowa obliczeniowa', 'typ docelowy obliczeniowy'), aby uniknąć pobierania obiektu docelowego obliczeniowego (typ AmlCompute to "AmlCompute", a typ RemoteCompute to "VirtualMachine").

Domyślna wartość: None
runconfig

Opcjonalna konfiguracja RunConfiguration do użycia. Za pomocą polecenia RunConfiguration można określić dodatkowe wymagania dotyczące przebiegu, takie jak zależności conda i obraz platformy Docker.

Domyślna wartość: None
runconfig_pipeline_params

Zastąpienie właściwości runconfig w czasie wykonywania przy użyciu par klucz-wartość każdy z nazwami właściwości runconfig i PipelineParameter dla tej właściwości.

Obsługiwane wartości: "NodeCount", "MpiProcessCountPerNode", "TensorflowWorkerCount", "TensorflowParameterServerCount"

Domyślna wartość: None
arguments

Lista argumentów wiersza polecenia dla pliku skryptu języka Python. Argumenty zostaną dostarczone do docelowego obiektu obliczeniowego za pośrednictwem argumentów w elem. Aby uzyskać więcej informacji na temat obsługi argumentów, takich jak symbole specjalne, zobacz argumenty w pliku RunConfiguration

Domyślna wartość: None
params

Słownik par name-value.

Domyślna wartość: None
name
str

Nazwa kroku.

Domyślna wartość: None
_workflow_provider
<xref:azureml.pipeline.core._aeva_provider._AevaWorkflowProvider>

(Tylko użycie wewnętrzne). Dostawca przepływu pracy.

Domyślna wartość: None
module
Wymagane

Moduł używany w kroku. module Podaj parametr lub , module_version ale nie oba.

version
Wymagane
str

Wersja modułu używanego w kroku.

module_version
Wymagane

ModuleVersion modułu użytego w kroku. module Podaj parametr lub , module_version ale nie oba.

inputs_map
Wymagane
dict[str, Union[InputPortBinding, DataReference, PortDataReference, PipelineData, <xref:azureml.pipeline.core.pipeline_output_dataset.PipelineOutputDataset>, DatasetConsumptionConfig]]

Słownik mapujący nazwy definicji portów elementu ModuleVersion na dane wejściowe kroku.

outputs_map
Wymagane
dict[str, Union[InputPortBinding, DataReference, PortDataReference, PipelineData, <xref:azureml.pipeline.core.pipeline_output_dataset.PipelineOutputDataset>]]

Słownik mapujący nazwy definicji portów elementu ModuleVersion na dane wyjściowe kroku.

compute_target
Wymagane

Docelowy obiekt obliczeniowy do użycia. Jeśli nie zostanie określony, zostanie użyty element docelowy z konfiguracji runconfig. Może to być obiekt docelowy obliczeniowy lub nazwa ciągu docelowego obiektu obliczeniowego w obszarze roboczym. Opcjonalnie, jeśli docelowy obiekt obliczeniowy nie jest dostępny w czasie tworzenia potoku, możesz określić krotkę ('nazwa docelowa obliczeniowa', 'typ docelowy obliczeniowy'), aby uniknąć pobierania obiektu docelowego obliczeniowego (typ AmlCompute to "AmlCompute", a typ RemoteCompute to "VirtualMachine").

runconfig
Wymagane

Opcjonalna konfiguracja RunConfiguration do użycia. Za pomocą polecenia RunConfiguration można określić dodatkowe wymagania dotyczące przebiegu, takie jak zależności conda i obraz platformy Docker.

runconfig_pipeline_params
Wymagane

Zastąpienie właściwości runconfig w czasie wykonywania przy użyciu par klucz-wartość każdy z nazwami właściwości runconfig i PipelineParameter dla tej właściwości.

Obsługiwane wartości: "NodeCount", "MpiProcessCountPerNode", "TensorflowWorkerCount", "TensorflowParameterServerCount"

arguments
Wymagane

Lista argumentów wiersza polecenia dla pliku skryptu języka Python. Argumenty zostaną dostarczone do docelowego obiektu obliczeniowego za pośrednictwem argumentów w elem. Aby uzyskać więcej informacji na temat obsługi argumentów, takich jak symbole specjalne, zobacz argumenty w pliku RunConfiguration

params
Wymagane

Słownik par name-value.

name
Wymagane
str

Nazwa kroku.

_wokflow_provider
Wymagane

(Tylko użycie wewnętrzne). Dostawca przepływu pracy.

Uwagi

Element jest Module używany do tworzenia jednostki obliczeniowej wielokrotnego użytku potoku usługi Azure Machine Learning i zarządzania nią. ModuleStep to wbudowany krok w usłudze Azure Machine Learning używany do korzystania z modułu. Możesz zdefiniować, który element ModuleVersion ma być używany, lub pozwolić usłudze Azure Machine Learning rozwiązać problem, którego parametru ModuleVersion użyć zgodnie z procesem rozwiązywania zdefiniowanym w sekcji Module uwagi klasy. Aby zdefiniować, który element ModuleVersion jest używany w przesłanym potoku, zdefiniuj jedną z następujących czynności podczas tworzenia modułuKrok:

  • Obiekt ModuleVersion.

  • Module Obiekt i wartość wersji.

  • Module Obiekt bez wartości wersji. W takim przypadku rozwiązanie wersji może się różnić w zależności od przesyłania.

Należy zdefiniować mapowanie między danymi wejściowymi i wyjściowymi elementu ModuleStep do danych wejściowych i wyjściowych modułu ModuleVersion.

W poniższym przykładzie pokazano, jak utworzyć element ModuleStep jako część potoku z wieloma obiektami ModuleStep:


   middle_step = ModuleStep(module=module,
                            inputs_map= middle_step_input_wiring,
                            outputs_map= middle_step_output_wiring,
                            runconfig=RunConfiguration(), compute_target=aml_compute,
                            arguments = ["--file_num1", first_sum, "--file_num2", first_prod,
                                         "--output_sum", middle_sum, "--output_product", middle_prod])

Pełny przykład jest dostępny w witrynie https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/machine-learning-pipelines/intro-to-pipelines/aml-pipelines-how-to-use-modulestep.ipynb

Metody

create_node

Utwórz węzeł z kroku ModuleStep i dodaj go do określonego grafu.

Ta metoda nie jest przeznaczona do bezpośredniego użycia. Po utworzeniu wystąpienia potoku w tym kroku usługa Azure ML automatycznie przekazuje parametry wymagane za pośrednictwem tej metody, aby można było dodać krok do grafu potoku reprezentującego przepływ pracy.

create_node

Utwórz węzeł z kroku ModuleStep i dodaj go do określonego grafu.

Ta metoda nie jest przeznaczona do bezpośredniego użycia. Po utworzeniu wystąpienia potoku w tym kroku usługa Azure ML automatycznie przekazuje parametry wymagane za pośrednictwem tej metody, aby można było dodać krok do grafu potoku reprezentującego przepływ pracy.

create_node(graph, default_datastore, context)

Parametry

Nazwa Opis
graph
Wymagane

Obiekt grafu, do który ma zostać dodany węzeł.

default_datastore
Wymagane

Domyślny magazyn danych.

context
Wymagane
<xref:azureml.pipeline.core._GraphContext>

Kontekst grafu.

Zwraca

Typ Opis

Obiekt węzła.