sp_replicationdboption (Transact-SQL)
適用於:SQL Server Azure SQL 受控執行個體
設定指定資料庫的復寫資料庫選項。 此預存程式會在任何資料庫的發行者或訂閱者端執行。
語法
sp_replicationdboption
[ @dbname = ] N'dbname'
, [ @optname = ] N'optname'
, [ @value = ] { N'true' | N 'false' }
[ , [ @ignore_distributor = ] ignore_distributor ]
[ , [ @from_scripting = ] from_scripting ]
[ ; ]
引數
[ @dbname = ] N'dbname'
正在設定複寫資料庫選項的資料庫。 @dbname為 sysname,沒有預設值。
[ @optname = ] N'optname'
要啟用或停用的複寫資料庫選項。 @optname為 sysname,而且可以是下列其中一個值。
值 | Description |
---|---|
merge publish |
資料庫可用於合併式發行集。 |
publish |
資料庫可用於其他類型的發行集。 |
subscribe |
資料庫是訂用帳戶資料庫。 |
sync with backup |
資料庫已啟用協調備份。 如需詳細資訊,請參閱 啟用事務複製的協調備份。 |
[ @value = ] { N'true' |N 'false' }
是否要啟用或停用指定的複寫資料庫選項。 @value為 sysname,沒有預設值。 當此值是 false
且 @optname 為 merge publish
時,也會卸除合併發行資料庫的訂閱。
[ @ignore_distributor = ] ignore_distributor
指出是否執行這個預存程式,而不連接到散發者。 @ignore_distributor為 bit,預設值為 0
。
如果
0
為 ,則散發者應該以發行資料庫的新狀態連線並更新。1
只有當散發者無法存取,而且sp_replicationdboption
正用來停用發行時,才應該指定 。
[ @from_scripting = ] from_scripting
僅供參考之用。 不支援。 我們無法保證未來的相容性。
傳回碼值
0
(成功) 或 1
(失敗)。
備註
sp_replicationdboption
用於快照式複寫、事務複製和合併式複寫。
此程式會根據指定的選項,建立或卸除特定的複寫系統數據表、安全性帳戶等等。 設定系統數據表中對應的 is_published
(交易式或快照式複寫)、 is_merge_published
(合併式複寫)或 is_distributor
位,並建立必要的系統 master.databases
數據表。
若要停用發行,發行集資料庫必須處於在線狀態。 如果發行集資料庫存在資料庫快照集,必須先卸除該快照集,才能停用發行。 資料庫快照集是資料庫的唯讀脫機複本,與復寫快照集無關。 如需詳細資訊,請參閱資料庫快照集(SQL Server)。
權限
只有系統管理員固定伺服器角色的成員才能執行 sp_replicationdboption
。