sp_changesubscriber_schedule (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure SQL Managed Instance

Ä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.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changesubscriber_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. Der Name des Abonnenten muss in der Datenbank eindeutig sein, darf nicht bereits vorhanden sein und darf nicht sein NULL.

[ @agent_type = ] agent_type

Der Agenttyp. @agent_type ist klein, mit einem Standardwert von 0.

0gibt einen Verteilungs-Agent an.
1gibt einen Merge-Agent an.

[ @frequency_type = ] frequency_type

Gibt die Häufigkeit an, mit der der Verteilungsvorgang 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 wird. @frequency_interval ist int und hängt vom Wert der @frequency_type ab.

Wert von @frequency_type	Auswirkung auf @frequency_interval
`1` (Standard)	@frequency_interval ist nicht verwendet.
`4`	Alle @frequency_interval Tage.
`8`	@frequency_interval ist eine oder mehrere der folgenden Elemente (kombiniert mit einem \| (Bitweise ODER) logischer Operator): `1` = Sonntag `2` = Montag `4` = Dienstag `8` = Mittwoch `16` = Donnerstag `32` = Freitag `64` = Samstag
`16`	Am @frequency_interval Tag des Monats.
`32`	@frequency_interval ist eine der folgenden Optionen: `1` = Sonntag `2` = Montag `3` = Dienstag `4` = Mittwoch `5` = Donnerstag `6` = Freitag `7` = Samstag `8` = Tag `9` = Wochentag `10` = Wochenendtag
`64`	@frequency_interval ist nicht verwendet.
`128`	@frequency_interval ist nicht verwendet.

[ @frequency_relative_interval = ] frequency_relative_interval

Das Datum des Verteilungsvorgangs. @frequency_relative_interval ist int und kann einer dieser Werte sein.

Wert	Beschreibung
`1` (Standardwert)	First
`2`	Second
`4`	Third
`8`	Viertes
`16`	Last

[ @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

Gibt an, wie oft in Minuten während des definierten Zeitraums neu geplant werden soll. @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

Die Anzahl der frequency_subday Zeiträume, die zwischen jeder Ausführung des Auftrags auftreten. @frequency_subday_interval ist int, mit einem Standardwert von 5.

[ @active_start_time_of_day = ] active_start_time_of_day

Die Tageszeit, zu der der Verteilungsvorgang zum ersten Mal geplant ist. @active_start_time_of_day ist int mit einem Standardwert von NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Die Tageszeit, zu der der Verteilungsvorgang nicht mehr geplant wird. @active_end_time_of_day ist int, mit einem Standardwert von 235959, was bedeutet, dass 11:59:59 Uhr auf einer 24-Stunden-Uhr.

[ @active_start_date = ] active_start_date

Das Datum, an dem der Verteilungsvorgang zum ersten Mal geplant ist, formatiert als yyyyMMdd. @active_start_date ist int, mit einem Standardwert von NULL.

[ @active_end_date = ] active_end_date

Das Datum, an dem der Verteilungsvorgang 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 nicht verwendet werden, wenn Artikeleigenschaften in einem SQL Server-Publisher geändert werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changesubscriber_schedule wird in allen Replikationstypen verwendet.

Berechtigungen

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

Freigeben über