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 主體物件識別碼 (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)。
根資料夾包含兩個資料夾：「中繼資料」和「KPI」：
- 中繼資料資料夾中包含檔案清單中的清查資料，每個區域一個檔案。
- KPI 資料夾包含使用資料。
結構描述定義資料表
下表詳細說明了資料的結構描述定義。 中繼資料會視為清查資料。
Power Apps 子資料夾
App
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| AppName | GUID | 可用於聯結資料表的唯一應用程式識別碼 |
| 名字 | Longtext | 應用程式名稱 |
| 描述 | Longtext | 應用程式描述 (目前無法使用) |
| tenantId | GUID | 客戶用戶識別碼 |
| EnvironmentId | Longtext | 環境識別碼 |
| 類型 | Longtext | 使用 Power Apps 建立的應用程式 |
| 子類型 | Longtext | 畫布 | 模型 | 頁面 |
| DocumentVersion | Datetime | 日期和時間戳記是用做為應用程式版本。 |
| URI | Longtext | 應用程式 URI |
| Lifecyclestate | Longtext | 草稿 | 已發佈 |
| DocumentUri | Longtext | 應用程式資訊 URI |
| IconUri | Longtext | 應用程式圖示 URI |
| 所有人 | Longtext | 應用程式負責人的名稱 |
| createdPrincipalId | GUID | 應用程式建立者主體的 Microsoft Entra 物件識別碼 |
| CreatedTime | 日期時間 | 應用程式的建立日期 |
| lastModifiedPrincipalId | GUID | 上次修改使用者的 Microsoft Entra 物件識別碼 |
| lastModifiedTime | 日期時間 | 最近更新的應用程式日期 |
| lastenabledprincipalId | GUID | 上次發佈使用者的 Microsoft Entra 物件識別碼 |
| lastEnabledTime | Datetime | 最近發布的應用程式日期 |
| DeletedTime | 日期時間 | 上次刪除應用程式的日期 |
| DeletedprincipalId | Longtext | 刪除應用程式之使用者的 Microsoft Entra 物件識別碼 |
| sharedUsers | int | 共用應用程式的使用者數目 |
| sharedGroups | int | 共用應用程式的群組數目 |
| 應用程式執行個體 | Longtext | 應用程式所屬的解決方案識別碼 |
| Creationtype | Longtext | 已產生 | 從頭開發 |
| embeddingHost | Longtext | Teams | Power Apps | Power BI |
| 設定 | Longtext | 已保留 |
| customExtensions | Longtext | 已保留 |
連線參考
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| resourceId | GUID | 唯一應用程式識別碼 (可用於聯結使用方式資料表) |
| Display name | Longtext | 使用者輸入的描述名稱，例如 Office 365 Outlook |
| connectionrefId | GUID | 唯一連線識別碼 |
| EnvironmentId | Longtext | 環境識別碼 |
| 階層 | Longtext | Premium 或 Standard |
| 類型 | Longtext | 連線類型，例如 SQL、Office 365 或 Azure |
連線
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| ConnectionId | GUID | 唯一連線識別碼 |
| connectionName | Longtext | 使用者輸入的描述名稱，例如 Office 365 Outlook |
| apiId | GUID | 連接器類型 |
| EnvironmentId | Longtext | 環境識別碼 |
| Displayname | Longtext | 連接 URI |
| isCustomApi | Longtext | 是 | 否 |
| createdPrincipalId | GUID | 應用程式建立者主體的 Microsoft Entra 物件識別碼 |
| CreatedTime | 日期時間 | 應用程式的建立日期 |
| Swaggerurl | Longtext | 自訂 API 的 Swagger URL |
| tenantId | GUID | 客戶用戶識別碼 |
環境
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| Environmentid | Longtext | 環境識別碼 |
| 名稱 | Longtext | 環境名稱 |
| 用途 | Longtext | 關於建立環境容器的詳細資料 |
| tenantGuid | GUID | 客戶用戶識別碼 |
| Environmentstate | Longtext | 已啟用 | 已停用 |
| environmenttype | Longtext | 沙箱 | 產品 | 試用 | 團隊 |
| Securitygroup | Longtext | 負責人安全性群組識別碼 |
| Environmentregion | Longtext | 環境地理位置 |
| EnvironmentUrl | Longtext | 環境 URL |
| isDefault | Longtext | 指示此環境是否為預設的布林值 |
| CdsInstanceURL | Longtext | 環境 URI |
| CdsInstanceId | Guid | 環境識別碼 |
| createdPrincipalId | GUID | 應用程式建立者主體的 Microsoft Entra 物件識別碼 |
| CreatedTime | 日期時間 | 應用程式的建立日期 |
| lastModifiedPrincipalId | GUID | 上次修改應用程式之使用者的 Microsoft Entra 物件識別碼 |
| lastModifiedTime | 日期時間 | 最近更新的應用程式日期 |
| DeletedTime | 日期時間 | 上次刪除應用程式的日期 |
| DeletedprincipalId | Longtext | 刪除應用程式之使用者的 Microsoft Entra 物件識別碼 |
使用狀況
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| AppId | GUID | 唯一 appid (可用於聯結資料表) |
| environmentId | GUID | 環境識別碼 |
| tenantId | GUID | 客戶用戶識別碼 |
| ObjectID | GUID | Microsoft Entra 使用者物件識別碼 |
| 工作階段識別碼 | GUID | 工作階段識別碼 |
| timeaccessed | 日期時間 | 使用者開啟或存取應用程式的時間 |
| 國家/地區 | Longtext | 開啟應用程式的國家/地區; 為 [篩選] |
| 平台 | Longtext | 用來開啟應用程式的平台或作業系統 (請參見此表格後面的注意)。 |
| PlayerVersion | LongText | 從中開啟應用程式的 Power Apps 播放程式版本 |
| AppVersion | 日期時間 | 應用程式版本 |
| Browsername | Longtext | 用戶端瀏覽器 |
| DataVersion | Int(11) | 資料表資料，與使用者無關 |
Power Automate 子資料夾
流程
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| ResourceId | GUID | 唯一流程識別碼 (可用於聯結資料表) |
| name | LongText | 流程名稱 |
| type | LongText | Power Automate |
| 子類型 | LongText | 雲端流程 |
| environmentId | GUID | 環境識別碼 |
| resourceVersion | LongText | 流程版本 |
| lifecycleState | LongText | 草稿，已發佈 |
| events_created_timestamp | Datetime | 流程的建立日期 |
| events_created_principalId | GUID | 流程建立者主體的 Microsoft Entra 物件識別碼 |
| events_lastModified_timestamp | Datetime | 最近更新的流程日期 |
| sharedUsers | int | 共用流程的使用者數目 |
| sharedGroups | int | 共用流程的群組數目 |
FlowsConnectionReference
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| resourceId | GUID | 唯一流程識別碼 (可用於聯結資料表) |
| tenantId | GUID | 客戶用戶識別碼 |
| environmentId | GUID | 環境識別碼 |
| connectionrefId | LongText | 唯一連接參考識別碼 |
| connectorType | LongText | 流程使用的連接器類型 |
| connectionId | LongText | 唯一連線識別碼 |
| displayName | LongText | 連接參考的名稱 |
| 階層 | LongText | 標準，進階 |
使用狀況
| 屬性名稱 | 屬性類型 | 描述 |
|---|---|---|
| resourceId | GUID | 唯一資源識別碼 (可用於聯結資料表) |
| environmentId | GUID | 環境識別碼 |
| tenantid | GUID | 客戶用戶識別碼 |
| timeaccessed | Datetime | 使用者開啟或存取應用程式的時間 |
| 狀態 | LongText | 成功，失敗，已取消，已終止 |
| subType | LongText | 雲端流程 |
| 執行 | Int | 執行次數 |
Note
- 眾所皆知的平台作業系統的最新版本應該包含資料，但在某些情況下，這些資料可能不可用。
- 模型導向應用程式存在已知問題，其中 createdPrincipalID 的值為 Null。