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 .
.gif "Ikona łącza do tematu")
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..gif "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ń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ń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.
Zobacz także