sp_addsubscriber_schedule (Transact-SQL)

Aggiunge una pianificazione per l'agente di distribuzione e l'agente di merge. Questa stored procedure viene eseguita in qualsiasi database del server di pubblicazione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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' ]

Argomenti

  • [ @subscriber = ] 'subscriber'
    Nome del Sottoscrittore. subscriber è di tipo sysname. Il nome del Sottoscrittore deve essere univoco all'interno del database, non deve essere già esistente e non può essere NULL.

  • [ @agent_type = ] agent_type
    Tipo di agente. agent_type è di tipo smallint e i possibili valori sono i seguenti.

    Valore

    Descrizione

    0 (predefinito)

    Agente di distribuzione

    1

    Agente di merge

  • [ @frequency_type = ] frequency_type
    Frequenza per l'esecuzione pianificata dell'agente di distribuzione. frequency_type è di tipo int e i possibili valori sono i seguenti.

    Valore

    Descrizione

    1

    Una volta

    2

    Su richiesta

    4

    Giornaliera

    8

    Settimanale

    16

    Mensile

    32

    Mensile relativo

    64 (predefinito)

    Avvio automatico

    128

    Periodica

  • [ @frequency_interval = ] frequency_interval
    Valore da applicare alla frequenza impostata da frequency_type. frequency_interval è di tipo int e il valore predefinito è 1.

  • [ @frequency_relative_interval = ] frequency_relative_interval
    Data dell'agente di distribuzione. Questo parametro viene utilizzato quando frequency_type è impostato su 32 (frequenza mensile relativa). frequency_relative_interval è di tipo int e i possibili valori sono i seguenti.

    Valore

    Descrizione

    1 (predefinito)

    Primo

    2

    Secondo

    4

    Terzo

    8

    Quarto

    16

    Ultimo

  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    Fattore di ricorrenza utilizzato da frequency_type. frequency_recurrence_factor è di tipo int e il valore predefinito è 0.

  • [ @frequency_subday = ] frequency_subday
    Frequenza di ripianificazione durante il periodo definito. frequency_subday è di tipo int e i possibili valori sono i seguenti.

    Valore

    Descrizione

    1

    Una volta

    2

    Secondo

    4 (predefinito)

    Minuto

    8

    Ora

  • [ @frequency_subday_interval = ] frequency_subday_interval
    Intervallo per frequency_subday. frequency_subday_interval è di tipo int e il valore predefinito è 5.

  • [ @active_start_time_of_day = ] active_start_time_of_day
    Ora del giorno della prima esecuzione pianificata dell'agente di distribuzione, nel formato HHMMSS. active_start_time_of_day è di tipo int e il valore predefinito è 0.

  • [ @active_end_time_of_day = ] active_end_time_of_day
    Ora del giorno dell'ultima esecuzione pianificata dell'agente di distribuzione, nel formato HHMMSS. active_end_time_of_dayè di tipo int e il valore predefinito è 235959, che corrisponde alle 23.59.59 nel formato 24 ore.

  • [ @active_start_date = ] active_start_date
    Data della prima esecuzione pianificata dell'agente di distribuzione, nel formato AAAAMMGG. active_start_date è di tipo int e il valore predefinito è 0.

  • [ @active_end_date = ] active_end_date
    Data dell'ultima esecuzione pianificata dell'agente di distribuzione, nel formato AAAAMMGG. active_end_date è di tipo int e il valore predefinito è 99991231, che corrisponde al 31 dicembre 9999.

  • [ @publisher = ] 'publisher'
    Specifica un server di pubblicazione non MicrosoftSQL Server. publisher è di tipo sysname e il valore predefinito è NULL.

    [!NOTA]

    Non specificare publisher per un server di pubblicazione SQL Server.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_addsubscriber_schedule viene utilizzata nella replica snapshot, transazionale e di tipo merge.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire la procedura sp_addsubscriber_schedule.