sp_mergemetadataretentioncleanup (Transact-SQL)sp_mergemetadataretentioncleanup (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Effectue un nettoyage manuel des métadonnées dans le MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_ mappages, et MSmerge_current_partition_mappings tables système.Performs a manual cleanup of metadata in the MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappings, and MSmerge_current_partition_mappings system tables. Cette procédure stockée est exécutée sur chaque serveur de publication et abonné dans la topologie.This stored procedure is executed at each Publisher and Subscriber in the topology.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
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 ]  

ArgumentsArguments

[ @num_genhistory_rows = ] num_genhistory_rows OUTPUT Retourne le nombre de lignes nettoyées dans le MSmerge_genhistory table.[ @num_genhistory_rows = ] num_genhistory_rows OUTPUT Returns the number of rows cleaned-up from the MSmerge_genhistory table. num_genhistory_rows est int, avec une valeur par défaut 0.num_genhistory_rows is int, with a default of 0.

[ @num_contents_rows = ] num_contents_rows OUTPUT Retourne le nombre de lignes nettoyées dans le MSmerge_contents table.[ @num_contents_rows = ] num_contents_rows OUTPUT Returns the number of rows cleaned-up from the MSmerge_contents table. num_contents_rows est int, avec une valeur par défaut 0.num_contents_rows is int, with a default of 0.

[ @num_tombstone_rows = ] num_tombstone_rows OUTPUT Retourne le nombre de lignes nettoyées dans le MSmerge_tombstone table.[ @num_tombstone_rows = ] num_tombstone_rows OUTPUT Returns the number of rows cleaned-up from the MSmerge_tombstone table. num_tombstone_rows est int, avec une valeur par défaut 0.num_tombstone_rows is int, with a default of 0.

[ @aggressive_cleanup_only = ] aggressive_cleanup_only Usage interne uniquement.[ @aggressive_cleanup_only = ] aggressive_cleanup_only Internal use only.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

Important

S’il existe plusieurs publications sur une base de données, et l’une des publications utilise une période de rétention de publication infinie, en cours d’exécution sp_mergemetadataretentioncleanup ne nettoie pas la suivi de la modification de la réplication de fusion métadonnées de la base de données.If there are multiple publications on a database, and any one of those publications uses an infinite publication retention period, running sp_mergemetadataretentioncleanup does not clean up the merge replication change tracking metadata for the database. C'est pour cette raison qu'il faut utiliser la période de rétention infinie avec prudence.For this reason, use infinite publication retention with caution. Pour déterminer si une publication a une période de rétention infinie, exécutez sp_helpmergepublication (Transact-SQL) le serveur de publication et notez toutes les publications dans le résultat défini avec une valeur de 0 pour rétention.To determine if a publication has an infinite retention period, execute sp_helpmergepublication (Transact-SQL) at the Publisher and note any publications in the result set with a value of 0 for retention.

AutorisationsPermissions

Seuls les membres de la db_owner fixe le rôle de base de données ou des utilisateurs dans la liste d’accès d’une base de données publiée peut exécuter sp_mergemetadataretentioncleanup.Only members of the db_owner fixed database role or users in the publication access list for a published database can execute sp_mergemetadataretentioncleanup.

Voir aussiSee Also

Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)