sys.sp_mergemetadataretentioncleanup (Transact-SQL)

Aplica-se a: SQL Server

Realiza uma limpeza manual dos metadados nas tabelas de sistema MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappings e MSmerge_current_partition_mappings . Este procedimento armazenado é executado em cada Publisher e Subscriber na topologia.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_mergemetadataretentioncleanup
    [ [ @num_genhistory_rows = ] num_genhistory_rows OUTPUT ]
    [ , [ @num_contents_rows = ] num_contents_rows OUTPUT ]
    [ , [ @num_tombstone_rows = ] num_tombstone_rows OUTPUT ]
    [ , [ @aggressive_cleanup_only = ] aggressive_cleanup_only ]
[ ; ]

Arguments

[ @num_genhistory_rows = ] num_genhistory_rows SAÍDA

Devolve o número de linhas limpas da tabela MSmerge_genhistory . @num_genhistory_rows é um OUTPUT parâmetro do tipo int, com um padrão de 0.

[ @num_contents_rows = ] num_contents_rows SAÍDA

Devolve o número de linhas limpas da tabela MSmerge_contents . @num_contents_rows é um OUTPUT parâmetro do tipo int, com um padrão de 0

[ @num_tombstone_rows = ] num_tombstone_rows SAÍDA

Devolve o número de linhas limpas da tabela MSmerge_tombstone . @num_tombstone_rows é um OUTPUT parâmetro do tipo int, com um padrão de 0.

[ @aggressive_cleanup_only = ] aggressive_cleanup_only

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

Se houver várias publicações numa base de dados, e qualquer uma dessas publicações usar um período infinito de retenção de publicações, a execução sp_mergemetadataretentioncleanup não limpa os metadados de rastreio de alterações da replicação da fusão para a base de dados. Por esta razão, use com cautela a retenção infinita de publicações. Para determinar se uma publicação tem um período de retenção infinito, execute sp_helpmergepublication no Publisher e note quaisquer publicações no conjunto de resultados com um valor de 0 para retention.

Permissions

Apenas os membros da db_owner função fixa de base de dados ou utilizadores na lista de acesso à publicação para uma base de dados publicada podem executar sp_mergemetadataretentioncleanup.