• Artikel

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.

Wichtiger HinweisWichtig

Diese gespeicherte Prozedur wurde als veraltet markiert. Es ist nicht mehr erforderlich, einen Abonnenten ausdrücklich auf dem Verleger zu registrieren.

Themenlink (Symbol)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)

    MicrosoftSQL 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.

    HinweisHinweis

    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.

    SicherheitshinweisSicherheitshinweis

    Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort.
    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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
    HinweisHinweis

    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.

    HinweisHinweis

    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
    HinweisHinweis

    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.

    HinweisHinweis

    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
    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.

    HinweisHinweis

    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.