sys.sp_xtp_checkpoint_force_garbage_collection (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Markiert Quelldateien, die im Zusammenführungsvorgang verwendet werden, mit der Protokollsequenznummer (Log Sequence Number, LSN), nach der sie nicht benötigt werden, und kann garbage collection werden. Verschiebt außerdem die Dateien, sys.sp_xtp_checkpoint_force_garbage_collection deren zugeordnete LSN niedriger als der Protokollabkürzungspunkt ist, in die Garbage Collection von FILESTREAM.

Im Gegensatz zu sys.sp_xtp_force_gc, was bewirkt, dass das In-Memory-Modul Speicher im Zusammenhang mit gelöschten Zeilen von In-Memory-Daten freigibt, die für die Garbage Collection berechtigt sind, die noch nicht vom Prozess freigegeben wurden.

Transact-SQL-Syntaxkonventionen

Syntax

sys.sp_xtp_checkpoint_force_garbage_collection
    [ [ @dbname = ] 'database_name' ]
[ ; ]

Argumente

[ @dbname = ] 'database_name'

Die Datenbank, für die die Garbage Collection ausgeführt werden soll. Gemäß Standardeinstellung die aktuelle Datenbank. @dbname ist "sysname".

Rückgabecodewerte

0 für Erfolg. Ungleich 0 für Fehler.

Resultset

Eine zurückgegebene Zeile enthält die folgenden Informationen:

Spalte Beschreibung
num_collected_items Gibt die Anzahl der Dateien an, die in die Garbage Collection von FILESTREAM verschoben wurden. Die Protokollsequenznummer (LSN) dieser Dateien ist kleiner als der LSN des Protokollabkürzungspunkts.
num_marked_for_collection_items Gibt die Anzahl der Daten-/Änderungsdateien an, deren LSN mit der Protokollblock-ID der Protokollende-LSN aktualisiert wurde.
last_collected_xact_seqno Gibt den letzten entsprechenden LSN zurück, in den die Dateien in die Garbage Collection von FILESTREAM verschoben wurden.

Hinweise

Sie können die Garbage Collection manuell mit einer anderen gespeicherten Systemprozedur auslösen. sys.sp_xtp_force_gc Sie können die Reduzierung des Arbeitsspeichers sauber in sys.dm_xtp_system_memory_consumers beobachten.

In SQL Server 2022 (16.x) verfügt die sys.dm_xtp_system_memory_consumers dynamische Verwaltungsansicht über verbesserte Einblicke, die für speicheroptimierte tempdb-Metadaten spezifisch sind.

Berechtigungen

Hierfür ist die Mitgliedschaft in der festen Datenbankrolle db_owner erforderlich.

Beispiele

Verwenden Sie das folgende Beispielskript, um nicht benötigte Quelldateien für die Garbage Collection in der tempdb Datenbank zu markieren:

EXEC sys.sp_xtp_checkpoint_force_garbage_collection N'tempdb';

Zugehöriger Inhalt