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 portal 内のデータとフォルダーの表示
これらのフォルダーにリストされているデータは、Azure portal から表示できます。 詳細については、https://portal.azure.com を参照してください。 次に、ストレージ アカウント (ホーム>サブスクリプション>サブスクリプション>リソース グループ>自分のリソース グループ>自分のストレージ アカウント>ストレージ アカウント) の順に選択します。
データ レイク内のコンテナーとフォルダの構造
メイン ルート ルート フォルダーは yyyy-mm-dd 日付形式です (例 2020-02-28)。
ルート フォルダーには、次の 2 つの フォルダーが含まれています: メタデータと KPI:
- メタデータ フォルダーには、リージョンごとに 1 つずつ、ファイルのリストにインベントリ データが含まれています。
- KPI フォルダーには、使用状況データが含まれています。
スキーマ定義テーブル
次の表に、データのスキーマ定義の詳細を示します。 メタデータはインベントリ データと見なされます。
Power Apps サブフォルダー
アプリ
| 物件名 | 物件タイプ | 説明 |
|---|---|---|
| AppName | GUID | テーブルの結合に使用できる一意のアプリ ID |
| 名称 | Longtext | アプリ名 |
| 内容 | Longtext | アプリの説明 (現在は利用できません) |
| tenantId | GUID | 顧客テナント ID |
| EnvironmentId | Longtext (ロングテキスト) | 環境 ID |
| タイプ | Longtext | Power Apps を使用して作成されたアプリ |
| サブタイプ | Longtext | キャンバス | モデル | ページ |
| DocumentVersion | Datetime | 日付と時刻のスタンプはアプリのバージョンとして使用されます |
| URI | Longtext (ロングテキスト) | アプリ URI |
| Lifecyclestate | Longtext (ロングテキスト) | ドラフト | 公開済み |
| DocumentUri | Longtext (ロングテキスト) | アプリ情報 URI |
| IconUri | Longtext | アプリ アイコン URI |
| 担当者 | Longtext | アプリ所有者の名前 |
| createdPrincipalId | GUID | アプリ作成者プリンシパルの Microsoft Entra オブジェクト ID |
| CreatedTime | Datetime | アプリの作成日 |
| lastModifiedPrincipalId | GUID | 最後に修正したユーザーの Microsoft Entra オブジェクト ID |
| lastModifiedTime | Datetime | アプリの最終更新日 |
| lastenabledprincipalId | GUID | 最後に公開したユーザーの Microsoft Entra オブジェクト ID |
| lastEnabledTime | Datetime | アプリの最終公開日 |
| DeletedTime | Datetime | アプリが最後に削除された日付 |
| DeletedprincipalId | Longtext (ロングテキスト) | アプリを削除したユーザーの Microsoft Entra オブジェクト ID |
| sharedUsers | Int | アプリを共有するユーザーの数 |
| sharedGroups | Int | アプリを共有するグループの数 |
| ソリューション | Longtext | アプリが属するソリューション ID |
| Creationtype | Longtext (ロングテキスト) | 生成 | スクラッチ開発 |
| embeddingHost | Longtext (ロングテキスト) | Teams | Power Apps | Power BI |
| 設定 | Longtext (ロングテキスト) | 予約済み |
| customExtensions | Longtext (ロングテキスト) | 予約済み |
接続参照
| 物件名 | 物件タイプ | 説明 |
|---|---|---|
| resourceId | GUID | 一意のアプリ ID (使用状況テーブルとの結合に使用できます) |
| 表示名称 | Longtext (ロングテキスト) | ユーザーが入力したわかりやすい名前 — 例: Office 365 Outlook |
| connectionrefId | GUID | 一意の接続 ID |
| EnvironmentId | Longtext (ロングテキスト) | 環境 ID |
| 階層 | Longtext (ロングテキスト) | プレミアムまたは標準 |
| タイプ | Longtext (ロングテキスト) | 接続タイプ — 例: SQL、Office 365、Azure |
つながり
| 物件名 | 物件タイプ | 説明 |
|---|---|---|
| ConnectionId | GUID | 一意の接続 ID |
| connectionName | Longtext (ロングテキスト) | ユーザーが入力したわかりやすい名前 — 例: Office 365 Outlook |
| apiId | GUID | Connector type |
| EnvironmentId | Longtext (ロングテキスト) | 環境 ID |
| Displayname | Longtext (ロングテキスト) | 接続の URI |
| isCustomApi | Longtext (ロングテキスト) | はい | いいえ |
| createdPrincipalId | GUID | アプリ作成者プリンシパルの Microsoft Entra オブジェクト ID |
| CreatedTime | Datetime | アプリの作成日 |
| Swaggerurl | Longtext | カスタム API の Swagger URL |
| tenantId | GUID | 顧客テナント ID |
環境
| 物件名 | 物件タイプ | 説明 |
|---|---|---|
| Environmentid | Longtext | 環境 ID |
| name | Longtext | 環境名 |
| 目的 | Longtext | 環境コンテナが作成される対象の詳細 |
| tenantGuid | GUID | 顧客テナント ID |
| Environmentstate | Longtext (ロングテキスト) | 有効 | 無効 |
| environmenttype | Longtext (ロングテキスト) | サンドボックス | 運用 | 試用 | Teams |
| Securitygroup | Longtext (ロングテキスト) | 所有者セキュリティ グループ ID |
| Environmentregion | Longtext | 環境の位置情報 |
| EnvironmentUrl | Longtext | 環境 URL |
| 既定 | Longtext | この環境が既定であるかどうかを示すブール値 |
| CdsInstanceURL | Longtext (ロングテキスト) | 環境 URI |
| CdsInstanceId | GUID | 環境識別子 |
| createdPrincipalId | GUID | アプリ作成者プリンシパルの Microsoft Entra オブジェクト ID |
| CreatedTime | Datetime | アプリの作成日 |
| lastModifiedPrincipalId | GUID | アプリを最後に修正したユーザーを表す Microsoft Entra オブジェクト ID |
| lastModifiedTime | Datetime | アプリの最終更新日 |
| DeletedTime | Datetime | アプリが最後に削除された日付 |
| DeletedprincipalId | Longtext (ロングテキスト) | アプリを削除したユーザーの Microsoft Entra オブジェクト ID |
使い方
| 物件名 | 物件タイプ | 説明 |
|---|---|---|
| AppId | GUID | 一意のアプリ ID (テーブルの結合に使用可能) |
| environmentId | GUID | 環境 ID |
| tenantId | GUID | 顧客テナント ID |
| ObjectID | GUID | Microsoft Entra ユーザー オブジェクト ID |
| SessionId | GUID | セッション ID |
| timeaccessed | Datetime | ユーザーがアプリを開いたりアクセスした時刻 |
| 国 | Longtext | アプリが開かれた国; フィルターである |
| プラットフォーム | Longtext | アプリを開くプラットフォームまたはオペレーティング システム (このテーブルの次の注を参照) |
| PlayerVersion | LongText | アプリを開く Power Apps プレーヤー バージョン |
| AppVersion | Datetime | アプリ バージョン |
| 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 | 接続参照の名前 |
| 層 | LongText | Standard, Premium |
使い方
| 物件名 | 物件タイプ | 説明 |
|---|---|---|
| resourceId | GUID | 一意のリソース ID (テーブルの結合に使用できる) |
| environmentId | GUID | 環境 ID |
| tenantid | GUID | 顧客テナント ID |
| timeaccessed | Datetime | ユーザーがアプリを開いたりアクセスした時刻 |
| ステータス | LongText | 成功、失敗、キャンセル、終了 |
| SubType | LongText | クラウド フロー |
| 実行 | Int | 実行数 |
Note
- 一般的によく知られている最新バージョンのプラットフォーム オペレーティング システムにはデータが含まれているはずですが、場合によっては、このデータが使用できないことがあります。
- モデル駆動型アプリには、createdPrincipalID の値が null であるという既知の問題があります。