Usare le etichette di query in Fabric Data Warehouse

Si applica a:✅ endpoint di analisi SQL e magazzino dati in Microsoft Fabric

Le etichette di query forniscono un meccanismo per l'individuazione delle query nelle viste di informazioni dettagliate sulle query o nel controllo del codice sorgente.

Suggerimento

Sono utili convenzioni di denominazione valide. Ad esempio, l'avvio dell'etichetta con PROJECT, PROCEDURE, STATEMENTo COMMENT consente di identificare le query tra le molte nel magazzino.

Sintassi del comando LABEL

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

Esempi

Annotazioni

Le query completate possono richiedere fino a 15 minuti per essere visualizzate nelle viste di informazioni dettagliate sulle query, a seconda del carico di lavoro simultaneo in esecuzione.

A. Tenere traccia delle prestazioni importanti delle query in Query Insights

Apporre un'etichetta univoca a una query a costi elevati di cui si vuole monitorare le prestazioni nel tempo.

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

È quindi possibile trovare le prestazioni di tale query nelle visualizzazioni analisi delle query, ad esempio:

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. Tenere traccia delle prestazioni delle query di più etichette

È possibile esaminare e confrontare più etichette di query, ad esempio:

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

Contenuti correlati

• Informazioni dettagliate sulle query in Fabric Data Warehouse