sp_changedistributiondb (Transact-SQL)

Article
12/22/2023

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= ] 'database'   
    [ , [ @property= ] 'property' ]   
    [ , [ @value= ] 'value' ]

Arguments

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

[ @property = ] 'property' Propriété à modifier pour la base de données donnée. 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 (par défaut)	Toutes les valeurs de propriété disponibles sont imprimées.

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

Codet de retour

0 (réussite) ou 1 (échec)

Notes

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

Exemple

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 exécuter sp_changedistributiondb.

Voir aussi

Afficher et modifier les propriétés d’un serveur de distribution ou d’un serveur de publication
sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)