將請(qǐng)求訂閱的代理程序添加到合并發(fā)布。此存儲(chǔ)過(guò)程在訂閱服務(wù)器的訂閱數(shù)據(jù)庫(kù)上執(zhí)行。
sp_addmergepullsubscription_agent [ [ @name = ] 'name' ]
,
[ @publisher = ] 'publisher'
,
[ @publisher_db = ] 'publisher_db'
,
[ @publication = ] 'publication '
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] 'publisher_login' ]
[ , [ @publisher_password = ] 'publisher_password' ]
[ , [ @publisher_encrypted_password = ] publisher_encrypted_password ]
[ , [ @subscriber = ] 'subscriber' ]
[ , [ @subscriber_db = ] 'subscriber_db' ]
[ , [ @subscriber_security_mode = ] subscriber_security_mode ]
[ , [ @subscriber_login = ] 'subscriber_login' ]
[ , [ @subscriber_password = ] 'subscriber_password' ]
[ , [ @distributor = ] 'distributor' ]
[ , [ @distributor_security_mode = ] distributor_security_mode ]
[ , [ @distributor_login = ] 'distributor_login' ]
[ , [ @distributor_password = ] 'distributor_password' ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @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 ]
[ , [ @optional_command_line = ] 'optional_command_line' ]
[ , [ @merge_jobid = ] merge_jobid ]
[ , [ @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' ]
[ , [ @reserved= ] 'reserved' ]
[ , [ @use_interactive_resolver = ] 'use_interactive_resolver' ]
[ , [ @offloadagent = ] 'remote_agent_activation' ]
[ , [ @offloadserver = ] 'remote_agent_server_name' ]
[ , [ @job_name = ] 'job_name' ]
[ , [ @dynamic_snapshot_location= ] 'dynamic_snapshot_location' ]
[@name = ] 'name'
是代理程序名。name 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@publisher = ] 'publisher'
是發(fā)布服務(wù)器名。publisher 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@publisher_db = ] 'publisher_db'
是發(fā)布服務(wù)器數(shù)據(jù)庫(kù)名。publisher_db 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@publication = ] 'publication'
是發(fā)布名。publication 的數(shù)據(jù)類型為 sysname,沒有默認(rèn)設(shè)置。
[@publisher_security_mode = ] publisher_security_mode
是在同步時(shí)用于連接到發(fā)布服務(wù)器的安全模式。publisher_security_mode 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 1。如果該設(shè)置為 0,則指定 SQL Server 身份驗(yàn)證。如果該設(shè)置為 1,則指定 Windows 身份驗(yàn)證。
[@publisher_login = ] 'publisher_login'
是在同步時(shí)用于連接到發(fā)布服務(wù)器的登錄。publisher_login 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@publisher_password = ] 'publisher_password'
是用于連接到發(fā)布服務(wù)器的密碼。publisher_password 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@publisher_encrypted_password = ] publisher_encrypted_password
指定是否以加密格式存儲(chǔ)密碼。publisher_encrypted_password 的數(shù)據(jù)類型為 bit,默認(rèn)設(shè)置為 0。
[@subscriber = ] 'subscriber'
是訂閱服務(wù)器名。subscriber 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@subscriber_db = ] 'subscriber_db'
是訂閱數(shù)據(jù)庫(kù)名稱。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。如果該設(shè)置為 0,則指定 SQL Server 身份驗(yàn)證。如果該設(shè)置為 1,則指定 Windows 身份驗(yàn)證。
[@subscriber_login = ] 'subscriber_login'
是在同步時(shí)用于連接到訂閱服務(wù)器的訂閱服務(wù)器登錄。如果將 subscriber_security_mode 設(shè)置為 0,則必需 subscriber_login。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,這表示發(fā)布服務(wù)器也是分發(fā)服務(wù)器。
[@distributor_security_mode = ] distributor_security_mode
是在同步時(shí)用于連接到分發(fā)服務(wù)器的安全模式。distributor_security_mode 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。0 指定 SQL Server 身份驗(yàn)證。1 指定 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è)置為 NULL。
[@distributor_password = ] 'distributor_password'
是分發(fā)服務(wù)器密碼。如果 distributor_security_mode 設(shè)置為 0,則必需 distributor_password。distributor_password 的數(shù)據(jù)類型為 sysname,默認(rèn)設(shè)置為 NULL。
[@encrypted_password = ] encrypted_password
指定是否加密分發(fā)服務(wù)器密碼。encrypted_password 的數(shù)據(jù)類型為 bit,默認(rèn)設(shè)置為 0。這用于生成復(fù)制腳本。
[@frequency_type = ] frequency_type
是調(diào)度合并代理程序所用的頻率。frequency_type 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1 | 一次 |
2 | 按需 |
4 | 每天 |
8 | 每周 |
16 | 每月 |
32 | 每月相對(duì)信息 |
64 | 自動(dòng)啟動(dòng) |
124 | 反復(fù)出現(xiàn) |
NULL(默認(rèn)值) |
[@frequency_interval = ] frequency_interval
是合并代理程序運(yùn)行的日期。frequency_interval 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1 | 星期日 |
2 | 星期一 |
3 | 星期二 |
4 | 星期三 |
5 | 星期四 |
6 | 星期五 |
7 | 星期六 |
8 | 天 |
9 | 工作日 |
10 | 周末 |
NULL(默認(rèn)值) |
[@frequency_relative_interval = ] frequency_relative_interval
是合并代理程序運(yùn)行的日期。當(dāng) frequency_type 設(shè)置為 32(每月相對(duì)信息)時(shí)使用該參數(shù)。frequency_relative_interval 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1 | 第一個(gè) |
2 | 秒 |
4 | 第三個(gè) |
8 | 第四個(gè) |
16 | 最后一個(gè) |
NULL(默認(rèn)值) |
[@frequency_recurrence_factor = ] frequency_recurrence_factor
是 frequency_type 使用的重復(fù)因子。frequency_recurrence_factor 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 0。
[@frequency_subday = ] frequency_subday
是在定義的周期內(nèi)重新調(diào)度的頻率。frequency_subday 的數(shù)據(jù)類型為 int,可以是下列值之一。
值 | 描述 |
---|---|
1 | 一次 |
2 | 秒 |
4 | 分鐘 |
8 | 小時(shí) |
NULL(默認(rèn)值) |
[@frequency_subday_interval = ] frequency_subday_interval
是 frequency_subday 的間隔。frequency_subday_interval 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 NULL。
[@active_start_time_of_day = ] active_start_time_of_day
是第一次調(diào)度合并代理程序的時(shí)間,格式為 HHMMSS。active_start_time_of_day 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 NULL。
[@active_end_time_of_day = ] active_end_time_of_day
是停止調(diào)度合并代理程序的時(shí)間,格式為 HHMMSS。active_end_time_of_day 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 NULL。
[@active_start_date = ] active_start_date
是第一次調(diào)度合并代理程序的日期,格式為 YYYYMMDD。active_start_date 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 NULL。
[@active_end_date = ] active_end_date
是停止調(diào)度合并代理程序的日期,格式為 YYYYMMDD。active_end_date 的數(shù)據(jù)類型為 int,默認(rèn)設(shè)置為 NULL。
[@optional_command_line = ] 'optional_command_line'
是提供給合并代理程序的可選命令提示符。例如,-DefinitionFile C:\Distdef.txt 或 -CommitBatchSize 10。optional_command_line 的數(shù)據(jù)類型為 nvarchar(255),默認(rèn)設(shè)置為 ''。
[@merge_jobid = ] merge_jobid
是作業(yè) ID 的輸出參數(shù)。merge_jobid 的數(shù)據(jù)類型為 binary(16),默認(rèn)設(shè)置為 NULL。
[@enabled_for_syncmgr = ] 'enabled_for_syncmgr'
指定能否通過(guò) Windows 同步管理器對(duì)訂閱進(jìn)行同步處理。enabled_for_syncmgr 的數(shù)據(jù)類型為 nvarchar(5),默認(rèn)設(shè)置為 FALSE。如果是 false,則表示該訂閱沒有注冊(cè)到同步管理器上。如果是 true,則表示該訂閱已注冊(cè)到同步管理器上,可以在不啟動(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。如果為 NULL,則將從發(fā)布服務(wù)器指定的默認(rèn)位置獲取快照文件。
[@working_directory = ] 'working_directory'
是在通過(guò) FTP 傳輸快照文件時(shí)用于臨時(shí)存儲(chǔ)發(fā)布的數(shù)據(jù)和架構(gòu)文件的工作目錄名。working_directory 的數(shù)據(jù)類型為 nvarchar(255),默認(rèn)設(shè)置為 NULL。
[@use_ftp = ] 'use_ftp'
指定使用 FTP 而是典型協(xié)議來(lái)檢索快照。use_ftp 的數(shù)據(jù)類型為 nvarchar(5),默認(rèn)設(shè)置為 FALSE。
[@reserved = ] 'reserved'
僅限內(nèi)部使用。
[@use_interactive_resolver = ] 'use_interactive_resolver' ]
使用交互式?jīng)_突解決程序解決所有允許交互解決的項(xiàng)目的沖突。use_interactive_resolver 的數(shù)據(jù)類型為 nvarchar(5),默認(rèn)設(shè)置為 FALSE。
[@offloadagent = ] 'remote_agent_activation'
指定可以遠(yuǎn)程激活代理程序。remote_agent_activation 的數(shù)據(jù)類型為 nvarchar(5),默認(rèn)設(shè)置為 FALSE。false 指定不能遠(yuǎn)程地激活代理程序。true 指定將遠(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)部使用。
[@dynamic_snapshot_location = ] 'dynamic_snapshot_location' ]
在使用動(dòng)態(tài)快照時(shí)將要讀取的快照文件所在的文件夾路徑。dynamic_snapshot_location 的數(shù)據(jù)類型為 nvarchar(260),默認(rèn)設(shè)置為 NULL。
0(成功)或 1(失敗)
sp_addmergepullsubscription_agent 用于合并復(fù)制,并使用與 sp_addsubsubscriber_agent 相似的功能。
只有 sysadmin 固定服務(wù)器角色成員或 db_owner 固定數(shù)據(jù)庫(kù)角色成員才能執(zhí)行 sp_addmergepullsubscription_agent。
相關(guān)文章