sp_addmergepullsubscription_agent (języka Transact-SQL)

Dodaje nowy agent zadanie używanych do planowania synchronizacji ściągać subskrypcja do publikacjakorespondencji seryjnej.Ta procedura składowana jest wykonywany przez subskrybenta bazy danych subskrypcja .

Języka Transact-SQL składni konwencje

Składnia

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

• [ @ Nazwa = ] 'name'
  Jest to nazwa agenta.namejest sysname, domyślna wartość NULL.

• [ @ publisher = ] 'publisher'
  Jest nazwą serwera Wydawca .publisherjest sysname, z braku domyślne.

• [ @ publisher_db = ] 'publisher_db'
  Jest to nazwa bazy danych Wydawca .publisher_dbjest sysname, z braku domyślne.

• [ @publikacja = ] 'publication'
  Jest to nazwa publikacja.publicationjest sysname, z braku domyślne.

• [ @ publisher_security_mode = ] publisher_security_mode
  Jest to tryb zabezpieczeń do użycia podczas podłączania do Wydawca , podczas synchronizacji.publisher_security_modejest int, domyślna wartość 1.Jeżeli 0, określa SQL Server uwierzytelniania.Jeżeli 1, określa uwierzytelnianie systemu Windows.

  Uwaga dotycząca zabezpieczeń
  Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows.

• [ @ publisher_login = ] 'publisher_login'
  To logowanie do użycia podczas podłączania do Wydawca , podczas synchronizacji.publisher_login jest sysname, domyślna wartość NULL.

• [ @ publisher_password = ] 'publisher_password'
  Hasło jest używany przy łączeniu się z Wydawca.publisher_passwordjest sysname, domyślna wartość NULL.

  Uwaga dotycząca zabezpieczeń
  Nie należy używać pustego hasła. Należy używać silnego hasła.Jeśli to możliwe, użytkownicy byli monitowani o wprowadzenie poświadczenia zabezpieczeń, w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby zapobiec nieautoryzowanemu dostępowi.

• [ @ publisher_encrypted_password = ]publisher_encrypted_password
  Ustawienie publisher_encrypted_password nie jest już obsługiwany.Próby zestaw to bit parametr 1 spowoduje błąd.

• [ @subskrybent = ] 'subscriber'
  Jest to nazwa subskrybenta.subscriberjest sysname, domyślna wartość NULL.

• [ @ subscriber_db = ] 'subscriber_db'
  Jest to nazwa bazy danych subskrypcja .subscriber_dbjest sysname, domyślna wartość NULL.

• [ @ subscriber_security_mode = ] subscriber_security_mode
  Jest to tryb zabezpieczeń do użycia podczas podłączania do subskrybenta podczas synchronizacji.subscriber_security_modejest int, domyślna wartość 1.Jeżeli 0, określa SQL Server uwierzytelniania.Jeżeli 1, określa uwierzytelnianie systemu Windows.

  Ostrzeżenie

  Ten parametr zaniechano i jest utrzymywana zgodność z poprzednimi wersjami skryptów.Agent scalić zawsze łączy się z subskrybenta lokalnego przy użyciu uwierzytelniania systemu Windows.Jeżeli określono wartość tego parametru, zostanie zwrócony komunikat ostrzegawczy, ale wartości zostaną zignorowane.

• [ @ subscriber_login = ] 'subscriber_login'
  Jest logowania subskrybenta do użycia podczas podłączania do subskrybenta podczas synchronizacji.subscriber_loginjest wymagany, jeśli subscriber_security_mode jest zestaw na 0.subscriber_loginjest sysname, domyślna wartość NULL.

  Ostrzeżenie

  Ten parametr zaniechano i jest utrzymywana zgodność 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'
  To hasło subskrybenta SQL Server uwierzytelniania.subscriber_passwordjest wymagany, jeśli subscriber_security_modejest zestaw na 0.subscriber_passwordjest sysname, domyślna wartość NULL.

  Ostrzeżenie

  Ten parametr zaniechano i jest utrzymywana zgodność z poprzednimi wersjami skryptów.Jeżeli określono wartość tego parametru, zostanie zwrócony komunikat ostrzegawczy, ale wartości zostaną zignorowane.

• [ @dystrybutor = ] 'distributor'
  Jest nazwą dystrybutora.distributorjest sysname, domyślnie publisher; oznacza to, że Wydawca jest również dystrybutora.

• [ @ distributor_security_mode = ] distributor_security_mode
  Jest to tryb zabezpieczeń do użycia podczas podłączania do dystrybutora podczas synchronizacji.distributor_security_modejest int, domyślna wartość 0.0 Określa SQL Server uwierzytelniania.1 Określa uwierzytelnianie systemu Windows.

  Uwaga dotycząca zabezpieczeń
  Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows.

