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 associe la chaîne « My Query Label » à la requête. Cette balise est utile, car l’étiquette est capable d’effectuer des requêtes via les DMV. L'interrogation des étiquettes fournit un mécanisme permettant de localiser les requêtes problématiques et de suivre l'évolution d'un processus ELT.

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

Il est essentiel de placer des crochets ou des guillemets doubles autour de l’étiquette du mot 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.