sp_changepublication_snapshot (Transact-SQL)

  • 项目

更新日期： 2006 年 12 月 12 日

更改指定发布的快照代理的属性。此存储过程在发布服务器的发布数据库中执行。

ms178574.security(zh-cn,SQL.90).gif安全说明：
使用远程分发服务器配置发布服务器时，为所有参数（包括 job_login 和 job_password）提供的值都将作为纯文本发送到分发服务器。在执行此存储过程之前，应该对发布服务器及其远程分发服务器之间的连接进行加密。有关详细信息，请参阅加密与 SQL Server 的连接。

主题链接图标Transact-SQL 语法约定

语法

sp_changepublication_snapshot [ @publication= ] 'publication'
    [ , [ @frequency_type= ] frequency_type ]
    [ , [ @frequency_interval= ] frequency_interval ]
    [ , [ @frequency_subday= ] frequency_subday ]
    [ , [ @frequency_subday_interval= ] frequency_subday_interval ]
    [ , [ @frequency_relative_interval= ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor= ] frequency_recurrence_factor ]
    [ , [ @active_start_date= ] active_start_date ]
    [ , [ @active_end_date= ] active_end_date ]
    [ , [ @active_start_time_of_day= ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day= ] active_end_time_of_day ]
    [ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher = ] 'publisher' ]

参数

  • [ @publication = ] 'publication'
    发布的名称。publication 的数据类型为 sysname，无默认值。

  • [ @frequency_type=] frequency_type
    计划代理的频率。frequency_type 的数据类型为 int，可以是下列值之一。

    值 说明

    1

    一次

    2

    按需

    4

    每天

    8

    每周

    16

    每月

    32

    “每月”选项相关

    64

    自动启动

    128

    重复执行

    NULL（默认值）

     

  • [ @frequency_interval=] frequency_interval
    代理运行的天数。frequency_interval 的数据类型为 int，可以是下列值之一。

    值 说明

    1

    星期日

    2

    星期一

    3

    星期二

    4

    星期三

    5

    星期四

    6

    星期五

    7

    星期六

    8

    日

    9

    工作日

    10

    周末

    NULL（默认值）

     

  • [ @frequency_subday=] frequency_subday
    freq_subday_interval 的单位。frequency_subday 的数据类型为 int，可以是下列值之一。

    Value 说明

    1

    一次

    2

    秒

    4

    分钟

    8

    小时

    NULL（默认值）

     
  • [ @frequency_subday_interval=] frequency_subday_interval
    frequency_subday 的间隔。frequency_subday_interval 的数据类型为 int，默认值为 NULL。
  • [ @frequency_relative_interval=] frequency_relative_interval
    快照代理的运行日期。frequency_relative_interval 的数据类型为 int，默认值为 NULL。
  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    frequency_type 使用的重复因子。frequency_recurrence_factor 的数据类型为 int，默认值为 0。
  • [ @active_start_date=] active_start_date
    第一次计划快照代理时的日期，格式为 YYYYMMDD。active_start_date 的数据类型为 int，默认值为 NULL。
  • [ @active_end_date=] active_end_date
    停止计划快照代理时的日期，格式为 YYYYMMDD。active_end_date 的数据类型为 int，默认值为 NULL。
  • [ @active_start_time_of_day=] active_start_time_of_day
    第一次计划快照代理时的时间，格式为 HHMMSS。active_start_time_of_day 的数据类型为 int，默认值为 NULL。
  • [ @active_end_time_of_day=] active_end_time_of_day
    停止计划快照代理时的时间，格式为 HHMMSS。active_end_time_of_day 的数据类型为 int，默认值为 NULL。
  • [ @snapshot_job_name = ] 'snapshot_agent_name'
    现有快照代理作业的名称（如果正在使用现有作业）。snapshot_agent_name 的数据类型为 nvarchar(100)，默认值为 NULL。

  • [ @publisher_security_mode= ] publisher_security_mode
    连接到发布服务器时代理所使用的安全模式。publisher_security_mode 的数据类型为 smallint，默认值为 NULL。0 指定 SQL Server 身份验证，1 指定 Windows 身份验证。对于非 SQL Server 发布服务器，必须将该值指定为 0。

    ms178574.security(zh-cn,SQL.90).gif安全说明：
    请尽可能使用 Windows 身份验证。
  • [ @publisher_login= ] 'publisher_login'
    连接到发布服务器时所用的登录名。publisher_login 的数据类型为 sysname，默认值为 NULL。如果 publisher_security_mode 为 0，则必须指定 publisher_login。如果 publisher_login 为 NULL 并且 publisher*_security_mode* 为 1，则在连接到发布服务器时，使用在 job_login 中指定的 Windows 帐户。

  • [ @publisher_password= ] 'publisher_password'
    用于连接到发布服务器的密码。publisher_password 的数据类型为 sysname，默认值为 NULL。

    ms178574.security(zh-cn,SQL.90).gif安全说明：
    不要使用空密码。请使用强密码。 如果可能，请在运行时提示用户输入安全凭据。如果将凭据存储在脚本文件中，则必须确保文件的安全性以防止未经授权的访问。
  • [ @job_login= ] 'job_login'
    用于运行代理的 Windows 帐户的登录名。job_login 的数据类型为 nvarchar(257)，默认值为 NULL。该 Windows 帐户始终用于代理与分发服务器的连接。创建新的快照代理作业时，必须提供此参数。对于非 SQL Server 发布服务器来说，这是无法更改的。

  • [ @job_password= ] 'job_password'
    用于运行代理的 Windows 帐户的密码。job_password 的数据类型为 sysname，默认值为 NULL。创建新的快照代理作业时，必须提供此参数。

    ms178574.security(zh-cn,SQL.90).gif安全说明：
    如果可能，请在运行时提示用户输入安全凭据。如果将凭据存储在脚本文件中，则必须确保文件的安全性以防止未经授权的访问。

  • [ @publisher = ] 'publisher'
    指定一个非 SQL Server 发布服务器。publisher 的数据类型为 sysname，默认值为 NULL。

    ms178574.note(zh-cn,SQL.90).gif注意：
    在 SQL Server 发布服务器中创建快照代理时，不应使用 publisher。

返回代码值

0（成功）或 1（失败）

备注

sp_changepublication_snapshot 用于快照复制、事务复制和合并复制。

权限

只有 sysadmin 固定服务器角色或 db_owner 固定数据库角色的成员才能执行 sp_changepublication_snapshot。

请参阅

参考

sp_addpublication_snapshot (Transact-SQL)
系统存储过程 (Transact-SQL)

其他资源

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
更改发布和项目属性

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

2006 年 12 月 12 日
更新的内容：
  • 更新了关于 @frequency_type 和 @frequency_interval 参数的信息。