sp_addmergepushsubscription_agent (Transact-SQL)

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

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 SQL Server Autenticação. 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 Autenticação 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 SQL Server Autenticação. 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 Agente de Mesclagem. 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 Agente de Mesclagem 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_intervalOs dias em que o Agente de Mesclagem é 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 Agente de Mesclagem. Esse parâmetro é usado quando frequency_type é definido como 32 (relativo mensal). frequency_relative_interval é int e pode ser um dos valores a seguir.

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 por 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 valores a seguir.

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 a Agente de Mesclagem é agendada pela primeira vez, formatada 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 a Agente de Mesclagem deixa de ser agendada, formatada como HHMMSS. active_end_time_of_day é int, com um padrão de NULL.

[ @active_start_date = ] active_start_dateÉ a data em que a Agente de Mesclagem é agendada pela primeira vez, formatada como YYYYMMDD. active_start_date é int, com um padrão de NULL.

[ @active_end_date = ] active_end_dateÉ a data em que a Agente de Mesclagem deixa de ser agendada, formatada 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 false, a assinatura não será registrada no Gerenciador de Sincronização. Se for true, a assinatura será registrada no Gerenciador de Sincronização e poderá ser sincronizada sem iniciar 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)