Share via


Utiliser des étiquettes de requête dans SQL Synapse

Cet article contient des conseils essentiels pour l’utilisation d’étiquettes de requête dans SQL Synapse.

Notes

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

Ce que sont les étiquettes de requête

Le pool SQL dédié prend en charge le concept d’étiquette de requête. Avant de poursuivre l’étude, 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 étiquette est utile, car le libellé peut être interrogé via des 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 conventions de nommage sont très utiles. Par exemple, démarrer l’étiquette par PROJET, PROCÉDURE, INSTRUCTION ou COMMENTAIRE identifie une requête de manière unique dans l’ensemble du code lors du contrôle de la source.

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

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

Notes

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

Étapes suivantes

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