添加新的代理程序到訂閱服務(wù)器數(shù)據(jù)庫。此存儲(chǔ)過程在訂閱服務(wù)器的訂閱數(shù)據(jù)庫上執(zhí)行。
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_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 ]
[ , [ @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' ]
[@publisher = ] 'publisher'
是發(fā)布服務(wù)器名。publisher 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@publisher_db = ] 'publisher_db'
是發(fā)布服務(wù)器數(shù)據(jù)庫名。publisher_db 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@publication = ] 'publication'
是發(fā)布名。publication 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@subscriber = ] 'subscriber'
是訂閱服務(wù)器名。subscriber 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@subscriber_db = ] 'subscriber_db'
是訂閱數(shù)據(jù)庫名稱。subscriber_db 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@subscriber_security_mode = ] subscriber_security_mode
是在同步時(shí)用于連接到訂閱服務(wù)器的安全模式。subscriber_security_mode 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 NULL。0 指定 Microsoft SQL Server 身份驗(yàn)證。1 指定 Microsoft Windows 身份驗(yàn)證。
[@subscriber_login = ] 'subscriber_login'
是在同步時(shí)用于連接到訂閱服務(wù)器的訂閱服務(wù)器登錄。subscriber_login 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@subscriber_password = ] 'subscriber_password'
是訂閱服務(wù)器密碼。如果 subscriber_security_mode 設(shè)置為 0,則必需subscriber_password。subscriber_password 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。如果使用訂閱服務(wù)器密碼,則將自動(dòng)加密該密碼。
[@distributor = ] 'distributor'
是分發(fā)服務(wù)器名。distributor 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置由 publisher 指定。
[ @distribution_db = ] 'distribution_db'
是分發(fā)服務(wù)器名。distribution_db 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@distributor_security_mode = ] distributor_security_mode
是在同步時(shí)用于連接到分發(fā)服務(wù)器的安全模式。distributor_security_mode 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。0 指定 Microsoft SQL Server 身份驗(yàn)證。1 指定 Microsoft Windows 身份驗(yàn)證。
[@distributor_login = ] 'distributor_login'
是在同步時(shí)用于連接到分發(fā)服務(wù)器的分發(fā)服務(wù)器登錄。如果 distributor_security_mode 設(shè)置為 0,則需要 distributor_login。distributor_login 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 sa。
[@distributor_password = ] 'distributor_password'
是分發(fā)服務(wù)器密碼。如果 distributor_security_mode 設(shè)置為 0,則必需 distributor_password。distributor_password 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@optional_command_line = ] 'optional_command_line'
是提供給分發(fā)代理程序的可選命令提示符。例如,-DefinitionFile C:\Distdef.txt 或 -CommitBatchSize 10。optional_command_line 的數(shù)據(jù)類型為 nvarchar(4000),默認(rèn)設(shè)置為空字符串。
[@frequency_type = ] frequency_type
是調(diào)度分發(fā)代理程序所用的頻率。frequency_type 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1 | 一次 |
2(默認(rèn)值) | 按需 |
4 | 每天 |
8 | 每周 |
16 | 每月 |
32 | 每月相對信息 |
64 | 自動(dòng)啟動(dòng) |
124 | 反復(fù)出現(xiàn) |
[@frequency_interval = ] frequency_interval
是應(yīng)用于 frequency_type 所設(shè)置頻率的值。frequency_interval 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 1。
[@frequency_relative_interval = ] frequency_relative_interval
是分發(fā)代理程序運(yùn)行的日期。當(dāng) frequency_type 設(shè)置為 32(每月相對信息)時(shí)使用該參數(shù)。frequency_relative_interval 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1(默認(rèn)值) | 第一個(gè) |
2 | 秒 |
4 | 第三個(gè) |
8 | 第四個(gè) |
16 | 最后一個(gè) |
[@frequency_recurrence_factor = ] frequency_recurrence_factor
是 frequency_type 使用的重復(fù)因子。frequency_recurrence_factor 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 1。
[@frequency_subday = ] frequency_subday
是在定義的周期內(nèi)重新調(diào)度的頻率。frequency_subday 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1(默認(rèn)值) | 一次 |
2 | 秒 |
4 | 分鐘 |
8 | 小時(shí) |
[@frequency_subday_interval = ] frequency_subday_interval
是 frequency_subday 的間隔。frequency_subday_interval 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 1。
[@active_start_time_of_day = ] active_start_time_of_day
是第一次調(diào)度分發(fā)代理程序的時(shí)間,格式為 HHMMSS。active_start_time_of_day 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。
[@active_end_time_of_day = ] active_end_time_of_day
是停止調(diào)度分發(fā)代理程序的時(shí)間,格式為 HHMMSS。active_end_time_of_day 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。
[@active_start_date = ] active_start_date
是第一次調(diào)度分發(fā)代理程序的日期,格式為 YYYYMMDD。active_start_date 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。
[@active_end_date = ] active_end_date
是停止調(diào)度分發(fā)代理程序的日期,格式為 YYYYMMDD。active_end_date 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。
[@distribution_jobid = ] distribution_jobid OUTPUT
是該作業(yè)的分發(fā)代理程序 ID。distribution_jobid 的數(shù)據(jù)類型為 binary(16),默認(rèn)設(shè)置為 NULL,并且該參數(shù)是 OUTPUT 參數(shù)。
[@encrypted_distributor_password = ] encrypted_distributor_password
僅限內(nèi)部使用。
[@enabled_for_syncmgr = ] 'enabled_for_syncmgr'
表示是否可以通過 Microsoft 同步管理器對訂閱進(jìn)行同步處理。enabled_for_syncmgr 的數(shù)據(jù)類型為 nvarchar(5),默認(rèn)設(shè)置為 FALSE。如果是 false,則表示該訂閱沒有注冊到同步管理器上。如果是 true,則表示該訂閱已注冊到同步管理器上,可以在不啟動(dòng) SQL Server 企業(yè)管理器的情況下進(jìn)行同步處理。
[@ftp_address = ] 'ftp_address'
僅為保持向后兼容性。
[@ftp_port = ] ftp_port
僅為保持向后兼容性。
[@ftp_login = ] 'ftp_login'
僅為保持向后兼容性。
[@ftp_password = ] 'ftp_password'
僅為保持向后兼容性。
[@alt_snapshot_folder = ] 'alternate_snapshot_folder'
指定快照的備用文件夾的位置。alternate_snapshot_folder 的數(shù)據(jù)類型為 nvarchar(255),默認(rèn)設(shè)置為 NULL。
[@working_directory = ] 'working_director'
是用于存儲(chǔ)發(fā)布的數(shù)據(jù)和架構(gòu)文件的工作目錄名。working_directory 的數(shù)據(jù)類型為 nvarchar(255),默認(rèn)設(shè)置為 NULL。應(yīng)將該名稱指定為 UNC 格式。
[@use_ftp = ] 'use_ftp'
指定使用 FTP 而不使用常規(guī)協(xié)議檢索快照。use_ftp 的數(shù)據(jù)類型為 nvarchar(5),默認(rèn)設(shè)置為 FALSE。
[@publication_type = ] publication_type
指定發(fā)布的復(fù)制類型。publication_type 的數(shù)據(jù)類型為 tinyint,默認(rèn)設(shè)置為 0。如果是 0,則發(fā)布是事務(wù)類型。如果是 1,則表示發(fā)布是快照類型。如果是 2,則表示發(fā)布是合并類型。
[@dts_package_name = ] 'dts_package_name'
指定 DTS 包的名稱。dts_package_name 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。例如,若要指定 DTSPub_Package 包,則該參數(shù)將是 @dts_package_name = N'DTSPub_Package'。
[@dts_package_password = ] 'dts_package_password'
指定如果有密碼,則密碼在包上。dts_package_password 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL,表示密碼不在包上。
[@dts_package_location = ] 'dts_package_location'
指定包的位置。dts_package_location 的數(shù)據(jù)類型為 nvarchar(12),默認(rèn)設(shè)置為 SUBSCRIBER。包的位置可以是 distributor 或 subscriber。
[@reserved = ] 'reserved'
僅限內(nèi)部使用。
[@offloadagent = ] 'remote_agent_activation'
指定可以遠(yuǎn)程地激活代理程序。remote_agent_activation 的數(shù)據(jù)類型為 bit,默認(rèn)設(shè)置為 0。0 指定不能遠(yuǎn)程地激活代理程序。而 1 指定將遠(yuǎn)程地激活代理程序,并且是在 remote_agent_server_name 所指定的遠(yuǎn)程計(jì)算機(jī)上激活。
[@offloadserver = ] 'remote_agent_server_name'
指定用于遠(yuǎn)程激活的服務(wù)器的網(wǎng)絡(luò)名。remote_agent_server_name 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@job_name = ] 'job_name'
僅限內(nèi)部使用。
0(成功)或 1(失敗)
sp_addpullsubscription_agent 用于快照復(fù)制和事務(wù)復(fù)制。
只有 sysadmin 固定服務(wù)器角色成員或 db_owner 固定數(shù)據(jù)庫角色成員才能執(zhí)行 sp_addpullsubscription_agent。
相關(guān)文章