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' ]
[ ; ]

引数

[ @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'

監視サーバーへのアクセスに使用するアカウントのパスワード。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

ありません。

解説

sp_change_log_shipping_secondary_primary は、セカンダリ サーバー上の master データベースから実行する必要があります。 このストアド プロシージャでは次の処理が行われます。

  1. 必要に応じて設定を log_shipping_secondary 変更します。

  2. モニター・サーバーがセカンダリ・サーバーと異なる場合、必要に応じて、指定された引数を使用してモニター・サーバー上のモニター・レコード log_shipping_monitor_secondary を変更します。

アクセス許可

このプロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーだけです。