Delen via

YAML-schema van CLI (v2)-pijplijnonderdeel

  • Artikel

VAN TOEPASSING OP: Azure CLI ml-extensie v2 (huidige)

Het JSON-bronschema vindt u op https://azuremlschemas.azureedge.net/latest/pipelineComponent.schema.json.

Notitie

De YAML-syntaxis die in dit document wordt beschreven, is gebaseerd op het JSON-schema voor de nieuwste versie van de ML CLI v2-extensie. Deze syntaxis werkt gegarandeerd alleen met de nieuwste versie van de ML CLI v2-extensie. U vindt de schema's voor oudere extensieversies op https://azuremlschemasprod.azureedge.net/.

YAML-syntaxis

Sleutel Type Description Toegestane waarden Default value
$schema tekenreeks Het YAML-schema. Als u de Azure Machine Learning VS Code-extensie gebruikt om het YAML-bestand te ontwerpen, inclusief $schema bovenaan het bestand, kunt u schema- en resourcevoltooiingen aanroepen.
type Const Het type onderdeel. pipeline pipeline
name tekenreeks Vereist. Naam van het onderdeel. Moet beginnen met kleine letters. Toegestane tekens zijn kleine letters, cijfers en onderstrepingstekens(_). De maximale lengte is 255 tekens.
version tekenreeks Versie van het onderdeel. Als u dit weglaat, wordt in Azure Machine Learning automatisch een versie gegenereerd.
display_name tekenreeks Weergavenaam van het onderdeel in de gebruikersinterface van studio. Deze kan niet uniek zijn binnen de werkruimte.
description tekenreeks Beschrijving van het onderdeel.
tags object Woordenlijst met tags voor het onderdeel.
jobs object Vereist. Woordenlijst van de set afzonderlijke taken die moeten worden uitgevoerd als stappen in de pijplijn. Deze taken worden beschouwd als onderliggende taken van de bovenliggende pijplijntaak.

De sleutel is de naam van de stap binnen de context van de pijplijntaak. Deze naam verschilt van de unieke taaknaam van de onderliggende taak. De waarde is de taakspecificatie, die het opdrachttaakschema of het schema van de opdrachttaak kan volgen. Momenteel kunnen alleen opdrachttaken en opruimen taken worden uitgevoerd in een pijplijn.
inputs object Woordenlijst met invoer voor de pijplijntaak. De sleutel is een naam voor de invoer binnen de context van de taak en de waarde is de invoerwaarde.

Met behulp van de expressie kunt u naar deze pijplijninvoeren verwijzen door de invoer van een afzonderlijke staptaak in de ${{ parent.inputs.<input_name> }} pijplijn. Zie de expressiesyntaxis voor bindingsinvoer en uitvoer tussen stappen in een pijplijntaak voor meer informatie over het binden van de invoer van een pijplijnstap aan de invoer van de pijplijntaak op het hoogste niveau.
inputs.<input_name> getal, geheel getal, booleaanse waarde, tekenreeks of object Een van een letterlijke waarde (van het type getal, geheel getal, booleaanse waarde of tekenreeks) of een object met een specificatie van de invoergegevens van een onderdeel.
outputs object Woordenlijst met uitvoerconfiguraties van de pijplijntaak. De sleutel is een naam voor de uitvoer binnen de context van de taak en de waarde is de uitvoerconfiguratie.

Naar deze pijplijnuitvoer kan worden verwezen door de uitvoer van een afzonderlijke staptaak in de pijplijn met behulp van de ${{ parents.outputs.<output_name> }} expressie. Zie de expressiesyntaxis voor bindingsinvoer en uitvoer tussen stappen in een pijplijntaak voor meer informatie over het binden van de invoer van een pijplijnstap aan de invoer van de pijplijntaak op het hoogste niveau.
outputs.<output_name> object U kunt het object leeg laten. In dat geval is de uitvoer standaard van het type uri_folder en genereert Azure Machine Learning een uitvoerlocatie voor de uitvoer op basis van het volgende sjabloonpad: {settings.datastore}/azureml/{job-name}/{output-name}/ Bestanden naar de uitvoermap worden geschreven via koppeling voor lezen/schrijven. Als u een andere modus voor de uitvoer wilt opgeven, geeft u een object op dat de uitvoerspecificatie van het onderdeel bevat.

Invoer van onderdelen

Sleutel Type Description Toegestane waarden Default value
type tekenreeks Vereist. Het type onderdeelinvoer. Meer informatie over gegevenstoegang number, , booleaninteger, string, , uri_file, uri_folder, mlflow_modelmltablecustom_model
description tekenreeks Beschrijving van de invoer.
default getal, geheel getal, booleaanse waarde of tekenreeks De standaardwaarde voor de invoer.
optional boolean Of de invoer vereist is. Als deze optie is ingesteld true, moet u de opdracht gebruiken met optionele invoer met $[[]] false
min geheel getal of getal De minimaal geaccepteerde waarde voor de invoer. Dit veld kan alleen worden opgegeven als type het veld is number of integer.
max geheel getal of getal De maximaal geaccepteerde waarde voor de invoer. Dit veld kan alleen worden opgegeven als type het veld is number of integer.
enum matrix De lijst met toegestane waarden voor de invoer. Alleen van toepassing als type het veld is string.

Onderdeeluitvoer

Sleutel Type Description Toegestane waarden Default value
type tekenreeks Vereist. Het type onderdeeluitvoer. uri_filemltable, uri_folder, mlflow_modelcustom_model
description tekenreeks Beschrijving van de uitvoer.

Opmerkingen

De az ml component opdrachten kunnen worden gebruikt voor het beheren van Azure Machine Learning-onderdelen.

Voorbeelden

Voorbeelden zijn beschikbaar in de GitHub-voorbeeldenopslagplaats.

Volgende stappen