az ml data
Not
Den här referensen är en del av ml-tillägget för Azure CLI (version 2.15.0 eller senare). Tillägget installeras automatiskt första gången du kör ett kommandot az ml data. Läs mer om tillägg.
Hantera Azure ML-datatillgångar.
Azure ML-datatillgångar är referenser till filer i dina lagringstjänster eller offentliga URL:er tillsammans med motsvarande metadata. De är inte kopior av dina data. Du kan använda dessa datatillgångar för att komma åt relevanta data under modellträningen och montera eller ladda ned refererade data till beräkningsmålet.
Kommandon
Name | Description | Typ | Status |
---|---|---|---|
az ml data archive |
Arkivera en datatillgång. |
Förlängning | GA |
az ml data create |
Skapa en datatillgång i en arbetsyta/ett register. Om du använder ett register ersätter du |
Förlängning | GA |
az ml data import |
Importera data och skapa en datatillgång. |
Förlängning | Förhandsvisning |
az ml data list |
Visa en lista över datatillgångar i en arbetsyta/ett register. Om du använder ett register ersätter du |
Förlängning | GA |
az ml data list-materialization-status |
Visa status för listan över dataimportmaterialiseringsjobb som skapar versioner av en datatillgång. |
Förlängning | Förhandsvisning |
az ml data mount |
Montera en specifik datatillgång på en lokal sökväg. För tillfället stöds endast Linux. |
Förlängning | Förhandsvisning |
az ml data restore |
Återställa en arkiverad datatillgång. |
Förlängning | GA |
az ml data share |
Dela en specifik datatillgång från arbetsyta till register. |
Förlängning | Förhandsvisning |
az ml data show |
Visar information om en datatillgång i en arbetsyta/ett register. Om du använder ett register ersätter du |
Förlängning | GA |
az ml data update |
Uppdatera en datatillgång. |
Förlängning | GA |
az ml data archive
Arkivera en datatillgång.
Om du arkiverar en datatillgång döljs den som standard från listfrågor (az ml data list
). Du kan fortfarande fortsätta att referera till och använda en arkiverad datatillgång i dina arbetsflöden. Du kan arkivera antingen en datatillgångscontainer eller en specifik datatillgångsversion. Om du arkiverar en datatillgångscontainer arkiveras alla versioner av datatillgången under det förnamnet. Du kan återställa en arkiverad datatillgång med hjälp av az ml data restore
. Om hela datatillgångscontainern arkiveras kan du inte återställa enskilda versioner av datatillgången – du måste återställa datatillgångscontainern.
az ml data archive --name
[--label]
[--resource-group]
[--version]
[--workspace-name]
Exempel
Arkivera en datatillgångscontainer (arkiverar alla versioner av den datatillgången)
az ml data archive --name my-env --resource-group my-resource-group --workspace-name my-workspace
Arkivera en specifik datatillgångsversion
az ml data archive --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace
Obligatoriska parametrar
Namnet på datatillgången.
Valfria parametrar
Datatillgångens etikett. Ömsesidigt uteslutande med version.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Version av datatillgången. Ömsesidigt uteslutande med etikett.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data create
Skapa en datatillgång i en arbetsyta/ett register. Om du använder ett register ersätter du --workspace-name my-workspace
med alternativet --registry-name <registry-name>
.
Datatillgångar kan definieras från filer på den lokala datorn eller som referenser till filer i molnlagring. Den skapade datatillgången spåras i arbetsytan/registret under det angivna namnet och versionen.
Om du vill skapa en datatillgång från filer på den lokala datorn anger du fältet "sökväg" i YAML-konfigurationen. Azure ML laddar upp dessa filer till blobcontainern som säkerhetskopierar arbetsytans standarddatalager (med namnet "workspaceblobstore"). Den skapade datatillgången pekar sedan på den uppladdade datan.
Om du vill skapa en datatillgång som refererar till filer i molnlagring anger du sökvägen till filerna i lagringen i YAML-konfigurationen.
Du kan också skapa en datatillgång direkt från en lagrings-URL eller en offentlig URL. Om du vill göra det anger du URL:en till fältet "sökväg" i yaml-konfigurationen. Om du använder ett register ersätter du --workspace-name my-workspace
med alternativet --registry-name <my-registry-name>
.
az ml data create [--datastore]
[--description]
[--file]
[--name]
[--no-wait]
[--path]
[--registry-name]
[--resource-group]
[--set]
[--skip-validation]
[--type {mltable, uri_file, uri_folder}]
[--version]
[--workspace-name]
Exempel
Skapa en datatillgång från en YAML-specifikationsfil på en arbetsyta
az ml data create --file data.yml --resource-group my-resource-group --workspace-name my-workspace
Skapa en datatillgång från en YAML-specifikationsfil i ett register
az ml data create --file data.yml --registry-name my-registry-name
Skapa en datatillgång utan att använda en YAML-specifikationsfil på en arbetsyta
az ml data create --name my-data --version 1 --path ./my-data.csv --resource-group my-resource-group --workspace-name my-workspace
Skapa en datatillgång utan att använda en YAML-specifikationsfil i ett register
az ml data create --name my-data --version 1 --path ./my-data.csv --registry-name my-registry-name
Valfria parametrar
Det datalager som den lokala artefakten ska laddas upp till.
Beskrivning av datatillgången.
Lokal sökväg till YAML-filen som innehåller Azure ML-dataspecifikationen. YAML-referensdokumenten för data finns på: https://aka.ms/ml-cli-v2-data-yaml-reference.
Namnet på datatillgången. Krävs om --registry-name anges.
Vänta inte tills den tidskrävande åtgärden har slutförts. Standardvärdet är Falskt.
Sökvägen till datatillgången kan vara lokal eller fjärransluten.
Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta. Måste anges om --workspace-name och --resource-group inte har angetts.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=value.
Hoppa över validering av MLTable-metadata när typen är MLTable.
Typ av datatillgång.
Version av datatillgången. Krävs om --registry-name anges.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data import
Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Importera data och skapa en datatillgång.
Datatillgången kan skapas genom att först importera data från databas eller filsystem till molnlagring. Den skapade datatillgången spåras på arbetsytan under det angivna namnet och versionen.
Ange "fråga" för databastabellen eller "sökvägen" i filsystemfälten i yaml-konfigurationen. Azure ML kör ett jobb för att kopiera data till molnlagring först .
az ml data import --resource-group
--workspace-name
[--datastore]
[--description]
[--file]
[--name]
[--path]
[--set]
[--skip-validation]
[--type {mltable, uri_file, uri_folder}]
[--version]
Exempel
Importera en datatillgång från en YAML-specifikationsfil
az ml data import --file dataimport.yml --resource-group my-resource-group --workspace-name my-workspace
Obligatoriska parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Valfria parametrar
Det datalager som den lokala artefakten ska laddas upp till.
Beskrivning av datatillgången.
Lokal sökväg till YAML-filen som innehåller Azure ML-dataspecifikationen. YAML-referensdokumenten för data finns på: https://aka.ms/ml-cli-v2-data-yaml-reference.
Namnet på datatillgången.
Sökväg till datatillgången i molnlagringen.
Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=value.
Hoppa över valideringen av beräkningsresursen som refereras till av det underliggande dataimportmaterialiseringsjobbet.
Typ av datatillgång.
Version av datatillgången.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data list
Visa en lista över datatillgångar i en arbetsyta/ett register. Om du använder ett register ersätter du --workspace-name my-workspace
med alternativet --registry-name <registry-name>
.
az ml data list [--archived-only]
[--include-archived]
[--max-results]
[--name]
[--registry-name]
[--resource-group]
[--workspace-name]
Exempel
Visa en lista över alla datatillgångar på en arbetsyta
az ml data list --resource-group my-resource-group --workspace-name my-workspace
Visa en lista över alla datatillgångsversioner för det angivna namnet på en arbetsyta
az ml data list --name my-data --resource-group my-resource-group --workspace-name my-workspace
Visa en lista över alla datatillgångar i en arbetsyta med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.
az ml data list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
Visa en lista över alla datatillgångar i ett register
az ml data list --registry-name my-registry-name
Visa en lista över alla datatillgångsversioner för det angivna namnet i ett register
az ml data list --name my-data --registry-name my-registry-name
Valfria parametrar
Lista endast arkiverade datatillgångar.
Visa en lista över arkiverade datatillgångar och aktiva datatillgångar.
Maximalt antal resultat som ska returneras.
Namnet på datatillgången. Om detta anges returneras alla dataversioner under det här namnet.
Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta. Måste anges om --workspace-name och --resource-group inte har angetts.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data list-materialization-status
Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Visa status för listan över dataimportmaterialiseringsjobb som skapar versioner av en datatillgång.
az ml data list-materialization-status --resource-group
--workspace-name
[--all-results {false, true}]
[--archived-only]
[--include-archived]
[--max-results]
[--name]
Exempel
Visa materialiseringsstatus för en datatillgång från en YAML-specifikationsfil
az ml data list-materialization-status --name asset-name --resource-group my-resource-group --workspace-name my-workspace
Obligatoriska parametrar
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Valfria parametrar
Returnerar alla resultat.
Lista endast arkiverade jobb.
Lista arkiverade jobb och aktiva jobb.
Maximalt antal resultat som ska returneras. Standardvärdet är 50.
Namnet på tillgången. Visar en lista över alla materialiseringsjobb som skapar versioner av tillgången som matchar det angivna namnet.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data mount
Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Montera en specifik datatillgång på en lokal sökväg. För tillfället stöds endast Linux.
az ml data mount --path
[--mode]
[--mount-point]
[--persistent]
[--resource-group]
[--workspace-name]
Exempel
Montera en datatillgångsversion med namngiven tillgångs-URI
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml:my_urifolder:1
Montera en datatillgångsversion med fullständig URI för AzureML
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/workspaces/myworkspace/data/some_data/versions/5
Montera alla versioner av en datatillgång med namngiven tillgångs-URI
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml:my_urifolder
Montera alla versioner av en datatillgång med Fullständig URI för AzureML
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/workspaces/myworkspace/data/some_data
Montera data på en offentlig HTTP-server efter URL
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path https://raw.githubusercontent.com/pandas-dev/pandas/main/doc/data/titanic.csv
Montera data på Azure efter Azure Blob Storage-URL
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path https://<account_name>.blob.core.windows.net/<container_name>/<path>
Montera data på Azure från Azure Data Lake Storage Gen 2 URL
az ml data mount --mount-point /mnt/my-data --mode ro_mount --path abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>
Obligatoriska parametrar
Datatillgångssökvägen som ska monteras i form av azureml:<name>
eller azureml:<name>:<version>
.
Valfria parametrar
Monteringsläge. Endast ro_mount
(skrivskyddad) stöds för montering av datatillgång.
En lokal sökväg som används som monteringspunkt.
Gör monteringen bestående mellan omstarter. Stöds endast på beräkningsinstansen.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data restore
Återställa en arkiverad datatillgång.
När en arkiverad datatillgång återställs döljs den inte längre från listfrågor (az ml data list
). Om en hel datatillgångscontainer arkiveras kan du återställa den arkiverade containern. Då återställs alla versioner av datatillgången under det angivna namnet. Du kan inte bara återställa en specifik datatillgångsversion om hela datatillgångscontainern arkiveras – du måste återställa hela containern. Om endast en enskild datatillgångsversion arkiverades kan du återställa den specifika versionen.
az ml data restore --name
[--label]
[--resource-group]
[--version]
[--workspace-name]
Exempel
Återställa en arkiverad datatillgångscontainer (återställer alla versioner av den datatillgången)
az ml data restore --name my-env --resource-group my-resource-group --workspace-name my-workspace
Återställa en specifik arkiverad datatillgångsversion
az ml data restore --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace
Obligatoriska parametrar
Namnet på datatillgången.
Valfria parametrar
Datatillgångens etikett. Ömsesidigt uteslutande med version.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Version av datatillgången. Ömsesidigt uteslutande med etikett.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data share
Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Dela en specifik datatillgång från arbetsyta till register.
Kopiera en befintlig datatillgång från en arbetsyta till ett register för återanvändning mellan arbetsytor.
az ml data share --name
--registry-name
--resource-group
--share-with-name
--share-with-version
--version
--workspace-name
Exempel
Dela en befintlig datatillgång från arbetsyta till register
az ml data share --name my-data --version my-version --resource-group my-resource-group --workspace-name my-workspace --share-with-name new-name-in-registry --share-with-version new-version-in-registry --registry-name my-registry
Obligatoriska parametrar
Namnet på datatillgången.
Målregister.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Namnet på den datatillgång som ska skapas med.
Version av datatillgången som ska skapas med.
Version av datatillgången.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data show
Visar information om en datatillgång i en arbetsyta/ett register. Om du använder ett register ersätter du --workspace-name my-workspace
med alternativet --registry-name <registry-name>
.
az ml data show --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Exempel
Visa information om en datatillgång med det angivna namnet och versionen på en arbetsyta
az ml data show --name my-data --version 1 --resource-group my-resource-group --workspace-name my-workspace
Visa information om en datatillgång med det angivna namnet och etiketten
az ml data show --name my-data --label latest --resource-group my-resource-group --workspace-name my-workspace
Visa information om en datatillgång med det angivna namnet och versionen i ett register
az ml data show --name my-data --version 1 --registry-name my-registry-name
Obligatoriska parametrar
Namnet på datatillgången.
Valfria parametrar
Datatillgångens etikett. Måste anges om versionen inte har angetts. Ömsesidigt uteslutande med version.
Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta. Måste anges om --workspace-name och --resource-group inte har angetts.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Version av datatillgången. Måste anges om etiketten inte har angetts. Ömsesidigt uteslutande med etikett.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az ml data update
Uppdatera en datatillgång.
Endast egenskaperna "description" och "tags" kan uppdateras.
az ml data update --name
--resource-group
--workspace-name
[--add]
[--force-string]
[--label]
[--registry-name]
[--remove]
[--set]
[--version]
Obligatoriska parametrar
Namnet på datatillgången.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>
.
Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>
.
Valfria parametrar
Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>
.
När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.
Datatillgångens etikett. Måste anges om versionen inte har angetts. Ömsesidigt uteslutande med version.
Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta. Måste anges om --workspace-name och --resource-group inte har angetts.
Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove>
ELLER --remove propertyToRemove
.
Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>
.
Version av datatillgången. Måste anges om etiketten inte har angetts. Ömsesidigt uteslutande med etikett.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.