sp_addpullsubscription_agent (Transact-SQL)

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'
  Is the name of the Publisher.publisher is sysname, with no default.

• [ @publisher_db=] **'**publisher_db'
  Is the name of the Publisher database.publisher_db is sysname, with a default value of NULL.publisher_db is ignored by Oracle Publishers.

• [ @publication=] 'publication'
  Is the name of the publication.publication is sysname, with no default.

• [ @subscriber=] 'subscriber'
  Is the name of the Subscriber.subscriber is sysname, with a default of NULL.

  Not

  Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur.

• [ @subscriber_db=] 'subscriber_db'
  Is the name of the subscription database.subscriber_db is sysname, with a default of NULL.

  Not

  Bu parametre onaylanmaz ve komut dosyaları geriye dönük uyumluluk için korunur.

• [ @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 NULL.0 belirtir SQL Server kimlik doğrulaması.1 Windows kimlik doğrulamasının kullanılacağı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 ile bağlanır.Bir değeri, null dışında veya 1 belirtilen bu parametre, bir uyarı iletisi döndürülür.

• [ @subscriber_login =] 'subscriber_login'
  Is the Subscriber login to use when connecting to a Subscriber when synchronizing.subscriber_login is sysname, with a default of NULL.

  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'
  Is the Subscriber password.subscriber_password is required if subscriber_security_mode is set to 0.subscriber_password is sysname, with a default of NULL.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.

• [ @distributor=] 'distributor'
  Is the name of the Distributor.distributor is sysname, with a default of the value specified by publisher.

• [ @distribution_db=] 'distribution_db'
  Is the name of the distribution database.distribution_db is sysname, with a default value of NULL.

• [ @distributor_security_mode=] distributor_security_mode
  Is the security mode to use when connecting to a Distributor when synchronizing.distributor_security_mode is int, with a default of 1. 0 belirtir SQL Server kimlik doğrulaması.1 Windows kimlik doğrulamasının kullanılacağını belirtir.

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

• [ @distributor_login=] 'distributor_login'
  Is the Distributor login to use when connecting to a Distributor when synchronizing.distributor_login is required if distributor_security_mode is set to 0.distributor_login is sysname, with a default of NULL.

• [ @distributor_password =] 'distributor_password'
  Is the Distributor password.distributor_password is required if distributor_security_mode is set to 0.distributor_password is sysname, with a default of NULL.

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

• [ @optional_command_line=] 'optional_command_line'
  Dağıtım Aracısı için isteğe bağlı bir komut istemi verilir.For example, -DefinitionFile C:\Distdef.txt or -CommitBatchSize 10.optional_command_line is nvarchar(4000), with a default of empty string.

• [ @frequency_type=] frequency_type
  Is the frequency with which to schedule the Distribution Agent.frequency_type is int, and can be one of the following values.

  Değer	Açıklama
  1	Birisaat
  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

  Değeri belirterek 64 sürekli modunda çalıştırmak Dağıtım Aracısı olur.Bu ayara karşılık gelir -sürekli Aracısı parametresi.Daha fazla bilgi için bkz: Çoğaltma Dağıtım Aracısı.

• [ @frequency_interval=] frequency_interval
  Is the value to apply to the frequency set by frequency_type.frequency_interval is int, with a default of 1.

• [ @frequency_relative_interval=] frequency_relative_interval
  Olan tarih Dağıtım Aracısı.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.

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

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  Is the recurrence factor used by frequency_type.frequency_recurrence_factor is int, with a default of 1.

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

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

• [ @frequency_subday_interval=] frequency_subday_interval
  Is the interval for frequency_subday.frequency_subday_interval is int, with a default of 1.

• [ @active_start_time_of_day=] active_start_time_of_day
  Is the time of day when the Distribution Agent is first scheduled, formatted as HHMMSS.active_start_time_of_day is int, with a default of 0.

• [ @active_end_time_of_day=] active_end_time_of_day
  Is the time of day when the Distribution Agent stops being scheduled, formatted as HHMMSS.active_end_time_of_day is int, with a default of 0.

• [ @active_start_date=] active_start_date
  Is the date when the Distribution Agent is first scheduled, formatted as YYYYMMDD.active_start_date is int, with a default of 0.

• [ @active_end_date=] active_end_date
  Is the date when the Distribution Agent stops being scheduled, formatted as YYYYMMDD.active_end_date is int, with a default of 0.

• [ @distribution_jobid =] distribution_jobidOUTPUT
  Is the ID of the Distribution Agent for this job.distribution_jobid is binary(16), with a default of NULL, and it is an OUTPUT parameter.

• [ @encrypted_distributor_password=] encrypted_distributor_password
  Ayar encrypted_distributor_password artık desteklenmiyor.Çalışırken küme bu bit parametresi 1 bir hata neden olur.

• [ @enabled_for_syncmgr=] 'enabled_for_syncmgr'
  Abonelik yoluyla mı eşitlenebilir olup Microsoft Eşitleme Yöneticisi. enabled_for_syncmgr olan nvarchar(5), varsayılan değer false.If false, the subscription is not registered with Synchronization Manager.If true, the subscription is registered with Synchronization Manager and can be synchronized without starting 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'
  Specifies the location of the alternate folder for the snapshot.alternate_snapshot_folder is nvarchar(255), with a default of NULL.

• [ @ working_directory=] 'working_director'
  Is the name of the working directory used to store data and schema files for the publication.working_directory is nvarchar(255), with a default of NULL.Adı unc biçiminde belirtilmelidir.

• [ @ use_ftp=] 'use_ftp'
  Specifies the use of FTP instead of the regular protocol to retrieve snapshots.use_ftp is nvarchar(5), with a default of FALSE.

• [ @ publication_type =] publication_type
  Specifies the replication type of the publication.publication_type is a tinyint with a default of 0.If 0, publication is a transaction type.If 1, publication is a snapshot type.If 2, publication is a merge type.

• [ @ dts_package_name=] 'dts_package_name'
  Specifies the name of the DTS package.dts_package_name is a sysname with a default of NULL.Örneğin, bir paket belirtin, DTSPub_Package, parametre olacak @dts_package_name = N'DTSPub_Package'.

• [ @ dts_package_password=] 'dts_package_password'
  Specifies the password on the package, if there is one.dts_package_password is sysname with a default of NULL, which means a password is not on the package.

  Not

  Size bir parola belirtmelisiniz dts_package_name belirtilir.

• [ @ dts_package_location=] 'dts_package_location'
  Specifies the package location.dts_package_location is a nvarchar(12), with a default of subscriber.Paket konumunu olabilir dağıtımcı veya abone.

• [ ayrılmış @=] '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_activation dışında bir değere false generate bir hata.

• [ @ 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_name herhangi bir boş olmayan değere üretmek bir hata.

• [ @ job_name=] 'job_name'
  Is the name of an existing agent job.job_name is sysname, with a default value of NULL.Bu parametre yalnızca olur ne zaman belirtilen abonelik (varsayılan) yeni oluşturulan iş yerine varolan bir işi kullanarak eşitlenir.Üye değilseniz, sysadmin sabit sunucu rolü, belirttiğiniz gerekir job_login ve job_password , belirttiğiniz job_name.

• [ @ job_login=] 'job_login'
  Is the login for the Windows account under which the agent runs.job_login is nvarchar(257), with no default.Bu Windows hesabı her zaman için abone Aracısı bağlantıları için kullanılır.

• [ @ job_password=] 'job_password'
  Is the password for the Windows account under which the agent runs.job_password is sysname, with no default.

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

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (başarısız)

Açıklamalar

sp_addpullsubscription_agent anlık görüntü çoğaltması çoğaltması ç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'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

İzinler

Yalnızca üyeleri sysadmin sabit sunucu rolü veya db_owner sabit veritabanı rolü olabilir yürütmek sp_addpullsubscription_agent.

Ayrıca bkz.

Görevler

Başvuru

Kavramlar