az ml datastore

  • Reference

Poznámka:

Tento odkaz je součástí rozšíření ml pro Azure CLI (verze 2.15.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az ml datastore . Přečtěte si další informace o rozšířeních.

Správa úložišť dat Azure ML

Úložiště dat Azure ML bezpečně propojí vaše služby úložiště Azure s pracovním prostorem, abyste měli přístup k úložišti, aniž byste museli pevně zakódovat informace o připojení do vašich skriptů. Tajné kódy připojení, jako jsou přihlašovací údaje pro ověřování služby úložiště, se ukládají ve službě Key Vault vašeho pracovního prostoru.

Při vytváření pracovního prostoru se účet Azure Storage automaticky vytvoří jako přidružený prostředek. V tomto účtu se vytvoří kontejner objektů blob a jeho informace o připojení se uloží jako úložiště dat s názvem workspaceblobstore. Slouží jako výchozí úložiště dat pracovního prostoru a kontejner objektů blob slouží k ukládání artefaktů pracovního prostoru a protokolů úloh strojového učení a výstupů.

Příkazy

Name Description Typ Stav
az ml datastore create

Vytvořte úložiště dat.

 Rozšíření GA
az ml datastore delete

Odstranění úložiště dat

 Rozšíření GA
az ml datastore list

Výpis úložišť dat v pracovním prostoru

 Rozšíření GA
az ml datastore mount

Připojte konkrétní úložiště dat k místní cestě. Pro tuto chvíli se podporuje jenom Linux.

 Rozšíření Preview
az ml datastore show

Zobrazí podrobnosti o úložišti dat.

 Rozšíření GA
az ml datastore update

Aktualizujte úložiště dat.

 Rozšíření GA

az ml datastore create

Vytvořte úložiště dat.

Tím se připojí podkladová služba Azure Storage k pracovnímu prostoru. Mezi typy služeb úložiště, ke kterým je v současné době možné připojit vytvořením úložiště dat, patří Azure Blob Storage, Sdílená složka Azure, Azure Data Lake Storage Gen1 a Azure Data Lake Storage Gen2.

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

Příklady

Vytvoření úložiště dat ze souboru specifikace YAML

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

Povinné parametry

--file -f

Místní cesta k souboru YAML obsahujícímu specifikaci úložiště dat Azure ML. Referenční dokumenty YAML pro úložiště dat najdete na adrese: 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

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--name -n

Název úložiště dat. Tím se přepíše pole name v souboru YAML poskytnutém souboru --file/-f.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml datastore delete

Odstranění úložiště dat

Tím se odstraní informace o připojení ke službě úložiště z pracovního prostoru, ale neodstraní se podkladová data v úložišti.

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

Povinné parametry

--name -n

Název úložiště dat.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml datastore list

Výpis úložišť dat v pracovním prostoru

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

Příklady

Zobrazí seznam všech úložišť dat v pracovním prostoru pomocí argumentu --query ke spuštění dotazu JMESPath na výsledky příkazů.

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

Povinné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--max-results -r

Maximální počet výsledků, které se mají vrátit.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml datastore mount

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Připojte konkrétní úložiště dat k místní cestě. Pro tuto chvíli se podporuje jenom Linux.

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

Příklady

Připojení úložiště dat podle názvu

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

Připojení úložiště dat pomocí adresy URL krátkého formuláře úložiště dat

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

Připojení úložiště dat pomocí dlouhé adresy URL úložiště dat

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

Povinné parametry

--path

Cesta úložiště dat, která se má připojit, ve formě <datastore_name> nebo azureml://datastores/<datastore_name>.

Volitelné parametry

--mode

Režim připojení ( ro_mount jen pro čtení) nebo rw_mount (pro čtení i zápis).

výchozí hodnota: ro_mount
--mount-point

Místní cesta použitá jako přípojný bod.

výchozí hodnota: /home/azureuser/mount/data
--persistent

Zachovají se připojení napříč restartováními. Podporuje se pouze u výpočetní instance.

výchozí hodnota: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml datastore show

Zobrazí podrobnosti o úložišti dat.

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

Povinné parametry

--name -n

Název úložiště dat.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml datastore update

Aktualizujte úložiště dat.

Vlastnosti description, tags a credential je možné aktualizovat.

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

Povinné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

výchozí hodnota: []
--file -f

Místní cesta k souboru YAML obsahujícímu specifikaci úložiště dat Azure ML. Referenční dokumenty YAML pro úložiště dat najdete na adrese: 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

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

výchozí hodnota: False
--name -n

Název úložiště dat. Tím se přepíše pole name v souboru YAML poskytnutém souboru --file/-f.

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

výchozí hodnota: []
--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

výchozí hodnota: []
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.