Partager via


Utiliser des étiquettes de requête dans Synapse SQL

Inclus dans cet article, vous trouverez des conseils essentiels pour utiliser des étiquettes de requête dans Synapse SQL.

Note

Le pool SQL serverless ne prend pas en charge les requêtes d’étiquetage.

Qu’est-ce que les étiquettes de requête ?

Le pool SQL dédié prend en charge un concept appelé étiquettes de requête. Avant d’entrer dans une profondeur, examinons un exemple :

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

La dernière ligne balise la chaîne « Mon étiquette de requête » dans la requête. Cette balise est utile, car l’étiquette est capable d’effectuer des requêtes via les DMV. L’interrogation d’étiquettes fournit un mécanisme de localisation des requêtes problématiques, qui permet d’identifier la progression via un processus ELT exécuté.

Les bonnes conventions d’affectation de noms sont les plus utiles. Par exemple, le démarrage de l’étiquette avec PROJECT, PROCEDURE, STATEMENT ou COMMENT identifie de manière unique la requête parmi tout le code dans le contrôle de code source.

La requête suivante utilise une vue de gestion dynamique pour effectuer une recherche par étiquette :

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

Note

Vous devez impérativement placer l’étiquette du mot entre crochets ou guillemets doubles lors de l’interrogation. L’étiquette est un mot réservé et provoque une erreur lorsqu’elle n’est pas délimitée.

Étapes suivantes

Pour obtenir des conseils supplémentaires, consultez la vue d’ensemble du développement.