通过

sp_change_log_shipping_secondary_primary（Transact-SQL）

适用范围：SQL Server

更改辅助数据库设置。

Transact-SQL 语法约定

语法

sp_change_log_shipping_secondary_primary
    [ @primary_server = ] 'primary_server' ,
    [ @primary_database = ] 'primary_database' ,
    [ , [ @backup_source_directory = ] N'backup_source_directory' ]
    [ , [ @backup_destination_directory = ] N'backup_destination_directory' ]
    [ , [ @file_retention_period = ] file_retention_period ]
    [ , [ @monitor_server_security_mode = ] monitor_server_security_mode ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

参数

[ @primary_server = ] 'primary_server'

日志传送配置中 SQL Server 数据库引擎的主要实例的名称。 @primary_server是 sysname，不能NULL。

[ @primary_database = ] 'primary_database'

主服务器上的数据库名称。 @primary_database为 sysname，无默认值。

[ @backup_source_directory = ] N'backup_source_directory'

存储主服务器的事务日志备份文件的目录。 @backup_source_directory 是 nvarchar（500）， 不能 NULL。

[ @backup_destination_directory = ] N'backup_destination_directory'

备份文件复制到的辅助服务器上的目录。 @backup_destination_directory 是 nvarchar（500）， 不能 NULL。

[ @file_retention_period = ] 'file_retention_period'

备份文件保留的时间长度（以分钟为单位）。 @file_retention_period为 int，默认值为 NULL. 如果不指定值，则使用值 14420。

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

用于连接到监视服务器的安全模式。

  • 1：Windows 身份验证;
  • 0：SQL Server 身份验证。

@monitor_server_security_mode为位，默认为 NULL.

[ @monitor_server_login = ] 'monitor_server_login'

用于访问监视服务器的帐户的用户名。

[ @monitor_server_password = ] 'monitor_server_password'

用于访问监视服务器的帐户的密码。

[ @monitor_connection_options = ] '<key_value_pairs>;}'

适用于：SQL Server 2025 （17.x） 预览版和更高版本

使用远程监视器时，以键值对的形式指定链接服务器连接的更多连接选项。 @monitor_connection_options 为 nvarchar（4000）， 默认值为 NULL.

下表列出了可用的连接选项：

Key 价值
Encrypt strict、mandatory、optional、true、false
TrustServerCertificate true、false、yes、no
ServerCertificate 文件系统上服务器证书的路径。 此长度上限为 260 个字符。
HostNameInCertificate 证书的主机名替代。 此长度上限为 255 个字符。

返回代码值

0（成功）或 1（失败）。

结果集

无。

注解

sp_change_log_shipping_secondary_primary 必须从 master 辅助服务器上的数据库运行。 此存储过程执行以下作：

  1. 根据需要更改设置 log_shipping_secondary 。

  2. 如果监视器服务器与辅助服务器不同，则根据需要使用提供的自变量更改监视服务器上的记录 log_shipping_monitor_secondary 。

权限

只有 sysadmin 固定服务器角色的成员才能运行此过程。

相关内容