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 Typ des Agents. 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 Zeitplanung 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 (Standard)	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. Der Standardwert ist 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 (Standard)	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. Der Standardwert ist 0.

• [ @frequency_subday = ] frequency_subday
  Die Häufigkeit für die erneute geplante Ausführung während des definierten Zeitraums. frequency_subday ist vom Datentyp int. Die folgenden Werte sind möglich:

  Wert	Beschreibung
  1	Einmal
  2	Zweimal
  4 (Standard)	Minute
  8	Stunde

• [ @frequency_subday_interval = ] frequency_subday_interval
  Das Intervall für frequency_subday. frequency_subday_interval ist vom Datentyp int. Der Standardwert ist 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. Der Standardwert ist 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_dayist vom Datentyp int und hat den Standardwert 235959 (23:59:59 Uhr im 24-Stunden-Format).

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

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

• [ @publisher = ] 'publisher'
  Gibt einen Nicht-Microsoft SQL Server-Verleger an. publisher ist vom Datentyp sysname. Der Standardwert ist 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 Momentaufnahme-, 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)