sp_addpullsubscription_agent (Transact-SQL)sp_addpullsubscription_agent (Transact-SQL)

Gilt für: JaSQL Server JaAzure SQL-Datenbank (nur verwaltete Instanz) NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Fügt einer Transaktionsveröffentlichung einen neuen geplanten Agent-Auftrag hinzu, mit dem ein Pullabonnement synchronisiert wird.Adds a new scheduled agent job used to synchronize a pull subscription to a transactional publication. Diese gespeicherte Prozedur wird auf dem Abonnenten für die Abonnement Datenbank ausgeführt.This stored procedure is executed at the Subscriber on the subscription database.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

  
sp_addpullsubscription_agent [ @publisher = ] 'publisher'  
    [ , [ @publisher_db = ] 'publisher_db' ]          , [ @publication = ] 'publication'  
    [ , [ @subscriber = ] 'subscriber' ]  
    [ , [ @subscriber_db = ] 'subscriber_db' ]  
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]  
    [ , [ @subscriber_login = ] 'subscriber_login' ]  
    [ , [ @subscriber_password = ] 'subscriber_password' ]  
    [ , [ @distributor = ] 'distributor' ]  
    [ , [ @distribution_db = ] 'distribution_db' ]  
    [ , [ @distributor_security_mode = ] distributor_security_mode ]  
    [ , [ @distributor_login = ] 'distributor_login' ]  
    [ , [ @distributor_password = ] 'distributor_password' ]  
    [ , [ @optional_command_line = ] 'optional_command_line' ]  
    [ , [ @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 ]  
    [ , [ @distribution_jobid = ] distribution_jobid OUTPUT ]  
    [ , [ @encrypted_distributor_password = ] encrypted_distributor_password ]  
    [ , [ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' ]  
    [ , [ @ftp_address = ] 'ftp_address' ]  
    [ , [ @ftp_port = ] ftp_port ]  
    [ , [ @ftp_login = ] 'ftp_login' ]  
    [ , [ @ftp_password = ] 'ftp_password' ]  
    [ , [ @alt_snapshot_folder = ] 'alternate_snapshot_folder' ]  
    [ , [ @working_directory = ] 'working_directory' ]  
    [ , [ @use_ftp = ] 'use_ftp' ]  
    [ , [ @publication_type = ] publication_type ]  
    [ , [ @dts_package_name = ] 'dts_package_name' ]  
    [ , [ @dts_package_password = ] 'dts_package_password' ]  
    [ , [ @dts_package_location = ] 'dts_package_location' ]  
    [ , [ @reserved = ] 'reserved' ]  
    [ , [ @offloadagent = ] 'remote_agent_activation' ]  
    [ , [ @offloadserver = ] 'remote_agent_server_name']  
    [ , [ @job_name = ] 'job_name' ]  
    [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

ArgumenteArguments

[ @publisher = ] 'publisher'Der Name des Verlegers.[ @publisher = ] 'publisher' Is the name of the Publisher. Publisher ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.publisher is sysname, with no default.

[ @publisher_db = ] 'publisher_db'_Der Name der Verleger Datenbank.[ @publisher_db = ] 'publisher_db'_ Is the name of the Publisher database. publisher_db ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.publisher_db is sysname, with a default value of NULL. publisher_db wird von Oracle-Verlegern ignoriert.publisher_db is ignored by Oracle Publishers.

[ @publication = ] 'publication'Der Name der Veröffentlichung.[ @publication = ] 'publication' Is the name of the publication. Publication ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.publication is sysname, with no default.

[ @subscriber = ] 'subscriber'Der Name der Abonnenten Instanz oder der Name des Verfügbarkeits Gruppen-Listener, wenn sich die Abonnenten Datenbank in einer Verfügbarkeits Gruppe befindet.[ @subscriber = ] 'subscriber' Is the name of the Subscriber instance or the name of the AG listener if the subscriber database is in an availability group. Subscriber ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.subscriber 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.

[ @subscriber_db = ] 'subscriber_db'Der Name der Abonnement Datenbank.[ @subscriber_db = ] 'subscriber_db' Is the name of the subscription database. subscriber_db ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.subscriber_db 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.

[ @subscriber_security_mode = ] subscriber_security_modeDer Sicherheitsmodus, der beim Synchronisieren zum Herstellen einer Verbindung mit einem Abonnenten verwendet wird.[ @subscriber_security_mode = ] subscriber_security_mode Is the security mode to use when connecting to a Subscriber when synchronizing. subscriber_security_mode ist vom Datentyp int und hat den Standardwert NULL.subscriber_security_mode is int, with a default of NULL. 0 gibt SQL ServerSQL Server die-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. Der Verteilungs-Agent stellt eine Verbindung mit dem lokalen Abonnenten immer mithilfe der Windows-Authentifizierung her.The Distribution Agent always connects to the local Subscriber using Windows Authentication. Wenn für diesen Parameter ein anderer Wert als NULL oder 1 angegeben wird, wird eine Warnmeldung zurückgegeben.If a value other than NULL or 1 is specified for this parameter, a warning message is returned.

[ @subscriber_login = ] 'subscriber_login'Der Anmelde Name des Abonnenten, der beim Synchronisieren zum Herstellen einer Verbindung mit einem Abonnenten verwendet wird. subscriber_login ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.[ @subscriber_login = ] 'subscriber_login' Is the Subscriber login to use when connecting to a Subscriber when synchronizing.subscriber_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. Wird für diesen Parameter ein Wert angegeben, wird eine Warnmeldung zurückgegeben, der Wert jedoch ignoriert.If a value is specified for this parameter, a warning message is returned, but the value is ignored.

[ @subscriber_password = ] 'subscriber_password'Das Kennwort des Abonnenten.[ @subscriber_password = ] 'subscriber_password' Is the Subscriber password. subscriber_password ist erforderlich, wenn subscriber_security_mode auf 0festgelegt ist.subscriber_password is required if subscriber_security_mode is set to 0. subscriber_password ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.subscriber_password is sysname, with a default of NULL. Bei Verwendung eines Abonnentenkennworts wird dieses automatisch verschlüsselt.If a subscriber password is used, it is automatically encrypted.

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. Wird für diesen Parameter ein Wert angegeben, wird eine Warnmeldung zurückgegeben, der Wert jedoch ignoriert.If a value is specified for this parameter, a warning message is returned, but the value is ignored.

[ @distributor = ] 'distributor'Der Name des Verteilers.[ @distributor = ] 'distributor' Is the name of the Distributor. Distributor ist vom Datentyp vom Datentyp sysname. der Standardwert ist der vom Verlegerangegebene Wert.distributor is sysname, with a default of the value specified by publisher.

[ @distribution_db = ] 'distribution_db'Der Name der Verteilungs Datenbank.[ @distribution_db = ] 'distribution_db' Is the name of the distribution database. distribution_db ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.distribution_db is sysname, with a default value of NULL.

[ @distributor_security_mode = ] distributor_security_modeDer Sicherheitsmodus, der beim Synchronisieren zum Herstellen einer Verbindung mit einem Verteiler verwendet wird.[ @distributor_security_mode = ] distributor_security_mode Is the security mode to use when connecting to a Distributor when synchronizing. distributor_security_mode ist vom Datentyp intund hat den Standardwert 1.distributor_security_mode is int, with a default of 1. 0 gibt SQL ServerSQL Server die-Authentifizierung an.0 specifies SQL ServerSQL Server Authentication. 1 gibt die Windows-Authentifizierung an.1 specifies Windows Authentication.

Wichtig

Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.When possible, use Windows authentication.

[ @distributor_login = ] 'distributor_login'Der Verteiler Anmelde Name, der beim Synchronisieren zum Herstellen einer Verbindung mit einem Verteiler verwendet wird.[ @distributor_login = ] 'distributor_login' Is the Distributor login to use when connecting to a Distributor when synchronizing. distributor_login ist erforderlich, wenn distributor_security_mode auf 0festgelegt ist.distributor_login is required if distributor_security_mode is set to 0. distributor_login ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.distributor_login is sysname, with a default of NULL.

[ @distributor_password = ] 'distributor_password'Das Verteiler Kennwort.[ @distributor_password = ] 'distributor_password' Is the Distributor password. distributor_password ist erforderlich, wenn distributor_security_mode auf 0festgelegt ist.distributor_password is required if distributor_security_mode is set to 0. distributor_password ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.distributor_password is sysname, 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. Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben.When possible, prompt users to enter security credentials at runtime. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

[ @optional_command_line = ] 'optional_command_line'Ist eine optionale Eingabeaufforderung, die für die Verteilungs-Agent bereitgestellt wird.[ @optional_command_line = ] 'optional_command_line' Is an optional command prompt supplied to the Distribution Agent. Beispiel: -DefinitionFile c:\Distdef.txt oder -CommitBatchSize 10.For example, -DefinitionFile C:\Distdef.txt or -CommitBatchSize 10. optional_command_line ist vom Datentyp nvarchar (4000) . der Standardwert ist eine leere Zeichenfolge.optional_command_line is nvarchar(4000), with a default of empty string.

[ @frequency_type = ] frequency_typeDie Häufigkeit, mit der die Verteilungs-Agent geplant werden soll.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the Distribution Agent. frequency_type ist vom Datentyp intund kann einen der folgenden Werte aufweisen.frequency_type is int, and can be one of the following values.

WertValue DescriptionDescription
11 EinmalOne time
2 (Standardwert)2 (default) BedarfsgesteuertOn demand
44 TäglichDaily
88 Wöchentlicher ZeitplanWeekly
1616 Monatlicher ZeitplanMonthly
3232 Monatlich, relativMonthly relative
6464 AutostartAutostart
128128 WiederholtRecurring

Hinweis

Das Angeben des Werts 64 bewirkt, dass die Verteilungs-Agent im kontinuierlichen Modus ausgeführt wird.Specifying a value of 64 causes the Distribution Agent to run in continuous mode. Dies entspricht dem Festlegen des -Continuous- Parameters für den Agent.This corresponds to setting the -Continuous parameter for the agent. Weitere Informationen finden Sie unter Replication Distribution Agent.For more information, see Replication Distribution Agent.

[ @frequency_interval = ] frequency_intervalDer Wert, der auf die von frequency_typefestgelegte Häufigkeit angewendet werden soll.[ @frequency_interval = ] frequency_interval Is the value to apply 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.

[ @frequency_relative_interval = ] frequency_relative_intervalDas Datum der Verteilungs-Agent.[ @frequency_relative_interval = ] frequency_relative_interval Is the date of the Distribution 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 intund kann einen der folgenden Werte aufweisen.frequency_relative_interval is int, and can be one of the following values.

WertValue BeschreibungDescription
1 (Standard)1 (default) ErsterFirst
22 ZweimalSecond
44 DritterThird
88 VierterFourth
1616 LetzterLast

[ @frequency_recurrence_factor = ] frequency_recurrence_factorDer 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 1.frequency_recurrence_factor is int, with a default of 1.

[ @frequency_subday = ] frequency_subdayGibt 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 intund kann einen der folgenden Werte aufweisen.frequency_subday is int, and can be one of the following values.

WertValue BeschreibungDescription
1 (Standard)1 (default) EinmalOnce
22 ZweimalSecond
44 MinuteMinute
88 HourHour

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

[ @active_start_time_of_day = ] active_start_time_of_dayDie Tageszeit, zu der die Verteilungs-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 Distribution 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.

[ @active_end_time_of_day = ] active_end_time_of_dayDie Tageszeit, zu der die Verteilungs-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 Distribution Agent stops being scheduled, formatted as HHMMSS. active_end_time_of_day ist vom Datentyp intund hat den Standardwert 0.active_end_time_of_day is int, with a default of 0.

[ @active_start_date = ] active_start_dateDas Datum, an dem die Verteilungs-Agent zum ersten Mal geplant ist, formatiert als YYYYMMDD.[ @active_start_date = ] active_start_date Is the date when the Distribution 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.

[ @active_end_date = ] active_end_dateDas Datum, an dem der Verteilungs-Agent nicht mehr geplant ist, formatiert als YYYYMMDD.[ @active_end_date = ] active_end_date Is the date when the Distribution Agent stops being scheduled, formatted as YYYYMMDD. active_end_date ist vom Datentyp intund hat den Standardwert 0.active_end_date is int, with a default of 0.

[ @distribution_jobid = ] _distribution_jobidOUTPUTDie ID der Verteilungs-Agent für diesen Auftrag.[ @distribution_jobid = ] _distribution_jobidOUTPUT Is the ID of the Distribution Agent for this job. distribution_jobid ist vom Typ Binary (16) und hat den Standardwert NULL, und es handelt sich um einen Output-Parameter.distribution_jobid is binary(16), with a default of NULL, and it is an OUTPUT parameter.

[ @encrypted_distributor_password = ] encrypted_distributor_passwordDas Festlegen von encrypted_distributor_password wird nicht mehr unterstützt.[ @encrypted_distributor_password = ] encrypted_distributor_password Setting encrypted_distributor_password is no longer supported. Der Versuch, diesen Bit -Parameter auf 1 festzulegen, führt zu einem Fehler.Attempting to set this bit parameter to 1 will result in an error.

[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr'Gibt an, ob das Abonnement über MicrosoftMicrosoft den Synchronisierungs-Manager synchronisiert werden kann.[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' Is whether the subscription can be synchronized through MicrosoftMicrosoft Synchronization Manager. enabled_for_syncmgr ist vom Datentyp nvarchar (5) und hat den Standardwert false.enabled_for_syncmgr is nvarchar(5), with a default of FALSE. Wenn der Wert falseist, wird das Abonnement nicht bei der Synchronisierungs Verwaltung registriert.If false, the subscription is not registered with Synchronization Manager. Wenn der Wert trueist, wird das Abonnement bei der Synchronisierungs Verwaltung registriert und SQL Server Management StudioSQL Server Management Studiokann synchronisiert werden, ohne zu starten.If true, the subscription is registered with Synchronization Manager and can be synchronized without starting SQL Server Management StudioSQL Server Management Studio.

[ @ftp_address = ] 'ftp_address'Nur aus Gründen der Abwärtskompatibilität.[ @ftp_address = ] 'ftp_address' For backward compatibility only.

[ @ftp_port = ] ftp_portNur aus Gründen der Abwärtskompatibilität.[ @ftp_port = ] ftp_port For backward compatibility only.

[ @ftp_login = ] 'ftp_login'Nur aus Gründen der Abwärtskompatibilität.[ @ftp_login = ] 'ftp_login' For backward compatibility only.

[ @ftp_password = ] 'ftp_password'Nur aus Gründen der Abwärtskompatibilität.[ @ftp_password = ] 'ftp_password' For backward compatibility only.

[ @alt_snapshot_folder = ] 'alternate_snapshot_folder'_Gibt den Speicherort des alternativen Ordners für die Momentaufnahme an.[ @alt_snapshot_folder = ] 'alternate_snapshot_folder'_ Specifies the location of the alternate folder for the snapshot. alternate_snapshot_folder ist vom Datentyp nvarchar (255) und hat den Standardwert NULL.alternate_snapshot_folder is nvarchar(255), with a default of NULL.

[ @working_directory = ] 'working_director'Der Name des Arbeitsverzeichnisses, das zum Speichern von Daten-und Schema Dateien für die Veröffentlichung verwendet wird.[ @working_directory = ] 'working_director' Is the name of the working directory used to store data and schema files for the publication. working_directory ist vom Datentyp nvarchar (255) und hat den Standardwert NULL.working_directory is nvarchar(255), with a default of NULL. Dieser Name sollte im UNC-Format angegeben werden.The name should be specified in UNC format.

[ @use_ftp = ] 'use_ftp'Gibt an, dass FTP anstelle des regulären Protokolls zum Abrufen von Momentaufnahmen verwendet wird.[ @use_ftp = ] 'use_ftp' Specifies the use of FTP instead of the regular protocol to retrieve snapshots. use_ftp ist vom Datentyp nvarchar (5) und hat den Standardwert false.use_ftp is nvarchar(5), with a default of FALSE.

[ @publication_type = ] publication_typeGibt den Replikationstyp der Veröffentlichung an.[ @publication_type = ] publication_type Specifies the replication type of the publication. publication_type ist vom Datentyp tinyint . der Standardwert ist 0.publication_type is a tinyint with a default of 0. Wenn der Wert 0ist, ist die Veröffentlichung ein Transaktionstyp.If 0, publication is a transaction type. Bei 1handelt es sich bei der Veröffentlichung um einen momentaufnahmetypIf 1, publication is a snapshot type. Wenn der Wert 2ist, ist die Veröffentlichung ein mergetyp.If 2, publication is a merge type.

[ @dts_package_name = ] 'dts_package_name'Gibt den Namen des DTS-Pakets an.[ @dts_package_name = ] 'dts_package_name' Specifies the name of the DTS package. dts_package_name ist vom Datentyp vom Datentyp sysname und hat den Standardwert NULL.dts_package_name is a sysname with a default of NULL. Zum Angeben eines Pakets mit dem Namen DTSPub_Package wird beispielsweise der @dts_package_name = N'DTSPub_Package'-Parameter verwendet.For example, to specify a package of DTSPub_Package, the parameter would be @dts_package_name = N'DTSPub_Package'.

[ @dts_package_password = ] 'dts_package_password'Gibt ggf. das Kennwort für das Paket an.[ @dts_package_password = ] 'dts_package_password' Specifies the password on the package, if there is one. dts_package_password ist vom Datentyp vom Datentyp sysname und hat den Standardwert NULL. Dies bedeutet, dass kein Kennwort für das Paket gilt.dts_package_password is sysname with a default of NULL, which means a password is not on the package.

Hinweis

Sie müssen ein Kennwort angeben, wenn dts_package_name angegeben wird.You must specify a password if dts_package_name is specified.

[ @dts_package_location = ] 'dts_package_location'Gibt den Speicherort des Pakets an.[ @dts_package_location = ] 'dts_package_location' Specifies the package location. dts_package_location ist vom Datentyp nvarchar (12) und hat den Standardwert Subscriber.dts_package_location is a nvarchar(12), with a default of subscriber. Der Speicherort des Pakets kann Distributor oder Subscribersein.The location of the package can be distributor or subscriber.

[ @reserved = ] 'reserved' Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Zukünftige Kompatibilität wird nicht sichergestellt.Future compatibility is not guaranteed.[ @reserved = ] 'reserved' Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Zukünftige Kompatibilität wird nicht sichergestellt.Future compatibility is not guaranteed.

[ @offloadagent = ] 'remote_agent_activation'

Hinweis

Die Aktivierung des Remote-Agents wurde als veraltet markiert und wird nicht mehr unterstützt.Remote agent activation has been deprecated and is no longer supported. Dieser Parameter wird nur zur Aufrechterhaltung der Abwärtskompatibilität von Skripts unterstützt.This parameter is supported only to maintain backward compatibility of scripts. Wenn Sie remote_agent_activation auf einen anderen Wert als false festlegen, wird ein Fehler generiert.Setting remote_agent_activation to a value other than false will generate an error.

[ @offloadserver = ] 'remote_agent_server_name'

Hinweis

Die Aktivierung des Remote-Agents wurde als veraltet markiert und wird nicht mehr unterstützt.Remote agent activation has been deprecated and is no longer supported. Dieser Parameter wird nur zur Aufrechterhaltung der Abwärtskompatibilität von Skripts unterstützt.This parameter is supported only to maintain backward compatibility of scripts. Wenn remote_agent_server_name auf einen anderen Wert als NULL festgelegt wird, wird ein Fehler generiert.Setting remote_agent_server_name to any non-NULL value will generate an error.

[ @job_name = ] 'job_name'Der Name eines vorhandenen Agentauftrags.[ @job_name = ] 'job_name' Is the name of an existing agent job. job_name ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.job_name is sysname, with a default value of NULL. Dieser Parameter wird nur angegeben, wenn das Abonnement mithilfe eines vorhandenen Auftrags statt mit einem neu erstellten Auftrag (Standard) synchronisiert wird.This parameter is only specified when the subscription will be synchronized using an existing job instead of a newly created job (the default). Wenn Sie kein Mitglied der festen Server Rolle sysadmin sind, müssen Sie job_login und job_password angeben, wenn Sie job_nameangeben.If you are not a member of the sysadmin fixed server role, you must specify job_login and job_password when you specify job_name.

[ @job_login = ] 'job_login'Der Anmelde Name für das Windows-Konto, unter dem der Agent ausgeführt wird.[ @job_login = ] 'job_login' Is the login for the Windows account under which the agent runs. job_login ist vom Datentyp nvarchar (257) und hat keinen Standardwert.job_login is nvarchar(257), with no default. Dieses Windows-Konto wird immer für Agent-Verbindungen mit dem Abonnenten verwendet.This Windows account is always used for agent connections to the Subscriber.

[ @job_password = ] 'job_password'Das Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird.[ @job_password = ] 'job_password' Is the password for the Windows account under which the agent runs. job_password ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.job_password is sysname, with no default.

Wichtig

Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben.When possible, prompt users to enter security credentials at runtime. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

RückgabecodewerteReturn Code Values

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

HinweiseRemarks

sp_addpullsubscription_agent wird bei der Momentaufnahme-und Transaktions Replikation verwendet.sp_addpullsubscription_agent is used in snapshot replication and transactional replication.

BeispielExample

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- Execute this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2012';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2012Replica]
EXEC sp_addpullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

-- Add an agent job to synchronize the pull subscription.
EXEC sp_addpullsubscription_agent 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication, 
  @distributor = @publisher, 
  @job_login = $(Login), 
  @job_password = $(Password);
GO

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin oder der festen Daten Bank Rolle db_owner können sp_addpullsubscription_agentausführen.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_addpullsubscription_agent.

Siehe auchSee Also

Erstellen eines Pullabonnements Create a Pull Subscription
Abonnieren von Veröffentlichungen Subscribe to Publications
sp_addpullsubscription (Transact-SQL) sp_addpullsubscription (Transact-SQL)
sp_change_subscription_properties (Transact-SQL) sp_change_subscription_properties (Transact-SQL)
sp_droppullsubscription (Transact-SQL) sp_droppullsubscription (Transact-SQL)
sp_helppullsubscription ((Transact-SQL)) sp_helppullsubscription (Transact-SQL)
sp_helpsubscription_properties (Transact-SQL)sp_helpsubscription_properties (Transact-SQL)