sp_addsubscriber (Transact-SQL)
Gilt für: SQL Server Azure SQL-Datenbank
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 Momentaufnahme- 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. Sie müssen einen Abonnenten nicht mehr explizit bei Publisher registrieren.
Transact-SQL-Syntaxkonventionen
Syntax
sp_addsubscriber
[ @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 ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @publisher = ] N'publisher' ]
[ ; ]
Argumente
[ @subscriber = ] N'subscriber'
Der Name des Servers, der als gültiger Abonnent der Publikationen auf diesem Server hinzugefügt werden soll. @subscriber ist "sysname" ohne Standard.
[ @type = ] Typ
Der Typ des Abonnenten. @type ist winzig und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
0 (Standardwert) |
SQL Server-Abonnent |
1 |
ODBC-Datenquellenserver |
2 |
Microsoft Jet-Datenbank |
3 |
OLE DB-Anbieter |
[ @login = ] N'login'
Die Anmelde-ID für die SQL Server-Authentifizierung. @login ist "sysname" mit der Standardeinstellung "NULL
.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @password = ] N'password'
Das Kennwort für die SQL Server-Authentifizierung. @password ist nvarchar(524), wobei die Standardeinstellung istNULL
.
Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @commit_batch_size = ] commit_batch_size
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten.
Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @status_batch_size = ] status_batch_size
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten.
Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @flush_frequency = ] flush_frequency
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten.
Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @frequency_type = ] frequency_type
Gibt die Häufigkeit an, mit der der Replikations-Agent 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 |
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @frequency_interval = ] frequency_interval
Der Wert, der auf die von @frequency_type festgelegte Häufigkeit angewendet wird. @frequency_interval ist int, mit einem Standardwert von 1
.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung 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 ist. @frequency_relative_interval ist int und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
1 (Standardwert) |
First |
2 |
Second |
4 |
Third |
8 |
Viertes |
16 |
Last |
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Der von @frequency_type verwendete Serienfaktor. @frequency_recurrence_factor ist int mit einem Standardwert von 0
.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @frequency_subday = ] frequency_subday
Wie oft während des definierten Zeitraums neu geplant wird. @frequency_subday ist int und kann einer dieser Werte sein.
Wert | Beschreibung |
---|---|
1 |
Einmal |
2 |
Second |
4 (Standard) |
Minute |
8 |
Hour |
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @frequency_subday_interval = ] frequency_subday_interval
Das Intervall für frequency_subday. @frequency_subday_interval ist int, mit einem Standardwert von 5
.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @active_start_time_of_day = ] active_start_time_of_day
Die Uhrzeit, zu der der Replikations-Agent zum ersten Mal geplant ist, formatiert als HHmmss
. @active_start_time_of_day ist int mit einem Standardwert von 0
.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @active_end_time_of_day = ] active_end_time_of_day
Die Tageszeit, zu der der Replikations-Agent nicht mehr geplant wird, formatiert als HHmmss
. @active_end_time_of_day ist int, mit einem Standardwert von 235959
, was bedeutet 11:59:59:59 P.M. gemessen auf einer 24-Stunden-Uhr.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @active_start_date = ] active_start_date
Das Datum, an dem der Replikations-Agent zum ersten Mal geplant ist, formatiert als yyyyMMdd
. @active_start_date ist int, mit einem Standardwert von 0
.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @active_end_date = ] active_end_date
Das Datum, an dem der Replikations-Agent nicht mehr geplant wird, formatiert als yyyyMMdd
. @active_end_date ist int, mit einer Standardeinstellung vom 99991231
31. Dezember 9999.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @description = ] N'description'
Eine Textbeschreibung des Abonnenten. @description ist nvarchar(255), mit einem Standardwert von NULL
.
[ @security_mode = ] security_mode
Der implementierte Sicherheitsmodus. @security_mode ist int mit einem Standardwert von 1
.
0
Gibt die SQL Server-Authentifizierung an.1
gibt Windows-Authentifizierung an.
Hinweis
Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Die Eigenschaft wird jetzt pro Abonnement angegeben, wenn sp_addsubscription ausgeführt wird. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements bei diesem Abonnenten als Standard verwendet, und es wird eine Warnmeldung zurückgegeben.
[ @encrypted_password = ] encrypted_password
Dieser Parameter ist veraltet und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Das Festlegen @encrypted_password auf einen beliebigen Wert, führt jedoch 0
zu einem Fehler.
[ @publisher = ] N'publisher'
Gibt einen Nicht-SQL Server-Herausgeber an. @publisher ist "sysname" mit der Standardeinstellung "NULL
.
@publisher sollte beim Veröffentlichen aus einem SQL Server-Herausgeber nicht verwendet werden.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Hinweise
sp_addsubscriber
wird in der Momentaufnahmereplikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.
sp_addsubscriber
ist nicht erforderlich, wenn der Abonnent nur über anonyme Abonnements zum Zusammenführen von Publikationen verfügt.
sp_addsubscriber
schreibt in die MSsubscriber_info Tabelle in der Verteilungsdatenbank .
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_addsubscriber
.