Udostępnij za pośrednictwem


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 .

Ikona łącza do tematuJę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ń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ń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ń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ń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ń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ń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.