共用方式為

az ml feature-store

  • 參考

注意

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

管理 Azure ML 功能存放區。

功能存放區是功能的生命週期管理系統。 功能存放區提供功能探索、具體化服務離線工作負載（定型/批次推斷）、以低延遲需求提供在線推斷，以及操作和功能質量監視。

命令

名稱 Description 類型 狀態
az ml feature-store create

建立功能存放區。

 副檔名 GA
az ml feature-store delete

刪除功能存放區。

 副檔名 GA
az ml feature-store list

列出訂用帳戶中的所有功能存放區。

 副檔名 GA
az ml feature-store provision-network

布建受控網路。

 副檔名 GA
az ml feature-store show

顯示功能存放區的詳細數據。

 副檔名 GA
az ml feature-store update

更新功能存放區。

 副檔名 GA

az ml feature-store create

建立功能存放區。

建立功能存放區時，Azure ML 將使用的數個 Azure 資源預設也會建立：Azure 儲存體、Azure Container Registry、Azure 金鑰保存庫，以及 Azure 應用程式 Insights。 您可以在功能存放區組態 YAML 檔案中指定資源識別符，來改用現有 Azure 資源實例來建立功能存放區。

az ml feature-store create --resource-group
                           [--application-insights]
                           [--container-registry]
                           [--description]
                           [--display-name]
                           [--file]
                           [--image-build-compute]
                           [--location]
                           [--managed-network]
                           [--materialization-identity]
                           [--name]
                           [--no-wait]
                           [--not-grant-permissions]
                           [--offline-store]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--set]
                           [--tags]
                           [--update-dependent-resources]

範例

從 YAML 規格檔案建立功能存放區。

az ml feature-store create --file feature-store.yml --resource-group my-resource-group

必要參數

--resource-group -g

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

選擇性參數

--application-insights -a

與此工作區相關聯的 Application Insights ARM 識別碼。

--container-registry -c

與此工作區相關聯的容器登錄ARM標識碼。

--description

功能存放區的描述。

--display-name

功能存放區的顯示名稱。

--file -f

YAML 檔案的本機路徑，其中包含 Azure ML feature_store規格。 如需feature_store的 YAML 參考檔，請參閱： https://aka.ms/ml-cli-v2-featurestore-yaml-reference。

--image-build-compute -i

容器登錄位於 VNet 後方時，用來建置環境 Docker 映射的計算目標名稱。

--location -l

要用於新功能存放區的位置。

--managed-network -m

工作區的受控網路隔離模式。

--materialization-identity -t

用於離線/在線商店連線的身分識別。

--name -n

功能存放區的名稱。

--no-wait

請勿等候功能存放區建立完成。

預設值: False
--not-grant-permissions

指定 --not-grant-permissions，不要將具體識別許可權授與功能存放區（工作區、離線市集和在線商店）。 預設值是 False。

預設值: False
--offline-store

功能存放區離線存放區設定。需要具體化身分識別，才能設定脫機存放區。

--primary-user-assigned-identity -p

指定多個受控識別時，主要使用者指派受控識別的 ARM 識別碼。 此外，適用於無叢集計算的預設受控識別。

--public-network-access

啟用工作區私人連結時，允許公用端點連線。

--set

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

--tags

對象標記的空間分隔索引鍵/值組。

--update-dependent-resources -u

指定 --update_dependent_resources，表示您同意更新功能存放區相依資源。 更新工作區連結的 Azure Container Registry 或 Application Insights 資源可能會中斷先前作業的譜系、已部署的推斷端點，或重新執行此功能存放區中先前作業的能力。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml feature-store delete

刪除功能存放區。

根據預設，不會刪除與功能存放區相關聯的相依資源（Azure 儲存體、Azure Container Registry、Azure 金鑰保存庫、Azure 應用程式 Insights）。 若要同時刪除這些專案，請包含 --all-resources。

az ml feature-store delete --name
                           --resource-group
                           [--all-resources]
                           [--no-wait]
                           [--yes]

必要參數

--name -n

功能存放區的名稱 您可以使用 來設定預設群組 az configure --defaults feature-store=<name>。

--resource-group -g

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

選擇性參數

--all-resources

刪除與功能存放區相關聯的所有相依資源（Azure 儲存體 帳戶、Azure Container Registry、Azure 應用程式 Insights、Azure 金鑰保存庫）。

