Usar rótulos para consultas de instrumento no SQL Data Warehouse do AzureUsing labels to instrument queries in Azure SQL Data Warehouse

Dicas para usar rótulos para consultas de instrumento no SQL Data Warehouse do Azure para desenvolvimento de soluções.Tips for using labels to instrument queries in Azure SQL Data Warehouse for developing solutions.

O que são rótulos?What are labels?

O SQL Data Warehouse oferece suporte a um conceito chamado rótulos de consulta.SQL Data Warehouse supports a concept called query labels. Antes de entrar em qualquer profundidade, vamos examinar um exemplo:Before going into any depth, let's look at an example:

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

A última linha marca a cadeia de caracteres ‘Meu Rótulo de Consulta’ à consulta.The last line tags the string 'My Query Label' to the query. Essa marca é particularmente útil, pois o rótulo é capaz de executar consultas por meio de DMVs.This tag is particularly helpful since the label is query-able through the DMVs. Consultar rótulos fornece um mecanismo para localizar as consultas de problema e ajudar a identificar o andamento por meio de uma execução de ELT.Querying for labels provides a mechanism for locating problem queries and helping to identify progress through an ELT run.

Uma boa convenção de nomenclatura ajuda muito.A good naming convention really helps. Por exemplo, começar o rótulo com PROJECT, PROCEDURE, STATEMENT ou COMMENT ajuda a identificar exclusivamente a consulta entre todos os códigos no controle de origem.For example, starting the label with PROJECT, PROCEDURE, STATEMENT, or COMMENT helps to uniquely identify the query among all the code in source control.

A consulta a seguir usa um modo de exibição de gerenciamento dinâmico para pesquisar por rótulo.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'
;

Observação

É essencial colocar colchetes ou aspas duplas em torno da palavra do rótulo ao consultar.It is essential to put square brackets or double quotes around the word label when querying. Rótulo é uma palavra reservada e causa um erro quando ele não é delimitado.Label is a reserved word and causes an error when it is not delimited.

Próximas etapasNext steps

Para obter mais dicas de desenvolvimento, consulte Visão geral de desenvolvimento.For more development tips, see development overview.