sp_changedistributiondb (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @database=] 'database'
    Nom de la base de données de distribution. database est de type sysname et n'a pas de valeur par défaut.

  • [ @property=] 'property'
    Propriété à modifier pour la base de données concernée. property est de type sysname et peut prendre l'une des valeurs suivantes :

    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 disponibles de property sont imprimées.

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

Valeurs des codes renvoyés

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

Notes

La procédure sp_changedistributiondb est utilisée dans tous les types de réplications.

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 la procédure sp_changedistributiondb.