Usare le etichette di query in Synapse SQL

In questo articolo sono inclusi suggerimenti essenziali per l'uso delle etichette di query in Synapse SQL.

Annotazioni

Il pool SQL serverless non supporta le query di etichettatura.

Che cosa sono le etichette di query

Il pool SQL dedicato supporta un concetto denominato etichette di query. Prima di approfondire, si esaminerà un esempio:

SELECT *
FROM sys.tables
OPTION (LABEL = 'My Query Label')
;

L'ultima riga etichetta la stringa 'My Query Label' alla query. Questo tag è utile perché l'etichetta è in grado di eseguire query tramite le DMV. L'esecuzione di query per le etichette fornisce un meccanismo per individuare le query sui problemi e consente di identificare lo stato di avanzamento tramite un'esecuzione ELT.

Le convenzioni di denominazione valide sono più utili. Ad esempio, iniziando l'etichetta con PROJECT, PROCEDURE, STATEMENT o COMMENT, la query viene identificata in modo univoco tra tutto il codice nel controllo di versione.

La query seguente usa una vista a gestione dinamica per eseguire ricerche in base all'etichetta:

SELECT  *
FROM    sys.dm_pdw_exec_requests r
WHERE   r.[label] = 'My Query Label'
;

Annotazioni

È essenziale inserire parentesi quadre o virgolette doppie intorno all'etichetta di parola durante l'esecuzione di query. Label è una parola riservata e genera un errore quando non viene delimitata.

Passaggi successivi

Per altri suggerimenti sullo sviluppo, vedere Panoramica dello sviluppo.