sp_addmergepushsubscription_agent (Transact-sql)

Makale
10/29/2012

Bir birleştirme yayını itme abonelik Eşitleme zamanlama için kullanılan yeni bir Aracısı iş ekler. Bu saklı yordam, yayını veritabanı üzerinde yayımcı adresindeki yürütülür.

Güvenlik Notu
Bir Publisher ile sağlanan tüm parametreler için değerler uzak bir dağıtımcı yapılandırma dahil job_loginve job_password, dağıtımcı düz metin olarak gönderilir. Bu saklı yordam yürütme önce Publisher ve kendi uzak dağıtımcı arasında bağlantı şifrelemek. Daha fazla bilgi için, bkz. Veritabanı altyapısı (SQL Server Configuration Manager) şifreli bağlantıları etkinleştir.

Bir Publisher ile sağlanan tüm parametreler için değerler uzak bir dağıtımcı yapılandırma dahil job_loginve job_password, dağıtımcı düz metin olarak gönderilir. Bu saklı yordam yürütme önce Publisher ve kendi uzak dağıtımcı arasında bağlantı şifrelemek. Daha fazla bilgi için, bkz. Veritabanı altyapısı (SQL Server Configuration Manager) şifreli bağlantıları etkinleştir.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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' ]

Bağımsız değişkenler

@ publication = 'publication'
Yayını addır. publicationise sysname, hiçbir varsayılan ile.
@ abone = 'subscriber'
Abone addır. subscriberise sysname, null varsayılan.
@ subscriber_db = 'subscriber_db'
Abonelik veritabanı adıdır. subscriber_db ise sysname, null varsayılan.
subscriber_security_mode @ = subscriber_security_mode
Bir abone eşitlerken bağlanırken kullanılacak güvenlik modudur. subscriber_security_modeise int, 1 varsayılan. Eğer 0, belirtir SQL Serverkimlik. Eğer 1, Windows kimlik doğrulamasını belirtir.
@ subscriber_login = 'subscriber_login'
Bir abone eşitlerken bağlanırken kullanılacak abone oturum açma 's. subscriber_loginEğer gerekli ise subscriber_security_modeayarı 0. subscriber_loginise sysname, null varsayılan.

@ subscriber_password = 'subscriber_password'
Abone parolası SQL Serverkimlik. subscriber_passwordgereklidir subscriber_security_modeayarı 0. subscriber_passwordise sysname, null varsayılan. Abone parola kullanılırsa, otomatik olarak şifrelenir.

Güvenlik Notu
Mümkün olduğunda, zamanında güvenlik kimlik bilgilerini girmesini ister. Bir komut dosyasında kimlik bilgileri saklamanız gerekir, yetkisiz erişimi önlemek için dosyayı güvenli gerekir.

@ publisher_security_mode = publisher_security_mode
Bir Publisher eşitlerken bağlanırken kullanılacak güvenlik modudur. publisher_security_modeise int, 1 varsayılan. Eğer 0, belirtir SQL Serverkimlik. Eğer 1, Windows kimlik doğrulamasını belirtir.
publisher_login @ = 'publisher_login'
Bir Publisher eşitlerken bağlanırken kullanılacak oturum açma 's. publisher_loginise sysname, null varsayılan.

publisher_password @ = 'publisher_password'
Yayımcı için bağlanırken kullanılan parolayı. publisher_passwordise sysname, null varsayılan.

Güvenlik Notu
Mümkün olduğunda, zamanında güvenlik kimlik bilgilerini girmesini ister. Bir komut dosyasında kimlik bilgileri saklamanız gerekir, yetkisiz erişimi önlemek için dosyayı güvenli gerekir.

@job_login ='job_login'
Aracı çalıştığı Windows hesabı için oturum açma 's. job_loginise nvarchar(257), varsayılan değeri NULL. Bu Windows hesabını her zaman Aracısı bağlantıları dağıtımcı için abone ve Publisher bağlantılar ve Windows tümleşik kimlik doğrulamasını kullanırken kullanılır.

@ job_password ='job_password'
Aracı çalıştığı Windows hesabı için parola değil. job_passwordise sysname, hiçbir varsayılan ile.

Güvenlik Notu
Mümkün olduğunda, zamanında güvenlik kimlik bilgilerini girmesini ister. Bir komut dosyasında kimlik bilgileri saklamanız gerekir, yetkisiz erişimi önlemek için dosyayı güvenli gerekir.

