sp_adddistributor (Transact-SQL)sp_adddistributor (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

Crée une entrée dans la table sys. sysservers (le cas échéant), marque l’entrée de serveur en tant que serveur de distribution et stocke les informations de propriété.Creates an entry in the sys.sysservers table (if there is not one), marks the server entry as a Distributor, and stores property information. Cette procédure stockée est exécutée sur la base de données master du serveur de distribution pour enregistrer et marquer le serveur en tant que serveur de distribution.This stored procedure is executed at the Distributor on the master database to register and mark the server as a distributor. Dans le cas d'un serveur de distribution distant, la procédure stockée est également exécutée sur le serveur de publication à partir de la base de données master.In the case of a remote distributor, it is also executed at the Publisher from the master database to register the remote distributor.

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

SyntaxeSyntax

  
sp_adddistributor [ @distributor= ] 'distributor'   
    [ , [ @heartbeat_interval= ] heartbeat_interval ]   
    [ , [ @password= ] 'password' ]   
    [ , [ @from_scripting= ] from_scripting ]  

ArgumentsArguments

[ @distributor = ] 'distributor'Nom du serveur de distribution.[ @distributor = ] 'distributor' Is the distribution server name. Distributor est de type sysname, sans valeur par défaut.distributor is sysname, with no default. Ce paramètre est uniquement utilisé lors de la configuration d'un serveur de distribution distant.This parameter is only used if setting up a remote Distributor. Elle ajoute des entrées pour les propriétés du serveur de distribution dans la base de données msdb. Table MSdistributor .It adds entries for the Distributor properties in the msdb..MSdistributor table.

[ @heartbeat_interval = ] heartbeat_intervalNombre maximal de minutes pendant lesquelles un agent peut se connecter sans enregistrer de message de progression.[ @heartbeat_interval = ] heartbeat_interval Is the maximum number of minutes that an agent can go without logging a progress message. heartbeat_interval est de type int, avec 10 minutes comme valeur par défaut.heartbeat_interval is int, with a default of 10 minutes. Un travail de l'Agent SQL Server est créé et s'exécute pendant cet intervalle de temps pour contrôler l'état des agents de réplication en cours d'exécution.A SQL Server Agent job is created that runs on this interval to check the status of the replication agents that are running.

[ @password = ] 'password']Mot de passe de la connexion distributor_admin .[ @password = ] 'password'] Is the password of the distributor_admin login. Password est de type sysname, avec NULL comme valeur par défaut.password is sysname, with a default of NULL. Si le mot de passe est NULL ou est une chaîne vide, une valeur aléatoire est redéfinie pour lui.If NULL or an empty string, password is reset to a random value. Le mot de passe doit être configuré lors de l'ajout du premier serveur de distribution distant.The password must be configured when the first remote distributor is added. la connexion et le mot de passe distributor_admin sont stockés pour l’entrée de serveur lié utilisée pour une connexion RPC du serveur de distribution , y compris les connexions locales.distributor_admin login and password are stored for linked server entry used for a distributor RPC connection, including local connections. Si le serveur de distribution est local, la nouvelle valeur est affectée au mot de passe pour distributor_admin .If distributor is local, the password for distributor_admin is set to a new value. Pour les serveurs de publication disposant d’un serveur de distribution distant, la même valeur de mot de passe doit être spécifiée lors de l’exécution de sp_adddistributor sur le serveur de publication et le serveur de distribution.For Publishers with a remote Distributor, the same value for password must be specified when executing sp_adddistributor at both the Publisher and Distributor. sp_changedistributor_password peut être utilisé pour modifier le mot de passe du serveur de distribution.sp_changedistributor_password can be used to change the Distributor password.

Important

Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution.When possible, prompt users to enter security credentials at runtime. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

[ @from_scripting = ] from_scripting Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.[ @from_scripting = ] from_scripting Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

sp_adddistributor est utilisé dans la réplication d’instantané, la réplication transactionnelle et la réplication de fusion.sp_adddistributor is used in snapshot replication, transactional replication, and merge replication.

ExempleExample

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- Install the Distributor and the distribution database.
DECLARE @distributor AS sysname;
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @directory AS nvarchar(500);
DECLARE @publicationDB AS sysname;
-- Specify the Distributor name.
SET @distributor = $(DistPubServer);
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
-- Specify the replication working directory.
SET @directory = N'\\' + $(DistPubServer) + '\repldata';
-- Specify the publication database.
SET @publicationDB = N'AdventureWorks2012'; 

-- Install the server MYDISTPUB as a Distributor using the defaults,
-- including autogenerating the distributor password.
USE master
EXEC sp_adddistributor @distributor = @distributor;

-- Create a new distribution database using the defaults, including
-- using Windows Authentication.
USE master
EXEC sp_adddistributiondb @database = @distributionDB, 
    @security_mode = 1;
GO

-- Create a Publisher and enable AdventureWorks2012 for replication.
-- Add MYDISTPUB as a publisher with MYDISTPUB as a local distributor
-- and use Windows Authentication.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);

USE [distribution]
EXEC sp_adddistpublisher @publisher=@publisher, 
    @distribution_db=@distributionDB, 
    @security_mode = 1;
GO 

AutorisationsPermissions

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

Voir aussiSee Also

Configurer la publication et la distribution Configure Publishing and Distribution
sp_changedistributor_property (Transact-SQL) sp_changedistributor_property (Transact-SQL)
sp_dropdistributor (Transact-SQL) sp_dropdistributor (Transact-SQL)
sp_helpdistributor (Transact-SQL) sp_helpdistributor (Transact-SQL)
Procédures stockées système (Transact-SQL) System Stored Procedures (Transact-SQL)
Configurer la distributionConfigure Distribution