yürütme eşdeğerdirsp_addpullsubscription_agent (Transact-sql)

Makale
10/29/2012

Çekme abonelik işlem yayınına eşitlemek için kullanılan yeni bir zamanlanmış Aracısı iş ekler. Bu saklı yordam, abonelik veritabanı abone adresindeki yürütülür.

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

Sözdizimi

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

Bağımsız değişkenler

@ publisher ='publisher'
Yayımcı addır. publisherise sysname, hiçbir varsayılan ile.
**@ publisher_db ='**publisher_db'
Publisher veritabanı adıdır. publisher_dbise sysname, varsayılan değeri NULL. publisher_dbOracle yayımcılar tarafından yoksayılır.
@ publication ='publication'
Yayını addır. publicationise sysname, hiçbir varsayılan ile.
@ abone ='subscriber'
Abone addır. subscriberise sysname, null varsayılan.

[!NOT]

Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur.
@ subscriber_db ='subscriber_db'
Abonelik veritabanı adıdır. subscriber_dbise sysname, null varsayılan.

[!NOT]

Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur.
**subscriber_security_mode @ =**subscriber_security_mode
Bir abone eşitlerken bağlanırken kullanılacak güvenlik modudur. subscriber_security_modeise int,null varsayılan. 0 belirtir SQL Serverkimlik. 1 Windows kimlik doğrulamasını belirtir.

[!NOT]

Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur. Dağıtım aracı her zaman Windows kimlik doğrulaması kullanarak yerel abone bağlanır. null dışında bir değer varsa veya 1 belirtilen bu parametre için bir uyarı iletisi döndürülür.
@ subscriber_login ='subscriber_login'
Bir abone eşitlerken bağlanırken kullanılacak abone oturum açma 's. subscriber_login olan sysname, null varsayılan.

[!NOT]

Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur. Bu parametre için bir değer belirtilirse, bir uyarı iletisi döndürülür, ancak değeri yoksayılır.
@ subscriber_password ='subscriber_password'
Abone paroladır. subscriber_passwordEğer gerekli ise subscriber_security_modeayarı 0. subscriber_passwordise sysname, null varsayılan. Abone parola kullanılırsa, otomatik olarak şifrelenir.

[!NOT]

Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur. Bu parametre için bir değer belirtilirse, bir uyarı iletisi döndürülür, ancak değeri yoksayılır.
Dağıtıcı ='distributor'
Dağıtımcı adıdır. distributorise sysname, bir varsayılan değeri tarafından belirtilen publisher.
@ distribution_db ='distribution_db'
Dağıtım veritabanının adıdır. distribution_dbise sysname, varsayılan değeri NULL.
**@ distributor_security_mode =**distributor_security_mode
Bir dağıtıcı eşitlerken bağlanırken kullanılacak güvenlik modudur. distributor_security_modeise int, varsayılan 1. 0 belirtir SQL Serverkimlik. 1 Windows kimlik doğrulamasını belirtir.

Güvenlik Notu

Mümkünse Windows Kimlik Doğrulaması kullanın.
@ distributor_login ='distributor_login'
Bir dağıtıcı eşitlerken bağlanırken kullanılacak dağıtımcı oturumu olduğunu. distributor_loginEğer gerekli ise distributor_security_modeayarı 0. distributor_loginise sysname, null varsayılan.

Güvenlik Notu
Mümkünse Windows Kimlik Doğrulaması kullanın.

distributor_password @ ='distributor_password'
Dağıtıcı paroladır. distributor_passwordEğer gerekli ise distributor_security_modeayarı 0. distributor_passwordise sysname, null varsayılan.

Güvenlik Notu
Boş parola kullanmayın. Güçlü bir parola kullanın. 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.

@ optional_command_line ='optional_command_line'
İsteğe bağlı bir komut istemi için dağıtım aracı sağlanır. Örneğin, - DefinitionFile C:\Distdef.txt veya - CommitBatchSize 10. optional_command_lineise nvarchar(4000), boş dize varsayılan.
**@ frequency_type =**frequency_type
Dağıtım 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 (varsayılan)

İ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

[!NOT]

Bir değer belirterek 64 sürekli modunda çalıştırmak dağıtım aracı neden olur. Bu ayara karşılık -sürekli Aracısı parametresi. Daha fazla bilgi için, bkz. Çoğaltma Dağıtım Aracısı.
**@ frequency_interval =**frequency_interval
Ayarlar sıklığı uygulamak için değeri frequency_type. frequency_intervalise int, 1 varsayılan.
**@ frequency_relative_interval =**frequency_relative_interval
Dağıtım 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 (varsayılan)

First

2

İkinci

4

Üçüncü

8

Dördüncü

16

Last
**@ frequency_recurrence_factor =**frequency_recurrence_factor
Tarafından kullanılan yineleme faktörü olduğunu frequency_type. frequency_recurrence_factorise int, varsayılan 1.
**@ 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 (varsayılan)

Bir kez

2

İkinci

4

Dakika

8

