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;