sp_change_subscription_properties (Transact-SQL)
更新提取訂閱的資訊。這個預存程序執行於訂閱資料庫的訂閱者端。
語法
sp_change_subscription_properties [ @publisher = ] 'publisher'
, [ @publisher_db = ] 'publisher_db'
, [ @publication = ] 'publication'
, [ @property = ] 'property'
, [ @value = ] 'value'
[ , [ @publication_type = ] publication_type ]
引數
- [ @publisher=] 'publisher'
這是發行者的名稱。publisher 是 sysname,沒有預設值。
- [ @publisher_db=] 'publisher_db'
這是發行者資料庫的名稱。publisher_db 是 sysname,沒有預設值。
- [ @publication=] 'publication'
這是發行集的名稱。publication 是 sysname,沒有預設值。
- [ @property=] 'property'
這是要變更的屬性。property 是 sysname。
- [ @value=] 'value'
這是屬性的新值。value 是 nvarchar(1000),沒有預設值。
[ @publication_type = ] publication_type
指定發行集的複寫類型。publication_type 是 int,它可以是下列值之一。值 發行集類型 0
交易式
1
快照集
2
合併式
NULL (預設值)
複寫決定了發行集的類型。由於預存程序必須查看多份資料表,因此,相較於提供確實的發行集類型,這個選項會比較慢。
下表描述發行項的屬性及這些屬性的值。
屬性
值
描述
alt_snapshot_folder
指定快照集替代資料夾的位置。如果設為 NULL,便會從發行者所指定的預設位置中,收取快照集檔案。
distrib_job_login
用來執行代理程式之 Microsoft Windows 帳戶的登入。
distrib_job_password
用來執行代理程式之 Windows 帳戶的密碼。
distributor_login
散發者登入。
distributor_password
散發者密碼。
distributor_security_mode
1
當連接到散發者時,使用 Windows 驗證。
0
當連接到散發者時,使用 SQL Server 驗證。
dts_package_name
指定 SQL Server 2000 Data Transformation Services (DTS) 封裝的名稱。只有在發行集是交易式或快照式時,才能指定這個值。
dts_package_password
指定封裝的密碼。dts_package_password 是 sysname,預設值是 NULL,指定密碼屬性維持不變。
附註:
DTS 封裝必須有密碼。
只有在發行集是交易式或快照式時,才能指定這個值。
dts_package_location
DTS 封裝的儲存位置。只有在發行集是交易式或快照式時,才能指定這個值。
dynamic_snapshot_location
指定儲存快照集檔案的資料夾路徑。只有在發行集是合併式發行集時,才能指定這個值。
ftp_address
只是為了與舊版相容。
ftp_login
只是為了與舊版相容。
ftp_password
只是為了與舊版相容。
ftp_port
只是為了與舊版相容。
hostname
連接到發行者時所用的主機名稱。
internet_login
當利用基本驗證來連接到主控 Web 同步處理的 Web 伺服器時,合併代理程式所用的登入。
internet_password
當利用基本驗證來連接到主控 Web 同步處理的 Web 伺服器時,合併代理程式所用的密碼。
internet_security_mode
1
Web 同步處理使用 Windows 整合式驗證。我們建議您搭配 Web 同步處理來使用基本驗證。如需詳細資訊,請參閱<設定 Web 同步處理>。
0
Web 同步處理使用基本驗證。
附註:
Web 同步處理需要 Web 伺服器的 SSL 連接。
internet_timeout
Web 同步處理要求到期之前的時間長度 (以秒為單位)。
internet_url
代表 Web 同步處理之複寫接聽程式位置的 URL。
merge_job_login
用來執行代理程式之 Windows 帳戶的登入。
merge_job_password
用來執行代理程式之 Windows 帳戶的密碼。
publisher_login
發行者登入。只支援訂閱合併式發行集變更 publisher_login。
publisher_password
發行者密碼。只支援訂閱合併式發行集變更 publisher_password。
publisher_security_mode
1
當連接到發行者時,使用 Windows 驗證。只支援訂閱合併式發行集變更 publisher_security_mode。
0
當連接到發行者時,使用 SQL Server 驗證。
use_ftp
true
利用 FTP 而不是正規通訊協定來擷取快照集。
false
利用正規通訊協定來擷取快照集。
use_web_sync
true
啟用 Web 同步處理。
false
停用 Web 同步處理。
working_directory
在利用檔案傳輸通訊協定 (FTP) 來傳送快照集檔案時,用來暫時儲存發行集的資料檔和結構描述檔的工作目錄名稱。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_change_subscription_properties 用於所有類型的複寫中。
sp_change_subscription_properties 用於提取訂閱。
如果是 Oracle 發行者,便會忽略 publisher_db,因為 Oracle 只允許每個伺服器執行個體有一個資料庫。
權限
只有系統管理員 (sysadmin) 固定伺服器角色或 db_owner 固定資料庫角色的成員,才能夠執行 sp_change_subscription_properties。
請參閱
參考
sp_addmergepullsubscription (Transact-SQL)
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription (Transact-SQL)
sp_addpullsubscription_agent (Transact-SQL)
系統預存程序 (Transact-SQL)
其他資源
How to: View and Modify Pull Subscription Properties (Replication Transact-SQL Programming)