Condividi tramite


sp_changesubscriber_schedule (Transact-SQL)

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

Modifica la pianificazione dell'agente di distribuzione o di merge per un Sottoscrittore. Questa stored procedure viene eseguita in qualsiasi database del server di pubblicazione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @subscriber = ] N'subscriber'

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

[ @agent_type = ] agent_type

Tipo di agente. @agent_type è smallint, con il valore predefinito 0.

  • 0indica un agente di distribuzione.
  • 1indica un agente di merge.

[ @frequency_type = ] frequency_type

Specifica la frequenza con cui pianificare l'attività 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 applicato alla frequenza impostata da @frequency_type. @frequency_interval è int e dipende dal valore di @frequency_type.

Valore di @frequency_type Effetto sulle @frequency_interval
1 (predefinito) @frequency_interval non è usato.
4 Ogni @frequency_interval giorni.
8 @frequency_interval è uno o più dei seguenti elementi (combinati con un oggetto | (OR bit per bit) (Transact-SQL) Operatore logico):

1 = Domenica
2 = Lunedì
4 = Martedì
8 = Mercoledì
16 = Giovedì
32 = Venerdì
64 = Sabato
16 Nel @frequency_interval giorno del mese.
32 @frequency_interval è una delle opzioni seguenti:

1 = Domenica
2 = Lunedì
3 = Martedì
4 = Mercoledì
5 = Giovedì
6 = Venerdì
7 = Sabato
8 = Giorno
9 = Giorno feriale
10 = Giorno del fine settimana
64 @frequency_interval non è usato.
128 @frequency_interval non è usato.

[ @frequency_relative_interval = ] frequency_relative_interval

Data dell'attività di distribuzione. @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

Specifica la frequenza, espressa in minuti, di riprogrammazione 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 Ora

[ @frequency_subday_interval = ] frequency_subday_interval

Numero di periodi di frequency_subday che si verificano tra ogni esecuzione del processo. @frequency_subday_interval è int, con il valore predefinito 5.

[ @active_start_time_of_day = ] active_start_time_of_day

Ora del giorno in cui l'attività di distribuzione è pianificata per la prima volta. @active_start_time_of_day è int, con il valore predefinito NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Ora del giorno in cui l'attività di distribuzione smette di essere pianificata. @active_end_time_of_day è int, con un valore predefinito 235959, che significa 11:59:59 P.M. su un orologio di 24 ore.

[ @active_start_date = ] active_start_date

Data della prima pianificazione dell'attività di distribuzione, formattata come yyyyMMdd. @active_start_date è int, con un valore predefinito .NULL

[ @active_end_date = ] active_end_date

Data in cui l'attività di distribuzione smette di essere pianificata, formattata 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 usato quando si modificano le proprietà dell'articolo in un server di pubblicazione di SQL Server.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_changesubscriber_schedule viene usato in tutti i tipi di replica.

Autorizzazioni

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