sp_change_log_shipping_secondary_primary (Transact-SQL)

セカンダリ データベースの設定を変更します。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_change_log_shipping_secondary_primary
[ @primary_server = ] 'primary_server',
[ @primary_database = ] 'primary_database',
[, [ @backup_source_directory = ] 'backup_source_directory']
[, [ @backup_destination_directory = ] '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'
    ログ配布構成における、Microsoft SQL Server データベース エンジンのプライマリ インスタンスの名前を指定します。primary_server のデータ型は sysname で、NULL 値は許容されません。
  • [ @primary_database = ] 'primary_database'
    プライマリ サーバーのデータベースの名前を指定します。primary_database のデータ型は sysname で、既定値はありません。
  • [ @backup_source_directory = ] 'backup_source_directory'
    プライマリ サーバーからのトランザクション ログ バックアップ ファイルを格納するディレクトリを指定します。backup_source_directory のデータ型は nvarchar(500) で、NULL 値は許可されません。
  • [ @backup_destination_directory = ] 'backup_destination_directory'
    バックアップ ファイルのコピー先となるセカンダリ サーバーのディレクトリを指定します。backup_destination_directory のデータ型は nvarchar(500) で、NULL 値は許可されません。
  • [ @file_retention_period = ] 'file_retention_period'
    履歴を保持する期間を分単位で指定します。history_retention_period のデータ型は int で、既定値は NULL です。何も指定しない場合は、値 14420 が使用されます。
  • [ @monitor_server_security_mode = ] 'monitor_server_security_mode'
    監視サーバーへの接続に使用されるセキュリティ モード。

    1 = Microsoft Windows 認証。

    0 = Microsoft SQL Server 認証。monitor_server_security_mode のデータ型は bit で、NULL 値は許可されません。

  • [ @monitor_server_login = ] 'monitor_server_login'
    監視サーバーへのアクセスに使用するアカウントのユーザー名を指定します。
  • [ @monitor_server_password = ] 'monitor_server_password'
    監視サーバーへのアクセスに使用するアカウントのパスワードを指定します。

結果セット

なし

解説

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

  1. 必要に応じて、log_shipping_secondary レコードの設定を変更する。
  2. 監視サーバーがセカンダリ サーバーとは異なる場合、必要に応じて、指定された引数を監視サーバー上の log_shipping_monitor_secondary にある監視レコードに適用し、このレコードを変更する。

権限

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

戻り値

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

参照

関連項目

システム ストアド プロシージャ (Transact-SQL)

その他の技術情報

ログ配布
ログ配布テーブルとストアド プロシージャ

ヘルプおよび情報

SQL Server 2005 の参考資料の入手