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 | クエリ ストア内のクエリの一意の識別子。 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によって作成され、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;