この記事には、Synapse SQL でクエリ ラベルを使用するための重要なヒントが含まれています。
注
サーバーレス SQL プールでは、ラベル付けクエリはサポートされていません。
クエリ ラベルとは
専用 SQL プールでは、クエリ ラベルと呼ばれる概念がサポートされています。 詳細に進む前に、例を見てみましょう。
SELECT *
FROM sys.tables
OPTION (LABEL = 'My Query Label')
;
最後の行は、文字列 'My Query Label' をクエリにタグ付けします。 このタグは、ラベルが DMV を介してクエリを実行できるため便利です。 ラベルのクエリは、問題のあるクエリを特定するためのメカニズムを提供し、ELT 実行を通じて進行状況を特定するのに役立ちます。
適切な名前付け規則が最も役立ちます。 たとえば、PROJECT、PROCEDURE、STATEMENT、または COMMENT でラベルを開始すると、ソース管理内のすべてのコード間でクエリが一意に識別されます。
次のクエリでは、動的管理ビューを使用してラベルで検索します。
SELECT *
FROM sys.dm_pdw_exec_requests r
WHERE r.[label] = 'My Query Label'
;
注
クエリを実行するときは、単語ラベルの周りに角かっこまたは二重引用符を付ける必要があります。 ラベルは予約語であり、区切られないとエラーが発生します。
次のステップ
開発についてのその他のヒントは、開発の概要に関するページをご覧ください。