sp_addsubscriber_schedule (Transact-SQL)
Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure
Adiciona uma agenda para o Distribution Agent e Merge Agent. Esse procedimento armazenado é executado no Publicador, em qualquer banco de dados.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_addsubscriber_schedule
[ @subscriber = ] N'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 = ] N'publisher' ]
[ ; ]
Argumentos
@subscriber [ = ] N'assinante'
O nome do Assinante. @subscriber é sysname, sem padrão. @subscriber deve ser exclusivo no banco de dados, não deve existir e não pode ser NULL
.
@agent_type [ = ] agent_type
O tipo de agente. @agent_type é pequeno e pode ser um desses valores.
Valor | Descrição |
---|---|
0 (padrão) |
Agente de Distribuição |
1 |
Merge Agent |
@frequency_type [ = ] frequency_type
Especifica a frequência com a qual agendar o Agente de Distribuição. @frequency_type é int, e pode ser um desses valores.
Valor | Descrição |
---|---|
1 |
Uma vez |
2 |
Sob demanda |
4 |
Diário |
8 |
Semanal |
16 |
Mensal |
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 é definido como 32
(relativo mensal). @frequency_relative_interval é int, e pode ser um desses 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 utilizado por frequency_type. @frequency_recurrence_factor é int, com um padrão de 0
.
@frequency_subday [ = ] frequency_subday
Com que frequência reagendar durante o período definido. @frequency_subday é int, e pode ser um desses valores.
Valor | Descrição |
---|---|
1 |
Uma vez |
2 |
Second |
4 (padrão) |
Minuto |
8 |
Hora |
@frequency_subday_interval [ = ] frequency_subday_interval
O intervalo para frequency_subday. @frequency_subday_interval é int, com um padrão de 5
.
@active_start_time_of_day [ = ] active_start_time_of_day
A hora do dia em que o Agente de Distribuição é agendado pela primeira vez, formatado 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 em que o Agente de Distribuição deixa de ser agendado, formatado como HHmmss
. @active_end_time_of_day é int, com um padrão de , o que significa 23:59:59 como medido em um relógio de 235959
24 horas.
@active_start_date [ = ] active_start_date
A data em que o Agente de Distribuição é agendado pela primeira vez, formatado como yyyyMMdd
. @active_start_date é int, com um padrão de 0
.
@active_end_date [ = ] active_end_date
A data em que o Distribution Agent deixa de ser agendado, formatado como yyyyMMdd
. @active_end_date é int, com um default de , o que significa 31 de dezembro de 99991231
9999.
@publisher [ = ] N'editor'
Especifica um Publicador que não seja do SQL Server. @publisher é sysname, com um padrão de NULL
.
@publisher não deve ser especificado para um Publicador do SQL Server.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Comentários
sp_addsubscriber_schedule
é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.
Permissões
Somente membros da função de servidor fixa sysadmin podem executar sp_addsubscriber_schedule
.
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de