Azure / Azure/MachineLearningNotebooks

Contradiction in Doc for compute_target

Offen
#1,481 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
ADO doc-bug Pipelines
Vorherrschende Sprache
Jupyter Notebook
Sterne
4.4k
Forks
2.6k
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

compute_target
Union[]
[Required] The compute target to use. If unspecified, the target from the runconfig will be used. This parameter may be specified as a compute target object or the string name of a compute target on the workspace. Optionally if the compute target is not available at pipeline creation time, you may specify a tuple of ('compute target name', 'compute target type') to avoid fetching the compute target object (AmlCompute type is 'AmlCompute' and RemoteCompute type is 'VirtualMachine').

PROBLEM: It's a [Required] parameter. So how could there be a note like 'If unspecified, the target of the runconfig will be used....'.
I tested it, if you do not specify it it fails, even with a runconfig which has a compute_target defined.

error: _executionId [453eac96]: Assignment for parameter Target is not specified_

So the doc is incorrect here.

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 76f6fde8-6396-f360-78c8-97970f5b0a4b
* Version Independent ID: 060905ce-7ab4-2052-6f35-7b1c14c1e581
* Content: [azureml.pipeline.steps.PythonScriptStep class - Azure Machine Learning Python](https://docs.microsoft.com/en-us/python/api/azureml-pipeline-steps/azureml.pipeline.steps.pythonscriptstep?view=azure-ml-py)
* Content Source: [AzureML-Docset/stable/docs-ref-autogen/azureml-pipeline-steps/azureml.pipeline.steps.PythonScriptStep.yml](https://github.com/MicrosoftDocs/MachineLearning-Python-pr/blob/live/AzureML-Docset/stable/docs-ref-autogen/azureml-pipeline-steps/azureml.pipeline.steps.PythonScriptStep.yml)
* Service: **machine-learning**
* Sub-service: **core**
* GitHub Login: @DebFro
* Microsoft Alias: **debfro**

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Rechercherichtung

Überprüfe AzureML-Docset/stable/docs-ref-autogen/azureml-pipeline-steps/azureml.pipeline.steps.PythonScriptStep.yml und die verknüpfte PythonScriptStep-Dokumentation. Vergleiche die Anforderung für compute_target mit dem gemeldeten Verhalten und aktualisiere die Parameterbeschreibung, sodass der erforderliche Status und die Formulierung zum Fallback konsistent sind; die Dokumentation sollte nicht länger einen nicht nutzbaren Fallback behaupten.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
azure, python
Bereich
documentation, machine-learning
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
55/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.