sp_link_publication (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis)

Define as informações de configuração e de segurança usadas por gatilhos de sincronização de assinaturas de atualização imediata na conexão com o Publicador. Esse procedimento armazenado é executado no Assinante no banco de dados de assinatura.

Importante

Quando um Publicador é configurado com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, inclusive job_login e job_password, são enviados ao Distribuidor como texto sem-formatação. Você deve criptografar a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, veja Habilitar conexões criptografadas no Mecanismo de Banco de Dados (SQL Server Configuration Manager).

Importante

em determinadas condições, esse procedimento armazenado poderá falhar se o assinante estiver executando o Microsoft SQL Server 2005 (9.x) Service Pack 1 ou posterior e o Publisher estiver executando uma versão anterior. Se o procedimento armazenado falhar neste cenário, atualize o Publicador para a versão do SQL Server 2005 (9.x) Service Pack 1 ou posterior.

Ícone de link do tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @publisher = ] 'publisher'é o nome do Publisher ao qual vincular. o Publicador é sysname, sem padrão.

[ @publisher_db = ] 'publisher_db'é o nome do banco de dados de Publisher ao qual vincular. publisher_db é sysname, sem padrão.

[ @publication = ] 'publication' É o nome da publicação à qual vincular. a publicação é sysname, sem padrão.

[ @security_mode = ] security_modeé o modo de segurança usado pelo assinante para se conectar a um Publisher remoto para atualização imediata. security_mode é int e pode ser um desses valores. Quando possível, use a autenticação do Windows.

Valor Descrição
0 Usa SQL Server a autenticação com o logon especificado neste procedimento armazenado como logon e senha.

Observação: em versões anteriores do SQL Server , essa opção foi usada para especificar uma RPC (chamada de procedimento remoto) dinâmica.
1 Usa o contexto de segurança (Autenticação do SQL Server ou Autenticação do Windows) do usuário que faz a alteração no Assinante.

observação: essa conta também deve existir no Publisher com privilégios suficientes. Ao usar Autenticação do Windows, deve haver suporte para delegação de conta de segurança.
2 Usa um logon de servidor vinculado existente definido pelo usuário criado usando sp_link_publication.

[ @login = ] 'login' É o logon. login é sysname, com um padrão de NULL. Esse parâmetro deve ser especificado quando security_mode é 0.

[ @password = ] 'password' É a senha. a senha é sysname, com um padrão de NULL. Esse parâmetro deve ser especificado quando security_mode é 0.

[ @distributor = ] 'distributor' É o nome do distribuidor. o distribuidor é sysname, com um padrão de NULL.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_link_publication é usado pelas assinaturas de atualização imediata na replicação transacional.

sp_link_publication pode ser usado para assinaturas push e pull. Pode ser chamado antes ou depois que a assinatura é criada. uma entrada é inserida ou atualizada na tabela do sistema MSsubscription_properties (Transact-SQL) .

para assinaturas push, a entrada pode ser limpa por sp_subscription_cleanup (Transact-SQL). para assinaturas pull, a entrada pode ser limpa por sp_droppullsubscription (transact-SQL) ou sp_subscription_cleanup (a SQL do transact-). você também pode chamar sp_link_publication com uma senha nula para limpar a entrada no MSsubscription_properties (SQL tabela do sistema)para questões de segurança.

O modo padrão usado por um Assinante de atualização imediata quando ele se conecta ao Publicador não permite uma conexão usando Autenticação do Windows. Para se conectar ao modo de Autenticação do Windows, um servidor vinculado precisa ser definido como Publicador e o Assinante de atualização imediata deve usar essa conexão ao atualizar o Assinante. Isso requer que o sp_link_publication seja executado com security_mode = 2. Ao usar Autenticação do Windows, deve haver suporte para delegação de conta de segurança.

Exemplo

-- 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'AdventureWorks2012';
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 AdventureWorks2012
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'AdventureWorks2012Replica'; 
SET @subscriber = $(SubServer);

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

Permissões

Somente os membros da função de servidor fixa sysadmin podem executar sp_link_publication.

Consulte Também

sp_droppullsubscription (Transact-SQL)
sp_helpsubscription_properties (Transact-SQL)
sp_subscription_cleanup (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)