Uttryck i Azure Machine Learning SDK och CLI v2

Med Azure Machine Learning SDK och CLI v2 kan du använda uttryck när ett värde kanske inte är känt när du skapar ett jobb eller en komponent. När du skickar ett jobb eller anropar en komponent utvärderas uttrycket och värdet ersätts.

Formatet för ett uttryck är ${{ <expression> }}. Vissa uttryck utvärderas på klienten när jobbet eller komponenten skickas. Andra uttryck utvärderas på servern (den beräkning där jobbet eller komponenten körs.)

Klientuttryck

Kommentar

Den "klient" som utvärderar uttrycket är den plats där jobbet skickas eller komponenten körs. Till exempel din lokala dator eller en beräkningsinstans.

Uttryck beskrivning Definitionsområde
${{inputs.<input_name>}} Referenser till en indatatillgång eller modell. Fungerar för alla jobb.
${{outputs.<output_name>}} Referenser till en utdatatillgång eller modell. Fungerar för alla jobb.
${{search_space.<hyperparameter>}} Refererar till de hyperparametrar som ska användas i ett svepjobb. Hyperparametervärdena för varje utvärderingsversion väljs baserat på search_space. Rensa bara jobb.
${{parent.inputs.<input_name>}} Binder indata för ett underordnat jobb (pipelinesteg) i en pipeline till indata för det överordnade pipelinejobbet på den översta nivån. Endast pipelinejobb.
${{parent.outputs.<output_name>}} Binder utdata från ett underordnat jobb (pipelinesteg) i en pipeline till utdata från det överordnade pipelinejobbet på den översta nivån. Endast pipelinejobb.
${{parent.jobs.<step-name>.inputs.<input-name>}} Binder till indata från ett annat steg i pipelinen. Endast pipelinejobb.
${{parent.jobs.<step-name>.outputs.<output-name>}} Binder till utdata från ett annat steg i pipelinen. Endast pipelinejobb.

Serveruttryck

Viktigt!

Följande uttryck matchas på serversidan , inte på klientsidan . För schemalagda jobb där jobbskapandetidenoch tiden för jobböverföring är olika löses uttrycken när jobbet skickas. Eftersom dessa uttryck matchas på serversidan använder de arbetsytans aktuella tillstånd, inte arbetsytans tillstånd när det schemalagda jobbet skapades. Om du till exempel ändrar standarddatalagringen för arbetsytan när du har skapat ett schemalagt jobb matchas uttrycket ${{default_datastore}} till det nya standarddataarkivet, inte standarddatalagringen när det schemalagda jobbet skapades.

Uttryck beskrivning Definitionsområde
${{default_datastore}} Om standarddatalager för pipelinen har konfigurerats matchas det som standardnamn för pipelinedatalager. annars matchas som standardnamn för arbetsytans datalager.

Standarddatalager för pipeline kan styras med hjälp av pipeline_job.settings.default_datastore.
Fungerar för alla jobb.

Pipelinejobb har ett konfigurerbart standarddatalager för pipeline.
${{name}} Jobbnamnet. För pipelines är det stegets jobbnamn, inte namnet på pipelinejobbet. Fungerar för alla jobb
${{output_name}} Jobbets utdatanamn Fungerar för alla jobb

Om azureml://datastores/${{default_datastore}}/paths/${{name}}/${{output_name}} den till exempel används som utdatasökväg löses den vid körning som en sökväg till azureml://datastores/workspaceblobstore/paths/<job-name>/model_path.

Nästa steg

Mer information om dessa uttryck finns i följande artiklar och exempel: