Microsoft Power Platform 自助服务分析架构定义（预览）
[本文为预发布文档，可能会发生变化。]
本主题讨论从 Power Platform 导出到 Azure Data Lake Gen2 存储位置的数据的内容。
重要提示
- 这是一项预览功能。
- 预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前已经可用，以便客户可以及早使用并提供反馈。
- 此功能正在跨区域逐步推出，您所在的区域可能尚未提供。
数据输出的结构
将 Power Apps 和 Power Automate 库存以及使用情况数据导出到您的 Data Lake Storage 时，自助服务分析将以 Common Data Model 架构格式提供这些数据。 这种基于 Common Data Model 的元数据让您可以跨应用程序和业务流程（如 Power Apps、Power Automate、Power BI、Dynamics 365 和 Azure）共享数据。
数据导出文件中包含：
租户中的所有应用、流、连接器和关联元数据的完整库存。
从导出时开始的数据构成的使用情况数据。
在首次生成数据导出后，Power Automate 将生成增量的每日更新。 每个每日更新中都包含有关所有新应用和现有应用的详细信息，包括连接器信息。 数据导出中包含 Microsoft Entra 主体对象 ID (userid)。 （可选）可以进一步使用 Microsoft Entra 检索实际用户名和业务部门，如市场、销售或财务。
Power Apps 文件夹结构
Power Apps 的主根文件夹采用以下文件夹结构：
- \Applications
- \ConnectionReference
- \Connections
- \Environments
- \Usage
Power Automate 文件夹结构
Power Automate 的主根文件夹采用以下文件夹结构：
- \Flows
- \FlowsConnectionReference
- \Usage
在 Azure 门户中查看数据和文件夹
可以通过 Azure 门户查看这些文件夹中列出的数据。 要了解详细信息，请转到 https://portal.azure.com。 然后，导航到您的存储帐户（主页>订阅>您的订阅名称>资源组>您的资源组>您的存储帐户>存储帐户）。
数据湖中容器和文件夹的结构
主文件夹采用 yyyy-mm-dd 日期格式（例如，2020-02-28）。
根文件夹中包含两个文件夹：Metadata 和 KPI：
- Metadata 文件夹中包含文件列表中的库存数据，每个区域一个。
- KPI 文件夹中包含使用情况数据。
架构定义表
下表详细说明了数据的架构定义。 元数据被视为库存数据。
Power Apps 子文件夹
应用程序
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| AppName | Guid | 可用于联接表的唯一应用程序 ID |
| 客户 | 长文本 | 应用名称 |
| 描述 | Longtext | 应用说明（当前不可用） |
| tenantId | Guid | 客户租户 ID |
| EnvironmentId | 长文本 | 环境 ID |
| 类型 | 长文本 | 使用 Power Apps 创建的应用 |
| 子类型 | 长文本 | 画布 | 模型 | 页面 |
| DocumentVersion | Datetime | 日期和时间戳用作应用版本 |
| URI | 长文本 | 应用程序 URI |
| Lifecyclestate | 长文本 | 草稿 | 已发布 |
| DocumentUri | 长文本 | 应用信息 URI |
| IconUri | Longtext | 应用图标 URI |
| 所有者 | Longtext | 应用负责人的姓名 |
| createdPrincipalId | Guid | 应用创建者主体的 Microsoft Entra 对象 ID |
| CreatedTime | 日期/时间 | 创建应用的日期 |
| lastModifiedPrincipalId | Guid | 上次修改用户的 Microsoft Entra 对象 ID |
| lastModifiedTime | 日期/时间 | 上次更新应用的日期 |
| lastenabledprincipalId | Guid | 上次发布用户的 Microsoft Entra 对象 ID |
| lastEnabledTime | Datetime | 上次发布应用的日期 |
| DeletedTime | 日期/时间 | 应用的上次删除日期 |
| DeletedprincipalId | 长文本 | 删除应用的用户的 Microsoft Entra 对象 ID |
| sharedUsers | Int | 与其共享应用的用户的数量 |
| sharedGroups | Int | 与其共享应用的组的数量 |
| 解决方案 | Longtext | 应用所属的解决方案 ID |
| Creationtype | 长文本 | 已生成 | 从头开发 |
| embeddingHost | 长文本 | Teams | Power Apps | Power BI |
| 设置 | 长文本 | 已保留 |
| customExtensions | 长文本 | 已保留 |
连接引用
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| resourceId | Guid | 唯一应用程序 ID（可用于联接使用情况表） |
| 显示名称 | 长文本 | 用户输入的说明名称—例如，Office 365 Outlook |
| connectionrefId | Guid | 唯一连接 ID |
| EnvironmentId | 长文本 | 环境 ID |
| 层 | 长文本 | 高级或标准 |
| 类型 | 长文本 | 连接类型—例如，SQL、Office 365 或 Azure |
连接
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| ConnectionId | Guid | 唯一连接 ID |
| connectionName | 长文本 | 用户输入的说明名称—例如，Office 365 Outlook |
| apiId | Guid | 连接器类型 |
| EnvironmentId | 长文本 | 环境 ID |
| Displayname | 长文本 | 连接的 URI |
| isCustomApi | 长文本 | 是 | 否 |
| createdPrincipalId | Guid | 应用创建者主体的 Microsoft Entra 对象 ID |
| CreatedTime | 日期/时间 | 创建应用的日期 |
| Swaggerurl | Longtext | 自定义 API 的 Swagger URL |
| tenantId | Guid | 客户租户 ID |
环境
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| Environmentid | Longtext | 环境 ID |
| 姓名 | 长文本 | 环境名称 |
| 宗旨 | Longtext | 有关为其创建环境容器的对象的详细信息 |
| tenantGuid | Guid | 客户租户 ID |
| Environmentstate | 长文本 | 已启用 | 已禁用 |
| environmenttype | 长文本 | 沙盒 | 生产 | 试用 | Teams |
| Securitygroup | 长文本 | 负责人安全组 ID |
| Environmentregion | Longtext | 环境地理位置 |
| EnvironmentUrl | Longtext | 环境 URL |
| isDefault | Longtext | 用于指示此环境是否为默认环境的布尔值 |
| CdsInstanceURL | 长文本 | 环境 URI |
| CdsInstanceId | Guid | 环境标识符 |
| createdPrincipalId | Guid | 应用创建者主体的 Microsoft Entra 对象 ID |
| CreatedTime | 日期/时间 | 创建应用的日期 |
| lastModifiedPrincipalId | Guid | 上次修改应用的用户的 Microsoft Entra 对象 ID |
| lastModifiedTime | 日期/时间 | 上次更新应用的日期 |
| DeletedTime | 日期/时间 | 应用的上次删除日期 |
| DeletedprincipalId | 长文本 | 删除应用的用户的 Microsoft Entra 对象 ID |
用法
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| AppId | Guid | 唯一应用程序 ID（可用于联接表） |
| environmentId | Guid | 环境 ID |
| tenantId | Guid | 客户租户 ID |
| ObjectID | Guid | Microsoft Entra 用户对象 ID |
| SessionId | Guid | 会话 ID |
| timeaccessed | 日期/时间 | 用户打开或访问应用的时间 |
| 国家/地区 | Longtext | 打开应用的国家/地区；属于筛选器 |
| platform | 长文本 | 打开应用的平台或操作系统（请参阅此表后面的注释） |
| PlayerVersion | LongText | 打开应用的 Power Apps 播放器版本 |
| AppVersion | 日期/时间 | 应用版本 |
| Browsername | Longtext | 客户端浏览器 |
| DataVersion | Int(11) | 表数据，与用户无关 |
Power Automate 子文件夹
流
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| ResourceId | Guid | 唯一流 ID（可用于联接表） |
| 姓名 | LongText | 流名称 |
| 类型 | LongText | Power Automate |
| 子类型 | LongText | 云端流 |
| environmentId | Guid | 环境 ID |
| resourceVersion | LongText | 流版本 |
| lifecycleState | LongText | 草稿，已发布 |
| events_created_timestamp | Datetime | 创建流的日期 |
| events_created_principalId | Guid | 流创建者主体的 Microsoft Entra 对象 ID |
| events_lastModified_timestamp | Datetime | 上次更新流的日期 |
| sharedUsers | int | 与其共享流的用户的数量 |
| sharedGroups | int | 与其共享流的组的数量 |
FlowsConnectionReference
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| resourceId | Guid | 唯一流 ID（可用于联接表） |
| tenantId | Guid | 客户租户 ID |
| environmentId | Guid | 环境 ID |
| connectionrefId | LongText | 唯一连接引用 ID |
| connectorType | LongText | 流使用的连接器类型 |
| connectionId | LongText | 唯一连接 ID |
| displayName | LongText | 连接引用的名称 |
| tier | LongText | 标准、高级 |
用法
| 属性名称 | 属性类型 | 说明 |
|---|---|---|
| resourceId | Guid | 唯一资源 ID（可用于联接表） |
| environmentId | Guid | 环境 ID |
| tenantid | Guid | 客户租户 ID |
| timeaccessed | Datetime | 用户打开或访问应用的时间 |
| 状态 | LongText | 成功、失败、已取消、已终止 |
| subType | LongText | 云端流 |
| runs | Int | 运行数 |
备注
- 众所周知的平台操作系统的最新版本应该包含数据，但在某些情况下，这些数据可能不可用。
- 对于模型驱动应用，有一个已知问题，即 createdPrincipalID 的值为空。