SET SHOWPLAN_ALL (Transact-SQL)
Microsoft SQL Server で Transact-SQL ステートメントを実行せず、代わりにステートメントの実行方法と実行に必要なリソースの見積もりに関する詳細情報を返します。
.gif "トピック リンク アイコン")
構文
SET SHOWPLAN_ALL { ON | OFF }
説明
SET SHOWPLAN_ALL は、解析時ではなく実行時に設定されます。
SET SHOWPLAN_ALL が ON の場合、SQL Server では各ステートメントの実行情報だけが返され、Transact-SQL ステートメントは実行されません。返される情報は、このオプションが ON に設定されてから OFF に設定されるまでに実行されたすべての Transact-SQL ステートメントに関する情報です。たとえば、SET SHOWPLAN_ALL が ON のときに CREATE TABLE ステートメントを実行し、その後この同じテーブルを参照する SELECT ステートメントを実行すると、SQL Server では指定したテーブルが存在しないというエラー メッセージが返されます。その後、このテーブルに対して行われる参照は失敗します。SET SHOWPLAN_ALL が OFF の場合、SQL Server ではレポートを作成せずに、ステートメントを実行します。
SET SHOWPLAN_ALL は、出力処理用に作成されたアプリケーションで使用できます。SET SHOWPLAN_TEXT は、osql ユーティリティなどの Microsoft Win32 コマンド プロンプト アプリケーションが読み取れる形式の出力を返す場合に使用します。
SET SHOWPLAN_TEXT ステートメントと SET SHOWPLAN_ALL ステートメントは、ストアド プロシージャ内では指定できません。これらのステートメントは、バッチ内にのみ指定できます。
SET SHOWPLAN_ALL では情報が行セットとして返されます。これは階層構造になっており、SQL Server クエリ プロセッサで各ステートメントが実行されるときのステップを表しています。出力結果には、ステートメントごとに、ステートメントのテキストを示す 1 行と、実行ステップの詳細を示す複数行が含まれます。次の表は、出力に含まれる列の一覧です。
列名 |
説明 |
|---|---|
StmtText |
PLAN_ROW 型でない行の場合、Transact-SQL ステートメントのテキストが含まれます。PLAN_ROW 型の行の場合、この列には操作の説明が含まれます。またこの列には物理操作と、必要に応じて論理操作が含まれます。この列の後に説明が続くこともありますが、その説明は物理操作によって決定されます。詳細については、「論理操作と物理操作のリファレンス」を参照してください。 |
StmtId |
現在のバッチに含まれるステートメントの数。 |
NodeId |
現在のクエリ内にあるノードの ID。 |
Parent |
親ステップのノードの ID。 |
PhysicalOp |
ノードの物理的な実装アルゴリズム。PLAN_ROWS 型の行の場合だけ返されます。 |
LogicalOp |
ノードが表す関係代数操作。PLAN_ROWS 型の行の場合だけ返されます。 |
Argument |
実行されている操作に関する補足情報。この列の内容は、物理操作に応じて異なります。 |
DefinedValues |
操作によって導入される値のコンマ区切りの一覧。これらの値は、現在のクエリ (たとえば、SELECT リストや WHERE 句) に指定された計算式であるか、またはこのクエリを処理するためにクエリ プロセッサで導入された内部値です。定義されたこれらの値は、このクエリ内の他の場所で参照できます。PLAN_ROWS 型の行の場合だけ返されます。 |
EstimateRows |
操作によって出力される行数の見積もり。PLAN_ROWS 型の行の場合だけ返されます。 |
EstimateIO |
操作の I/O コスト* の見積もり。PLAN_ROWS 型の行の場合だけ返されます。 |
EstimateCPU |
操作の CPU コスト* の見積もり。PLAN_ROWS 型の行の場合だけ返されます。 |
AvgRowSize |
操作を介して渡される行の平均サイズ (バイト単位)。 |
TotalSubtreeCost |
親演算とすべての子演算に関する (累積) コスト* の見積もり。 |
OutputList |
現在の演算によって示される列のコンマ区切りの一覧。 |
Warnings |
現在の演算に関係する警告メッセージのコンマ区切りの一覧。警告メッセージには、"NO STATS:()" という文字列と列の一覧が含まれることがあります。この警告メッセージは、クエリ オプティマイザが列の統計を基に判断を下そうとしたときに、使用できる統計がなかったことを意味します。この結果、クエリ オプティマイザでは推定値が用いられ、効率の悪いクエリ プランが作成された可能性があります。クエリ オプティマイザで効率的なクエリ プランを選択できるような列統計を作成し更新する方法の詳細については、「UPDATE STATISTICS」を参照してください。場合によっては、この列には "MISSING JOIN PREDICATE" という文字列が含まれることがあります。これは、結合述語のない結合 (テーブルを含む) が実行されていることを意味します。結合述語を誤って破棄すると、予想より実行時間が長くなり、巨大な結果セットを返すクエリが作成される可能性があります。この警告が返された場合は、結合述語が意図的に省略されているかどうかを確認してください。 |
Type |
ノードの型。各クエリの親ノードの場合は、Transact-SQL ステートメントの種類 (SELECT、INSERT、EXECUTE など) を表します。実行プランを表すサブノードの場合は、型は PLAN_ROW です。 |
Parallel |
0 = 操作は並列実行されない 1 = 操作は並列実行される |
EstimateExecutions |
現在のクエリの実行中に、操作が実行される推定回数。 |
* コスト単位は、ウォール クロック時間ではなく、内部測定時間に基づいています。コスト単位は、プランの相対コストを他のプランと比較して決定するために使用されます。
権限
SET SHOWPLAN_ALL を使用するには、SET SHOWPLAN_ALL の実行ステートメントを実行するための適切な権限が与えられている必要があります。また、参照されるオブジェクトを含むすべてのデータベースに対して、SHOWPLAN 権限が必要です。
プラン表示を作成するには、SELECT、INSERT、UPDATE、DELETE、EXEC stored_procedure ステートメントと EXEC user_defined_function ステートメントに対して次の権限が必要です。
Transact-SQL ステートメントを実行するための適切な権限。
SHOWPLAN 権限。これは、Transact-SQL ステートメントで参照されるオブジェクト (テーブルやビューなど) を含むすべてのデータベースに対して必要です。
DDL、USE database_name、SET、DECLARE、動的 SQL など、その他すべてのステートメントでは、Transact-SQL ステートメントを実行するための適切な権限だけが必要です。
詳細については、「プラン表示のセキュリティ」および「SHOWPLAN 権限と Transact-SQL バッチ」を参照してください。
例
次の 2 つのステートメントは、SET SHOWPLAN_ALL の設定を使用して、SQL Server でクエリ内のインデックスの使用状況を分析し最適化する方法を示しています。
最初のクエリでは、インデックス列の WHERE 句で = (等しい) 比較演算子を使用しています。この結果、LogicalOp 列に Clustered Index Seek 値が格納され、Argument 列にインデックスの名前が格納されます。
2 番目のクエリでは、WHERE 句で LIKE 演算子を使用します。このように指定すると、SQL Server ではクラスタ化インデックス スキャンが行われ、WHERE 句の条件を満たすデータが検索されます。この結果、LogicalOp 列に Clustered Index Scan 値、Argument 列にインデックスの名前、LogicalOp 列にフィルタ値、Argument 列に WHERE 句の条件がそれぞれ格納されます。
EstimateRows 列と TotalSubtreeCost 列の値は、インデックスが設定された最初のクエリの方が小さくなるので、インデックスが設定されていないクエリよりも速く処理が行われ、使用リソースが少なかったことがわかります。
USE AdventureWorks;
GO
SET SHOWPLAN_ALL ON;
GO
-- First query.
SELECT EmployeeID
FROM HumanResources.Employee
WHERE NationalIDNumber = '509647174';
GO
-- Second query.
SELECT EmployeeID, EmergencyContactID
FROM HumanResources.Employee
WHERE EmergencyContactID LIKE '1%';
GO
SET SHOWPLAN_ALL OFF;
GO