Expressies in Azure Machine Learning SDK en CLI v2
Met Azure Machine Learning SDK en CLI v2 kunt u expressies gebruiken wanneer een waarde mogelijk niet bekend is wanneer u een taak of onderdeel ontwerpt. Wanneer u een taak verzendt of een onderdeel aanroept, wordt de expressie geëvalueerd en wordt de waarde vervangen.
De notatie voor een expressie is ${{ <expression> }}. Sommige expressies worden geëvalueerd op de client bij het verzenden van de taak of het onderdeel. Andere expressies worden geëvalueerd op de server (de berekening waar de taak of het onderdeel wordt uitgevoerd.)
Clientexpressies
Notitie
De 'client' die de expressie evalueert, is waar de taak wordt verzonden of het onderdeel wordt uitgevoerd. Bijvoorbeeld uw lokale computer of een rekenproces.
| Expression | Beschrijving | Bereik |
|---|---|---|
${{inputs.<input_name>}} |
Verwijzingen naar een invoergegevensasset of -model. | Werkt voor alle taken. |
${{outputs.<output_name>}} |
Verwijzingen naar een uitvoergegevensasset of -model. | Werkt voor alle taken. |
${{search_space.<hyperparameter>}} |
Verwijst naar de hyperparameters die moeten worden gebruikt in een sweep-taak. De hyperparameterwaarden voor elke proefversie worden geselecteerd op basis van de search_space. |
Alleen taken opruimen. |
${{parent.inputs.<input_name>}} |
Verbindt de invoer van een onderliggende taak (pijplijnstap) in een pijplijn met de invoer van de bovenliggende pijplijntaak op het hoogste niveau. | Alleen pijplijntaken. |
${{parent.outputs.<output_name>}} |
Verbindt de uitvoer van een onderliggende taak (pijplijnstap) in een pijplijn met de uitvoer van de bovenliggende pijplijntaak op het hoogste niveau. | Alleen pijplijntaken. |
${{parent.jobs.<step-name>.inputs.<input-name>}} |
Verbindt met de invoer van een andere stap in de pijplijn. | Alleen pijplijntaken. |
${{parent.jobs.<step-name>.outputs.<output-name>}} |
Verbindt met de uitvoer van een andere stap in de pijplijn. | Alleen pijplijntaken. |
Serverexpressies
Belangrijk
De volgende expressies worden opgelost aan de serverzijde , niet aan de clientzijde . Voor geplande taken waarbij de aanmaaktijd en de tijd voor het indienen van taken verschillen, worden de expressies opgelost wanneer de taak wordt verzonden. Omdat deze expressies aan de serverzijde worden omgezet, gebruiken ze de huidige status van de werkruimte, niet de status van de werkruimte wanneer de geplande taak is gemaakt. Als u bijvoorbeeld het standaardgegevensarchief van de werkruimte wijzigt nadat u een geplande taak hebt gemaakt, wordt de expressie ${{default_datastore}} omgezet in het nieuwe standaardgegevensarchief, niet het standaardgegevensarchief wanneer de geplande taak is gemaakt.
| Expression | Beschrijving | Bereik |
|---|---|---|
${{default_datastore}} |
Als het standaardgegevensarchief van de pijplijn is geconfigureerd, wordt deze omgezet als standaardnaam voor het gegevensarchief van de pijplijn; anders wordt omgezet als de standaardnaam van het gegevensarchief van de werkruimte. Standaardgegevensarchief voor pijplijnen kan worden beheerd met behulp van pipeline_job.settings.default_datastore. |
Werkt voor alle taken. Pijplijntaken hebben een configureerbaar standaardgegevensarchief voor pijplijnen. |
${{name}} |
De taaknaam. Voor pijplijnen is dit de naam van de staptaak, niet de naam van de pijplijntaak. | Werkt voor alle taken |
${{output_name}} |
De naam van de taakuitvoer | Werkt voor alle taken |
Als azureml://datastores/${{default_datastore}}/paths/${{name}}/${{output_name}} dit bijvoorbeeld wordt gebruikt als het uitvoerpad, wordt deze tijdens runtime omgezet als een pad van azureml://datastores/workspaceblobstore/paths/<job-name>/model_path.
Volgende stappen
Zie de volgende artikelen en voorbeelden voor meer informatie over deze expressies: