sp_changesubscriber_schedule (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_changesubscriber_schedule [ @subscriber = ] 'subscriber', [ @agent_type = ] 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=] type
    É o tipo de agente. type é smallint, com um padrão de 0. 0 indica um Distribution Agent. 1 indica um Merge Agent.

  • [ @frequency_type=] frequency_type
    É a freqüência de agendamento da tarefa de distribuição. frequency_type é int, com um padrão de 64. Há 10 colunas agendadas.

  • [ @frequency_interval=] frequency_interval
    É o valor a ser aplicado à freqüência definida por frequency_type. frequency_interval é int, com um padrão de 1.

  • [ @frequency_relative_interval=] frequency_relative_interval
    É a data da tarefa de distribuição. frequency_relative_interval é int, com um padrão de 1.

  • [ @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
    É a freqüência, em minutos, de reagendamento durante o período definido. frequency_subday é int, com um padrão de 4.

  • [ @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 do primeiro agendamento da tarefa de distribuição. 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 a tarefa de distribuição deixa de ser agendada. active_end_time_of_day é int, com um padrão de 235959, que significa 11:59:59 P.M. em um relógio de 24 horas.

  • [ @active_start_date=] active_start_date
    É a data do primeiro agendamento da tarefa de distribuição. active_start_date é int, com um padrão de 0.

  • [ @active_end_date=] active_end_date
    É a data em que a tarefa de distribuição deixa de ser agendada, formatada comoYYYYMMDD. active_end_date é int, com um padrão de 99991231, que significa 31 de dezembro de 9999.

  • [ @publisher= ] 'publisher'
    Especifica um Publicador não-Microsoft SQL Server. publisher é sysname, com um padrão de NULL.

    ObservaçãoObservação

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

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

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

Permissões

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