適用対象:✅ Microsoft Fabric の SQL 分析エンドポイントおよびウェアハウス
クエリ ラベルは、 クエリ分析情報 ビューまたはソース管理でクエリを検索するためのメカニズムを提供します。
ヒント
適切な名前付け規則が役立ちます。 たとえば、 PROJECT、 PROCEDURE、 STATEMENT、または COMMENT でラベルを開始すると、ウェアハウス内の多数のクエリを識別するのに役立ちます。
LABEL 構文
SELECT ...
FROM ...
OPTION (LABEL = '<label text>');
例示
注
完了したクエリは、実行されている同時実行ワークロードに応じて、クエリ分析情報ビューに表示されるまでに最大 15 分かかることがあります。
A。 Query Insights で重要なクエリ パフォーマンスを追跡する
時間の経過に伴うパフォーマンスを追跡する高コストのクエリに一意のラベルを配置します。
SELECT FinanceKey, DateKey, OrganizationKey, DepartmentGroupKey, SUM(AMOUNT)
FROM dbo.FactFinance
WHERE OrganizationKey = 123
AND DepartmentGroupKey = 123
GROUP BY FinanceKey, DateKey, OrganizationKey, DepartmentGroupKey
OPTION (LABEL = 'SALES DASHBOARD');
その後、 クエリ分析情報 ビューでそのクエリのパフォーマンスを確認できます。次に例を示します。
SELECT *
FROM
queryinsights.long_running_queries
WHERE
last_run_command LIKE '%SALES DASHBOARD%'
ORDER BY
median_total_elapsed_time_ms DESC;
SELECT *
FROM
queryinsights.exec_requests_history
WHERE
label IN ('SALES DASHBOARD')
ORDER BY
submit_time DESC;
B: 複数のラベルのクエリ パフォーマンスを追跡する
次のような複数のクエリ ラベルを確認して比較できます。
SELECT *
FROM
queryinsights.exec_requests_history
WHERE
label IN ('Regular','Clustered')
ORDER BY
submit_time DESC;