Synapse SQL でクエリラベルを使用する

この記事には、Synapse SQL でクエリラベルを使用する際の重要なヒントが含まれています。

注意

サーバーレス SQL プールでは、ラベル付けクエリはサポートされていません。

クエリラベルとは

専用 SQL プールでは、クエリラベルと呼ばれる概念がサポートされています。難解な領域に入る前に、1 つの例を説明しましょう。

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'
;

注意

クエリをする際に、語句のラベルを角かっこまたは二重引用符で囲むことが必要です。ラベルは予約語であるため、区切られていない場合はエラーが発生します。

開発についてのその他のヒントは、開発の概要に関するページをご覧ください。