sp_addmergepullsubscription_agent (Transact-SQL)

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.

  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

Reference

Other Resources