sp_addsubscriber (Transact-SQL)

Gilt für:SQL ServerAzure 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 Letzte

Hinweis

Dieser Parameter ist veraltet und wird zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 zur Abwärtskompatibilität von Skripts Standard 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 9999123131. Dezember 9999.

Hinweis

Dieser Parameter ist veraltet und wird zur Abwärtskompatibilität von Skripts Standard 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.
  • 1gibt Windows-Authentifizierung an.

Hinweis

Dieser Parameter ist veraltet und wird zur Abwärtskompatibilität von Skripts Standard 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 (Erfolg) oder 1 (Fehler).

Hinweise

sp_addsubscriberwird in Momentaufnahme Replikation, 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.