次の方法で共有


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_queryquery_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_replicasreplica_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;