Compartilhar via


sp_filestream_force_garbage_collection (Transact-SQL)

Aplica-se: SQL Server

Força o coletor de lixo (GC) FILESTREAM a ser executado, excluindo todos os arquivos FILESTREAM desnecessários.

Um contêiner FILESTREAM não pode ser removido até que todos os arquivos excluídos dentro dele sejam limpos pelo GC. O FILESTREAM GC é executado automaticamente. No entanto, se você precisar remover um contêiner antes que o GC seja executado, poderá usar sp_filestream_force_garbage_collection para executar o GC manualmente.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_filestream_force_garbage_collection
    [ @dbname = ] 'database_name'
    [ , [ @filename = ] 'logical_file_name' ]
[ ; ]

Argumentos

@dbname [ = ] 'database_name'

Significa o nome do banco de dados no qual o GC será executado.

@dbname é sysname. Se não for especificado, o banco de dados atual será assumido.

@filename [ = ] 'logical_file_name'

Especifica o nome lógico do contêiner FILESTREAM no qual o GC será executado. @filename é opcional. Se nenhum nome de arquivo lógico for especificado, o GC limpará todos os contêineres FILESTREAM no banco de dados especificado.

Valores do código de retorno

Valor Descrição
0 Êxito na operação
1 Falha na operação

Conjunto de resultados

Valor Descrição
file_name Indica o nome de contêiner FILESTREAM
num_collected_items Indica o número de itens FILESTREAM (arquivos ou diretórios) que foram coletados (excluídos) neste contêiner.
num_marked_for_collection_items Indica o número de itens FILESTREAM (arquivos ou diretórios) que foram marcados para GC neste contêiner. Esses itens ainda não foram excluídos, mas podem estar qualificados para exclusão após a fase de GC.
num_unprocessed_items Indica o número de itens FILESTREAM qualificados (arquivos ou diretórios) que não foram processados para GC neste contêiner FILESTREAM. Os itens podem não ser processados por vários motivos, incluindo:

- Arquivos que precisam ser fixados porque um backup de log ou ponto de verificação não foi feito.

- Arquivos no modelo de recuperação FULL ou BULK_LOGGED.

- Há uma transação ativa de longa duração.

- O trabalho do leitor de log de replicação não foi executado. Consulte o white paper Armazenamento FILESTREAM no SQL Server 2008 para obter mais informações.
last_collected_xact_seqno Retorna o número de sequência de log correspondente (LSN) até onde os arquivos do contêiner FILESTREAM especificado foram coletados pelo coletor de lixo.

Comentários

Executa explicitamente a tarefa de coleta de lixo FILESTREAM até a conclusão no banco de dados solicitado (e no contêiner FILESTREAM). O processo de GC remove arquivos que não são mais necessários. O tempo necessário para que essa operação seja concluída depende do tamanho dos dados FILESTREAM nesse banco de dados ou contêiner e da quantidade de atividade DML que ocorreu recentemente nos dados FILESTREAM. Embora essa operação possa ser executada com o banco de dados online, isso pode afetar o desempenho do banco de dados durante sua execução devido a várias atividades de E/S feitas pelo processo de GC.

Observação

Recomenda-se que essa operação seja executada somente quando necessário e fora do horário normal de operação.

É possível executar várias invocações desse procedimento armazenado simultaneamente em contêineres ou em bancos de dados separados.

Devido às operações de duas fases, o procedimento armazenado deve ser executado duas vezes para realmente excluir os arquivos FILESTREAM subjacentes.

A coleta de lixo depende do truncamento de log. Portanto, se os arquivos foram excluídos recentemente em um banco de dados usando o modelo de recuperação completa, eles serão coletados como lixo somente depois que um backup de log dessas partes do log de transações for feito e a parte do log for marcada como inativa. Em um banco de dados que usa o modelo de recuperação simples, um truncamento de log ocorre depois que a CHECKPOINT é emitido no banco de dados.

Permissões

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

Exemplos

Os exemplos a seguir executam o GC para contêineres FILESTREAM no fsdb banco de dados.

R. Não especificar nenhum contêiner

USE fsdb;
GO
EXEC sp_filestream_force_garbage_collection @dbname = N'fsdb';

B. Especificar um contêiner

USE fsdb;
GO
EXEC sp_filestream_force_garbage_collection @dbname = N'fsdb',
    @filename = N'FSContainer';