sp_addsubscriber (Transact-SQL)
Fügt einen neuen Abonnenten zu einem Verleger hinzu, wobei dieser für den Empfang von Publikationen aktiviert wird. Diese gespeicherte Prozedur wird für Snapshot- und Transaktionspublikationen auf dem Verleger in der Publikationsdatenbank ausgeführt. Für Mergepublikationen, 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. |
Transact-SQL-Syntaxkonventionen
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 Publikationen 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)
Microsoft SQL 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 Mergepublikationen 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
Verweis
sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)
Andere Ressourcen
Vorgehensweise: Erstellen eines Pushabonnements (Replikationsprogrammierung mit Transact-SQL)
Vorgehensweise: Erstellen eines Pullabonnements (Replikationsprogrammierung mit Transact-SQL)