Freigeben über


sp_query_store_clear_hints (Transact-SQL)

Gilt für: SQL Server 2022 (16.x) und höhere Versionen von Azure SQL DatabaseAzure SQL Managed InstanceSQL SQL database in Microsoft Fabric

Entfernt alle Abfragespeicher Hinweise für eine bestimmte Abfrage-ID.

Transact-SQL-Syntaxkonventionen

Syntax

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

Arguments

Important

Argumente für erweiterte gespeicherte Prozeduren müssen in der spezifischen Reihenfolge eingegeben werden, wie im Abschnitt Syntax beschrieben. Wenn die Parameter außerhalb der Reihenfolge eingegeben werden, tritt eine Fehlermeldung auf.

[ @query_id = ] query_id

Die Abfragespeicher query_id Spalte aus sys.query_store_query. query_id ist groß.

[ @replica_group_id = ] 'replica_group_id'

Das optionale @replica_group_id Argument ist standardmäßig für das lokale Replikat (primär oder sekundär) festgelegt, Sie können aber optional einen Wert angeben, der einem Wert in der replica_group_id Spalte in sys.query_store_replicas entspricht, um einen Hinweis für eine andere Replikatgruppe zu löschen. @replica_group_id ist groß.

Rückgabewert

0 (erfolgreich) oder 1 Fehler.

Remarks

Abfragespeicher Hinweise werden von sys.sp_query_store_set_hints erstellt.

Permissions

Erfordert die Berechtigung ALTER für die Datenbank.

Examples

Löschen von Abfragehinweistext

Im folgenden Beispiel wird der Abfragespeicher Hinweistext für query_id 39 entfernt:

EXECUTE sys.sp_query_store_clear_hints @query_id = 39;

Anzeigen von Abfragespeicherhinweisen

Im folgenden Beispiel werden vorhandene Abfragespeicher Hinweise für query_id 39 zurückgegeben:

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;