sp_addsubscriber_schedule (Transact-SQL)

Gilt für:SQL ServerAzure 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 Letzte

[ @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 9999123131. 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 (Erfolg) oder 1 (Fehler).

Hinweise

sp_addsubscriber_schedulewird in Momentaufnahme Replikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_addsubscriber_schedule.