sp_addsubscriber (Transact-SQL)
Fügt einen neuen Abonnenten zu einem Verleger hinzu, wobei dieser für den Empfang von Veröffentlichungen aktiviert wird. Diese gespeicherte Prozedur wird für Snapshot- und Transaktionsveröffentlichungen auf dem Verleger in der Veröffentlichungsdatenbank ausgeführt. Für Mergeveröffentlichungen, die einen Remoteverteiler verwenden, wird diese gespeicherte Prozedur auf dem Verteiler ausgeführt.
Wichtig |
---|
Diese gespeicherte Prozedur wurde als veraltet markiert. Es ist nicht mehr erforderlich, einen Abonnenten ausdrücklich auf dem Verleger zu registrieren. |
Syntax
sp_addsubscriber [ @subscriber = ] 'subscriber'
[ , [ @type = ] type ]
[ , [ @login = ] 'login' ]
[ , [ @password = ] '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 = ] 'description' ]
[ , [ @security_mode = ] security_mode ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @publisher = ] 'publisher' ]
Argumente
[ @subscriber=] 'subscriber'
Der Name des Servers, der den Veröffentlichungen auf diesem Server als gültiger Abonnent hinzugefügt werden soll. subscriber ist vom Datentyp sysname und hat keinen Standardwert.[ @type=] type
Der Abonnententyp. type ist vom Datentyp tinyint. Die folgenden Werte sind möglich:Wert
Beschreibung
0 (Standard)
MicrosoftSQL Server-Abonnent
1
ODBC-Datenquellenserver
2
Microsoft Jet-Datenbank
3
OLE DB-Anbieter (OLE DB provider)
[ @login =] 'login'
Die Anmelde-ID für die SQL Server-Authentifizierung. login ist vom Datentyp sysname und hat den Standardwert NULL.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @password = ] 'password'
Das Kennwort für die SQL Server-Authentifizierung. password ist vom Datentyp nvarchar(524) und hat den Standardwert NULL.Sicherheitshinweis Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort.
Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @commit_batch_size=] commit_batch_size
Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.Hinweis Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @status_batch_size=] status_batch_size
Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.Hinweis Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @flush_frequency=] flush_frequency
Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.Hinweis Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @frequency_type=] frequency_type
Die Häufigkeit für die Planung des Replikations-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
Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[@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.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @frequency_relative_interval=] frequency_relative_interval
Das Datum des Replikations-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
Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @frequency_recurrence_factor=] frequency_recurrence_factor
Der von frequency_type verwendete Wiederholungsfaktor. frequency_recurrence_factor ist vom Datentyp int und hat den Standardwert 0.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @frequency_subday=] frequency_subday
Die Häufigkeit der erneuten Planung während des definierten Zeitraumes. frequency_subday ist vom Datentyp int. Die folgenden Werte sind möglich:Wert
Beschreibung
1
Einmal
2
Sekunde
4 (Standard)
Minute
8
Stunde
Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @frequency_subday_interval=] frequency_subday_interval
Das Intervall für frequency_subday. frequency_subday_interval ist vom Datentyp int und hat den Standardwert 5.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @active_start_time_of_day=] active_start_time_of_day
Die Tageszeit, zu der der Replikations-Agent zum ersten Mal geplant ist. Dabei wird das Format HHMMSS verwendet. active_start_time_of_day ist vom Datentyp int und hat den Standardwert 0.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @active_end_time_of_day=] active_end_time_of_day
Die Tageszeit, ab der der Replikations-Agent nicht mehr geplant ist. Dabei wird das Format HHMMSS verwendet. active_end_time_of_day ist vom Datentyp int und hat den Standardwert 235959, womit 23:59:59 Uhr des 24-Stunden-Systems gemeint ist.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @active_start_date = ] active_start_date
Das Datum, an dem der Replikations-Agent zum ersten Mal geplant ist. Dabei wird das Format YYYYMMDD verwendet. active_start_date ist vom Datentyp int und hat den Standardwert 0.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @active_end_date = ] active_end_date
Das Datum, ab dem der Replikations-Agent nicht mehr geplant ist. 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.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @description =] 'description'
Eine Textbeschreibung für den Abonnenten. description ist vom Datentyp nvarchar(255) und hat den Standardwert NULL.[ @security_mode=] security_mode
Der implementierte Sicherheitsmodus. security_mode ist vom Datentyp int und hat den Standardwert 1. Mit 0 wird die SQL Server-Authentifizierung angegeben. 1 gibt die Windows-Authentifizierung an.Hinweis Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird nun auf abonnementspezifischer Basis beim Ausführen von sp_addsubscription angegeben. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.
[ @encrypted_password = ] encrypted_password
Dieser Parameter wurde als veraltet markiert und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Das Festlegen von encrypted_password auf einen anderen Wert als 0 führt zu einem Fehler.[ @publisher= ] 'publisher'
Gibt einen Nicht-SQL Server-Verleger an. publisher ist ein Wert vom Datentyp sysname und besitzt den Standardwert NULL.Hinweis publisher sollte nicht verwendet werden, wenn ein SQL Server-Verleger verwendet wird.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_addsubscriber wird bei der Snapshot-, Transaktions- und Mergereplikation verwendet.
sp_addsubscriber ist nicht erforderlich, wenn der Abonnent nur über anonyme Abonnements von Mergeveröffentlichungen verfügt.
sp_addsubscriber schreibt in die MSsubscriber_info-Tabelle der distribution-Datenbank.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können sp_addsubscriber ausführen.
Siehe auch