sp_addsubscriber (Transact-SQL)sp_addsubscriber (Transact-SQL)

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL DatabaseAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL Database

Fügt einen neuen Abonnenten zu einem Verleger hinzu, wobei dieser für den Empfang von Veröffentlichungen aktiviert wird.Adds a new Subscriber to a Publisher, enabling it to receive publications. 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.This stored procedure is executed at the Publisher on the publication database for snapshot and transactional publications; and for merge publications using a remote Distributor, this stored procedure is executed at the Distributor.

Wichtig

Diese gespeicherte Prozedur wurde als veraltet markiert.This stored procedure has been deprecated. Es ist nicht mehr erforderlich, einen Abonnenten ausdrücklich auf dem Verleger zu registrieren.You are no longer required to explicitly register a Subscriber at the Publisher.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

  
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' ]  

ArgumenteArguments

[ @subscriber = ] 'subscriber' Der Name des Servers, der den Veröffentlichungen auf diesem Server als gültiger Abonnent hinzugefügt werden soll.[ @subscriber = ] 'subscriber' Is the name of the server to be added as a valid Subscriber to the publications on this server. Subscriber ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.subscriber is sysname, with no default.

[ @type = ] type Der Typ des Abonnenten.[ @type = ] type Is the type of Subscriber. Type ist vom Datentyp tinyint. die folgenden Werte sind möglich:type is tinyint, and can be one of these values.

WertValue BESCHREIBUNGDescription
0 (Standardwert)0 (default) MicrosoftMicrosoftSQL ServerSQL ServerAbonnentSQL ServerSQL Server Subscriber
11 ODBC-DatenquellenserverODBC data source server
22 MicrosoftMicrosoft Jet-DatenbankJet database
33 OLE DB-AnbieterOLE DB provider

[ @login = ] 'login' Die Anmelde-ID für die SQL ServerSQL Server Authentifizierung.[ @login = ] 'login' Is the login ID for SQL ServerSQL Server Authentication. login ist vom Datentyp sysnameund hat den Standardwert NULL.login is sysname, with a default of NULL.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @password = ] 'password' Das Kennwort für die SQL ServerSQL Server Authentifizierung.[ @password = ] 'password' Is the password for SQL ServerSQL Server Authentication. Password ist vom Datentyp nvarchar (524) und hat den Standardwert NULL.password is nvarchar(524), with a default of NULL.

Wichtig

Verwenden Sie kein leeres Kennwort.Do not use a blank password. Verwenden Sie ein sicheres Kennwort.Use a strong password.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @commit_batch_size = ] commit_batch_size Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.[ @commit_batch_size = ] commit_batch_size This parameter has been deprecated and is maintained for backward compatibility of scripts.

Hinweis

Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @status_batch_size = ] status_batch_size Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.[ @status_batch_size = ] status_batch_size This parameter has been deprecated and is maintained for backward compatibility of scripts.

Hinweis

Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @flush_frequency = ] flush_frequency Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.[ @flush_frequency = ] flush_frequency This parameter has been deprecated and is maintained for backward compatibility of scripts.

Hinweis

Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_type = ] frequency_type Die Häufigkeit, mit der der Replikations-Agent geplant werden soll.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the replication agent. frequency_type ist vom Datentyp int. die folgenden Werte sind möglich:frequency_type is int, and can be one of these values.

WertValue BESCHREIBUNGDescription
11 EinmaligOne time
22 On-Demand-StreamingOn demand
44 TäglichDaily
88 WöchentlichWeekly
1616 MonatlichMonthly
3232 Monatlich, relativMonthly relative
64 (Standard)64 (default) AutostartAutostart
128128 WiederholtRecurring

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_interval = ] frequency_interval Der Wert, der auf die von frequency_typefestgelegte Häufigkeit angewendet wird.[ @frequency_interval = ] frequency_interval Is the value applied to the frequency set by frequency_type. frequency_interval ist vom Datentyp intund hat den Standardwert 1.frequency_interval is int, with a default of 1.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_relative_interval = ] frequency_relative_interval Das Datum des Replikations-Agents.[ @frequency_relative_interval = ] frequency_relative_interval Is the date of the replication agent. Dieser Parameter wird verwendet, wenn frequency_type auf 32 (monatlich, relativ) festgelegt ist.This parameter is used when frequency_type is set to 32 (monthly relative). frequency_relative_interval ist vom Datentyp int. die folgenden Werte sind möglich:frequency_relative_interval is int, and can be one of these values.

WertValue BESCHREIBUNGDescription
1 (Standard)1 (default) FirstFirst
22 SekundeSecond
44 ThirdThird
88 VierterFourth
1616 Last (Letzter)Last

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Der von frequency_typeverwendete Wiederholungs Faktor.[ @frequency_recurrence_factor = ] frequency_recurrence_factor Is the recurrence factor used by frequency_type. frequency_recurrence_factor ist vom Datentyp intund hat den Standardwert 0.frequency_recurrence_factor is int, with a default of 0.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_subday = ] frequency_subday Gibt an, wie oft innerhalb des definierten Zeitraums neu geplant werden soll.[ @frequency_subday = ] frequency_subday Is how often to reschedule during the defined period. frequency_subday ist vom Datentyp int. die folgenden Werte sind möglich:frequency_subday is int, and can be one of these values.

