sp_addsubscriber_schedule (Transact-SQL)

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

Argumente

• [ @subscriber=] 'subscriber'
  Der Name des Abonnenten. subscriber ist vom Datentyp sysname. Der Name des Abonnenten muss innerhalb der Datenbank eindeutig und darf nicht bereits vorhanden sein. Außerdem darf er nicht gleich NULL sein.

• [ @agent_type=] agent_type
  Der Agenttyp. agent_type ist vom Datentyp smallint. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  0 (Standardwert)	Verteilungs-Agent
  1	Merge-Agent

• [ @frequency_type=] frequency_type
  Die Häufigkeit für die Planung des Verteilungs-Agents. frequency_type ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  1	Einmal
  2	Bedarfsgesteuert
  4	Täglich
  8	Wöchentlich
  16	Monatlich
  32	Monatlich, relativ
  64 (Standardwert)	Autostart
  128	Wiederholt

• [ @frequency_interval=] frequency_interval
  Der Wert, der auf die durch frequency_type festgelegte Häufigkeit angewendet werden soll. frequency_interval ist vom Datentyp int und hat den Standardwert 1.

• [ @frequency_relative_interval=] frequency_relative_interval
  Das Datum des Verteilungs-Agents. Dieser Parameter wird verwendet, wenn frequency_type auf 32 (monatlich, relativ) festgelegt wird. frequency_relative_interval ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  1 (Standardwert)	Erster
  2	Zweiter
  4	Dritter
  8	Vierter
  16	Letzter

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  Der von frequency_type verwendete Wiederholungsfaktor. frequency_recurrence_factor ist vom Datentyp int und hat den Standardwert 0.

• [ @frequency_subday=] frequency_subday
  Die Häufigkeit der erneuten Planung während des definierten Zeitraumes. frequency_subday ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  1	Einmal
  2	Sekunde
  4 (Standardwert)	Minute
  8	Stunde

• [ @frequency_subday_interval=] frequency_subday_interval
  Das Intervall für frequency_subday. frequency_subday_interval ist vom Datentyp int und hat den Standardwert 5.

• [ @active_start_time_of_day=] active_start_time_of_day
  Die Tageszeit, zu der der Verteilungs-Agent zum ersten Mal geplant ist. Dabei wird das Format HHMMSS verwendet. active_start_time_of_day ist vom Datentyp int und hat den Standardwert 0.

• [ @active_end_time_of_day=] active_end_time_of_day
  Die Tageszeit, ab der der Verteilungs-Agent nicht mehr geplant ist. Dabei wird das Format HHMMSS verwendet. active_end_time_of_day ist vom Datentyp int und hat den Standardwert 235959, womit 23:59:59 Uhr des 24-Stunden-Systems gemeint ist.

• [ @active_start_date = ] active_start_date
  Das Datum, an dem der Verteilungs-Agent zum ersten Mal geplant ist. Dabei wird das Format YYYYMMDD verwendet. active_start_date ist vom Datentyp int und hat den Standardwert 0.

• [ @active_end_date = ] active_end_date
  Das Datum, ab dem der Verteilungs-Agent nicht mehr geplant ist. Dabei wird das Format YYYYMMDD verwendet. active_end_date ist vom Datentyp int und hat den Standardwert 99991231, womit der 31. Dezember 9999 gemeint ist.

• [ @publisher = ] 'publisher'
  Gibt einen Nicht-Microsoft SQL Server-Verleger an. publisher ist vom Datentyp sysname und hat den Standardwert NULL.

  Hinweis
  publisher sollte nicht für einen SQL Server-Verleger angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_addsubscriber_schedule wird bei der Snapshot-, Transaktions- und Mergereplikation verwendet.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können sp_addsubscriber_schedule ausführen.

Siehe auch

Verweis

sp_changesubscriber_schedule (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)