sp_changedistributiondb (Transact-SQL)sp_changedistributiondb (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Modifie les propriétés de la base de données de distribution.Changes the properties of the distribution database. Cette procédure stockée est exécutée sur n’importe quelle base de données du serveur de distribution.This stored procedure is executed at the Distributor on any database.

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

SyntaxeSyntax

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

ArgumentsArguments

[ @database = ] 'database'Nom de la base de données de distribution.[ @database = ] 'database' Is the name of the distribution database. Database est de type sysname, sans valeur par défaut.database is sysname, with no default.

[ @property = ] 'property'Propriété à modifier pour la base de données spécifiée.[ @property = ] 'property' Is the property to change for the given database. Property est de type sysnameet peut prendre l’une des valeurs suivantes.property is sysname, and can be one of these values.

ValueValue DescriptionDescription
history_retentionhistory_retention Période de rétention de la table historique.History table retention period.
max_distretentionmax_distretention Période maximale de rétention de distribution.Maximum distribution retention period.
min_distretentionmin_distretention Période de rétention de distribution minimale.Minimum distribution retention period.
NULL (par défaut)NULL (default) Toutes les valeurs de propriété disponibles sont imprimées.All available property values are printed.

[ @value = ] 'value'Nouvelle valeur de la propriété spécifiée.[ @value = ] 'value' Is the new value for the specified property. la valeur est de type nvarchar (255) , avec NULL comme valeur par défaut.value is nvarchar(255), with a default of NULL.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_changedistributiondb est utilisé dans tous les types de réplications.sp_changedistributiondb is used in all types of replication.

ExempleExample

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 

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_changedistributiondb.Only members of the sysadmin fixed server role can execute sp_changedistributiondb.

Voir aussiSee Also

Afficher et modifier les propriétés d’un serveur de distribution et d’un serveur de publication View and Modify Distributor and Publisher Properties
sp_adddistributiondb (Transact-SQL) sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL) sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL) sp_helpdistributiondb (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)