テキスト形式の実行プランに関する情報を出力する：SQL Server動的管理ビューレファレンス（75）

「Microsoft SQL Server」が稼働するデータベースシステムを運用する管理者に向け、「動的管理ビュー」の活用を軸にしたトラブル対策のためのノウハウを紹介していきます。今回は、テキスト形式の実行プランに関する情報の出力について解説します。

[椎名武史，＠IT]

SQL Server動的管理ビュー一覧

　本連載では、「Microsoft SQL Server（以下、SQL Server）」で使用可能な動的管理ビューについて、動作概要や出力内容などを紹介していきます。今回は動的管理関数「sys.dm_exec_text_query_plan」における、テキスト形式の実行プランに関する情報の出力について解説します。対応バージョンは、SQL Server（サポートされている全てのバージョン）です。

概要

　実行プランはXML形式で保存されており、「sys.dm_exec_query_plan」ではXML形式の実行プランに関する情報を出力できました。「sys.dm_exec_text_query_plan」を実行すると、テキスト形式の実行プランに関する情報を出力します。

• sys.dm_exec_text_query_plan（Transact-SQL）

構文と引数

構文　sys.dm_exec_text_query_plan (plan_handle, statement_start_offset, statement_end_offset)

引数名	データ型	説明
plan_handle	varbinary（64）	クエリプランのトークンを指定
statement_start_offset	int	ステートメントの開始オフセット
statement_end_offset	int	ステートメントの終了オフセット

出力内容

列名	データ型	説明
dbid	smallint	データベースのID
objectid	int	オブジェクトのID
number	smallint	ストアドプロシージャの番号
encrypted	bit	暗号化の有無。次のいずれかになる 　「1」＝暗号化されている 　「0」＝暗号化されていない
query_plan	nvarchar（max）	コンパイル時の実行プラン

動作例

　クエリを幾つか実行させた環境で「sys.dm_exec_text_query_plan」を実行すると、テキスト形式の実行プランに関する情報が出力されました（図1）。

図1　「sys.dm_exec_requests」と結合させてテキスト形式の実行プランに関する情報を確認できる

　分かりやすくするために「sys.dm_exec_text_query_plan」の列しか出力していませんが、「sys.dm_exec_requests」の列も出力することで、要求と実行プランの両方を確認できます。

　出力内容は、前回の「sys.dm_exec_sql_text」とあまり変わりませんが、最後が「query_plan」列になっています。「sys.dm_exec_query_plan」ではXML形式で出力されていたため、出力結果をクリックするとグラフィカルな実行プランを確認できました。

　「sys.dm_exec_text_query_plan」ではグラフィカルな実行プランを簡単に見ることはできませんが、「nvarchar（max）」型で定義されているため、「LIKE」演算子などを使用して条件検索することもできます。また、「statement_start_offset」と「statement_end_offset」を引数に指定できるため、オフセットを指定した実行プランを確認できます。「plan_handle」を引数として渡せればよいため、別の動的管理ビューと結合したり、「handle」を直接入力したりしても出力できます。

※本Tipsは、「Windows Server 2019」上に「SQL Server 2019 RTM」をインストールした環境を想定して解説しています。

筆者紹介

椎名 武史（しいな たけし）

日本ユニシス株式会社所属。Microsoft MVP for Data Platform（2017〜）。入社以来 SQL Serverの評価／設計／構築／教育などに携わりながらも、主にサポート業務に従事。SQL Serverのトラブル対応で社長賞の表彰を受けた経験も持つ。休日は学生時代の仲間と市民駅伝に参加し、銭湯で汗を流してから飲み会へと流れる。

伊東 敏章（いとう としあき）

日本ユニシス株式会社所属。入社以来SQL Server一筋で評価／設計／構築／教育などに携わりながらも、主にサポート業務に従事。社内のプログラミングコンテストで4回の優勝経験も持つ。趣味は輪行で週末は自転車を持っての旅行。目標は色々な日本百選を制覇すること。