sp_addmergepullsubscription_agent (Transact-SQL)sp_addmergepullsubscription_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 einen neuen Agentauftrag für die geplante Synchronisierung eines Pullabonnements mit einer Mergeveröffentlichung hinzu.Adds a new agent job used to schedule synchronization of a pull subscription to a merge 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_addmergepullsubscription_agent [ [ @name = ] 'name' ]   
        , [ @publisher = ] 'publisher'   
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication =] 'publication'   
    [ , [ @publisher_security_mod e= ] publisher_security_mode ]   
    [ , [ @publisher_login = ] 'publisher_login' ]   
    [ , [ @publisher_password = ] 'publisher_password' ]   
    [ , [ @publisher_encrypted_password = ] publisher_encrypted_password ]   
    [ , [ @subscriber = ] 'subscriber' ]   
    [ , [ @subscriber_db = ] 'subscriber_db' ]   
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]   
    [ , [ @subscriber_login = ] 'subscriber_login' ]   
    [ , [ @subscriber_password= ] 'subscriber_password' ]   
    [ , [ @distributor = ] 'distributor' ]   
    [ , [ @distributor_security_mode = ] distributor_security_mode ]   
    [ , [ @distributor_login = ] 'distributor_login' ]   
    [ , [ @distributor_password = ] 'distributor_password' ]   
    [ , [ @encrypted_password = ] encrypted_password ]   
    [ , [ @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 ]   
    [ , [ @optional_command_line = ] 'optional_command_line' ]   
    [ , [ @merge_jobid = ] merge_jobid ]   
    [ , [ @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' ]   
    [ , [ @reserved = ] 'reserved' ]   
    [ , [ @use_interactive_resolver = ] 'use_interactive_resolver' ]   
    [ , [ @offloadagent = ] 'remote_agent_activation' ]   
    [ , [ @offloadserver = ] 'remote_agent_server_name']   
    [ , [ @job_name = ] 'job_name' ]   
    [ , [ @dynamic_snapshot_location = ] 'dynamic_snapshot_location' ]  
    [ , [ @use_web_sync = ] use_web_sync ]  
        [ , [ @internet_url = ] 'internet_url' ]  
    [ , [ @internet_login = ] 'internet_login' ]  
        [ , [ @internet_password = ] 'internet_password' ]  
    [ , [ @internet_security_mode = ] internet_security_mode ]  
        [ , [ @internet_timeout = ] internet_timeout ]  
    [ , [ @hostname = ] 'hostname' ]  
        [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

ArgumenteArguments

[ @name = ] 'name'Der Name des Agents.[ @name = ] 'name' Is the name of the agent. name ist vom Datentyp sysnameund hat den Standardwert NULL.name is sysname, with a default of NULL.

[ @publisher = ] 'publisher'Der Name des Verleger Servers.[ @publisher = ] 'publisher' Is the name of the Publisher server. 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 keinen Standardwert.publisher_db is sysname, with no default.

[ @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.

[ @publisher_security_mode = ] publisher_security_modeDer Sicherheitsmodus, der beim Synchronisieren zum Herstellen einer Verbindung mit einem Verleger verwendet wird.[ @publisher_security_mode = ] publisher_security_mode Is the security mode to use when connecting to a Publisher when synchronizing. publisher_security_mode ist vom Datentyp intund hat den Standardwert 1.publisher_security_mode is int, with a default of 1. Bei 0wird die SQL ServerSQL Server -Authentifizierung angegeben.If 0, specifies SQL ServerSQL Server Authentication. Wenn der 1ist, wird die Windows-Authentifizierung angegeben.If 1, specifies Windows Authentication.

Wichtig

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

[ @publisher_login = ] 'publisher_login'Der Anmelde Name, der beim Synchronisieren zum Herstellen einer Verbindung mit einem Verleger verwendet wird.[ @publisher_login = ] 'publisher_login' Is the login to use when connecting to a Publisher when synchronizing. publisher_login ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.publisher_login is sysname, with a default of NULL.

[ @publisher_password = ] 'publisher_password'Das Kennwort, das beim Herstellen einer Verbindung mit dem Verleger verwendet wird.[ @publisher_password = ] 'publisher_password' Is the password used when connecting to the Publisher. publisher_password ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.publisher_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, Sicherheitsanmeldeinformationen 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.

[ @publisher_encrypted_password = ]publisher_encrypted_passwordDas Festlegen von publisher_encrypted_password wird nicht mehr unterstützt.[ @publisher_encrypted_password = ]publisher_encrypted_password Setting publisher_encrypted_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.

[ @subscriber = ] 'subscriber'Der Name des Abonnenten.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. Subscriber ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.subscriber is sysname, with a default of NULL.

[ @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.

[ @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 intund hat den Standardwert 1.subscriber_security_mode is int, with a default of 1. Bei 0wird die SQL ServerSQL Server -Authentifizierung angegeben.If 0, specifies SQL ServerSQL Server Authentication. Wenn der 1ist, wird die Windows-Authentifizierung angegeben.If 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 Merge-Agent verwendet für die Herstellung einer Verbindung mit dem lokalen Abonnenten stets die Windows-Authentifizierung.The Merge Agent always connects to the local Subscriber using Windows Authentication. Falls für diesen Parameter ein Wert angegeben wird, wird zwar eine Warnmeldung zurückgegeben, doch der Wert selbst wird ignoriert.If a value is specified for this parameter, a warning message will be returned, but the value will be ignored.

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

[ @subscriber_password = ] 'subscriber_password'Das Kennwort des Abonnenten SQL ServerSQL Server für die Authentifizierung.[ @subscriber_password = ] 'subscriber_password' Is the Subscriber password for SQL ServerSQL Server Authentication. 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.

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. Falls für diesen Parameter ein Wert angegeben wird, wird zwar eine Warnmeldung zurückgegeben, doch der Wert selbst wird ignoriert.If a value is specified for this parameter, a warning message will be returned, but the value will be 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 Publisher. Das heißt, der Verleger ist auch der Verteiler.distributor is sysname, with a default of publisher; that is, the Publisher is also the Distributor.

[ @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 0.distributor_security_mode is int, with a default of 0. 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, Sicherheitsanmeldeinformationen 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.

[ @encrypted_password = ] encrypted_passwordDas Festlegen von encrypted_password wird nicht mehr unterstützt.[ @encrypted_password = ] encrypted_password Setting encrypted_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.

[ @frequency_type = ] frequency_typeDie Häufigkeit, mit der die Merge-Agent geplant werden soll.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the Merge 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
22 BedarfsgesteuertOn demand
44 TäglichDaily
88 Wöchentlicher ZeitplanWeekly
1616 Monatlicher ZeitplanMonthly
3232 Monatlich, relativMonthly relative
6464 AutostartAutostart
128128 WiederholtRecurring
NULL (Standard)NULL (default)

Hinweis

Das Angeben des Werts 64 bewirkt, dass die Merge-Agent im kontinuierlichen Modus ausgeführt wird.Specifying a value of 64 causes the Merge 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 Merge Agent.For more information, see Replication Merge Agent.

[ @frequency_interval = ] frequency_intervalDer Tag oder die Tage, an denen die Merge-Agent ausgeführt wird.[ @frequency_interval = ] frequency_interval The day or days that the Merge Agent runs. frequency_interval ist vom Datentyp intund kann einen der folgenden Werte aufweisen.frequency_interval is int, and can be one of these values.

WertValue DescriptionDescription
11 SonntagSunday
22 MontagMonday
33 DienstagTuesday
44 MittwochWednesday
55 DonnerstagThursday
66 FreitagFriday
77 SamstagSaturday
88 DayDay
99 TageWeekdays
1010 WochenendtageWeekend days
NULL (Standard)NULL (default)

[ @frequency_relative_interval = ] frequency_relative_intervalDas Datum der Merge-Agent.[ @frequency_relative_interval = ] frequency_relative_interval Is the date of the Merge 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 these values.

WertValue DescriptionDescription
11 ErsterFirst
22 ZweimalSecond
44 DritterThird
88 VierterFourth
1616 LetzterLast
NULL (Standard)NULL (default)

[ @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 NULL.frequency_recurrence_factor is int, with a default of NULL.

[ @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 these values.

WertValue DescriptionDescription
11 EinmalOnce
22 ZweimalSecond
44 MinuteMinute
88 HourHour
NULL (Standard)NULL (default)

[ @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 NULL.frequency_subday_interval is int, with a default of NULL.

[ @active_start_time_of_day = ] active_start_time_of_dayDie Tageszeit, zu der die Merge-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 Merge Agent is first scheduled, formatted as HHMMSS. active_start_time_of_day ist vom Datentyp intund hat den Standardwert NULL.active_start_time_of_day is int, with a default of NULL.

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

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

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

[ @optional_command_line = ] 'optional_command_line'Ist eine optionale Eingabeaufforderung, die für die Merge-Agent bereitgestellt wird.[ @optional_command_line = ] 'optional_command_line' Is an optional command prompt that is supplied to the Merge Agent. optional_command_line ist vom Datentyp nvarchar (255) . der Standardwert ist "".optional_command_line is nvarchar(255), with a default of ' '. Kann zur Bereitstellung zusätzlicher Parameter für den Merge-Agent verwendet werden, wie im folgenden Beispiel gezeigt wird, bei dem das Standardtimeout für Abfragen auf 600 Sekunden erhöht wird:Can be used to supply additional parameters to the Merge Agent, such as in the following example that increases the default query time-out to 600 seconds:

@optional_command_line = N'-QueryTimeOut 600'  

[ @merge_jobid = ] merge_jobidDer Output-Parameter für die Auftrags-ID.[ @merge_jobid = ] merge_jobid Is the output parameter for the job ID. merge_jobid ist vom Typ Binary (16) und hat den Standardwert NULL.merge_jobid is binary(16), with a default of NULL.

[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr'Gibt an, ob das Abonnement über die Synchronisierungs Verwaltung von Windows synchronisiert werden kann.[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' Specifies if the subscription can be synchronized through Windows 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 an, von dem die Momentaufnahme Dateien abgerufen werden sollen.[ @alt_snapshot_folder = ] 'alternate_snapshot_folder' Specifies the location from which to pick up the snapshot files. alternate_snapshot_folder ist vom Datentyp nvarchar (255) und hat den Standardwert NULL.alternate_snapshot_folder is nvarchar(255), with a default of NULL. Wenn dieser Wert NULL ist, werden die Momentaufnahmedateien aus dem vom Verleger angegebenen Standardspeicherort abgeholt.If NULL, the snapshot files will be picked up from the default location specified by the Publisher.

[ @working_directory = ] 'working_directory'Der Name des Arbeitsverzeichnisses, das zum vorübergehenden Speichern von Daten-und Schema Dateien für die Veröffentlichung verwendet wird, wenn FTP zum Übertragen von Momentaufnahme Dateien verwendet wird.[ @working_directory = ] 'working_directory' Is the name of the working directory used to temporarily store data and schema files for the publication when FTP is used to transfer snapshot files. working_directory ist vom Datentyp nvarchar (255) und hat den Standardwert NULL.working_directory is nvarchar(255), with a default of NULL.

[ @use_ftp = ] 'use_ftp'Gibt an, dass FTP anstelle des üblichen Protokolls zum Abrufen von Momentaufnahmen verwendet wird.[ @use_ftp = ] 'use_ftp' Specifies the use of FTP instead of the typical 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.

[ @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.

[ @use_interactive_resolver = ] 'use_interactive_resolver' ]Verwendet den interaktiven Konflikt Löser, um Konflikte für alle Artikel aufzulösen, die eine interaktive Auflösung ermöglichen.[ @use_interactive_resolver = ] 'use_interactive_resolver' ] Uses interactive resolver to resolve conflicts for all articles that allow interactive resolution. use_interactive_resolver ist vom Datentyp nvarchar (5) und hat den Standardwert false.use_interactive_resolver is nvarchar(5), with a default of FALSE.

[ @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.

[ @dynamic_snapshot_location = ] 'dynamic_snapshot_location' ]Der Pfad zu dem Ordner, aus dem die Momentaufnahme Dateien gelesen werden, wenn eine gefilterte Daten Momentaufnahme verwendet werden soll.[ @dynamic_snapshot_location = ] 'dynamic_snapshot_location' ] The path to the folder where the snapshot files will be read from if a filtered data snapshot is to be used. dynamic_snapshot_location ist vom Datentyp nvarchar (260) und hat den Standardwert NULL.dynamic_snapshot_location is nvarchar(260), with a default of NULL. Weitere Informationen zu parametrisierten Zeilenfiltern finden Sie unter Parametrisierte Zeilenfilter.For more information, see Parameterized Row Filters.

[ @use_web_sync = ] use_web_syncGibt an, dass die Websynchronisierung aktiviert ist.[ @use_web_sync = ] use_web_sync Indicates that Web synchronization is enabled. use_web_sync ist vom Typ Bit. der Standardwert ist 0.use_web_sync is bit, with a default of 0. 1 gibt an, dass das Pullabonnement mithilfe von http über das Internet synchronisiert werden kann.1 specifies that the pull subscription can be synchronized over the internet using HTTP.

[ @internet_url = ] 'internet_url'Der Speicherort des Replikations-Listener (replisapi). DLL) für die Websynchronisierung.[ @internet_url = ] 'internet_url' Is the location of the replication listener (REPLISAPI.DLL) for Web synchronization. internet_url ist vom Datentyp nvarchar (260) und hat den Standardwert NULL.internet_url is nvarchar(260), with a default of NULL. internet_url ist eine voll qualifizierte URL im Format http://server.domain.com/directory/replisapi.dll.internet_url is a fully qualified URL, in the format http://server.domain.com/directory/replisapi.dll. Wenn der Server so konfiguriert ist, dass er einen anderen Port als Port 80 überwacht, muss auch die Portnummer im Format http://server.domain.com:portnumber/directory/replisapi.dll angegeben werden, wobei portnumber den Port darstellt.If the server is configured to listen on a port other than port 80, the port number must also be supplied in the format http://server.domain.com:portnumber/directory/replisapi.dll, where portnumber represents the port.

[ @internet_login = ] 'internet_login'Der Anmelde Name, den der Merge-Agent verwendet, wenn eine Verbindung mit dem Webserver hergestellt wird, der die Websynchronisierung mithilfe der http-Standard Authentifizierung verwendet.[ @internet_login = ] 'internet_login' Is the login that the Merge Agent uses when connecting to the Web server that is hosting Web synchronization using HTTP Basic Authentication. internet_login ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.internet_login is sysname, with a default of NULL.

[ @internet_password = ] 'internet_password'Das Kennwort, das der Merge-Agent verwendet, wenn eine Verbindung mit dem Webserver hergestellt wird, der die Websynchronisierung mithilfe der http-Standard Authentifizierung verwendet.[ @internet_password = ] 'internet_password' Is the password that the Merge Agent uses when connecting to the Web server that is hosting Web synchronization using HTTP Basic Authentication. internet_password ist vom Datentyp nvarchar (524) und hat den Standardwert NULL.internet_password is nvarchar(524), with a default value of NULL.

Wichtig

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

[ @internet_security_mode = ] internet_security_modeDie beim Herstellen einer Verbindung mit dem Webserver während der Websynchronisierung mithilfe Merge-Agent von HTTPS verwendete Authentifizierungsmethode.[ @internet_security_mode = ] internet_security_mode Is the authentication method used by the Merge Agent when connecting to the Web server during Web synchronization using HTTPS. internet_security_mode ist vom Datentyp int und kann einen der folgenden Werte aufweisen.internet_security_mode is int and can be one of these values.

WertValue DescriptionDescription
00 Die Standardauthentifizierung wird verwendet.Basic Authentication is used.
1 (Standard)1 (default) Die integrierte Windows-Authentifizierung wird verwendet.Windows Integrated Authentication is used.

Hinweis

Wir empfehlen, bei der Websynchronisierung die Standardauthentifizierung zu verwenden.We recommend using Basic Authentication with Web synchronization. Für die Websynchronisierung müssen Sie eine SSL-Verbindung mit dem Webserver herstellen.To use Web synchronization, you must make an SSL connection to the Web server. Weitere Informationen finden Sie unter Configure Web Synchronization.For more information, see Configure Web Synchronization.

[ @internet_timeout = ] internet_timeoutDie Zeitdauer in Sekunden, bevor eine Websynchronisierungs Anforderung abläuft.[ @internet_timeout = ] internet_timeout Is the length of time, in seconds, before a Web synchronization request expires. internet_timeout ist vom Datentyp intund hat den Standardwert 300 Sekunden.internet_timeout is int, with a default of 300 seconds.

[ @hostname = ] 'hostname'Überschreibt den Wert von HOST_NAME (), wenn diese Funktion in der WHERE-Klausel eines parametrisierten Filters verwendet wird.[ @hostname = ] 'hostname' Overrides the value of HOST_NAME() when this function is used in the WHERE clause of a parameterized filter. der Hostname ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.hostname is sysname, with a default of NULL.

[ @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. Für Agentverbindungen mit dem Abonnenten sowie für Verbindungen mit dem Verteiler und Verleger über die integrierte Windows-Authentifizierung wird stets dieses Windows-Konto verwendet.This Windows account is always used for agent connections to the Subscriber and for connections to the Distributor and Publisher when using Windows Integrated authentication.

[ @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

Speichern Sie keine Authentifizierungsinformationen in Skriptdateien.Do not store authentication information in script files. Für die optimale Sicherheit sollten Anmeldenamen und Kennwörter zur Laufzeit bereitgestellt werden.For best security, login names and passwords should be supplied at runtime.

RückgabecodewerteReturn Code Values

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

HinweiseRemarks

sp_addmergepullsubscription_agent wird bei der Mergereplikation verwendet und verwendet ähnliche Funktionen wie sp_addpullsubscription_agent.sp_addmergepullsubscription_agent is used in merge replication and uses functionality similar to sp_addpullsubscription_agent.

Ein Beispiel für die Sicherheitseinstellungen ordnungsgemäß angeben, für die Ausführung Sp_addmergepullsubscription_agent, finden Sie unter Erstellen eines Pullabonnements.For an example of how to correctly specify security settings when executing sp_addmergepullsubscription_agent, see Create a Pull Subscription.

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;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2012';
SET @hostname = N'adventure-works\david8';

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

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

BerechtigungenPermissions

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

Siehe auchSee Also

Erstellen eines Pullabonnements Create a Pull Subscription
Abonnieren von Veröffentlichungen Subscribe to Publications
sp_addmergepullsubscription (Transact-SQL) sp_addmergepullsubscription (Transact-SQL)
sp_changemergepullsubscription (Transact-SQL) sp_changemergepullsubscription (Transact-SQL)
sp_dropmergepullsubscription (Transact-SQL) sp_dropmergepullsubscription (Transact-SQL)
sp_helpmergepullsubscription ((Transact-SQL)) sp_helpmergepullsubscription (Transact-SQL)
sp_helpsubscription_properties (Transact-SQL)sp_helpsubscription_properties (Transact-SQL)