• Artikel

sp_changesubscriber_schedule (Transact-SQL)

Ändert den Zeitplan des Verteilungs- und Merge-Agents für einen Abonnenten. Diese gespeicherte Prozedur wird auf dem Verleger für jede Datenbank ausgeführt.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_changesubscriber_schedule [ @subscriber = ] 'subscriber', [ @agent_type = ] 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 sein und darf nicht bereits vorhanden sein. Außerdem darf er nicht gleich NULL sein.

  • [ @agent_type=] type
    Der Agenttyp. type ist vom Datentyp smallint und hat den Standardwert 0. 0 zeigt einen Verteilungs-Agent an. 1 zeigt einen Merge-Agent an.

  • [ @frequency_type=] frequency_type
    Die Häufigkeit für die Planung des Verteilungstasks. frequency_type ist vom Datentyp int und hat den Standardwert 64. Es gibt 10 Zeitplanspalten.

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

  • [ @frequency_relative_interval=] frequency_relative_interval
    Das Datum des Verteilungstasks.frequency_relative_interval ist vom Datentyp int und hat den Standardwert 1.

  • [ @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 (in Minuten) der erneuten Planung während des definierten Zeitraumes. frequency_subday ist vom Datentyp int und hat den Standardwert 4.

  • [ @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 Verteilungstask zum ersten Mal geplant ist. 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, zu der der Verteilungstask beendet werden soll. active_end_time_of_day ist vom Datentyp int und hat den Standardwert 235959, womit 23:59:59 des 24-Stunden-Formats gemeint ist.

  • [ @active_start_date=] active_start_date
    Das Datum, an dem der Verteilungstask 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, an dem der Verteilungstask beendet werden soll. 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 ein Wert vom Datentyp sysname; der Standardwert ist NULL.

    HinweisHinweis

    publisher sollte nicht beim Ändern von Artikeleigenschaften für einen SQL Server-Verleger verwendet werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changesubscriber_schedule wird für alle Replikationstypen verwendet.

Berechtigungen

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