Partager via


sp_changedistributiondb (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Modifie les propriétés de la base de données de distribution. Cette procédure stockée est exécutée sur le serveur de distribution sur n’importe quelle base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_changedistributiondb
    [ @database = ] N'database'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

Arguments

[ @database = ] N’database'

Nom de la base de données de distribution. @database est sysname, sans valeur par défaut.

[ @property = ] N’property'

Propriété à modifier pour la base de données donnée. @property est sysname et peut être l’une de ces valeurs.

Valeur Description
history_retention Période de rétention de la table historique.
max_distretention Période maximale de rétention de distribution.
min_distretention Période de rétention de distribution minimale.
NULL (valeur par défaut) Toutes les valeurs de @property disponibles sont imprimées.

[ @value = ] N’value'

Nouvelle valeur de la propriété spécifiée. @value est nvarchar(255), avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_changedistributiondb est utilisé dans tous les types de réplication.

Exemples

DECLARE @distributionDB AS sysname;
SET @distributionDB = N'distribution';

-- Change the history retention period to 24 hours and the
-- maximum retention period to 48 hours.  
USE distribution
EXEC sp_changedistributiondb @distributionDB, N'history_retention', 24
EXEC sp_changedistributiondb @distributionDB, N'max_distretention', 48
GO

autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_changedistributiondb