Uso delle etichette per instrumentare query in Azure SQL Data WarehouseUsing labels to instrument queries in Azure SQL Data Warehouse

Suggerimenti per l'uso di etichette per instrumentare query in Azure SQL Data Warehouse per lo sviluppo di soluzioni.Tips for using labels to instrument queries in Azure SQL Data Warehouse for developing solutions.

Definizione di etichetteWhat are labels?

SQL Data Warehouse supporta un concetto detto etichette di query.SQL Data Warehouse supports a concept called query labels. Prima di approfondire il concetto, eccone un esempio:Before going into any depth, let's look at an example:

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

L'ultima riga contrassegna la stringa 'My Query Label' per la query.The last line tags the string 'My Query Label' to the query. Questo tag è particolarmente utile in quanto l'etichetta suppor la query tramite le DMV.This tag is particularly helpful since the label is query-able through the DMVs. L'esecuzione di query per le etichette offre un meccanismo per l'individuazione di query problematiche e semplifica il controllo dell'avanzamento mediante l'esecuzione di un processo ELT.Querying for labels provides a mechanism for locating problem queries and helping to identify progress through an ELT run.

Una buona convenzione di denominazione è estremamente utile.A good naming convention really helps. Ad esempio, una stringa che inizia con PROJECT, PROCEDURE, STATEMENT o COMMENT può facilitare l'identificazione univoca della query in tutto il codice nel controllo del codice sorgente.For example, starting the label with PROJECT, PROCEDURE, STATEMENT, or COMMENT helps to uniquely identify the query among all the code in source control.

La query seguente usa una vista a gestione dinamica da sottoporre a ricerca in base all'etichetta.The following query uses a dynamic management view to search by label.

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

Nota

È essenziale racchiudere tra parentesi quadre o virgolette doppie la parola label durante l'esecuzione della query.It is essential to put square brackets or double quotes around the word label when querying. Label è una parola riservata e restituisce un errore quando non è delimitata.Label is a reserved word and causes an error when it is not delimited.

Passaggi successiviNext steps

Per altri suggerimenti sullo sviluppo, vedere la panoramica dello sviluppo.For more development tips, see development overview.