• [ @ distributor_login = ] 'distributor_login'
  Jest logowania dystrybutora do użycia podczas podłączania do dystrybutora podczas synchronizacji.distributor_loginjest wymagany, jeśli distributor_security_modejest zestaw na 0.distributor_loginjest sysname, domyślna wartość NULL.

• [ @ distributor_password = ] 'distributor_password'
  Jest to hasło dystrybutora.distributor_passwordjest wymagany, jeśli distributor_security_modejest zestaw na 0.distributor_passwordjest sysname, domyślna wartość NULL.

  Uwaga dotycząca zabezpieczeń
  Nie należy używać pustego hasła. Należy używać silnego hasła.Jeśli to możliwe, użytkownicy byli monitowani o wprowadzenie poświadczenia zabezpieczeń, w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane w pliku skryptu, należy zabezpieczyć plik, aby zapobiec nieautoryzowanemu dostępowi.

• [ @ encrypted_password = ] encrypted_password
  Ustawienie encrypted_password nie jest już obsługiwany.Próby zestaw to bit parametr 1 spowoduje błąd.

• [ @ frequency_type = ] frequency_type
  Jest częstotliwość harmonogramu agenta scalania.frequency_typejest int, i może mieć jedną z następujących wartości.

  Wartość	Opis
  1	czas
  2	Na żądanie
  4	Dzienny
  8	Tygodniowy
  16	Miesięczne
  32	Miesięczne względna
  64	Autostart
  128	Cykliczne
  Wartość NULL (wartość domyślna)

  Ostrzeżenie

  Określając wartość 64 powoduje, że Agent scalania do pracy w trybie ciągłym.Odpowiada to ustawieniu -Ciągłe parametr agenta.Aby uzyskać więcej informacji, zobacz temat Agent replikacji scalania.

• [ @ frequency_interval = ] frequency_interval
  Dzień lub dni, które działa Agent scalania.frequency_intervaljest int, i może być jedną z tych wartości.

  Wartość	Opis
  1	Niedziela
  2	Poniedziałek
  3	Wtorek
  4	Środa
  5	Czwartek
  6	Piątek
  7	Sobota
  8	Dzień
  9	Dni powszednie
  10	Dni weekendowe
  Wartość NULL (wartość domyślna)

• [ @ frequency_relative_interval = ] frequency_relative_interval
  To data agenta scalania.Ten parametr jest używany podczas frequency_type jest zestaw na 32 (względne miesięcznych).frequency_relative_intervaljest int, i może być jedną z tych wartości.

  Wartość	Opis
  1	First
  2	Drugie
  4	Trzecia
  8	Czwarty
  16	Last
  Wartość NULL (wartość domyślna)

• [ @ frequency_recurrence_factor = ] frequency_recurrence_factor
  Jest używany przez współczynnik cykl frequency_type.frequency_recurrence_factorjest int, domyślna wartość NULL.

• [ @ frequency_subday = ] frequency_subday
  To, jak często ponownie zaplanować w definiowanym okresie.frequency_subdayjest int, i może być jedną z tych wartości.

  Wartość	Opis
  1	Raz
  2	Drugie
  4	Minuta
  8	Godzina
  Wartość NULL (wartość domyślna)

• [ @ frequency_subday_interval = ] frequency_subday_interval
  Interwał dla frequency_subday.frequency_subday_intervaljest int, domyślna wartość NULL.

• [ @ active_start_time_of_day =] active_start_time_of_day
  czas po pierwszym agenta scalanie zaplanowano, sformatowane jako HHMMSS.active_start_time_of_dayjest int, domyślna wartość NULL.

• [ @ active_end_time_of_day = ] active_end_time_of_day
  Jest czas podczas scalania agenta Zatrzymuje zaplanowane, sformatowane jako HHMMSS.active_end_time_of_dayjest int, domyślna wartość NULL.

• [ @ active_start_date = ] active_start_date
  To data , podczas scalania agenta najpierw planowania w formacie RRRRMMDD.active_start_datejest int, domyślna wartość NULL.

• [ @ active_end_date = ] active_end_date
  To data , podczas scalania agenta przestanie być zaplanowane, w formacie RRRRMMDD.active_end_datejest int, domyślna wartość NULL.

• [ @ optional_command_line = ] 'optional_command_line'
  Jest opcjonalne wiersz polecenia , które zostały dostarczone do agenta scalania.optional_command_linejest nvarchar(255), domyślna wartość ' ".Można podać dodatkowe parametry do agenta scalić takie, jak w poniższym przykładzie, która zwiększa kwerendy domyślny czas-out do 600 sekund:

  @optional_command_line = N'-QueryTimeOut 600'
  

