Condividi tramite


sys.sp_xtp_checkpoint_force_garbage_collection (Transact-SQL)

Si applica a: SQL Server

Contrassegna i file di origine usati nell'operazione di unione con il numero di sequenza di log (LSN) dopo il quale non sono necessari e possono essere sottoposto a Garbage Collection. sys.sp_xtp_checkpoint_force_garbage_collection Sposta inoltre i file il cui LSN associato è inferiore al punto di troncamento del log in Garbage Collection FILESTREAM.

A differenza di sys.sp_xtp_force_gc, il motore in memoria rilascia la memoria correlata alle righe eliminate di dati in memoria idonei per l'operazione di Garbage Collection, che non sono ancora state rilasciate dal processo.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @dbname = ] 'database_name'

Il database in cui eseguire Garbage Collection. Il valore predefinito è il database attuale. @dbname è sysname.

Valori del codice restituito

0 per il successo. Diverso da zero per l'esito negativo.

Set di risultati

Ogni riga restituita contiene le informazioni seguenti:

Colonna Descrizione
num_collected_items Indica il numero di file spostati in Garbage Collection FILESTREAM. Il numero di sequenza del log (LSN) di questi file è minore dell'LSN del punto di troncamento del log.
num_marked_for_collection_items Indica il numero dei file di dati o dei file differenziali con un LSN aggiornato con l'ID blocco dell'LSN di fine log.
last_collected_xact_seqno Restituisce l'ultimo LSN corrispondente fino al quale i file sono stati spostati in Garbage Collection FILESTREAM.

Osservazioni:

È possibile attivare manualmente Garbage Collection con un'altra stored procedure di sistema, sys.sp_xtp_force_gc. È possibile osservare la riduzione della pulizia della memoria in sys.dm_xtp_system_memory_consumers.

In SQL Server 2022 (16.x), la vista a gestione dinamica sys.dm_xtp_system_memory_consumers ha migliorato informazioni dettagliate specifiche per i metadati tempDB ottimizzati per la memoria.

Autorizzazioni

Richiede l'adesione al ruolo predefinito del database db_owner.

Esempi

Per contrassegnare i file di origine non necessari per Garbage Collection nel tempdb database, usare lo script di esempio seguente:

EXEC sys.sp_xtp_checkpoint_force_garbage_collection N'tempdb';