CLI (v2) Azure Data Lake Gen2 YAML 架构
源 JSON 架构可在此资源中找到。
注意
本文档中详细介绍的 YAML 语法基于最新版本的 ML CLI v2 扩展的 JSON 架构。 此语法必定仅适用于最新版本的 ML CLI v2 扩展。 可以在 https://azuremlschemasprod.azureedge.net/ 上查找早期扩展版本的架构。
YAML 语法
| 密钥 | 类型 | 说明 | 允许的值 | 默认值 |
|---|---|---|---|---|
$schema |
字符串 | YAML 架构。 如果使用 Azure 机器学习 Visual Studio Code 扩展创作 YAML 文件，则可以通过在文件顶部包含 $schema 来调用架构和资源完成。 |
||
type |
字符串 | 必需。 数据存储类型。 | azure_data_lake_gen2 |
|
name |
字符串 | 必需。 数据存储名称。 | ||
description |
字符串 | 数据存储说明。 | ||
tags |
object | 数据存储标记字典。 | ||
account_name |
字符串 | 必需。 Azure 存储帐户名称。 | ||
filesystem |
字符串 | 必需。 文件系统名称。 包含文件和文件夹的父目录，等效于 Azure 博客存储容器。 | ||
endpoint |
字符串 | 存储服务的终结点后缀，用于创建存储帐户终结点 URL。 它将存储帐户名称和 endpoint 组合在一起。 示例存储帐户 URL：https://<storage-account-name>.dfs.core.chinacloudapi.cn。 |
core.chinacloudapi.cn |
|
protocol |
字符串 | 用于连接到文件系统的协议。 | https，abfss |
https |
credentials |
object | 用于连接到 Azure 存储帐户的服务主体凭据。 凭据机密将存储在工作区密钥保管库中。 | ||
credentials.tenant_id |
字符串 | 服务主体租户 ID。 如果指定了 credentials，则为必需。 |
||
credentials.client_id |
字符串 | 服务主体客户端 ID。 如果指定了 credentials，则为必需。 |
||
credentials.client_secret |
字符串 | 服务主体客户端机密。 如果指定了 credentials，则为必需。 |
||
credentials.resource_url |
字符串 | 资源 URL，可指定将在 Azure Data Lake Storage Gen2 帐户上执行的操作。 | https://storage.azure.com/ |
|
credentials.authority_url |
字符串 | 用于进行用户身份验证的颁发机构 URL。 | https://login.chinacloudapi.cn |
备注
az ml datastore 命令可用于管理 Azure 机器学习数据存储。
示例
示例 GitHub 存储库中提供了示例。 下面显示了几个示例：
YAML：基于标识的访问
$schema: https://azuremlschemas.azureedge.net/latest/azureDataLakeGen2.schema.json
name: adls_gen2_credless_example
type: azure_data_lake_gen2
description: Credential-less datastore pointing to an Azure Data Lake Storage Gen2.
account_name: mytestdatalakegen2
filesystem: my-gen2-container
YAML：租户 ID、客户端 ID、客户端密码
$schema: https://azuremlschemas.azureedge.net/latest/azureDataLakeGen2.schema.json
name: adls_gen2_example
type: azure_data_lake_gen2
description: Datastore pointing to an Azure Data Lake Storage Gen2.
account_name: mytestdatalakegen2
filesystem: my-gen2-container
credentials:
tenant_id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
client_id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
client_secret: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX