Delen via


az ml datastore

Note

This reference is part of the ml extension for the Azure CLI (version 2.15.0 or higher). De extensie installeert automatisch de eerste keer dat u een az ml datastore opdracht uitvoert. Learn more about extensions.

Azure ML-gegevensarchieven beheren.

Azure ML-gegevensarchieven koppelen uw Azure-opslagservices veilig aan uw werkruimte, zodat u toegang hebt tot uw opslag zonder dat u de verbindingsgegevens in uw scripts hoeft te coderen. De verbindingsgeheimen, zoals de verificatiereferenties van de opslagservice, worden opgeslagen in de Key Vault van uw werkruimte.

Wanneer u een werkruimte maakt, wordt automatisch een Azure Storage-account gemaakt als een gekoppelde resource. Er wordt een blobcontainer gemaakt in dit account en de verbindingsgegevens worden opgeslagen als een gegevensarchief met de naam workspaceblobstore. Dit fungeert als het standaardgegevensarchief van de werkruimte en de blobcontainer wordt gebruikt om uw werkruimteartefacten en machine learning-taaklogboeken en -uitvoer op te slaan.

Opdracht

Name Description Type Status
az ml datastore create

Maak een gegevensarchief.

Extension GA
az ml datastore delete

Een gegevensarchief verwijderen.

Extension GA
az ml datastore list

Gegevensarchieven weergeven in een werkruimte.

Extension GA
az ml datastore mount

Koppel een specifiek gegevensarchief aan een lokaal pad. Voorlopig wordt alleen Linux ondersteund.

Extension Preview
az ml datastore show

Details weergeven voor een gegevensarchief.

Extension GA
az ml datastore update

Een gegevensarchief bijwerken.

Extension GA

az ml datastore create

Maak een gegevensarchief.

Hiermee wordt de onderliggende Azure-opslagservice verbonden met de werkruimte. De opslagservicetypen waarmee momenteel kan worden verbonden door een gegevensarchief te maken, zijn Azure Blob Storage, Azure File Share, Azure Data Lake Storage Gen1 en Azure Data Lake Storage Gen2.

az ml datastore create --file
                       --resource-group
                       --workspace-name
                       [--name]
                       [--set]

Voorbeelden

Een gegevensarchief maken op basis van een YAML-specificatiebestand

az ml datastore create --file blobstore.yml --resource-group my-resource-group --workspace-name my-workspace

Vereiste parameters

--file -f

Lokaal pad naar het YAML-bestand met de Specificatie van het Azure ML-gegevensarchief. De YAML-referentiedocumenten voor het gegevensarchief vindt u op: https://aka.ms/ml-cli-v2-datastore-blob-yaml-reference, https://aka.ms/ml-cli-v2-datastore-file-yaml-reference, https://aka.ms/ml-cli-v2-datastore-data-lake-gen1-yaml-reference, https://aka.ms/ml-cli-v2-datastore-data-lake-gen2-yaml-reference.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Naam van het gegevensarchief. Hiermee overschrijft u het veld 'name' in het YAML-bestand dat is verstrekt aan --file/-f.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=value.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml datastore delete

Een gegevensarchief verwijderen.

Hiermee verwijdert u de verbindingsgegevens met de opslagservice uit de werkruimte, maar worden de onderliggende gegevens in de opslag niet verwijderd.

az ml datastore delete --name
                       --resource-group
                       --workspace-name

Vereiste parameters

--name -n

Naam van het gegevensarchief.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml datastore list

Gegevensarchieven weergeven in een werkruimte.

az ml datastore list --resource-group
                     --workspace-name
                     [--max-results]

Voorbeelden

Vermeld alle gegevensarchieven in een werkruimte met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

az ml datastore list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Vereiste parameters

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-results -r

Maximum aantal resultaten dat moet worden geretourneerd.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml datastore mount

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Koppel een specifiek gegevensarchief aan een lokaal pad. Voorlopig wordt alleen Linux ondersteund.

az ml datastore mount --path
                      [--mode]
                      [--mount-point]
                      [--persistent]
                      [--resource-group]
                      [--workspace-name]

Voorbeelden

Een gegevensarchief koppelen op naam

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path my-datastore

Een gegevensarchief koppelen aan een korte URL van het gegevensarchief

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path azureml://datastores/my-datastore

Een gegevensarchief koppelen aan een lange url van het gegevensarchief

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/providers/Microsoft.MachineLearningServices/workspaces/myworkspace/datastores/my-datastore

Vereiste parameters

--path

Het gegevensarchiefpad dat moet worden gekoppeld, in de vorm van <datastore_name> of azureml://datastores/<datastore_name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--mode

Koppelingsmodus, ro_mount (alleen-lezen) of rw_mount (lezen/schrijven).

Eigenschap Waarde
Default value: ro_mount
--mount-point

Een lokaal pad dat wordt gebruikt als koppelpunt.

Eigenschap Waarde
Default value: /home/azureuser/mount/data
--persistent

Maak de koppeling behouden tijdens het opnieuw opstarten. Alleen ondersteund voor het rekenproces.

Eigenschap Waarde
Default value: False
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml datastore show

Details weergeven voor een gegevensarchief.

az ml datastore show --name
                     --resource-group
                     --workspace-name

Vereiste parameters

--name -n

Naam van het gegevensarchief.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml datastore update

Een gegevensarchief bijwerken.

De eigenschappen 'description', 'tags' en 'credential' kunnen worden bijgewerkt.

az ml datastore update --resource-group
                       --workspace-name
                       [--add]
                       [--file]
                       [--force-string]
                       [--name]
                       [--remove]
                       [--set]

Vereiste parameters

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

Eigenschap Waarde
Parameter group: Generic Update Arguments
Default value: []
--file -f

Lokaal pad naar het YAML-bestand met de Specificatie van het Azure ML-gegevensarchief. De YAML-referentiedocumenten voor het gegevensarchief vindt u op: https://aka.ms/ml-cli-v2-datastore-blob-yaml-reference, https://aka.ms/ml-cli-v2-datastore-file-yaml-reference, https://aka.ms/ml-cli-v2-datastore-data-lake-gen1-yaml-reference, https://aka.ms/ml-cli-v2-datastore-data-lake-gen2-yaml-reference.

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

Eigenschap Waarde
Parameter group: Generic Update Arguments
Default value: False
--name -n

Naam van het gegevensarchief. Hiermee overschrijft u het veld 'name' in het YAML-bestand dat is verstrekt aan --file/-f.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

Eigenschap Waarde
Parameter group: Generic Update Arguments
Default value: []
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

Eigenschap Waarde
Parameter group: Generic Update Arguments
Default value: []
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Output format.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False