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。