sys.sp_changesubscriber_schedule (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Altera o horário do Distribution Agent ou Merge Agent para um assinante. Este procedimento armazenado é executado no Publisher em qualquer base de dados.

Transact-SQL convenções de sintaxe

Syntax

sys.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' ]
[ ; ]

Arguments

[ @subscriber = ] N'assinante'

O nome do Assinante. @subscriber é sysname, sem padrão. O nome do Assinante deve ser único na base de dados, não pode existir já e não pode ser NULL.

[ @agent_type = ] agent_type

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

• 0indica um Distribution Agent.
• 1indica um Merge Agent.

[ @frequency_type = ] frequency_type

Especifica a frequência com que agendar a tarefa de distribuição. @frequency_type é int, e pode ser um desses valores.

[ @frequency_interval = ] frequency_interval

O valor aplicado à frequência definida por @frequency_type. @frequency_interval é int, e depende do valor da @frequency_type.

[ @frequency_relative_interval = ] frequency_relative_interval

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

[ @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

Especifica com que frequência, em minutos, reagendar durante o período definido. @frequency_subday é int, e pode ser um desses valores.

[ @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 é marcada 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 num relógio de 24 horas.

[ @active_start_date = ] active_start_date

A data em que a tarefa de distribuição é inicialmente agendada, 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 99991231, o que significa 31 de dezembro de 9999.

@publisher [ = ] N'editor'

Especifica um Editor de Server que não seja SQL. @publisher é sysname, com um padrão de NULL.

@publisher não deve ser usado ao alterar propriedades de artigos numa SQL Server Publisher.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

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

Permissions

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

Conteúdo relacionado

• sp_addsubscriber_schedule (Transact-SQL)
• Procedimentos armazenados do sistema (Transact-SQL)