Freigeben über


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.

Themenlink (Symbol) 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.

    HinweisHinweis

    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)