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.

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 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)	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 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

Aufgaben

Vorgehensweise: Erstellen eines Pushabonnements (Replikationsprogrammierung mit Transact-SQL)

Vorgehensweise: Erstellen eines Pullabonnements (Replikationsprogrammierung mit Transact-SQL)

Verweis

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)