預設值: False
--no-wait

請勿等候長時間執行的作業完成。 預設值是 False。

預設值: False
--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml feature-store list

列出訂用帳戶中的所有功能存放區。

功能存放區清單可以依資源群組進行篩選。

az ml feature-store list [--max-results]
                         [--resource-group]

範例

列出資源群組中的所有功能存放區

az ml feature-store list --resource-group my-resource-group

使用 --query 自變數列出所有功能存放區，以在命令的結果上執行 JMESPath 查詢。

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

選擇性參數

--max-results -r

要傳回的結果數目上限。

--resource-group -g

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

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml feature-store provision-network

布建受控網路。

觸發功能存放區來布建受控網路。 指定已啟用Spark的旗標，會準備工作區受控網路以支援Spark。 如果未指定，預設值為 false，但稍後可以使用這個旗標再次執行此命令來啟用。 一旦啟用，就無法停用。

az ml feature-store provision-network --name
                                      --resource-group
                                      [--include-spark]
                                      [--no-wait]

範例

布建受控網路。

az ml feature-store provision-network --resource-group my-resource-group --name my-feature-store-name

必要參數

--name -n

功能存放區的名稱 您可以使用 來設定預設群組 az configure --defaults feature-store=<name>。

--resource-group -g

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

選擇性參數

--include-spark

布爾值 [true/false] 適用於是否應該布建受控網路以考慮Spark作業。 如果未設定旗標，則預設值為 false。 稍後可以使用這個旗標再次執行此命令來啟用它。

預設值: False
--no-wait

請勿等候長時間執行的作業完成。 預設值是 False。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml feature-store show

顯示功能存放區的詳細數據。

az ml feature-store show --name
                         --resource-group

必要參數

--name -n

功能存放區的名稱 您可以使用 來設定預設群組 az configure --defaults feature-store=<name>。

--resource-group -g

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

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml feature-store update

更新功能存放區。

可以更新 'description'、'tags'、'friendly_name' 和 materialization_identity 屬性。

az ml feature-store update --name
                           --resource-group
                           [--add]
                           [--application-insights]
                           [--container-registry]
                           [--description]
                           [--display-name]
                           [--file]
                           [--force-string]
                           [--image-build-compute]
                           [--managed-network]
                           [--materialization-identity]
                           [--no-wait]
                           [--not-grant-permissions]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--remove]
                           [--set]
                           [--update-dependent-resources]

範例

從 YAML 規格檔案更新功能存放區。

az ml feature-store update --resource-group my-resource-group --name my-feature-store-name --file feature-store.yml

必要參數

--name -n

功能存放區的名稱 您可以使用 來設定預設群組 az configure --defaults feature-store=<name>。

--resource-group -g

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

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []
--application-insights -a

與此工作區相關聯的 Application Insights ARM 識別碼。

--container-registry -c

與此工作區相關聯的容器登錄ARM標識碼。

--description

功能存放區的描述。

--display-name

功能存放區的顯示名稱。

--file -f

YAML 檔案的本機路徑，其中包含 Azure ML feature_store規格。 如需feature_store的 YAML 參考檔，請參閱： https://aka.ms/ml-cli-v2-featurestore-yaml-reference。

--force-string

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

預設值: False
--image-build-compute -i

容器登錄位於 VNet 後方時，用來建置環境 Docker 映射的計算目標名稱。

--managed-network -m

工作區的受控網路隔離模式。

--materialization-identity -t

用於離線/在線商店連線的身分識別。

--no-wait

請勿等候長時間執行的作業完成。 預設值是 False。

預設值: False
--not-grant-permissions

指定 --not-grant-permissions，不要將具體識別許可權授與功能存放區（工作區、離線市集和在線商店）。 預設值是 False。

預設值: False
--primary-user-assigned-identity -p

與此工作區相關聯的主要使用者指派身分識別的 ARM 識別碼。

--public-network-access

啟用工作區私人連結時，允許公用端點連線。

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []
--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []
--update-dependent-resources -u

指定 --update_dependent_resources，表示您同意更新工作區相依資源。 更新工作區連結的 Azure Container Registry 或 Application Insights 資源可能會中斷先前作業的譜系、已部署的推斷端點，或您在此工作區中重新執行先前作業的能力。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。