sp_addmergepushsubscription_agent (Transact-SQL)

Aplica-se a:yesSQL Server (todas as versões com suporte) YesInstância Gerenciada de SQL do Azure

Adiciona um novo trabalho de agente para agendar sincronização de uma assinatura push para uma publicação de mesclagem. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

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, confira Habilitar conexões criptografadas para o mecanismo de banco de dados (SQL Server Configuration Manager).

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

  
sp_addmergepushsubscription_agent [ @publication =] 'publication'   
    [ , [ @subscriber = ] 'subscriber' ]   
    [ , [ @subscriber_db = ] 'subscriber_db' ]   
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]   
    [ , [ @subscriber_login = ] 'subscriber_login' ]   
    [ , [ @subscriber_password = ] 'subscriber_password' ]   
    [ , [ @publisher_security_mode = ] publisher_security_mode ]   
    [ , [ @publisher_login = ] 'publisher_login' ]   
    [ , [ @publisher_password = ] 'publisher_password' ]   
    [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   
    [ , [ @job_name = ] 'job_name' ]   
    [ , [ @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 ]   
    [ , [ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' ]   

Argumentos

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

[ @subscriber = ] 'subscriber' É o nome do Assinante. assinante é sysname, com um padrão de NULL.

[ @subscriber_db = ] 'subscriber_db' É o nome do banco de dados de assinatura. subscriber_db é sysname, com um padrão de NULL.

[ @subscriber_security_mode = ] subscriber_security_mode É o modo de segurança a ser usado ao se conectar a um Assinante ao sincronizar. subscriber_security_mode é int, com um padrão de 1. Se 0, especifica a Autenticação do SQL Server. Se 1, especifica a Autenticação do Windows.

[ @subscriber_login = ] 'subscriber_login' É o logon do Assinante a ser usado ao se conectar a um Assinante ao sincronizar. subscriber_login será necessário se subscriber_security_mode estiver definido como 0. subscriber_login é sysname, com um padrão de NULL.

[ @subscriber_password = ] 'subscriber_password' É a senha do Assinante para a Autenticação do SQL Server. subscriber_password será necessário se subscriber_security_mode estiver definido como 0. subscriber_password é sysname, com um padrão de NULL. Se uma senha de assinante for usada, será criptografada automaticamente.

Importante

Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.

[ @publisher_security_mode = ] publisher_security_mode É o modo de segurança a ser usado ao se conectar a um Publicador ao sincronizar. publisher_security_mode é int, com um padrão de 1. Se 0, especifica a Autenticação do SQL Server. Se 1, especifica a Autenticação do Windows.

[ @publisher_login = ] 'publisher_login' É o logon a ser usado ao se conectar a um Publicador ao sincronizar. publisher_login é sysname, com um padrão de NULL.

[ @publisher_password = ] 'publisher_password' É a senha usada ao se conectar ao Publicador. publisher_password é sysname, com um padrão de NULL.

Importante

Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.

[ @job_login = ] 'job_login' É o logon da conta do Windows na qual o agente é executado. job_login é nvarchar(257), com um valor padrão de NULL. Essa conta do Windows é sempre usada para conexões do agente com o Distribuidor e para conexões com o Assinante e o Publicador ao usar a autenticação integrada do Windows.

[ @job_password = ] 'job_password' É a senha da conta do Windows na qual o agente é executado. job_password é sysname, sem padrão.

Importante

Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.

[ @job_name = ] 'job_name' É o nome de um trabalho de agente existente. job_name é sysname, com um valor padrão de NULL. Esse parâmetro só é especificado quando a assinatura é sincronizada usando um trabalho existente em vez de um trabalho recém-criado (o padrão). Se você não for membro da função de servidor fixa sysadmin , deverá especificar job_login e job_password quando especificar job_name.

[ @frequency_type = ] frequency_type É a frequência com a qual agendar o Merge Agent. frequency_type é int e pode ser um dos valores a seguir.

Valor Descrição
1 Uma vez
2 Sob demanda
4 Diariamente
8 Semanalmente
16 Mensal
32 Relativo ao mês
64 Iniciar automaticamente
128 Recorrente
NULL (padrão)

Observação

Especificar um valor de 64 faz com que o Merge Agent seja executado no modo contínuo. Isso corresponde à configuração do parâmetro -Continuous para o agente. Para obter mais informações, consulte Replication Merge Agent.

[ @frequency_interval = ] frequency_interval Os dias em que o Merge Agent é executado. frequency_interval é int e pode ser um dos valores a seguir.

Valor Descrição
1 Sunday
2 Monday
3 Terça-feira
4 Quarta-feira
5 Quinta-feira
6 Friday
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 data do Merge Agent. Esse parâmetro é usado quando frequency_type é definido como 32 (relativo mensal). frequency_relative_interval é int e pode ser um dos seguintes valores.

Valor Descrição
1 Primeiro
2 Segundo
4 Terceiro
8 Quarto
16 Último
NULL (padrão)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor É o fator de recorrência usado pelo frequency_type. frequency_recurrence_factor é int, com um padrão de NULL.

[ @frequency_subday = ] frequency_subday É com que frequência reagendar durante o período definido. frequency_subday é int e pode ser um dos seguintes valores.

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

[ @frequency_subday_interval = ] frequency_subday_interval É o intervalo para frequency_subday. 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.

[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' Especifica se a assinatura pode ser sincronizada por meio do Gerenciador de Sincronização do Windows. enabled_for_syncmgr é nvarchar(5), com um padrão de FALSE. Se for falsa, a assinatura não será registrada no Gerenciador de Sincronização. Se for true, a assinatura será registrada no Synchronization Manager e poderá ser sincronizada sem iniciar o SQL Server Management Studio.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_addmergepushsubscription_agent é usado na replicação de mesclagem e usa funcionalidade semelhante à sp_addpushsubscription_agent.

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

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 [AdventureWorks2012];
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_addmergepushsubscription_agent.

Consulte Também

Criar uma Assinatura Push
Assinar publicações
sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL)
sp_dropmergesubscription (Transact-SQL)
sp_helpmergesubscription (Transact-SQL)