sys.query_store_query_hints (Transact-SQL)

適用対象: SQL Server 2022 (16.x) Azure SQL データベースAzure SQL Managed Instance

クエリ ストア ヒントからクエリ ヒントを返します。

列名	データ型	説明
query_hint_id	bigint	クエリ ヒントの一意の識別子。
query_id	bigint	クエリ ストア内のクエリの一意の識別子。 query_idの列への外部キー。
query_hint_text	nvarchar(max)	の形式のヒント定義 N'OPTION (...)
last_query_hint_failure_reason	int	ヒントを適用できないときに返されるエラー コード。 エラー メッセージの message_id が含まれます。
last_query_hint_failure_reason_desc	nvarchar(128)	エラー メッセージのエラーの説明が含まれます。
query_hint_failure_count	bigint	クエリ ヒントが作成または最後に変更されてからクエリ ヒント アプリケーションが失敗した回数。
source	int	クエリ ストア ヒントのソース: ユーザー ソースは 0 であり、システム生成は 0 以外です。
source_desc	nvarchar(128)	クエリ ストア ヒントのソースの説明。
comment	nvarchar(max)	内部のみで使用します。
query_hint_scope	tinyint	ヒントが適用されるスコープを、replica_group_idの列に従って決定します。

解説

クエリ ストアヒントはsys.sp_query_store_set_hintsによって作成され、sys.sp_query_store_clear_hintsによって削除されます。

アクセス許可

SQL Server 2019 (15.x) 以前のバージョンでは、サーバーに対する VIEW SERVER STATE アクセス許可が必要です。

SQL Server 2022 (16.x) 以降のバージョンでは、サーバーに対する VIEW SERVER PERFORMANCE STATE アクセス許可が必要です。

例

クエリ ストアのヒントを表示する

次の例では、query_id 39 の既存クエリ ストア ヒントが返されます。

SELECT query_hint_id,
       query_id,
       query_hint_text,
       last_query_hint_failure_reason,
       last_query_hint_failure_reason_desc,
       query_hint_failure_count,
       source,
       source_desc
FROM sys.query_store_query_hints
WHERE query_id = 39;

関連するコンテンツ

• クエリ ストアのヒント
• sys.sp_query_store_set_hints
• sys.sp_query_store_clear_hints
• sys.query_store_query (Transact-SQL)