Saat
**@ frequency_subday_interval =**frequency_subday_interval
Aralık için frequency_subday. frequency_subday_intervalise int, varsayılan 1.
**@ active_start_time_of_day =**active_start_time_of_day
Ne zaman dağıtım aracı ilk günün saati SSDDSS biçimlendirilmiş planlanmıştır. active_start_time_of_dayise int, varsayılan 0.
**@ active_end_time_of_day =**active_end_time_of_day
Dağıtım Aracısı durduğunda günün saati zamanlanmış SSDDSS biçimlendirilmiş. active_end_time_of_dayise int, varsayılan 0.
**@ active_start_date =**active_start_date
Ne zaman dağıtım aracı ilk tarih YYYYMMDD'nın biçimlendirilmiş planlanmıştır. active_start_dateise int, varsayılan 0.
**@ active_end_date =**active_end_date
Dağıtım Aracısı durduğunda tarih zamanlanmış YYYYMMDD'nın biçimlendirilmiş. active_end_dateise int, varsayılan 0.
@ distribution_jobid =distribution_jobidOUTPUT
Dağıtım Aracısı için bu işlem kimliğidir. distribution_jobidise binary(16), null ve varsayılan ile bir çıkış parametresidir.
**@ encrypted_distributor_password =**encrypted_distributor_password
Ayar encrypted_distributor_passwordartık desteklenmiyor. Bu ayarlama girişiminde bitparametresi 1 bir hata neden olur.
@ enabled_for_syncmgr ='enabled_for_syncmgr'
Yoksa abonelik üzerinden eşitlenebilir olup MicrosoftEşitleme Yöneticisi. enabled_for_syncmgr's 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.
@ ftp_address ='ftp_address'
Yalnızca geriye dönük uyumluluk için.
**@ftp_port=**ftp_port
Yalnızca geriye dönük uyumluluk için.
@ftp_login='ftp_login'
Yalnızca geriye dönük uyumluluk için.
ftp_password @ ='ftp_password'
Yalnızca geriye dönük uyumluluk için.
@ alt_snapshot_folder = **'**alternate_snapshot_folder'
Anlık görüntüsü için diğer klasör konumu belirtir. alternate_snapshot_folderise nvarchar(255), null varsayılan.
@ working_directory=] 'working_director'
Yayın için veri ve şema dosyaları depolamak için kullanılan çalışma dizini adıdır. working_directoryise nvarchar(255), null varsayılan. Adı unc biçiminde belirtilmelidir.
@use_ftp= ] 'use_ftp'
ftp yerine normal Protokolü anlık görüntülerini almak için kullanılacağını belirtir. use_ftpise nvarchar(5), false varsayılan.
@ publication_type=] publication_type
Yayını çoğaltma türünü belirtir. publication_typeolan bir tinyintvarsayılan ile 0. Eğer 0, yayını işlem türüdür. Eğer 1, yayını anlık görüntü türüdür. Eğer 2, yayına birleştirme türüdür.
@ dts_package_name=] 'dts_package_name'
dts paketinin adını belirtir. dts_package_nameolan bir sysnamenull varsayılan. Örneğin, bir paket belirtmek için DTSPub_Package, parametre olacaktır @dts\_package\_name = N'DTSPub_Package'.
@ dts_package_password=] 'dts_package_password'
Varsa Paket parolasını belirtir. dts_package_passwordise sysnamenull varsayılan ile yani bir şifre paketi değil.

[!NOT]

Eğer bir parola belirtmelisiniz dts_package_namebelirtilen.
@ dts_package_location=] 'dts_package_location'
Paket konumu belirtir. dts_package_locationolan bir nvarchar(12), varsayılan abone. Paket konumu olabilir Dağıtıcı veya abone.
@reserved= ] 'reserved'
Yalnızca bilgi amaçlı olarak belirtilmiştir. Desteklenmez. Gelecekteki uyumluluk garanti edilmez.
@ offloadagent=] 'remote_agent_activation'

[!NOT]

Uzaktaki aracı etkinleştirme onaylanmaz ve artık desteklenmiyor. Bu parametre, yalnızca geriye dönük uyumluluk komut dosyaları korumak için desteklenir. Ayar remote_agent_activationdışında bir değere falsebir hata üretecektir.
@ offloadserver=] 'remote_agent_server_name'

[!NOT]

Uzaktaki aracı etkinleştirme onaylanmaz ve artık desteklenmiyor. Bu parametre, yalnızca geriye dönük uyumluluk komut dosyaları korumak için desteklenir. Ayar remote_agent_server_nameherhangi bir boş olmayan değer bir hata üretecektir.
@ job_name=] 'job_name'
Varolan Aracısı iş adıdır. job_nameise sysname, varsayılan değeri NULL. Bu parametre yalnızca abonelik oluşturulan iş (varsayılan) yerine varolan bir işi kullanarak senkronize olacak zaman belirtildi. Eğer üye değilseniz sysadmin belirtmelisiniz sabit sunucu rolü, job_loginve job_passwordsizin belirlediğiniz zaman job_name.
@job_login= ] 'job_login'
Aracı çalıştığı Windows hesabı için oturum açma 's. job_loginise nvarchar(257), hiçbir varsayılan ile. Bu Windows hesabını her zaman abone Aracısı bağlantıları için kullanılır.

Değer	Açıklama
1	Bir kez
2 (varsayılan)	İ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

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

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

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

Dönüş Kodu Değerleri

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

Açıklamalar

sp_addpullsubscription_agent anlık görüntü çoğaltma ve işlem çoğaltma kullanılır.

Ö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".

-- 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'AdventureWorks2012';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2012Replica]
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