sp_addsubscriber_schedule (Transact-SQL)
Gilt für: SQL Server Azure SQL Managed Instance
Fügt dem Verteilungs- und Merge-Agent einen Zeitplan hinzu. Diese gespeicherte Prozedur wird auf dem Verleger für jede Datenbank ausgeführt.
Transact-SQL-Syntaxkonventionen
Syntax
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' ]
[ ; ]
Argumente
[ @subscriber = ] N'subscriber'
Den Namen des Abonnenten. @subscriber ist "sysname" ohne Standard. @subscriber muss in der Datenbank eindeutig sein, darf nicht bereits vorhanden sein und darf nicht seinNULL
.
[ @agent_type = ] agent_type
Der Agenttyp. @agent_type ist klein und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
0 (Standardwert) |
Verteilungs-Agent |
1 |
Merge-Agent |
[ @frequency_type = ] frequency_type
Gibt die Häufigkeit an, mit der die Verteilungs-Agent geplant werden soll. @frequency_type ist int und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
1 |
Einmal |
2 |
On-Demand-Streaming |
4 |
Täglich |
8 |
Wöchentlich |
16 |
Monatlich |
32 |
Monatlich, relativ |
64 (Standard) |
Autostart |
128 |
Wiederkehrend |
[ @frequency_interval = ] frequency_interval
Der Wert, der auf die von frequency_type festgelegte Häufigkeit angewendet werden soll. @frequency_interval ist int, mit einem Standardwert von 1
.
[ @frequency_relative_interval = ] frequency_relative_interval
Das Datum des Verteilungs-Agent. Dieser Parameter wird verwendet, wenn frequency_type auf 32
(monatlich relativ) festgelegt ist. @frequency_relative_interval ist int und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
1 (Standardwert) |
First |
2 |
Second |
4 |
Third |
8 |
Viertes |
16 |
Last |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Der von frequency_type verwendete Serienfaktor. @frequency_recurrence_factor ist int mit einem Standardwert von 0
.
[ @frequency_subday = ] frequency_subday
Wie oft während des definierten Zeitraums neu geplant wird. @frequency_subday ist int und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
1 |
Einmal |
2 |
Second |
4 (Standard) |
Minute |
8 |
Hour |
[ @frequency_subday_interval = ] frequency_subday_interval
Das Intervall für frequency_subday. @frequency_subday_interval ist int, mit einem Standardwert von 5
.
[ @active_start_time_of_day = ] active_start_time_of_day
Die Tageszeit, zu der die Verteilungs-Agent zum ersten Mal geplant ist, formatiert als HHmmss
. @active_start_time_of_day ist int mit einem Standardwert von 0
.
[ @active_end_time_of_day = ] active_end_time_of_day
Die Tageszeit, zu der die Verteilungs-Agent nicht mehr geplant wird, formatiert als HHmmss
. @active_end_time_of_day ist int, mit einem Standardwert von 235959
, was bedeutet 11:59:59:59 P.M. gemessen auf einer 24-Stunden-Uhr.
[ @active_start_date = ] active_start_date
Das Datum, an dem die Verteilungs-Agent zum ersten Mal geplant ist, formatiert als yyyyMMdd
. @active_start_date ist int, mit einem Standardwert von 0
.
[ @active_end_date = ] active_end_date
Das Datum, an dem die Verteilungs-Agent nicht mehr geplant wird, formatiert als yyyyMMdd
. @active_end_date ist int, mit einer Standardeinstellung vom 99991231
31. Dezember 9999.
[ @publisher = ] N'publisher'
Gibt einen Nicht-SQL Server-Herausgeber an. @publisher ist "sysname" mit der Standardeinstellung "NULL
.
@publisher sollte für einen SQL Server-Herausgeber nicht angegeben werden.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Hinweise
sp_addsubscriber_schedule
wird in der Momentaufnahmereplikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_addsubscriber_schedule
.