Compartilhar via


sys.sp_persistent_version_cleanup (Transact-SQL)

Aplica-se a: SQL Server 2019 (15.x) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Inicia manualmente o processo de limpeza do PVS (repositório de versão persistente), um elemento-chave da ADR (recuperação acelerada de banco de dados). Esse limpador reverte dados não confirmados no PVS de transações anuladas.

Normalmente, não é necessário iniciar o processo de limpeza do PVS manualmente usando sys.sp_persistent_version_cleanupo . No entanto, em alguns cenários, em um período conhecido de repouso/recuperação após atividade OLTP ocupada, talvez você queira iniciar o processo de limpeza do PVS manualmente.

Para obter mais informações sobre o ADR no Azure SQL, consulte Recuperação Acelerada de Banco de Dados no Azure SQL.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_persistent_version_cleanup
    [ [ @dbname = ] N'dbname' ]
    [ , [ @scanallpages = ] scanallpages ]
    [ , [ @clean_option = ] clean_option ]
[ ; ]

Argumentos

@dbname [ = ] N'dbname'

Opcional. O nome do banco de dados a ser limpo. Se não for fornecido, usa o contexto de banco de dados atual. @dbname é sysname, com um padrão de NULL.

@scanallpages [ = ] scanallpages

Opcional. @scanallpages é bit, com um padrão de 0. Quando definida como 1, essa opção força a limpeza de todas as páginas do banco de dados, mesmo que não tenham controle de versão.

@clean_option [ = ] clean_option

Opcional. As opções possíveis determinam se a página PVS fora da linha deve ou não ser recuperada. @clean_option é int, com um padrão de 0. Essa referência geralmente não é necessária e o valor 0 padrão é recomendado.

Valor Descrição
0 Padrão, nenhuma opção especificada
1 armazenamento de versão fora da linha sem verificar o conteúdo da página PVS individual
2 repositório de versão fora da linha com cada página PVS visitada
3 somente repositório de versão em linha
4 Apenas para uso interno

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Permissões

Requer a permissão ALTER DATABASE para ser executada.

Comentários

O sys.sp_persistent_version_cleanup procedimento armazenado é síncrono, o que significa que ele não é concluído até que todas as informações de versão sejam limpas do PVS atual.

No SQL Server 2019 (15.x), o processo de limpeza do PVS é executado apenas para um banco de dados por vez. No Banco de Dados SQL do Azure e na Instância Gerenciada de SQL do Azure, e a partir do SQL Server 2022 (16.x), o processo de limpeza do PVS pode ser executado em paralelo em vários bancos de dados na mesma instância.

Se o processo de limpeza do PVS já estiver em execução no banco de dados desejado, esse procedimento armazenado será bloqueado e aguardará a conclusão antes de iniciar outro processo de limpeza do PVS. Transações ativas e de longa execução em qualquer banco de dados em que a ADR esteja habilitada também podem bloquear a limpeza do PVS. Você pode monitorar a tarefa do limpador de versão procurando seu processo com a seguinte consulta de exemplo:

SELECT *
FROM sys.dm_exec_requests
WHERE command LIKE '%PERSISTED_VERSION_CLEANER%';

Limitações

O espelhamento de banco de dados não pode ser definido para um banco de dados em que a ADR está habilitada ou ainda há versões no PVS (repositório de versão persistente). Se o ADR estiver desabilitado, execute sys.sp_persistent_version_cleanup para limpar as versões anteriores ainda no PVS.

Exemplos

Para ativar o processo de limpeza do PVS manualmente entre cargas de trabalho ou durante as janelas de manutenção, use o seguinte script de exemplo:

EXEC sys.sp_persistent_version_cleanup [database_name];

Por exemplo:

EXEC sys.sp_persistent_version_cleanup [WideWorldImporters];

Ou, para assumir o contexto atual do banco de dados:

USE [WideWorldImporters];
GO
EXEC sys.sp_persistent_version_cleanup;