Delen via

az ml datastore

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de ml-extensie voor de Azure CLI (versie 2.15.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az ml datastore-opdracht uitvoert. Meer informatie over extensies.

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.

 Toestel GA
az ml datastore delete

Een gegevensarchief verwijderen.

 Toestel GA
az ml datastore list

Gegevensarchieven weergeven in een werkruimte.

 Toestel GA
az ml datastore mount

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

 Toestel Preview
az ml datastore show

Details weergeven voor een gegevensarchief.

 Toestel GA
az ml datastore update

Een gegevensarchief bijwerken.

 Toestel 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

De naam van de 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 behulp van az configure --defaults workspace=<name>.

Optionele parameters

--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=.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.

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

De naam van de 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 behulp van az configure --defaults workspace=<name>.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.

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

De naam van de 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 behulp van az configure --defaults workspace=<name>.

Optionele parameters

--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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.

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

--mode

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

standaardwaarde: ro_mount
--mount-point

Een lokaal pad dat wordt gebruikt als koppelpunt.

standaardwaarde: /home/azureuser/mount/data
--persistent

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

standaardwaarde: False
--resource-group -g

De naam van de 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 behulp van az configure --defaults workspace=<name>.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.

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

De naam van de 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 behulp van az configure --defaults workspace=<name>.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.

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

De naam van de 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 behulp van az configure --defaults workspace=<name>.

Optionele parameters

--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>.

standaardwaarde: []
--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.

standaardwaarde: 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.

standaardwaarde: []
--set

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

standaardwaarde: []
Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.