Compartilhar via


sp_addmergesubscription (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Cria uma assinatura push ou pull. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_addmergesubscription
    [ @publication = ] N'publication'
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @subscriber_type = ] N'subscriber_type' ]
    [ , [ @subscription_priority = ] subscription_priority ]
    [ , [ @sync_type = ] N'sync_type' ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @optional_command_line = ] N'optional_command_line' ]
    [ , [ @description = ] N'description' ]
    [ , [ @enabled_for_syncmgr = ] N'enabled_for_syncmgr' ]
    [ , [ @offloadagent = ] offloadagent ]
    [ , [ @offloadserver = ] N'offloadserver' ]
    [ , [ @use_interactive_resolver = ] N'use_interactive_resolver' ]
    [ , [ @merge_job_name = ] N'merge_job_name' ]
    [ , [ @hostname = ] N'hostname' ]
[ ; ]

Argumentos

@publication [ = ] N'publicação'

O nome da publicação. @publication é sysname, sem padrão. A publicação já deve existir.

@subscriber [ = ] N'assinante'

O nome do Assinante. @subscriber é sysname, com um padrão de NULL.

@subscriber_db [ = ] N'subscriber_db'

O nome do banco de dados de assinatura. @subscriber_db é sysname, com um padrão de NULL.

@subscription_type [ = ] N'subscription_type'

O tipo de assinatura. @subscription_type é nvarchar(15), com um padrão de push.

  • Se push, uma assinatura push é adicionada e o Merge Agent é adicionado no Distribuidor.
  • Se pull, uma assinatura pull será adicionada sem adicionar um Merge Agent no Distribuidor.

Observação

As assinaturas anônimas não precisam usar esse procedimento armazenado.

@subscriber_type [ = ] N'subscriber_type'

O tipo de Assinante. @subscriber_type é nvarchar(15) e pode ser um dos seguintes valores.

Valor Descrição
local (padrão) Assinante conhecido somente pelo Publicador.
global Assinante conhecido por todos os servidores.

No SQL Server 2005 (9.x) e versões posteriores, as assinaturas locais são chamadas de assinaturas de cliente e as assinaturas globais são chamadas de assinaturas de servidor.

@subscription_priority [ = ] subscription_priority

Um número que indica a prioridade da assinatura. @subscription_priority é real, com um padrão de NULL. Para assinaturas locais e anônimas, a prioridade é 0.0. Para assinaturas globais, a prioridade deve ser menor que 100.0.

@sync_type [ = ] N'sync_type'

O tipo de sincronização de assinatura. @sync_type é nvarchar(15), com um padrão de automatic.

  • Se automatic, o esquema e os dados iniciais das tabelas publicadas serão transferidos primeiro para o Assinante.
  • Se none, presume-se que o Assinante já tenha o esquema e os dados iniciais das tabelas publicadas. Tabelas de sistema e dados sempre são transferidos.

Observação

Recomendamos não especificar um valor de none.

@frequency_type [ = ] frequency_type

Um valor que indica quando o Merge Agent é executado. @frequency_type é int e pode ser um dos seguintes valores.

Valor Descrição
1 Uma vez
4 Diário
8 Semanal
10 Mensal
20 Mensalmente, relativo ao intervalo de frequência
40 Quando o SQL Server Agent é iniciado
NULL (padrão)

@frequency_interval [ = ] frequency_interval

O dia ou dias em que o Agente de Mesclagem é executado. @frequency_interval é int e pode ser um dos seguintes valores.

Valor Descrição
1 Domingo
2 Segunda-feira
3 Terça-feira
4 Quarta-feira
5 Quinta-feira
6 Sexta-feira
7 Sábado
8 Dia
9 Dias da semana
10 Dias de fim de semana
NULL (padrão)

@frequency_relative_interval [ = ] frequency_relative_interval

A ocorrência de mesclagem programada do intervalo de frequência em cada mês. @frequency_relative_interval é int e pode ser um desses valores.

Valor Descrição
1 First
2 Segundo
4 Terceiro
8 Quarto
16 Last
NULL (padrão)

@frequency_recurrence_factor [ = ] frequency_recurrence_factor

O fator de recorrência usado por @frequency_type. @frequency_recurrence_factor é int, com um padrão de NULL.

@frequency_subday [ = ] frequency_subday

A unidade para @frequency_subday_interval. @frequency_subday é int e pode ser um dos valores a seguir.

Valor Descrição
1 Uma vez
2 Second
4 Minuto
8 Hora
NULL (padrão)

@frequency_subday_interval [ = ] frequency_subday_interval

