sp_change_subscription_properties (Transact-SQL)

更新请求订阅信息。 此存储过程在订阅服务器的订阅数据库中执行。

主题链接图标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

使用 Windows 集成身份验证进行 Web 同步。 建议您将基本身份验证与 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