• 發行項

sp_replicationdboption (Transact-SQL)

設定指定資料庫的複寫資料庫選項。這個預存程序執行於任何資料庫的發行者端或訂閱者端。

主題連結圖示Transact-SQL 語法慣例

語法

sp_replicationdboption [ @dbname= ] 'db_name' 
        , [ @optname= ] 'optname' 
        , [ @value= ] 'value' 
    [ , [ @ignore_distributor= ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]

引數

  • [@dbname=] 'dbname'
    這是要設定複寫資料庫選項的資料庫。db_name 是 sysname，沒有預設值。

  • [@optname=] 'optname'
    這是要啟用或停用的複寫資料庫選項。optname 是 sysname，它可以是下列值之一。

    值

    描述

    merge publish

    可用於合併式發行集的資料庫。

    publish

    資料庫可用於其他類型的發行集。

    subscribe

    資料庫是訂閱資料庫。

    sync with backup

    啟用資料庫的協調備份。如需詳細資訊，請參閱＜如何：為交易式複寫啟用協調備份 (複寫 Transact-SQL 程式設計)＞。

  • [@value=] 'value'
    這是指要啟用或停用給定的複寫資料庫選項。value 是 sysname，它可以是 true 或 false。當這個值是 false 且 optname 是 merge publish 時，也會卸除合併發行資料庫的訂閱。

  • [@ignore_distributor=] ignore_distributor
    指出是否在未連接到散發者的情況之下，執行這個預存程序。ignore_distributor 是 bit，預設值是 0，表示散發者應該連接到發行資料庫，且應該用發行資料庫的新狀態來加以更新。只有在散發者無法存取且利用 sp_replicationdboption 來停用發行時，才應該指定 1 值。

  • [@from_scripting=] from_scripting
    僅供參考之用。不支援。我們無法保證未來的相容性。

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_replicationdboption 用於快照式複寫、交易式複寫和合併式複寫中。

隨著給定的選項而不同，這個程序會建立或卸除特定複寫系統資料表、安全性帳戶等。它會在 master.sysdatabases 系統資料表中設定對應的類別目錄位元，且會建立必要的系統資料表。

若要停用發行，發行集資料庫必須在線上。如果發行集資料庫的資料庫快照集存在，您必須先卸除它，才能停用發行。資料庫快照集是資料庫的唯讀離線複本，與複寫快照集無關。如需詳細資訊，請參閱＜資料庫快照集＞。

權限

只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行 sp_replicationdboption。