A frequência com que @frequency_subday ocorrem entre cada mesclagem. @frequency_subday_interval é int, com um padrão de NULL.

@active_start_time_of_day [ = ] active_start_time_of_day

A hora do dia em que o Merge Agent é agendado pela primeira vez, formatado como HHmmss. @active_start_time_of_day é int, com um padrão de NULL.

@active_end_time_of_day [ = ] active_end_time_of_day

A hora do dia em que o Merge Agent deixa de ser agendado, formatado como HHmmss. @active_end_time_of_day é int, com um padrão de NULL.

@active_start_date [ = ] active_start_date

A data em que o Merge Agent é agendado pela primeira vez, formatado como yyyyMMdd. @active_start_date é int, com um padrão de NULL.

@active_end_date [ = ] active_end_date

A data em que o Merge Agent deixa de ser agendado, formatado como yyyyMMdd. @active_end_date é int, com um padrão de NULL.

@optional_command_line [ = ] N'optional_command_line'

O prompt de comando opcional a ser executado. @optional_command_line é nvarchar(4000), com um padrão de NULL. Esse parâmetro é usado para adicionar um comando que captura a saída e a salva em um arquivo ou para especificar um arquivo de configuração ou atributo.

@description [ = ] N'descrição'

Uma breve descrição dessa assinatura de mesclagem. @description é nvarchar(255), com um padrão de NULL. Esse valor é exibido pelo Replication Monitor na Friendly Name coluna, que pode ser usada para classificar as assinaturas de uma publicação monitorada.

@enabled_for_syncmgr [ = ] N'enabled_for_syncmgr'

Especifica se a assinatura pode ser sincronizada por meio do Gerenciador de Sincronização do Microsoft Windows. @enabled_for_syncmgr é nvarchar(5), com um padrão de false.

  • Se false, a assinatura não está registrada no Gerenciador de Sincronização.
  • Se true, a assinatura é registrada no Gerenciador de Sincronização e pode ser sincronizada sem iniciar o SQL Server Management Studio.

@offloadagent [ = ] agente de descarregamento

Especifica que o agente pode ser ativado remotamente. @offloadagent é bit, com um padrão de 0.

Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

@offloadserver [ = ] N'offloadserver'

Especifica o nome da rede de servidor a ser usado para ativação de agente remota. @offloadserver é sysname, com um padrão de NULL.

@use_interactive_resolver [ = ] N'use_interactive_resolver'

Permite resolver conflitos interativamente para todos os artigos que permitem resolução interativa. @use_interactive_resolver é nvarchar(5), com um padrão de false.

@merge_job_name [ = ] N'merge_job_name'

Esse parâmetro foi preterido e não pode ser definido. @merge_job_name é sysname, com um padrão de NULL.

@hostname [ = ] N'nome do host'

Substitui o valor retornado por HOST_NAME quando essa função é usada na cláusula WHERE de um filtro parametrizado. @hostname é sysname, com um padrão de NULL.

Importante

Por motivos de desempenho, recomendamos que não sejam aplicadas funções a nomes de colunas em cláusulas de filtro de linha com parâmetros, como LEFT([MyColumn]) = SUSER_SNAME(). Se você usar HOST_NAME em uma cláusula de filtro e substituir o valor HOST_NAME, talvez seja necessário converter tipos de dados usando CONVERT. Para obter mais informações sobre as práticas recomendadas para esse caso, consulte a seção "Substituindo o valor HOST_NAME()" no tópico Filtros com parâmetros - Filtros de linha com parâmetros.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_addmergesubscription é usado na replicação de mesclagem.

Quando sp_addmergesubscription é executado por um membro da função de servidor fixa sysadmin para criar uma assinatura push, o trabalho do Merge Agent é criado implicitamente e executado na conta de serviço do SQL Server Agent. Recomendamos que você execute sp_addmergepushsubscription_agent e especifique as credenciais de uma conta do Windows diferente e específica do agente para @job_login e @job_password. Para obter mais informações, consulte Replication Agent Security Model.

Exemplos

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

DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorksReplica'; 
SET @hostname = N'adventure-works\david8'

-- Add a push subscription to a merge publication.
USE [AdventureWorks2022];
EXEC sp_addmergesubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @subscription_type = N'push',
  @hostname = @hostname;

--Add an agent job to synchronize the push subscription.
EXEC sp_addmergepushsubscription_agent 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @job_login = $(Login), 
  @job_password = $(Password);
GO

Permissões

Somente membros da função de servidor fixa sysadmin ou db_owner função de banco de dados fixa podem executar sp_addmergesubscription.