• [ @ merge_jobid = ] merge_jobid
  Jest parametr wyjściowy dla identyfikatora zadanie .merge_jobidjest binary(16), domyślna wartość NULL.

• [ @ enabled_for_syncmgr = ] 'enabled_for_syncmgr'
  Określa, jeżeli subskrypcja mogą być synchronizowane za pomocą Menedżera synchronizacji systemu Windows.enabled_for_syncmgrjest nvarchar(5), domyślna wartość FALSE.Jeśli false, subskrypcja nie jest zarejestrowana z Menedżera synchronizacji.Jeśli true, subskrypcja jest zarejestrowany przy użyciu Menedżera synchronizacji i może być synchronizowana bez uruchamiania SQL Server Management Studio.

• [ @ ftp_address = ] 'ftp_address'
  Tylko zgodności ze starszymi wersjami.

• [ @ ftp_port = ] ftp_port
  Tylko zgodności ze starszymi wersjami.

• [ @ ftp_login = ] 'ftp_login'
  Tylko zgodności ze starszymi wersjami.

• [ @ ftp_password = ] 'ftp_password'
  Tylko zgodności ze starszymi wersjami.

• [ @ alt_snapshot_folder = ] 'alternate_snapshot_folder'
  Określa lokalizację, w której do pobrania plików migawka .alternate_snapshot_folderjest nvarchar(255), domyślna wartość NULL.Jeśli ma wartość NULL, plików migawka zostanie pobrana z lokalizacji domyślnej, określonej przez Wydawca.

• [ @ working_directory = ] 'working_directory'
  Jest nazwą katalogu roboczego używane do tymczasowego przechowywania plików danych i schematu dla publikacja , gdy FTP jest używany do transferu plików migawka .working_directoryjest nvarchar(255), domyślna wartość NULL.

• [ @ use_ftp = ] 'use_ftp'
  Określa użycie FTP zamiast typowego protokół pobrać migawek.use_ftpjest nvarchar(5), domyślna wartość FALSE.

• [ @ zarezerwowane = ] 'reserved'
  Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.

• [ @ use_interactive_resolver = ] 'use_interactive_resolver' ]
  Używa interaktywne rozpoznawania nazw do rozwiązywania konfliktów dla wszystkich artykułów, które umożliwia interakcyjne rozpoznawanie.use_interactive_resolverjest nvarchar(5), domyślna wartość FALSE.

• [ @ offloadagent = ] 'remote_agent_activation'

  Ostrzeżenie

  Agenta zdalnego aktywacja zaniechano i nie jest już obsługiwany.Ten parametr jest obsługiwany tylko w celu zachowania zgodności z poprzednimi wersjami skryptów.Ustawienie remote_agent_activation na wartość inną niż false spowoduje wygenerowanie błędu.

• [ @ offloadserver = ] 'remote_agent_server_name'

  Ostrzeżenie

  Agenta zdalnego aktywacja zaniechano i nie jest już obsługiwany.Ten parametr jest obsługiwany tylko w celu zachowania zgodności z poprzednimi wersjami skryptów.Ustawienie remote_agent_server_name dowolną wartość NIEZEROWĄ spowoduje wygenerowanie błędu.

• [ @ job_name = ] 'job_name' ]
  Jest nazwą istniejącego zadanieagenta.job_namejest sysname, o wartości domyślnej NULL.Ten parametr jest określony tylko, gdy subskrypcja zostaną zsynchronizowane przy użyciu istniejącego zadanie , a nie nowo utworzone zadanie (domyślnie).Jeśli nie jesteś element członkowski sysadmin stała rola serweranależy określić job_login i job_password Po określeniu job_name.

• [ @ dynamic_snapshot_location = ] 'dynamic_snapshot_location' ]
  ścieżka do folderu, w którym migawka plików zostaną odczytane z Jeśli filtrowane dane migawka ma być używany.dynamic_snapshot_locationjest nvarchar(260), domyślna wartość NULL.Aby uzyskać więcej informacji, zobacz temat Filtry parametrami wiersza.

• [ @ use_web_sync = ] use_web_sync
  Wskazuje, że jest włączona synchronizacja w sieci Web .use_web_syncjest bit, domyślna wartość 0.1 Określa, że mogą być synchronizowane ściągać subskrypcja przez internet przy użyciu protokołu HTTP.

