Udostępnij za pośrednictwem


sp_addpullsubscription_agent (języka Transact-SQL)

Dodaje nowy agent zaplanowane zadanie używana do synchronizowania ściągać subskrypcja transakcyjnych publikacja.Ta procedura składowana jest wykonywany przez subskrybenta bazy danych subskrypcja .

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

sp_addpullsubscription_agent [ @publisher = ] 'publisher'
    [ , [ @publisher_db = ] 'publisher_db' ]
        , [ @publication = ] 'publication'
    [ , [ @subscriber = ] 'subscriber' ]
    [ , [ @subscriber_db = ] 'subscriber_db' ]
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]
    [ , [ @subscriber_login = ] 'subscriber_login' ]
    [ , [ @subscriber_password = ] 'subscriber_password' ]
    [ , [ @distributor = ] 'distributor' ]
    [ , [ @distribution_db = ] 'distribution_db' ]
    [ , [ @distributor_security_mode = ] distributor_security_mode ]
    [ , [ @distributor_login = ] 'distributor_login' ]
    [ , [ @distributor_password = ] 'distributor_password' ]
    [ , [ @optional_command_line = ] 'optional_command_line' ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subda y= ] 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 ]
    [ , [ @distribution_jobid = ] distribution_jobid OUTPUT ]
    [ , [ @encrypted_distributor_password = ] encrypted_distributor_password ]
    [ , [ @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' ]
    [ , [ @publication_type = ] publication_type ]
    [ , [ @dts_package_name = ] 'dts_package_name' ]
    [ , [ @dts_package_password = ] 'dts_package_password' ]
    [ , [ @dts_package_location = ] 'dts_package_location' ]
    [ , [ @reserved = ] 'reserved' ]
    [ , [ @offloadagent = ] 'remote_agent_activation' ]
    [ , [ @offloadserver = ] 'remote_agent_server_name']
    [ , [ @job_name = ] 'job_name' ]
    [ , [ @job_login = ] 'job_login' ] 
    [ , [ @job_password = ] 'job_password' ] 

Argumenty

  • [ @ publisher =] 'publisher'
    Jest to nazwa Wydawca.publisherjest sysname, z braku domyślne.

  • [ @ publisher_db =] **'**publisher_db'
    Jest to nazwa bazy danych Wydawca .publisher_dbjest sysname, o wartości domyślnej NULL.publisher_dbjest ignorowana przez wydawców Oracle.

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

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

    Ostrzeżenie

    Ten parametr zaniechano i jest utrzymywana zgodność z poprzednimi wersjami skryptów.

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

    Ostrzeżenie

    Ten parametr zaniechano i jest utrzymywana zgodność z poprzednimi wersjami skryptów.

  • [ @ 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ść NULL.0 Określa SQL Server uwierzytelniania.1 Określa uwierzytelnianie systemu Windows.

    Ostrzeżenie

    Ten parametr zaniechano i jest utrzymywana zgodność z poprzednimi wersjami skryptów.Agent dystrybucji zawsze łączy się z subskrybenta lokalnego przy użyciu uwierzytelniania systemu Windows.Jeśli wartość inną niż NULL lub 1 określono tego parametru, zwracany jest komunikat ostrzegawczy.

  • [ @ subscriber_login =] 'subscriber_login'
    Jest logowania subskrybenta do użycia podczas podłączania do subskrybenta podczas synchronizacji.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, zwracany jest komunikat ostrzegawczy, ale wartość jest ignorowana.

  • [ @ subscriber_password =] 'subscriber_password'
    Jest to hasło subskrybenta.subscriber_passwordjest wymagany, jeśli subscriber_security_modejest zestaw na 0.subscriber_passwordjest sysname, domyślna wartość NULL.Jeśli użyto hasła subskrybent są automatycznie szyfrowane.

    Ostrzeżenie

    Ten parametr zaniechano i jest utrzymywana zgodność z poprzednimi wersjami skryptów.Jeżeli określono wartość tego parametru, zwracany jest komunikat ostrzegawczy, ale wartość jest ignorowana.

  • [ @dystrybutor =] 'distributor'
    Jest nazwą dystrybutora.distributorjest sysname, z domyślnej wartości określonej przez publisher.

  • [ @ distribution_db =] 'distribution_db'
    Jest to nazwa baza danych dystrybucji.distribution_dbjest sysname, o wartości domyślnej NULL.

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

  • [ @ optional_command_line =] 'optional_command_line'
    Opcjonalny wiersz polecenia jest dostarczany do agenta dystrybucji.Na przykład: -DefinitionFile C:\Distdef.txt lub -CommitBatchSize 10.optional_command_linejest nvarchar(4000), domyślnie pusty ciąg.

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

    Wartość

    Opis

    1

    czas

    2 (wartość domyślna)

    Na żądanie

    4

    Dzienny

    8

    Tygodniowy

    16

    Miesięczne

    32

    Miesięczne względna

    64

    Autostart

    128

    Cykliczne

    Ostrzeżenie

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

  • [ @ frequency_interval =] frequency_interval
    Jest wartością, którą stosuje się do częstotliwości zestaw przez frequency_type.frequency_intervaljest int, domyślna wartość 1.

  • [ @ frequency_relative_interval =] frequency_relative_interval
    Jest to data agenta dystrybucji.Ten parametr jest używany podczas frequency_type jest zestaw na 32 (względne miesięcznych).frequency_relative_intervaljest int, i może mieć jedną z następujących wartości.

    Wartość

    Opis

    1 (wartość domyślna)

    First

    2

    Drugie

    4

    Trzecia

    8

    Czwarty

    16

    Last

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

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

    Wartość

    Opis

    1 (wartość domyślna)

    Raz

    2

    Drugie

    4

    Minuta

    8

    Godzina

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

  • [ @ active_start_time_of_day =] active_start_time_of_day
    czas po pierwszym agenta dystrybucji zaplanowano, sformatowane jako HHMMSS.active_start_time_of_dayjest int, domyślna 0.

  • [ @ active_end_time_of_day =] active_end_time_of_day
    czas momentu zatrzymania agenta dystrybucji jest zaplanowane, sformatowane jako HHMMSS.active_end_time_of_dayjest int, domyślna 0.

  • [ @ active_start_date =] active_start_date
    Jest data , gdy Agent dystrybucji najpierw jest planowana, w formacie RRRRMMDD.active_start_datejest int, domyślna 0.

  • [ @ active_end_date =] active_end_date
    Jest data zatrzymania agenta dystrybucji planowany, w formacie RRRRMMDD.active_end_datejest int, domyślna 0.

  • [ @ distribution_jobid =] distribution_jobidDANE WYJŚCIOWE
    Jest to identyfikator agenta dystrybucji dla tego zadanie.distribution_jobidjest binary(16), domyślna wartość NULL i jest parametr wyjściowy.

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

  • [ @ enabled_for_syncmgr =] 'enabled_for_syncmgr'
    To, czy subskrypcja mogą być synchronizowane za pośrednictwem Microsoft Menedżera synchronizacji. enabled_for_syncmgr jest 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ę innego folderu migawka.alternate_snapshot_folderjest nvarchar(255), domyślna wartość NULL.

  • [ @ working_directory= ] 'working_director'
    Jest nazwą katalogu roboczego używanego do przechowywania plików danych i schematu dla publikacja.working_directoryjest nvarchar(255), domyślna wartość NULL.Nazwę należy określić w formacie UNC.

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

  • [ @ publication_type= ] publication_type
    Określa typ replikacja publikacja.publication_typejest tinyint Domyślna 0.Jeżeli 0, publikacja jest typ transakcji.Jeżeli 1, publikacja jest typu migawka .Jeżeli 2, publikacja jest typ scalania.

  • [ @ dts_package_name= ] 'dts_package_name'
    Określa nazwę pakietDTS.dts_package_namejest sysname Domyślna wartość NULL.Na przykład, aby określić pakiet DTSPub_Package, byłoby parametr @dts_package_name = N'DTSPub_Package'.

  • [ @ dts_package_password= ] 'dts_package_password'
    Określa hasło na pakiet, jeżeli istnieje.dts_package_passwordjest sysname z domyślną wartość NULL oznacza hasło nie znajduje się na pakiet.

    Ostrzeżenie

    Należy określić hasło, jeśli dts_package_name określono.

  • [ @ dts_package_location= ] 'dts_package_location'
    Określa lokalizację pakiet .dts_package_locationjest nvarchar(12), domyślna subskrybent.Lokalizacja pakiet może być dystrybutor lub subskrybent.

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

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

  • [ @ job_login= ] 'job_login'
    Jest logowania konta systemu Windows, w ramach którego działa agent.job_loginjest nvarchar(257), z braku domyślne.To konto systemu Windows jest zawsze używane dla połączeń agenta subskrybenta.

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

    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.

Wartości kodów powrotnych

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

Uwagi

sp_addpullsubscription_agent jest używany w migawka replikacja i replikacjatransakcyjnej.

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;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2008R2';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2008R2Replica]
EXEC sp_addpullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

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

Uprawnienia

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