sp_query_store_clear_hints（Transact-SQL）

適用於： SQL Server 2022 （16.x） 及後版本 Azure SQL Database AzureSQL Managed InstanceMicrosoft Fabric 中的 SQL 資料庫

拿掉指定查詢識別碼的所有 查詢存放區 提示。

Transact-SQL 語法慣例

Syntax

sp_query_store_clear_hints
    [ @query_id = ] query_id
    [ , [ @replica_group_id = ] 'replica_group_id' ]
[ ; ]

Arguments

Important

擴充預存程式的自變數必須依特定順序輸入，如 語法 一節所述。 如果參數依序輸入，就會發生錯誤訊息。

[ @query_id = ] query_id

query_idsys.query_store_query中的 查詢存放區 數據行。 query_id是 bigint。

[ @replica_group_id = ] 「replica_group_id」

選擇性 @replica_group_id 自變數預設為本機複本（主要或次要複本），但您可以選擇性地指定符合數據行中 replica_group_id 值的值 ，sys.query_store_replicas 以清除不同複本群組的提示。 @replica_group_id是 bigint。

返回值

0 (成功) 或 1 (失敗)。

Remarks

sys.sp_query_store_set_hints會建立 查詢存放區 提示。

Permissions

需要資料庫的 ALTER 權限。

Examples

清除查詢提示文字

下列範例會移除 query_id 39 的 查詢存放區 提示文字：

EXECUTE sys.sp_query_store_clear_hints @query_id = 39;

檢視 查詢存放區 提示

下列範例會傳回query_id 39 的現有 查詢存放區 提示：

SELECT query_hint_id,
       query_id,
       replica_group_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 （Transact-SQL）
• sys.query_store_query_hints（Transact-SQL）
• 查詢存放區提示
• 使用查詢存放區監視效能