• 项目

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。