sp_addsubscriber_schedule (Transact-SQL)
Adiciona uma agenda para o Distribution Agent e Merge Agent. Esse procedimento armazenado é executado no Publicador em qualquer banco de dados.
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
sp_addsubscriber_schedule [ @subscriber = ] 'subscriber'
[ , [ @agent_type = ] agent_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 ]
[ , [ @publisher = ] 'publisher' ]
Argumentos
[ @subscriber = ] 'subscriber'
É o nome do Assinante. subscriber é sysname. O nome do Assinante deve ser exclusivo no banco de dados, não deve existir e não deve ser NULL.[ @agent_type = ] agent_type
É o tipo de agente. agent_type é smallint, e pode ter um destes valores.Valor
Descrição
0 (padrão)
Distribution Agent
1
Merge Agent
[ @frequency_type = ] frequency_type
É a frequência de agendamento do Distribution Agent. frequency_type é int, e pode ter um destes valores.Valor
Descrição
1
Uma vez
2
Sob demanda
4
Diariamente
8
Semanalmente
16
Mensalmente
32
Relativo ao mês
64 (padrão)
Iniciar automaticamente
128
Recorrente
[ @frequency_interval = ] frequency_interval
É o valor a ser aplicado à frequência definida por frequency_type. frequency_interval é int, com um padrão de 1.[ @frequency_relative_interval = ] frequency_relative_interval
É a data do Agente de Distribuição. Esse parâmetro é usado quando frequency_type está definido como 32 (mensal relativo). frequency_relative_interval é int, e pode ter um destes valores.Valor
Descrição
1 (padrão)
Primeiro
2
Segundo
4
Terceiro
8
Quarto
16
Último
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
É o fator de recorrência usado por frequency_type. frequency_recurrence_factor é int, com um padrão 0.[ @frequency_subday = ] frequency_subday
É a frequência de reagendamento durante o período definido. frequency_subday é int, e pode ter um destes valores.Valor
Descrição
1
Uma vez
2
Segundo
4 (padrão)
Minuto
8
Hora
[ @frequency_subday_interval = ] frequency_subday_interval
É o intervalo de frequency_subday. frequency_subday_interval é int, com um padrão 5.[ @active_start_time_of_day = ] active_start_time_of_day
É a hora do dia do primeiro agendamento do Agente de Distribuição, formatada como HHMMSS. active_start_time_of_day é int, com um padrão de 0.[ @active_end_time_of_day = ] active_end_time_of_day
É a hora do dia do último agendamento do Distribution Agent, formatada como HHMMSS. active_end_time_of_dayé int, com um padrão de 235959, que significa 23h59m59 medida em um relógio de 24 horas.[ @active_start_date = ] active_start_date
É a data do primeiro agendamento do Distribution Agent, formatada como AAAAMMDD. active_start_date é int, com um padrão de 0.[ @active_end_date = ] active_end_date
É a data do último agendamento do Distribution Agent, formatada como AAAAMMDD. active_end_date é int, com um padrão de 99991231, que significa 31 de dezembro de 9999.[ @publisher = ] 'publisher'
Especifica um Publicador que não é Microsoft SQL Server. publisher é sysname, com um padrão de NULL.Dica
publisher não deve ser especificado para um Editor SQL Server.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_addsubscriber_schedule é usado em replicação de instantâneo, replicação transacional e replicação de mesclagem.
Permissões
Somente os membros da função de servidor fixa sysadmin podem executar sp_subscriber_schedule.