sys.sp_xtp_checkpoint_force_garbage_collection (Transact-SQL)

Aplica-se a:SQL Server

Marca os arquivos de origem usados na operação de mesclagem com o número de sequência de log (LSN) após o qual eles não são necessários e podem ser coletados lixo. Além disso, sys.sp_xtp_checkpoint_force_garbage_collection move os arquivos cujo LSN associado é menor que o ponto de truncamento de log para a coleta de lixo FILESTREAM.

Contraste com o sys.sp_xtp_force_gc, que faz com que o mecanismo na memória libere memória relacionada a linhas excluídas de dados na memória que são elegíveis para coleta de lixo, que ainda não foram liberadas pelo processo.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@dbname [ = ] 'database_name'

O banco de dados no qual será executada a coleta de lixo. O padrão é o banco de dados atual. @dbname é sysname.

Valores do código de retorno

0 para o sucesso. Diferente de zero para falha.

Conjunto de resultados

Uma linha retornada contém as seguintes informações:

Coluna Descrição
num_collected_items Indica o número de arquivos que foram movidos para a coleta de lixo FILESTREAM. O número de sequência de log (LSN) desses arquivos é menor que o LSN do ponto de truncamento de log.
num_marked_for_collection_items Indica o número de arquivos de dados/delta cujo LSN foi atualizado com o blockID de log do LSN de fim de log.
last_collected_xact_seqno Retorna o último LSN correspondente até o qual os arquivos foram movidos para a coleta de lixo FILESTREAM.

Comentários

Você pode acionar manualmente a coleta de lixo com outro procedimento armazenado do sistema, sys.sp_xtp_force_gc. Você pode observar a redução na limpeza de memória em sys.dm_xtp_system_memory_consumers.

No SQL Server 2022 (16.x), o modo de exibição de gerenciamento dinâmico sys.dm_xtp_system_memory_consumers aprimorou insights específicos para metadados tempdb otimizados para memória.

Permissões

Requer associação na função de banco de dados fixa db_owner.

Exemplos

Para marcar arquivos de origem desnecessários para coleta de lixo no tempdb banco de dados, use o seguinte script de exemplo:

EXEC sys.sp_xtp_checkpoint_force_garbage_collection N'tempdb';