sp_link_publication (Transact-SQL)

Sintaxis

sp_link_publication [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication' 
        , [ @security_mode = ] security_mode
    [ , [ @login = ] 'login' ]
    [ , [ @password = ]'password' ]
    [ , [ @distributor = ] 'distributor' ]

Argumentos

• [ @publisher = ] 'publisher'
  Es el nombre del publicador con el que se establece el vínculo. publisher es de tipo sysname y no tiene ningún valor predeterminado.

• [ @publisher_db= ] 'publisher_db'
  Es el nombre de la base de datos del publicador con el que se establece el vínculo. publisher_db es de tipo sysname y no tiene ningún valor predeterminado.

• [ @publication= ] 'publication'
  Es el nombre de la publicación con la que se establece el vínculo. publication es de tipo sysname y no tiene ningún valor predeterminado.

• [ @security_mode= ] security_mode
  Es el modo de seguridad utilizado por el suscriptor para conectarse a un publicador remoto para la actualización inmediata. security_mode es de tipo int y puede ser uno de los valores siguientes. Siempre que sea posible, utilice la autenticación de Windows.

  Valor	Descripción
  0	Utiliza la autenticación de SQL Server con el inicio de sesión especificado en este procedimiento almacenado como login y password. Nota En versiones anteriores de SQL Server, esta opción se utiliza para especificar una llamada a procedimiento remoto (RPC) dinámico.
  1	Utiliza el contexto de seguridad (autenticación de SQL Server o autenticación de Windows) del usuario que realiza el cambio en el suscriptor. Nota Esta cuenta también debe existir en el publicador con privilegios suficientes. Al usar la autenticación de Windows, se debe admitir la delegación de cuentas de seguridad.
  2	Utiliza un inicio de sesión de servidor vinculado definido por el usuario existente y creado con sp_link_publication.

• [ @login= ] 'login'
  Es el inicio de sesión. login es de tipo sysname y su valor predeterminado es NULL. Este parámetro se debe especificar si security_mode es 0.

• [ @password = ] 'password'
  Es la contraseña. password es de tipo sysname y su valor predeterminado es NULL. Este parámetro se debe especificar si security_mode es 0.

• [ @distributor= ] 'distributor'
  Es el nombre del distribuidor. distributor es de tipo sysname y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_link_publication se utiliza para las suscripciones de actualización inmediata en la replicación transaccional.

sp_link_publication se puede utilizar para suscripciones de extracción e inserción. Se puede llamar antes o después de haber creado la suscripción. Al hacerlo se inserta o actualiza una entrada de la tabla de sistema MSsubscription_properties (Transact-SQL).

Para las suscripciones de inserción, la entrada se puede limpiar con sp_subscription_cleanup (Transact-SQL). Para las suscripciones de extracción, la entrada se puede limpiar con sp_droppullsubscription (Transact-SQL) o sp_subscription_cleanup (Transact-SQL). También puede llamar a sp_link_publication con NULL como contraseña para borrar la entrada de la tabla de sistema MSsubscription_properties (Transact-SQL) por motivos de seguridad.

El modo predeterminado que utiliza un suscriptor de actualización inmediata cuando se conecta al publicador no permite una conexión mediante la autenticación de Windows. Para conectar con un modo de autenticación de Windows, se deberá configurar un servidor vinculado como publicador, y el suscriptor de actualización inmediata debe utilizar esta conexión cuando actualice el suscriptor. Esto requiere que se ejecute sp_link_publication con security_mode = 2. Al usar la autenticación de Windows, se debe admitir la delegación de cuentas de seguridad.

Ejemplo

-- 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".

-- Execute this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publicationDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS nvarchar(512);
SET @publication = N'AdvWorksProductTran';
SET @publicationDB = N'AdventureWorks';
SET @publisher = $(PubServer);
SET @login = $(Login);
SET @password = $(Password);

-- At the subscription database, create a pull subscription to a transactional 
-- publication using immediate updating with queued updating as a failover.
EXEC sp_addpullsubscription 
    @publisher = @publisher, 
    @publication = @publication, 
    @publisher_db = @publicationDB, 
    @update_mode = N'failover', 
    @subscription_type = N'pull';

-- Add an agent job to synchronize the pull subscription, 
-- which uses Windows Authentication when connecting to the Distributor.
EXEC sp_addpullsubscription_agent 
    @publisher = @publisher, 
    @publisher_db = @publicationDB, 
    @publication = @publication,
    @job_login = @login,
    @job_password = @password; 

-- Add a Windows Authentication-based linked server that enables the 
-- Subscriber-side triggers to make updates at the Publisher. 
EXEC sp_link_publication 
    @publisher = @publisher, 
    @publication = @publication,
    @publisher_db = @publicationDB, 
    @security_mode = 0,
    @login = @login,
    @password = @password;
GO

USE AdventureWorks
GO

-- Execute this batch at the Publisher.
DECLARE @publication AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @subscriptionDB = N'AdventureWorksReplica'; 
SET @subscriber = $(SubServer);

-- At the Publisher, register the subscription, using the defaults.
USE [AdventureWorks]
EXEC sp_addsubscription 
    @publication = @publication, 
    @subscriber = @subscriber, 
    @destination_db = @subscriptionDB, 
    @subscription_type = N'pull', 
    @update_mode = N'failover';
GO

Permisos

Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_link_publication.

Vea también

Referencia

Conceptos