sys.query_store_plan (Transact-SQL)

適用対象: SQL Server 2016 (13.x) 以降 Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics

クエリに関連付けられた各実行プランに関する情報が含まれます。

解説

セカンダリ レプリカのクエリ ストアが有効になっている場合は複数のプランを強制できます。

Azure Synapse Analytics では、列 has_compile_replay_script、 is_optimized_plan_forcing_disabled、 plan_typeを使用 plan_type_desc 、サポートされていないため、 Invalid Column Name エラーが発生します。 Azure Synapse Analytics でsys.query_store_planを使用する方法の例については、Example B を参照してください。

プランの適用の制限事項

クエリ ストアには、クエリ オプティマイザーに特定の実行プランを使用させるためのメカニズムがあります。 ただし、適用の適用を妨げる可能性のある制限がいくつかあります。

第 1 に、プランに次の構造が含まれる場合です。

• 一括ステートメントを挿入する
• 外部テーブルの参照
• 分散クエリまたはフルテキスト操作
• 弾性クエリの使用
• 動的カーソルまたはキーセット カーソル
• 無効なスター結合の指定

第 2 に、プランが依存しているオブジェクトが使用できなくなった場合です。

• データベース (プランが発生したデータベースが存在しなくなった場合)
• インデックス (存在しない場合、または無効になった場合)

最後に、プラン自体に問題がある場合です。

• クエリに対して有効ではない
• クエリ オプティマイザーが許可されている操作の数を超えた
• プランの XML の形式が正しくない

アクセス許可

VIEW DATABASE STATE アクセス許可が必要です。

例

A. SQL Server が QDS 経由でプランを強制できなかった理由を見つける

last_force_failure_reason_desc列とforce_failure_count列に注意してください。

SELECT TOP 1000
    p.query_id,
    p.plan_id,
    p.last_force_failure_reason_desc,
    p.force_failure_count,
    p.last_compile_start_time,
    p.last_execution_time,
    q.last_bind_duration,
    q.query_parameterization_type_desc,
    q.context_settings_id,
    c.set_options,
    c.STATUS
FROM sys.query_store_plan p
INNER JOIN sys.query_store_query q
    ON p.query_id = q.query_id
INNER JOIN sys.query_context_settings c
    ON c.context_settings_id = q.context_settings_id
LEFT JOIN sys.query_store_query_text t
    ON q.query_text_id = t.query_text_id
WHERE p.is_forced_plan = 1
    AND p.last_force_failure_reason != 0;

B. Azure Synapse Analytics でクエリ プランの結果を表示するクエリ

次のサンプル クエリを使用して、Azure Synapse Analytics のクエリ ストアで最新の 100 個の実行プランを検索します。

SELECT TOP 100
    plan_id,
    query_id,
    plan_group_id,
    engine_version,
    compatibility_level,
    query_plan_hash,
    query_plan,
    is_online_index_plan,
    is_trivial_plan,
    is_parallel_plan,
    is_forced_plan,
    is_natively_compiled,
    force_failure_count,
    last_force_failure_reason,
    last_force_failure_reason_desc,
    count_compiles,
    initial_compile_start_time,
    last_compile_start_time,
    last_execution_time,
    avg_compile_duration,
    last_compile_duration,
    plan_forcing_type,
    plan_forcing_type_desc
FROM sys.query_store_plan
ORDER BY last_execution_time DESC;

関連するコンテンツ

• クエリ ストアを使用したパフォーマンスの監視
• sys.database_query_store_options (Transact-SQL)
• sys.query_context_settings (Transact-SQL)
• sys.query_store_query (Transact-SQL)
• sys.query_store_query_text (Transact-SQL)
• sys.query_store_runtime_stats (Transact-SQL)
• sys.query_store_wait_stats (Transact-SQL)
• sys.query_store_runtime_stats_interval (Transact-SQL)
• システム カタログ ビュー (Transact-SQL)
• クエリ ストアのストアド プロシージャ (Transact-SQL)