az ml data

注意

此參考是 Azure CLI (2.15.0 版或更高版本) ml 延伸模組 的一部分。 當您第一次執行 az ml data 命令時,擴充功能會自動安裝。 深入了解延伸模組。

管理 Azure ML 資料資產。

Azure ML 資料資產是儲存體服務或公用 URL 中檔案 () 的參考,以及任何對應的中繼資料。 它們不是您的資料複本。 您可以使用這些資料資產在模型定型和掛接期間存取相關資料,或將參考的資料下載至計算目標。

命令

az ml data archive

封存資料資產。

az ml data create

建立資料資產。

az ml data list

列出工作區中的資料資產。

az ml data restore

還原封存的資料資產。

az ml data show

顯示資料資產的詳細資料。

az ml data update

更新資料資產。

az ml data archive

封存資料資產。

根據預設,封存資料資產會隱藏 () az ml data list 清單查詢。 您仍然可以在工作流程中繼續參考和使用封存的資料資產。 您可以封存資料資產容器或特定資料資產版本。 封存資料資產容器會將該指定名稱下的所有資料資產版本封存。 您可以使用 還原封存的資料資產 az ml data restore 。 如果封存整個資料資產容器,您就無法還原資料資產的個別版本- 您必須還原資料資產容器。

az ml data archive --name
                   --resource-group
                   --workspace-name
                   [--label]
                   [--version]

範例

封存資料資產容器 (封存該資料資產的所有版本)

az ml data archive --name my-env --resource-group my-resource-group --workspace-name my-workspace

封存特定資料資產版本

az ml data archive --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

必要參數

--name -n

資料資產的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 az configure --defaults workspace=<name> 來設定預設群組。

選擇性參數

--label -l

資料資產的標籤。

--version -v

資料資產的版本。

az ml data create

建立資料資產。

您可以從本機電腦上的檔案或雲端儲存體中的檔案參考來定義資料資產。 所建立的資料資產將會在工作區的指定名稱和版本下追蹤。

若要在本機電腦上從檔案 () 建立資料資產,請在 YAML 組態中指定 [路徑] 欄位。Azure ML 會將這些檔案 () 上傳至備份工作區預設資料存放區的 Blob 容器, (名為 'workspaceblobstore') 。 建立的資料資產接著會指向該上傳的資料。

若要建立參考雲端儲存體中檔案 () 的資料資產,請在 YAML 組態的儲存體中指定檔案 () 的「路徑」。

您也可以直接從儲存體 URL 或公用 URL 建立資料資產。 若要這樣做,請在 YAML 組態中指定 'path' 欄位的 URL。

az ml data create --resource-group
                  --workspace-name
                  [--datastore]
                  [--description]
                  [--file]
                  [--name]
                  [--path]
                  [--set]
                  [--skip-validation]
                  [--type {mltable, uri_file, uri_folder}]
                  [--version]

範例

從 YAML 規格檔案建立資料資產

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

不使用 YAML 規格檔案建立資料資產

az ml data create --name my-data --version 1 --path ./my-data.csv --resource-group my-resource-group --workspace-name my-workspace

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 az configure --defaults workspace=<name> 來設定預設群組。

選擇性參數

--datastore

要上傳本機成品的資料存放區。

--description -d

資料資產的描述。

--file -f

包含 Azure ML 資料規格之 YAML 檔案的本機路徑。 如需資料的 YAML 參考檔,請參閱: https://aka.ms/ml-cli-v2-data-yaml-reference

--name -n

資料資產的名稱。

--path -p

資料資產的路徑可以是本機或遠端。

--set

指定要設定的屬性路徑和值來更新物件。 範例:--set property1.property2=。

--skip-validation

當類型為 MLTable 時,請略過 MLTable 中繼資料的驗證。

--type -t

資料資產的類型。

接受的值: mltable, uri_file, uri_folder
--version -v

資料資產的版本。

az ml data list

列出工作區中的資料資產。

az ml data list --resource-group
                --workspace-name
                [--archived-only]
                [--include-archived]
                [--max-results]
                [--name]

範例

列出工作區中的所有資料資產

az ml data list --resource-group my-resource-group --workspace-name my-workspace

列出工作區中指定名稱的所有資料資產版本

az ml data list --name my-data --resource-group my-resource-group --workspace-name my-workspace

使用 --query 引數來列出工作區中的所有資料資產,以在命令的結果上執行 JMESPath 查詢。

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

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 az configure --defaults workspace=<name> 來設定預設群組。

選擇性參數

--archived-only

僅列出封存的資料資產。

--include-archived

列出封存的資料資產和作用中資料資產。

--max-results -r

要傳回的結果數目上限。

--name -n

資料資產的名稱。 如果提供,則會傳回此名稱下的所有資料版本。

az ml data restore

還原封存的資料資產。

還原封存的資料資產時,不會再從清單查詢 () az ml data list 隱藏。 如果封存整個資料資產容器,您可以還原該封存的容器。 這會還原該指定名稱下的所有資料資產版本。 如果整個資料資產容器已封存,您就不能只還原特定的資料資產版本- 您必須還原整個容器。 如果只有個別的資料資產版本已封存,您可以還原該特定版本。

az ml data restore --name
                   --resource-group
                   --workspace-name
                   [--label]
                   [--version]

範例

還原封存的資料資產容器 (還原該資料資產的所有版本)

az ml data restore --name my-env --resource-group my-resource-group --workspace-name my-workspace

還原特定的封存資料資產版本

az ml data restore --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

必要參數

--name -n

資料資產的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 az configure --defaults workspace=<name> 來設定預設群組。

選擇性參數

--label -l

資料資產的標籤。

--version -v

資料資產的版本。

az ml data show

顯示資料資產的詳細資料。

az ml data show --name
                --resource-group
                --workspace-name
                [--label]
                [--version]

範例

顯示具有指定名稱和版本的資料資產詳細資料

az ml data show --name my-data --version 1 --resource-group my-resource-group --workspace-name my-workspace

必要參數

--name -n

資料資產的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 az configure --defaults workspace=<name> 來設定預設群組。

選擇性參數

--label -l

資料資產的標籤。

--version -v

資料資產的版本。

az ml data update

更新資料資產。

只能更新 'description' 和 'tags' 屬性。

az ml data update --name
                  --resource-group
                  --version
                  --workspace-name
                  [--add]
                  [--force-string]
                  [--label]
                  [--remove]
                  [--set]

必要參數

--name -n

資料資產的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--version -v

資料資產的版本。

--workspace-name -w

Azure ML 工作區的名稱。 您可以使用 az configure --defaults workspace=<name> 來設定預設群組。

選擇性參數

--add

藉由指定路徑和索引鍵值組,將 物件新增至物件清單。 範例:--add property.listProperty < key=value、string 或 JSON 字串 > 。

--force-string

使用 'set' 或 'add' 時,請保留字元串常值,而不是嘗試轉換成 JSON。

--label -l

資料資產的標籤。

--remove

從清單中移除屬性或專案。 範例:--remove property.list OR --remove propertyToRemove。

--set

指定要設定的屬性路徑和值來更新物件。 範例:--set property1.property2=。