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)

Hilfe und Informationen

Informationsquellen für SQL Server 2005