• [ @ internet_url = ] 'internet_url'
  Lokalizacja odbiornika replikacja (REPLISAPI.Biblioteka DLL) synchronizacja w sieci Web.internet_urljest nvarchar(260), domyślna wartość NULL.internet_urljest w pełni kwalifikowany adres URL w formacie http://server.domain.com/directory/replisapi.dll.Jeśli serwer jest skonfigurowany do nasłuchu na porcie innego niż 80, numer portu musi być dostarczone w formacie http://server.domain.com:portnumber/directory/replisapi.dll, gdzie portnumber reprezentuje portu

• [ @ internet_login = ] 'internet_login'
  Jest scalanie Agent używa do łączenia z serwerem sieci Web obsługującym synchronizacja w sieci Web logowania przy użyciu uwierzytelniania podstawowego protokołu HTTP.internet_loginjest sysname, domyślna wartość NULL.

• [ @ internet_password = ] 'internet_password'
  Scalanie Agent używa do łączenia z serwerem sieci Web obsługującym synchronizacja w sieci Web hasło jest przy użyciu uwierzytelniania podstawowego protokołu HTTP.internet_passwordjest nvarchar(524), o wartości domyślnej NULL.

  Uwaga dotycząca zabezpieczeń
  Nie należy używać pustego hasła. Należy używać silnego hasła.

• [ @ internet_security_mode = ] internet_security_mode
  metoda uwierzytelnianie, używana przez agenta seryjny podczas nawiązywania połączenia z serwerem sieci Web podczas synchronizacja w sieci Web używa protokołu HTTPS. internet_security_modejest int i może być jedną z tych wartości.

  Wartość	Opis
  0	Uwierzytelnianie podstawowe jest używany.
  1 (wartość domyślna)	Jest używane zintegrowane uwierzytelnianie systemu Windows.

  Ostrzeżenie

  Zaleca się, aby przy użyciu uwierzytelniania podstawowego z synchronizacja w sieci Web.synchronizacja w sieci Webnależy połączenia SSL na serwerze sieci Web.Aby uzyskać więcej informacji, zobacz temat Konfigurowanie synchronizacji w sieci Web.

• [ @ internet_timeout = ] internet_timeout
  czasjest wyrażony w sekundach, przed upływem żądanie synchronizacja w sieci Web .internet_timeoutjest int, domyślna 300 Liczba sekund.

• [ @ hostname = ] 'hostname'
  Zastępuje wartość HOST_NAME(), gdy ta funkcja jest używana w klauzula sparametryzowana filtru.hostnamejest sysname, domyślna wartość NULL.

• [ @ job_login = ] 'job_login'
  Jest logowania konta systemu Windows, w ramach którego działa agent.job_loginjest nvarchar(257), z braku domyślne.Przy użyciu uwierzytelnianiezintegrowanego systemu Windows to konto systemu Windows jest zawsze używany w agenta połączeń subskrybenta i połączeń do dystrybutora i Wydawca .

• [ @ job_password = ] 'job_password'
  Jest to hasło konta systemu Windows, w ramach którego działa agent.job_passwordjest sysname, z braku domyślne.

  Uwaga dotycząca zabezpieczeń
  Nie można przechowywać informacje o uwierzytelnianie w plikach skryptów.Najlepszym zabezpieczeniem nazwy logowania i hasła powinny być dostarczane w czasie wykonywania.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Uwagi

sp_addmergepullsubscription_agent używane w replikacja scalająca i używa funkcjonalność podobną do sp_addpullsubscription_agent.

Model zabezpieczeń agent replikacja uległy znacznym zmianom od SQL Server 2000.Aby przykład prawidłowo określić ustawienia zabezpieczeń podczas wykonywania sp_addmergepullsubscription_agent, see Jak Tworzenie subskrypcji ściąganej (Programowanie replikacji Transact-SQL).

Przykład

-- 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'AdventureWorks2008R2';
SET @hostname = N'adventure-works\david8';

-- At the subscription database, create a pull subscription 
-- to a merge publication.
USE [AdventureWorks2008R2Replica]
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

Uprawnienia

Tylko członkowie sysadmin stała rola serwera lub db_owner Stała rola bazy danych można wykonać sp_addmergepullsubscription_agent.

Zobacz także

Zadania

Jak Tworzenie subskrypcji ściąganej (Programowanie replikacji Transact-SQL)

Odwołanie

sp_addmergepullsubscription (języka Transact-SQL)

sp_changemergepullsubscription (języka Transact-SQL)

sp_dropmergepullsubscription (języka Transact-SQL)

sp_helpmergepullsubscription (języka Transact-SQL)

sp_helpsubscription_properties (języka Transact-SQL)

Koncepcje

Subskrybowanie publikacje