sp_adddistpublisher (Transact-SQL)

Se aplica a: SQL Server Azure SQL Managed Instance

Configura un publicador para que utilice una base de datos de distribución determinada. Este procedimiento almacenado se ejecuta en el distribuidor en cualquier base de datos. Los procedimientos almacenados sp_adddistributor y sp_adddistributiondb deben haberse ejecutado antes de usar este procedimiento almacenado.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_adddistpublisher
    [ @publisher = ] N'publisher'
    , [ @distribution_db = ] N'distribution_db'
    [ , [ @security_mode = ] security_mode ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @working_directory = ] N'working_directory' ]
    [ , [ @trusted = ] N'trusted' ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @thirdparty_flag = ] thirdparty_flag ]
    [ , [ @publisher_type = ] N'publisher_type' ]
    [ , [ @storage_connection_string = ] N'storage_connection_string' ]
[ ; ]

Argumentos

[ @publisher = ] N'publisher'

Nombre del publicador. @publisher es sysname, sin ningún valor predeterminado.

[ @distribution_db = ] N'distribution_db'

El nombre de la base de datos de distribución. @distribution_db es sysname, sin ningún valor predeterminado. Los agentes de replicación utilizan este parámetro para conectarse al publicador.

[ @security_mode = ] security_mode

Modo de seguridad implementado. Los agentes de replicación usan este parámetro solo para conectarse al publicador para suscripciones de actualización en cola o con un publicador que no es de SQL Server. @security_mode es int y puede ser uno de estos valores.

[ @login = ] N'login'

Inicio de sesión. Este parámetro es necesario si security_mode es 0. @login es sysname, con un valor predeterminado de NULL. Los agentes de replicación utilizan este parámetro para conectarse al publicador.

[ @password = ] N'password'

La contraseña. @password es sysname, con un valor predeterminado de NULL. Los agentes de replicación utilizan este parámetro para conectarse al publicador.

[ @working_directory = ] N'working_directory'

Nombre del directorio de trabajo utilizado para almacenar archivos de datos y de esquema para la publicación. @working_directory es nvarchar(255) y el valor predeterminado es la ReplData carpeta para esta instancia de SQL Server. Por ejemplo, C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.1\ReplData. El nombre se debe especificar en el formato UNC.

Para Azure SQL Database, use \\<storage_account>.file.core.windows.net\<share>.

[ @trusted = ] N'trusted'

@trusted está en desuso y solo se proporciona para la compatibilidad con versiones anteriores. @trusted es nvarchar(5), con un valor predeterminado de false. Si se establece este parámetro en cualquier elemento, pero false se produce un error.

[ @encrypted_password = ] encrypted_password

Ya no se admite establecer este parámetro. @encrypted_password es bit, con un valor predeterminado de 0. Si se establece este parámetro en 1 , se producirá un error.

[ @thirdparty_flag = ] thirdparty_flag

Especifica cuándo el publicador es SQL Server. @thirdparty_flag es bit y puede ser uno de los siguientes valores.

[ @publisher_type = ] N'publisher_type'

Especifica el tipo de publicador cuando el publicador no es SQL Server. @publisher_type es sysname y puede ser uno de los siguientes valores.

Para obtener más información sobre las diferencias entre un publicador de Oracle y un publicador de puerta de enlace de Oracle, consulte Configuración de un publicador de Oracle.

[ @storage_connection_string = ] N'storage_connection_string'

Necesario para Azure SQL Database. @storage_connection_string es nvarchar(255), con un valor predeterminado de NULL. Use la clave de acceso desde Azure Portal, en Configuración de almacenamiento>.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_adddistpublisher se usa mediante la replicación de instantáneas, la replicación transaccional y la replicación de mezcla.

Ejemplos

-- 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'AdventureWorks2022'; 

-- 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 AdventureWorks2022 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

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_adddistpublisher.

Contenido relacionado

• Configurar la publicación y la distribución
• sp_changedistpublisher (Transact-SQL)
• sp_dropdistpublisher (Transact-SQL)
• sp_helpdistpublisher (Transact-SQL)
• Procedimientos almacenados del sistema (Transact-SQL)
• Configurar distribución