sp_addmergepullsubscription_agent (Transact-SQL)
Dodaje nowe zadanie Agenta używanych do planowania synchronizacji subskrypcja ściąganej do publikacja korespondencji seryjnej.Ta procedura przechowywana jest wykonywany przez subskrybent do baza danych subskrypcja.
.gif "Topic link icon")
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' ]
Argumenty
[ @name = ] 'name'
Is the name of the agent.name is sysname, with a default of NULL.[ @publisher = ] 'publisher'
Is the name of the Publisher server.publisher is sysname, with no default.[ @publisher_db = ] 'publisher_db'
Is the name of the Publisher database.publisher_db is sysname, with no default.[ @publication = ] 'publication'
Is the name of the publication.publication is sysname, with no default.[ @publisher_security_mode = ] publisher_security_mode
Is the security mode to use when connecting to a Publisher when synchronizing.publisher_security_mode is int, with a default of 1.Jeśli 0Określa, ,SQL Server Uwierzytelnianie. Jeśli 1, określa uwierzytelnianie systemu Windows..gif "Security note")
Security Note:When possible, use Windows Authentication.
[ @publisher_login = ] 'publisher_login'
Is the login to use when connecting to a Publisher when synchronizing.publisher_login is sysname, with a default of NULL.[ @publisher_password = ] 'publisher_password'
Is the password used when connecting to the Publisher.publisher_password is sysname, with a default of NULL.Security Note:Do not use a blank password. Use a strong password. Jeśli jest to możliwe, monituje użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby uniemożliwić nieautoryzowany dostęp.
[ @publisher_encrypted_password = ]publisher_encrypted_password
Ustawienie publisher_encrypted_password nie jest już obsługiwany. Podjęto próbę zestaw to bit Parametr 1 spowoduje błąd.[ @subscriber = ] 'subscriber'
Is the name of the Subscriber.subscriber is sysname, with a default of NULL.[ @subscriber_db = ] 'subscriber_db'
Is the name of the subscription database.subscriber_db is sysname, with a default of NULL.[ @subscriber_security_mode = ] subscriber_security_mode
Is the security mode to use when connecting to a Subscriber when synchronizing.subscriber_security_mode is int, with a default of 1.Jeśli 0Określa, ,SQL Server Uwierzytelnianie. Jeśli 1, określa uwierzytelnianie systemu Windows.Uwaga
Tego parametru została zastąpiona i jest utrzymywana w celu zapewnienia zgodności z poprzednimi wersjami skryptów.Agent korespondencji seryjnej zawsze łączy się z lokalnym subskrybent przy użyciu uwierzytelnianie systemu Windows.Jeżeli określono wartość tego parametru, zostanie zwrócony komunikat ostrzegawczy, ale wartości zostaną zignorowane.
[ @subscriber_login = ] 'subscriber_login'
Is the Subscriber login to use when connecting to a Subscriber when synchronizing.subscriber_login is required if subscriber_security_mode is set to 0.subscriber_login is sysname, with a default of NULL.Uwaga
Tego parametru została zastąpiona i jest utrzymywana w celu zapewnienia zgodności z poprzednimi wersjami skryptów.Jeżeli określono wartość tego parametru, zostanie zwrócony komunikat ostrzegawczy, ale wartości zostaną zignorowane.
[ @subscriber_password = ] 'subscriber_password'
Is the Subscriber password for SQL Server Authentication.subscriber_password is required if subscriber_security_mode is set to 0.subscriber_password is sysname, with a default of NULL.Uwaga
Tego parametru została zastąpiona i jest utrzymywana w celu zapewnienia zgodności z poprzednimi wersjami skryptów.Jeżeli określono wartość tego parametru, zostanie zwrócony komunikat ostrzegawczy, ale wartości zostaną zignorowane.
[ @distributor = ] 'distributor'
Is the name of the Distributor.distributor is sysname, with a default of publisher; that is, the Publisher is also the Distributor.[ @distributor_security_mode = ] distributor_security_mode
Is the security mode to use when connecting to a Distributor when synchronizing.distributor_security_mode is int, with a default of 0.0 Określa, SQL Server Uwierzytelnianie. 1 Określa uwierzytelnianie systemu Windows.Security Note:When possible, use Windows Authentication.
[ @distributor_login = ] 'distributor_login'
Is the Distributor login to use when connecting to a Distributor when synchronizing.distributor_login is required if distributor_security_mode is set to 0.distributor_login is sysname, with a default of NULL.[ @distributor_password = ] 'distributor_password'
Is the Distributor password.distributor_password is required if distributor_security_mode is set to 0.distributor_password is sysname, with a default of NULL.Security Note:Do not use a blank password. Use a strong password. Jeśli jest to możliwe, monituje użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby uniemożliwić nieautoryzowany dostęp.
[ @encrypted_password = ] encrypted_password
Ustawienie encrypted_password nie jest już obsługiwany. Podjęto próbę zestaw to bit Parametr 1 spowoduje błąd.[ @frequency_type = ] frequency_type
Is the frequency with which to schedule the Merge Agent.frequency_type is int, and can be one of the following values.Wartość
Description
1
Jeden raz
2
Na żądanie
4
Dzienne
8
Co tydzień
16
Miesięczne
32
Względna miesięczne
64
Autostart
128
Cykliczne
NULL(default)
Uwaga
Określanie wartości 64 powoduje, że Agent korespondencji seryjnej do pracy w trybie ciągłym.Odpowiada to ustawieniu -Ciągłe parametr dla agenta.Aby uzyskać więcej informacji zobacz Agent replikacja w korespondencji seryjnej.
[ @frequency_interval = ] frequency_interval
The day or days that the Merge Agent runs.frequency_interval is int, and can be one of these values.Wartość
Description
1
Niedziela
2
Poniedziałek
3
Wtorek
4
Środa
5
Czwartek
6
Piątek
7
Sobota
8
Dzień
9
Dni tygodnia
10
Dni weekendowe
NULL(default)
[ @frequency_relative_interval = ] frequency_relative_interval
Jest to data Agent korespondencji seryjnej.This parameter is used when frequency_type is set to 32 (monthly relative).frequency_relative_interval is int, and can be one of these values.Wartość
Description
1
First
2
Sekundy
4
Trzecia
8
Czwarty
16
Last
NULL(default)
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Is the recurrence factor used by frequency_type.frequency_recurrence_factor is int, with a default of NULL.[ @frequency_subday = ] frequency_subday
Is how often to reschedule during the defined period.frequency_subday is int, and can be one of these values.Wartość
Description
1
Tylko raz
2
Sekundy
4
Minuta
8
Godziny
NULL(default)
[ @frequency_subday_interval = ] frequency_subday_interval
Is the interval for frequency_subday.frequency_subday_interval is int, with a default of NULL.[ @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 is int, with a default of NULL.[ @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 is int, with a default of NULL.[ @active_start_date = ] active_start_date
Is the date when the Merge Agent is first scheduled, formatted as YYYYMMDD.active_start_date is int, with a default of NULL.[ @active_end_date = ] active_end_date
Is the date when the Merge Agent stops being scheduled, formatted as YYYYMMDD.active_end_date is int, with a default of NULL.[ @optional_command_line = ] 'optional_command_line'
Is an optional command prompt that is supplied to the Merge Agent.optional_command_line is nvarchar(255), with a default of ' '.Można podać dodatkowe parametry do agenta korespondencji seryjnej, takie jak w poniższym przykładzie, zwiększającą się domyślny limit czasu kwerendy do 600 czas (w sekundach):@optional_command_line = N'-QueryTimeOut 600'[ @merge_jobid = ] merge_jobid
Is the output parameter for the job ID.merge_jobid is binary(16), with a default of NULL.[ @enabled_for_syncmgr = ] 'enabled_for_syncmgr'
Specifies if the subscription can be synchronized through Windows Synchronization Manager.enabled_for_syncmgr is nvarchar(5), with a default of FALSE.Jeśli false, subskrypcja nie został zarejestrowany z menedżer synchronizacji. Jeśli true, subskrypcja jest zarejestrowany z menedżer synchronizacji i mogą być synchronizowane bez konieczności uruchamiania SQL Server Management Studio.[ @ftp_address = ] 'ftp_address'
Tylko zgodność z poprzednimi wersjami.[ @ftp_port = ] ftp_port
Tylko zgodność z poprzednimi wersjami.[ @ftp_login = ] 'ftp_login'
Tylko zgodność z poprzednimi wersjami.[ @ftp_password = ] 'ftp_password'
Tylko zgodność z poprzednimi wersjami.[ @alt_snapshot_folder = ] 'alternate_snapshot_folder'
Specifies the location from which to pick up the snapshot files.alternate_snapshot_folder is nvarchar(255), with a default of NULL.Jeśli wartością tą jest NULL, będzie pobierane pliki migawka znajdujących się w lokalizacji domyślnej, określonej przez wydawcę.[ @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 is nvarchar(255), with a default of NULL.[ @use_ftp = ] 'use_ftp'
Specifies the use of FTP instead of the typical protocol to retrieve snapshots.use_ftp is nvarchar(5), with a default of FALSE.[ @reserved = ] 'reserved'
Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.[ @use_interactive_resolver = ] 'use_interactive_resolver' ]
Uses interactive resolver to resolve conflicts for all articles that allow interactive resolution.use_interactive_resolver is nvarchar(5), with a default of FALSE.[ @offloadagent = ] 'remote_agent_activation'
Uwaga
Aktywacja agenta zdalnego została zastąpiona i nie jest już obsługiwany.Ten parametr jest obsługiwany tylko w celu zachowania zgodności ze starszymi wersjami skryptów.Ustawienie remote_agent_activation wartość inną niż false spowoduje wystąpienie błędu.
[ @offloadserver = ] 'remote_agent_server_name'
Uwaga
Aktywacja agenta zdalnego została zastąpiona i nie jest już obsługiwany.Ten parametr jest obsługiwany tylko w celu zachowania zgodności ze starszymi wersjami skryptów.Ustawienie remote_agent_server_name do każdej wartości NULL nie spowoduje wystąpienie błędu.
[ @job_name = ] 'job_name' ]
Is the name of an existing agent job.job_name is sysname, with a default value of NULL.Ten parametr jest określony tylko wtedy, gdy subskrypcja zostaną zsynchronizowane przy użyciu istniejącego zadanie, a nie do nowo utworzonego zadanie (ustawienie domyślne).Jeśli nie jesteś członkiem sysadmin roli serwera stałe, należy określić job_login i job_password Po określeniu job_name.[ @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 is nvarchar(260), with a default of NULL.Aby uzyskać więcej informacji zobacz Sparametryzowana filtry wierszy.[ @use_web_sync = ] use_web_sync
Indicates that Web synchronization is enabled.use_web_sync is bit, with a default of 0.1 Określa, że subskrypcja ściąganej mogą być synchronizowane przez internet przy użyciu protokołu HTTP.[ @internet_url = ] 'internet_url'
Is the location of the replication listener (REPLISAPI.DLL) for Web synchronization.internet_url is nvarchar(260), with a default of NULL.internet_url is a fully qualified URL, in the format http://server.domain.com/directory/replisapi.dll.Jeśli serwer jest skonfigurowany do nasłuchu na porcie innego niż port 80, numer portu musi być dostarczone w formacie http://server.domain.com:portnumber/directory/replisapi.dll, gdzie portnumber reprezentuje port.[ @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 is sysname, with a default of NULL.[ @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 is nvarchar(524), with a default value of NULL.Security Note:Do not use a blank password. Use a strong password.
[ @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 is int and can be one of these values.Wartość
Description
0
Uwierzytelnianie podstawowe jest używany.
1 (domyślnie)
Jest używane zintegrowane uwierzytelnianie systemu Windows.
Uwaga
Zaleca się stosowanie uwierzytelnianie podstawowego z synchronizacją w sieci Web.Aby użyć synchronizacja w sieci Web, należy połączeń SSL na serwerze sieci Web.Aby uzyskać więcej informacji zobacz Konfigurowanie synchronizacja w sieci Web.
[ @internet_timeout = ] internet_timeout
Is the length of time, in seconds, before a Web synchronization request expires.internet_timeout is int, with a default of 300 seconds.[ @hostname = ] 'hostname'
Overrides the value of HOST_NAME() when this function is used in the WHERE clause of a parameterized filter.hostname is sysname, with a default of NULL.[ @job_login = ] 'job_login'
Is the login for the Windows account under which the agent runs.job_login is nvarchar(257), with no default.Tego konta systemu Windows jest zawsze używana dla połączeń agenta subskrybent i połączeń z dystrybutor i Wydawca przy użyciu uwierzytelnianie zintegrowane systemu Windows.[ @job_password = ] 'job_password'
Is the password for the Windows account under which the agent runs.job_password is sysname, with no default.Security Note:Nie należy przechowywać informacje uwierzytelniające w plikach skryptów.Aby zapewnić najwyższy poziom zabezpieczeń należy dostarczyć nazwy logowania i hasła w czasie wykonywania.
Wartości kodów powrotnych
0 (sukces) lub 1 (brak)
Remarks
sp_addmergepullsubscription_agent jest używane w korespondencji seryjnej replikacja i wykorzystuje funkcje podobne do sp_addpullsubscription_agent.
Model replikacja agenta zabezpieczeń zmienił się znacznie od SQL Server 2000. Na przykład poprawnie określić ustawienia zabezpieczeń podczas wykonywania sp_addmergepullsubscription_agent, see Jak Tworzenie subskrypcja ściąganej (Programowanie replikacja języka Transact-SQL).
Uprawnienia
Tylko członkowie sysadmin Rola serwera lub db_owner stała rola bazy danych może być wykonywany sp_addmergepullsubscription_agent.
See Also