WertValue BESCHREIBUNGDescription
11 EinmaligOnce
22 SekundeSecond
4 (Standard)4 (default) MinuteMinute
88 StundeHour

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_subday_interval = ] frequency_subday_interval Das Intervall für die frequency_subday.[ @frequency_subday_interval = ] frequency_subday_interval Is the interval for frequency_subday. frequency_subday_interval ist vom Datentyp intund hat den Standardwert 5.frequency_subday_interval is int, with a default of 5.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @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 = ] active_start_time_of_day Is the time of day when the replication agent is first scheduled, formatted as HHMMSS. active_start_time_of_day ist vom Datentyp intund hat den Standardwert 0.active_start_time_of_day is int, with a default of 0.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_end_time_of_day = ] active_end_time_of_day Die Tageszeit, zu der der Replikations-Agent nicht mehr geplant ist. dabei wird das Format HHMMSS verwendet.[ @active_end_time_of_day = ] active_end_time_of_day Is the time of day when the replication agent stops being scheduled, formatted as HHMMSS. active_end_time_of_dayist vom Datentyp intund hat den Standardwert 235959, was bedeutet 11:59:59 Uhr.active_end_time_of_dayis int, with a default of 235959, which means 11:59:59 P.M. gemessen auf einem 24-Stunden-Format.as measured on a 24-hour clock.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_start_date = ] active_start_date Das Datum, an dem der Replikations-Agent zum ersten Mal geplant ist, formatiert als YYYYMMDD.[ @active_start_date = ] active_start_date Is the date when the replication agent is first scheduled, formatted as YYYYMMDD. active_start_date ist vom Datentyp intund hat den Standardwert 0.active_start_date is int, with a default of 0.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_end_date = ] active_end_date Das Datum, an dem der Replikations-Agent nicht mehr geplant ist, formatiert als YYYYMMDD.[ @active_end_date = ] active_end_date Is the date when the replication agent stops being scheduled, formatted as YYYYMMDD. active_end_date ist vom Datentyp intund hat den Standardwert 99991231, was bedeutet, dass der 31. Dezember 9999.active_end_date is int, with a default of 99991231, which means December 31, 9999.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @description = ] 'description' Eine Textbeschreibung des Abonnenten.[ @description = ] 'description' Is a text description of the Subscriber. die Beschreibung ist vom Datentyp nvarchar (255) und hat den Standardwert NULL.description is nvarchar(255), with a default of NULL.

[ @security_mode = ] security_mode Der implementierte Sicherheitsmodus.[ @security_mode = ] security_mode Is the implemented security mode. security_mode ist vom Datentyp intund hat den Standardwert 1.security_mode is int, with a default of 1. 0 gibt die- SQL ServerSQL Server Authentifizierung an.0 specifies SQL ServerSQL Server Authentication. 1 gibt die Windows-Authentifizierung an.1 specifies Windows Authentication.

Hinweis

Dieser Parameter wurde als veraltet markiert und wird aus Gründen der Abwärtskompatibilität von Skripts beibehalten.This parameter has been deprecated and is maintained for backward compatibility of scripts. Die-Eigenschaft wird jetzt auf Abonnement Basis angegeben, wenn sp_addsubscriptionausgeführt wird.The property is now specified on a per-subscription basis when executing sp_addsubscription. Wenn ein Wert angegeben wird, wird er beim Erstellen von Abonnements auf diesem Abonnenten als Standard verwendet, und eine Warnmeldung wird zurückgegeben.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @encrypted_password = ] encrypted_password Dieser Parameter wurde als veraltet markiert und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt, indem encrypted_password auf einen beliebigen Wert festgelegt wird. 0 führt jedoch zu einem Fehler.[ @encrypted_password = ] encrypted_password This parameter has been deprecated and is provided for backward-compatibility only Setting encrypted_password to any value but 0 will result in an error.

[ @publisher = ] 'publisher' Gibt einen nicht-- SQL ServerSQL Server Verleger an.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. Publisher ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.publisher is sysname, with a default of NULL.

Hinweis

der Verleger sollte beim Veröffentlichen von einem Verleger nicht verwendet werden SQL ServerSQL Server .publisher should not be used when publishing from a SQL ServerSQL Server Publisher.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

sp_addsubscriber wird bei der Momentaufnahme-, Transaktions-und Mergereplikation verwendet.sp_addsubscriber is used in snapshot replication, transactional replication, and merge replication.

sp_addsubscriber ist nicht erforderlich, wenn der Abonnent nur anonyme Abonnements für Mergeveröffentlichungen hat.sp_addsubscriber is not required when the Subscriber will only have anonymous subscriptions to merge publications.

sp_addsubscriber in die MSsubscriber_info Tabelle in der Verteilungs Datenbank schreiben.sp_addsubscriber writes to the MSsubscriber_info table in the distribution database.

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin können sp_addsubscriberausführen.Only members of the sysadmin fixed server role can execute sp_addsubscriber.

Weitere InformationenSee Also

Create a Push Subscription Create a Push Subscription
Create a Pull Subscription Create a Pull Subscription
sp_changesubscriber (Transact-SQL-) sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL-) sp_dropsubscriber (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)sp_helpsubscriberinfo (Transact-SQL)