sp_addmergepushsubscription_agent (języka Transact-SQL)
Dodaje nowe zadanie Agenta można planować synchronizację z subskrypcja wypychana do publikacja korespondencji seryjnej.Ta procedura składowana jest wykonywany na Wydawca na bazie publikacja.
.gif "Uwaga dotycząca zabezpieczeń") Uwaga dotycząca zabezpieczeń |
|---|
Podczas konfigurowania Publisher z dystrybutor zdalny, wartości dostarczone dla wszystkich parametrów, łącznie z job_login i job_password, są wysyłane do dystrybutora jako zwykły tekst.Należy zaszyfrować połączenie między wydawcy i jego dystrybutor zdalny przed wykonywania tej procedura składowana.Aby uzyskać więcej informacji, zobacz Szyfrowania połączeńSQL Server. |
.gif "Ikona łącza do tematu")
Składnia
sp_addmergepushsubscription_agent [ @publication =] 'publication'
[ , [ @subscriber = ] 'subscriber' ]
[ , [ @subscriber_db = ] 'subscriber_db' ]
[ , [ @subscriber_security_mode = ] subscriber_security_mode ]
[ , [ @subscriber_login = ] 'subscriber_login' ]
[ , [ @subscriber_password = ] 'subscriber_password' ]
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] 'publisher_login' ]
[ , [ @publisher_password = ] 'publisher_password' ]
[ , [ @job_login = ] 'job_login' ]
[ , [ @job_password = ] 'job_password' ]
[ , [ @job_name = ] 'job_name' ]
[ , [ @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 ]
[ , [ @enabled_for_syncmgr = ] 'enabled_for_syncmgr' ]
Argumenty
[ @ publikacja = 'publication"
Is the name of the publication.publication is sysname, with no default.[ @ subskrybent = '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 0, określa SQL Server uwierzytelniania.Jeśli 1, określa uwierzytelnianie systemu Windows.[ @ 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.[ @ 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.Jeśli subskrybent używać hasła, jest automatycznie szyfrowane.Uwaga dotycząca zabezpieczeńJeśli to możliwe, monitują 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_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 0, określa SQL Server uwierzytelniania.Jeśli 1, określa uwierzytelnianie systemu Windows.[ @ 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.Uwaga dotycząca zabezpieczeńJeśli to możliwe, monitują 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.
[ @ job_login = 'job_login"
Is the login for the Windows account under which the agent runs.job_login is nvarchar(257), with a default value of NULL.To konto systemu Windows jest zawsze używana dla połączeń agenta do dystrybutora i połączeń subskrybenta i Wydawca przy użyciu zintegrowane uwierzytelnianie 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.Uwaga dotycząca zabezpieczeńJeśli to możliwe, monitują 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.
[ @ 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 po zsynchronizowaniu subskrypcja przy użyciu istniejącego zadania zamiast nowo utworzone zadanie (domyślnie).Jeśli nie są element członkowski z sysadmin ustalona roli serwera, należy określić job_login i job_password podczas określania job_name.[ @ 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ść
Opis
1
Jedenczas
2
Na żądanie
4
Dzienny
8
Tygodniowy
16
Miesięczne
32
Miesięczne względna
64
Autostart
128
Cykliczne
NULL(default)
Ostrzeżenie
Określając wartość 64 powoduje scalanie agenta do uruchamiania w trybie ciągłym.Odpowiada to ustawieniu -ciągłego parametr dla agenta.Aby uzyskać więcej informacji, zobacz Agent replikacji scalania.
[ @ frequency_interval = frequency_interval
The days that the Merge Agent runs.frequency_interval is int, and can be one of the following values.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
NULL(default)
[ @ frequency_relative_interval = frequency_relative_interval
Jest to data agenta scalania.This parameter is used when frequency_type is set to 32 (monthly relative).frequency_relative_interval is int, and can be one of the following values.Wartość
Opis
1
First
2
Drugie
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 the following values.Wartość
Opis
1
Raz
2
Drugie
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.[ @ 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 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.
Wartości kodów powrotnych
0 (sukces) lub 1 (błąd)
Uwagi
sp_addmergepushsubscription_agent używane w replikacja scalająca i używa funkcjonalność podobną do sp_addpushsubscription_agent.
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".
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2008R2Replica';
SET @hostname = N'adventure-works\david8'
-- Add a push subscription to a merge publication.
USE [AdventureWorks2008R2]
EXEC sp_addmergesubscription
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@subscription_type = N'push',
@hostname = @hostname;
--Add an agent job to synchronize the push subscription.
EXEC sp_addmergepushsubscription_agent
@publication = @publication,
@subscriber = @subscriber,
@subscriber_db = @subscriptionDB,
@job_login = $(Login),
@job_password = $(Password);
GO
Uprawnienia
Tylko członkowie sysadmin stała rola serwera lub db_owner ustaloną rola bazy danych można wykonać sp_addmergepushsubscription_agent.
Zobacz także