sp_addsubscriber_schedule (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

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.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @subscriber = ] N'subscriber'

Nome del Sottoscrittore. @subscriber è sysname, senza impostazione predefinita. @subscriber deve essere univoco nel database, non deve esistere già e non può essere NULL.

[ @agent_type = ] agent_type

Tipo di agente. @agent_type è smallint e può essere uno di questi valori.

Valore Descrizione
0 (predefinito) Agente di distribuzione
1 Agente di merge

[ @frequency_type = ] frequency_type

Specifica la frequenza con cui pianificare il agente di distribuzione. @frequency_type è int e può essere uno di questi valori.

Valore Descrizione
1 Singola occorrenza
2 Su richiesta
4 Ogni giorno
8 Settimanale
16 Mensile
32 Mensile relativa
64 (predefinito) Avvio automatico
128 Ricorrente

[ @frequency_interval = ] frequency_interval

Valore da applicare alla frequenza impostata da frequency_type. @frequency_interval è int, con il valore predefinito 1.

[ @frequency_relative_interval = ] frequency_relative_interval

Data del agente di distribuzione. Questo parametro viene usato quando frequency_type è impostato su 32 (relativo mensile). @frequency_relative_interval è int e può essere uno di questi valori.

Valore Descrizione
1 (predefinito) First
2 Secondo
4 Terza
8 Quarta
16 Last

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Fattore di ricorrenza utilizzato da frequency_type. @frequency_recurrence_factor è int, con un valore predefinito .0

[ @frequency_subday = ] frequency_subday

Frequenza con cui riprogrammare durante il periodo definito. @frequency_subday è int e può essere uno di questi valori.

Valore Descrizione
1 Una sola volta
2 Secondo
4 (predefinito) Minute
8 Ore

[ @frequency_subday_interval = ] frequency_subday_interval

Intervallo per frequency_subday. @frequency_subday_interval è int, con il valore predefinito 5.

[ @active_start_time_of_day = ] active_start_time_of_day

Ora del giorno in cui il agente di distribuzione viene pianificato per la prima volta, formattato come HHmmss. @active_start_time_of_day è int, con il valore predefinito 0.

[ @active_end_time_of_day = ] active_end_time_of_day

Ora del giorno in cui il agente di distribuzione smette di essere pianificato, formattato come HHmmss. @active_end_time_of_day è int, con un valore predefinito , 235959che significa 11:59:59 P.M. come misurato su un orologio di 24 ore.

[ @active_start_date = ] active_start_date

Data in cui il agente di distribuzione viene pianificato per la prima volta, formattato come yyyyMMdd. @active_start_date è int, con un valore predefinito .0

[ @active_end_date = ] active_end_date

Data in cui il agente di distribuzione smette di essere pianificato, formattato come yyyyMMdd. @active_end_date è int, con un valore predefinito 99991231, che indica il 31 dicembre 9999.

[ @publisher = ] N'publisher'

Specifica un server di pubblicazione non SQL Server. @publisher è sysname, con un valore predefinito .NULL

@publisher non deve essere specificato per un server di pubblicazione di SQL Server.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_addsubscriber_schedule viene usato nella replica snapshot, nella replica transazionale e nella replica di tipo merge.

Autorizzazioni

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