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.

Convenções de 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 é smallinte pode ser um destes valores.

  Valor	Descrição
  0 (padrão)	Distribution Agent
  1	Merge Agent

• [ @frequency_type = ] frequency_type
  É a freqüência de agendamento do Distribution Agent. frequency_type é int, e pode ser 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 à freqüência definida por frequency_type. frequency_interval é int, com um padrão 1.

• [ @frequency_relative_interval = ] frequency_relative_interval
  É a data do Distribution Agent. Esse parâmetro é usado quando frequency_type é definido como 32 (relativo ao mês). frequency_relative_interval é int e pode ser 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 freqüência de reagendamento durante o período definido. frequency_subday é inte pode ser 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 Distribution Agent, formatada como HHMMSS. active_start_time_of_day é int, com um padrão 0.

• [ @active_end_time_of_day = ] active_end_time_of_day
  É a hora do dia em que o Distribution Agent deixa de ser agendado, formatada como HHMMSS. active_end_time_of_dayis int, com um padrão 235959, o que significa 23:59:59 como a medição de um relógio 24 horas.

• [ @active_start_date = ] active_start_date
  É a data do primeiro agendamento do Distribution Agent, formatada comoYYYYMMDD. active_start_date é int, com um padrão 0.

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

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

  Observação
  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.

Consulte também

Referência

sp_changesubscriber_schedule (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)