Partage via


Utiliser des étiquettes de requête dans Fabric Data Warehouse

S’applique à :✅ point de terminaison pour les analyses SQL et entrepôt de données dans Microsoft Fabric

Les étiquettes de requête fournissent un mécanisme permettant de localiser des requêtes dans les vues d'analyse de requête ou dans la gestion de versions.

Conseil / Astuce

Les bonnes conventions d’affectation de noms sont utiles. Par exemple, commencer l’étiquette avec PROJECT, PROCEDURE, STATEMENT ou COMMENT aide à identifier les requêtes parmi les nombreuses de votre entrepôt.

Syntaxe LABEL

SELECT ...
FROM ...
OPTION (LABEL = '<label text>');

Examples

Note

Les requêtes terminées peuvent prendre jusqu’à 15 minutes pour apparaître dans les vues d’insights des requêtes en fonction de la charge de travail simultanée exécutée.

R. Suivre les performances importantes des requêtes dans Query Insights

Mettez une étiquette unique sur une requête à coût élevé dont vous souhaitez suivre les performances au fil du temps.

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');

Vous pouvez ensuite trouver les performances de cette requête dans les vues Query Insights , par exemple :

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. Suivre la performance des requêtes portant sur plusieurs étiquettes

Vous pouvez examiner et comparer plusieurs étiquettes de requête, par exemple :

SELECT *
FROM 
    queryinsights.exec_requests_history 
WHERE 
    label IN ('Regular','Clustered')
ORDER BY 
    submit_time DESC;