sys.query_store_query_hints (Transact-SQL)

適用対象: SQL Server 2022 (16.x) Azure SQL DatabaseAzure SQL Managed Instance

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

列名	データ型	説明
query_hint_id	bigint	クエリ ヒントの一意の識別子。
query_id	bigint	クエリ ストア内のクエリの一意の識別子。 sys.query_store_query.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	sys.query_store_replicasの列に従って、ヒントを適用するスコープをreplica_group_id決定します。

解説

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

アクセス許可

VIEW DATABASE 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)