您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az ml data

备注

此引用是适用于 Azure CLI 的 ml 扩展的一部分,需要2.15.0 或更高版本。 首次运行 az ml data 命令时,扩展将自动安装。 详细了解扩展。

管理 Azure ML 数据资产。

Azure ML 数据资产是对存储服务或公共 url 中的文件 () 的引用以及任何相应的元数据。 它们不是你的数据的副本。 您可以使用这些数据资产来访问模型定型过程中的相关数据,并将引用的数据装载或下载到您的计算目标。

命令

az ml data create

创建数据资产。

az ml data delete

删除数据资产。

az ml data list

列出工作区中的数据资产。

az ml data show

显示数据资产的详细信息。

az ml data update

更新数据资产。

az ml data create

创建数据资产。

可以从本地计算机上的文件或云存储中的文件引用来定义数据资产。 将在工作区中按指定的名称和版本跟踪创建的数据资产。

若要从本地计算机上的文件 () 创建数据资产,请在 YAML config 中指定 "local_path" 字段。Azure ML 会将这些文件 (s) 上载到 blob 容器,该容器将 (名为 "workspaceblobstore ) " 的工作区默认数据存储。 然后,所创建的数据资产将指向已上传的数据。

若要创建引用云存储中的文件 () 的数据资产,请在 YAML config 中指定存储服务与存储中 () 的 "数据存储"。

还可以直接从存储 URL 或公共 URL 创建数据资产。 为此,请在 YAML config 中指定 "path" 字段的 URL。

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

示例

从 YAML 规范文件创建数据资产

az ml data create --file data.yml --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-name -z

要将数据上传到的数据存储的名称。

--file -f

包含 Azure ML 数据规范的 YAML 文件的本地路径。

--name -n

数据资产的名称。

--set

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

--version -v

数据资产的版本。

az ml data delete

删除数据资产。

az ml data delete --name
                  --resource-group
                  --version
                  --workspace-name

必需参数

--name -n

数据资产的名称。

--resource-group -g

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

--version -v

数据资产的版本。

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

az ml data list

列出工作区中的数据资产。

az ml data list --resource-group
                --workspace-name
                [--max-pages]
                [--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> 配置默认组。

可选参数

--max-pages -r

要返回的结果的页数。 默认值为返回 all。

--name -n

数据资产的名称。 如果提供,将返回此名称下的所有数据版本。

az ml data show

显示数据资产的详细信息。

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

示例

显示具有指定名称和版本的数据资产的详细信息

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

显示具有指定名称的最新版本的数据资产的详细信息

az ml data show --name my-data --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> 配置默认组。

可选参数

--version -v

数据资产的版本。 如果省略,则显示最新版本。

az ml data update

更新数据资产。

只有 "description" 和 "tags" 属性可以更新。

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

必需参数

--resource-group -g

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

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

可选参数

--add

通过指定路径和键值对,将对象添加到对象列表中。 示例:--添加 listProperty <键 = 值、字符串或 JSON 字符串>。

--force-string

使用 "set" 或 "add" 时,保留字符串文本,而不是尝试转换为 JSON。

--name -n

数据资产的名称。

--remove

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

--set

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

--version -v

数据资产的版本。