sp_changesubscriber_schedule (Transact-SQL)

  • Artigo

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

Altera o agendamento do Distribution Agent ou Merge Agent para um assinante. Esse procedimento armazenado é executado no Publicador, em qualquer banco de dados.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_changesubscriber_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. O nome do Assinante deve ser exclusivo no banco de dados, ainda não deve existir e não pode ser NULL.

@agent_type [ = ] agent_type

O tipo de agente. @agent_type é smallint, com um padrão de 0.

  • 0 indica um Agente de Distribuição.
  • 1 indica um Merge Agent.

@frequency_type [ = ] frequency_type

Especifica a freqüência com a qual agendar a tarefa 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 aplicado à frequência definida por @frequency_type. @frequency_interval é int e depende do valor de @frequency_type.

Valor do @frequency_type Efeito na @frequency_interval
1 (padrão) @frequency_interval não é usado.
4 A cada @frequency_interval dias.
8 @frequency_interval é um ou mais dos seguintes (combinados com um | (OU bit a bit) operador lógico):

1 = Domingo
2 = Segunda-feira
4 = Terça-feira
8 = Quarta-feira
16 = Quinta-feira
32 = Sexta-feira
64 = Sábado
16 No @frequency_interval dia do mês.
32 @frequency_interval é uma das seguintes opções:

1 = Domingo
2 = Segunda-feira
3 = Terça-feira
4 = Quarta-feira
5 = Quinta-feira
6 = Sexta-feira
7 = Sábado
8 = Dia
9 = Dia da semana
10 = Dia de fim de semana
64 @frequency_interval não é usado.
128 @frequency_interval não é usado.

@frequency_relative_interval [ = ] frequency_relative_interval

A data da tarefa de distribuição. @frequency_relative_interval é int e pode ser um desses valores.

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

@frequency_recurrence_factor [ = ] frequency_recurrence_factor

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

@frequency_subday [ = ] frequency_subday

Especifica a frequência, em minutos, com que reprogramação 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 número de períodos de frequency_subday que ocorrem entre cada execução do trabalho. @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 a tarefa de distribuição é agendada pela primeira vez. @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 tarefa de distribuição deixa de ser agendada. @active_end_time_of_day é int, com um padrão de 235959, o que significa 23:59:59 em um relógio de 24 horas.

@active_start_date [ = ] active_start_date

A data em que a tarefa de distribuição é 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 tarefa de distribuição deixa de ser agendada, formatada como yyyyMMdd. @active_end_date é int, com um padrão de , o que significa 31 de dezembro de 999912319999.

@publisher [ = ] N'editor'

Especifica um Publicador não-SQL Server. @publisher é sysname, com um padrão de NULL.

@publisher não deve ser usado ao alterar as propriedades do artigo em um Publicador do SQL Server.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_changesubscriber_schedule é usado em todos os tipos de replicação.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_changesubscriber_schedule.

Conteúdo relacionado