sp_changesubscriber (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL Managed Instance

Ändert die Optionen für einen Abonnenten. Alle Verteilungstasks für die Abonnenten des Verlegers werden aktualisiert. Diese gespeicherte Prozedur schreibt in die MSsubscriber_info Tabelle in der Verteilungsdatenbank. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changesubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @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 ]
    [ , [ @description = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argumente

[ @subscriber = ] N'subscriber'

Der Name des Abonnenten, für den die Optionen geändert werden sollen. @subscriber ist "sysname" ohne Standard.

[ @type = ] Typ

Der Abonnententyp. @type ist winzig, mit einem Standardwert von NULL.

  • 0 gibt einen SQL Server-Abonnent an.
  • 1 Gibt einen Nicht-SQL Server oder einen anderen ODBC-Datenquellenserverabonnent an.

[ @login = ] N'login'

Die ANMELDE-ID der SQL Server-Authentifizierung. @login ist "sysname" mit der Standardeinstellung "NULL.

[ @password = ] N'password'

Das SQL Server-Authentifizierungskennwort. @password ist "sysname" mit dem Standardwert "%, der angibt, dass die Kennworteigenschaft nicht geändert wird.

[ @commit_batch_size = ] commit_batch_size

Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten.

[ @status_batch_size = ] status_batch_size

Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten.

[ @flush_frequency = ] flush_frequency

Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten.

[ @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 Autostart
128 Wiederkehrend

[ @frequency_interval = ] frequency_interval

Das Intervall für @frequency_type. @frequency_interval ist int, mit einem Standardwert von NULL.

[ @frequency_relative_interval = ] frequency_relative_interval

Das Datum des Verteilungsvorgangs. Dieser Parameter wird verwendet, wenn @frequency_type auf 32 (monatlich relativ) festgelegt ist. @frequency_relative_interval ist int und kann einer dieser Werte sein.

Wert Beschreibung
1 First
2 Second
4 Third
8 Viertes
16 Last

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Gibt an, wie oft die Verteilungsaufgabe während der definierten @frequency_type erneut ausgeführt werden soll. @frequency_recurrence_factor ist int mit einem Standardwert von NULL.

[ @frequency_subday = ] frequency_subday

Gibt an, wie oft 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 Minute
8 Hour

[ @frequency_subday_interval = ] frequency_subday_interval

Das Intervall für @frequence_subday. @frequency_subday_interval ist int, mit einem Standardwert von NULL.

[ @active_start_time_of_day = ] active_start_time_of_day

Die Tageszeit, zu der der Verteilungsvorgang zum ersten Mal geplant ist, formatiert als HHmmss. @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, formatiert als HHmmss. @active_end_time_of_day ist int mit einem Standardwert von NULL.

[ @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 einem Standardwert von NULL.

[ @description = ] N'description'

Eine optionale Beschreibung in Textform @description ist nvarchar(255), mit einem Standardwert von NULL.

[ @security_mode = ] security_mode

Der implementierte Sicherheitsmodus. @security_mode ist int und kann einer dieser Werte sein.

Wert Beschreibung
0 SQL Server-Authentifizierung
1 Windows-Authentifizierung

[ @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 wird in allen Replikationstypen verwendet.

Berechtigungen

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

Zugehöriger Inhalt