クエリ ログ テーブルには、Real-Time Intelligence の一部である Eventhouse KQL データベースに対するクエリ実行のリストが含まれています。 クエリごとに、ログ イベント レコードが EventhouseQueryLogs テーブルに格納されます。
クエリ ログ テーブル
クエリ ログを使って次のことを行います。
- クエリのパフォーマンスと傾向を分析する。
- 遅いクエリのトラブルシューティングを行う。
- 大量のシステム リソースを消費する負荷の大きなクエリを特定する。
- 最も多くのクエリを実行しているユーザーやアプリケーションを特定する。
次の表では、EventhouseQueryLogs テーブルに格納される列について説明します。
| 列名 | タイプ | 説明 |
|---|---|---|
| CacheColdHitsBytes | long | データのプリフェッチのためにコールド キャッシュでクエリに使用できたコールド ストレージ データの量。 |
| CacheColdMissesBytes | long | コールド キャッシュでクエリに使用できなかったコールド ストレージ データの量。 |
| CacheHotHitsBytes | long | ホット キャッシュでクエリに使用できたデータの量。 ホット キャッシュに格納されるデータの量は、データベースまたはテーブルのキャッシュ ポリシーによって定義されています。 |
| CacheHotMissesBytes | long | ホット キャッシュでクエリに使用できなかったデータの量。 |
| CapacityId | 文字列 | Fabric の容量識別子。 |
| ComponentFault | 文字列 | クエリ エラーのイベントで、エラーが発生したコンポーネント。 有効な値: Server と Client。 クエリ結果セットが大きすぎる場合、値は Client です。 内部エラーが発生した場合、値は Server です。 |
| CorrelationId | 文字列 | クエリの相関関係識別子。 この値には、クエリを実行しているレポートのセマンティック モデルなど、クエリに参加している他のアイテムのコンポーネントが含まれる場合があります。 |
| CpuTimeMs | long | クエリによって使われた合計 CPU 時間 (ミリ秒)。 |
| CustomerTenantId | 文字列 | 顧客テナント識別子。 |
| DatabaseId | 文字列 | データベースの一意識別子。 |
| DatabaseName | 文字列 | データベースの名前。 |
| DurationMs | long | クエリの継続時間 (ミリ秒)。 |
| ExtentsMaxScannedTime | datetime | 最大データ スキャン時間。 |
| ExtentsMinScannedTime | datetime | 最小データ スキャン時間。 |
| FailureReason | 文字列 | クエリが失敗した理由。 |
| ID | 動的 | クエリを実行したユーザーまたはアプリケーションの ID。 |
| ItemId | 文字列 | Fabric Eventhouse アイテムの識別子。 |
| ItemKind | 文字列 | Fabric アイテムの種類。 有効な値: Eventhouse。 |
| ItemName | 文字列 | Fabric Eventhouse アイテムの名前。 |
| Level | 文字列 | 該当なし。 |
| MemoryPeakBytes | long | クエリの最大メモリ消費量。 |
| OperationEndTime | datetime | 操作が終了した時刻 (UTC)。 |
| OperationId | 文字列 | 一意のクエリ ログ識別子。 |
| OperationStartTime | datetime | 操作が開始された時刻 (UTC)。 |
| QueryText | 文字列 | クエリのテキスト。 |
| リージョン | 文字列 | Fabric KQL データベースが配置されているリージョン。 |
| ResultTableCount | int | クエリで使われたテーブルの数。 |
| ResultTableStatistics | 文字列 | クエリで使われたテーブルの詳細な統計情報。 |
| ScannedExtentsCount | long | クエリによってスキャンされたエクステントの数。 値が大きい場合は、クエリの待ち時間の問題の原因を示している可能性があります。 |
| ScannedRowsCount | long | クエリによってスキャンされた行の数。 値が大きい場合は、クエリの待ち時間の問題の原因を示している可能性があります。 |
| SourceApplication | 文字列 | クエリを実行したソース アプリケーションの名前。 |
| 状態 | 文字列 | クエリの完了状態。 |
| Timestamp | datetime | イベントが生成された時刻 (UTC)。 |
| TotalExtentsCount | long | 結果セット内のエクステントの合計数。 |
| TotalRowsCount | long | 結果セット内の行の合計数。 |
| WorkspaceId | 文字列 | ワークスペースの識別子。 |
| WorkspaceMonitoringTableName | 文字列 | ワークスペース監視テーブルの名前。 有効な値: EventhouseQueryLogs。 |
| WorkspaceName | 文字列 | ワークスペースの名前。 |
サンプル クエリ
サンプル クエリは、GitHub リポジトリ fabric-samples にあります。
Templates
Visualize workspaceの監視ガイドに従うことで、Real-Time ダッシュボードの組み込みテンプレートを使ってログを探索・可視化できます。