你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az ml feature-store

注意

此参考是 Azure CLI(版本 2.15.0 或更高版本)的 ml 扩展的一部分。 该扩展将在首次运行 az ml feature-store 命令时自动安装。 详细了解扩展。

管理 Azure ML 功能存储。

功能存储是功能的生命周期管理系统。 功能存储提供功能发现、为脱机工作负荷提供具体化(训练/批处理推理)、以低延迟要求提供联机推理,以及操作和功能质量监视。

命令

名称 说明 类型 状态
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 容器注册表、Azure 密钥库 和 Azure 应用程序 Insights。 通过在功能存储配置 YAML 文件中指定资源 ID,可以在创建功能存储时为这些功能存储使用现有的 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 ID。

--container-registry -c

与此工作区关联的容器注册表的 ARM ID。

--description

特征存储的说明。

--display-name

功能存储的显示名称。

--file -f

包含 Azure ML feature_store规范的 YAML 文件的本地路径。 可以在以下位置找到适用于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 容器注册表或 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ml feature-store delete

删除功能存储。

默认情况下,不会删除与功能存储关联的依赖资源(Azure 存储、Azure 容器注册表、Azure 密钥库、Azure 应用程序 Insights)。 若要同时删除这些资源,请包括 --all-resources。

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

必需参数

--name -n

功能存储的名称,可以使用 < a0/> 配置默认组 az configure --defaults feature-store=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--all-resources

删除与功能存储关联的所有依赖资源(Azure 存储帐户、Azure 容器注册表、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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

功能存储的名称,可以使用 < a0/> 配置默认组 az configure --defaults feature-store=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--include-spark

如果应预配托管网络以考虑 Spark 作业,则为布尔值 [true/false]。 如果未设置标志,则默认值为 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ml feature-store show

显示功能存储的详细信息。

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

必需参数

--name -n

功能存储的名称,可以使用 < a0/> 配置默认组 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

订阅的名称或 ID。 可以使用 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

功能存储的名称,可以使用 < a0/> 配置默认组 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 ID。

--container-registry -c

与此工作区关联的容器注册表的 ARM ID。

--description

特征存储的说明。

--display-name

功能存储的显示名称。

--file -f

包含 Azure ML feature_store规范的 YAML 文件的本地路径。 可以在以下位置找到适用于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 ID。

--public-network-access

启用工作区专用链接时允许公共终结点连接。

--remove

从列表中删除属性或元素。 示例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []
--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>

默认值: []
--update-dependent-resources -u

指定 --update_dependent_resources,同意更新工作区依赖资源。 更新工作区附加Azure 容器注册表或 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。