@job_name ='job_name'
Varolan Aracısı iş adıdır. job_nameise sysname, varsayılan değeri NULL. Bu parametre yalnızca abonelik kullanarak varolan iş yerine bir yeni oluşturulan iş (varsayılan) eşitlendiğinde belirtildi. Eğer üye değilseniz sysadmin belirtmelisiniz sabit sunucu rolü, job_loginve job_passwordsizin belirlediğiniz zaman job_name.
@ frequency_type = frequency_type
Birleştirme Aracısı zamanlama kullanılacak sıklığıdır. frequency_typeise int, ve aşağıdaki değerlerden biri olabilir.

Değer

Açıklama

1

Bir kez

2

İsteğe bağlı

4

Günlük

8

Haftalık

16

Aylık

32

Aylık göreli

64

Otomatik başlatma

128

Yinelenen

NULL (varsayılan)

[!NOT]

Bir değer belirterek 64 Birleştirme Aracısı sürekli modunda çalışmasına neden olur. Bu ayara karşılık -sürekli Aracısı parametresi. Daha fazla bilgi için, bkz. Birleştirme çoğaltma aracısı.
@ frequency_interval = frequency_interval
Birleştirme Aracısı çalıştığı günler. frequency_intervalise int, ve aşağıdaki değerlerden biri olabilir.

Değer

Açıklama

1

Pazar

2

Pazartesi

3

Salı

4

Çarşamba

5

Perşembe

6

Cuma

7

Cumartesi

8

Gün

9

Hafta içi

10

Hafta sonunu

NULL (varsayılan)
@ frequency_relative_interval = frequency_relative_interval
Birleştirme Aracısı tarihidir. Bu parametre zaman frequency_typeayarı 32 (aylık göreli). frequency_relative_intervalise int, ve aşağıdaki değerlerden biri olabilir.

Değer

Açıklama

1

First

2

İkinci

4

Üçüncü

8

Dördüncü

16

Last

NULL (varsayılan)
@ frequency_recurrence_factor = frequency_recurrence_factor
Tarafından kullanılan yineleme faktörü olduğunu frequency_type. frequency_recurrence_factorise int, null varsayılan.
@ frequency_subday = frequency_subday
Tanımlanan dönem sırasında sık sık yeniden zamanlamak nasıl olduğunu. frequency_subdayise int, ve aşağıdaki değerlerden biri olabilir.

Değer

Açıklama

1

Bir kez

2

İkinci

4

Dakika

8

Saat

NULL (varsayılan)
@ frequency_subday_interval = frequency_subday_interval
Aralık için frequency_subday. frequency_subday_intervalise int, null varsayılan.
@ active_start_time_of_day = active_start_time_of_day
Ne zaman birleştirme aracı ilk günün saati SSDDSS biçimlendirilmiş planlanmıştır. active_start_time_of_dayise int, null varsayılan.
@ active_end_time_of_day = active_end_time_of_day
Birleştirme Aracısı durduğunda günün saati zamanlanmış SSDDSS biçimlendirilmiş. active_end_time_of_dayise int, null varsayılan.
@ active_start_date = active_start_date
Ne zaman birleştirme aracı ilk tarih YYYYMMDD'nın biçimlendirilmiş planlanmıştır. active_start_dateise int, null varsayılan.
@ active_end_date = active_end_date
Birleştirme Aracısı durduğunda tarih zamanlanmış YYYYMMDD'nın biçimlendirilmiş. active_end_dateise int, null varsayılan.
@ enabled_for_syncmgr = 'enabled_for_syncmgr'
Windows Eşitleme Yöneticisi üzerinden eşitlenebilir abonelik belirtir. enabled_for_syncmgrise nvarchar(5), false varsayılan. Eğer false, abonelik Eşitleme Yöneticisi ile kayıtlı değil. Eğer true, abonelik Eşitleme Yöneticisi ile kayıtlı ve başlatmadan eşitlenebilir SQL Server Management Studio.

Değer	Açıklama
1	Bir kez
2	İsteğe bağlı
4	Günlük
8	Haftalık
16	Aylık
32	Aylık göreli
64	Otomatik başlatma
128	Yinelenen
NULL (varsayılan)

Değer	Açıklama
1	Pazar
2	Pazartesi
3	Salı
4	Çarşamba
5	Perşembe
6	Cuma
7	Cumartesi
8	Gün
9	Hafta içi
10	Hafta sonunu
NULL (varsayılan)

Değer	Açıklama
1	First
2	İkinci
4	Üçüncü
8	Dördüncü
16	Last
NULL (varsayılan)

Değer	Açıklama
1	Bir kez
2	İkinci
4	Dakika
8	Saat
NULL (varsayılan)

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Açıklamalar

sp_addmergepushsubscription_agent için benzer işlevleri kullanır ve birleştirme çoğaltması kullanılan sp_addpushsubscription_agent.

Örnek

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

-- Add a push subscription to a merge publication.
USE [AdventureWorks2012];
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