sp_change_log_shipping_secondary_database (Transact-SQL)
變更次要資料庫設定。
語法
sp_change_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[, [ @restore_delay = ] 'restore_delay']
[, [ @restore_all = ] 'restore_all']
[, [ @restore_mode = ] 'restore_mode']
[, [ @disconnect_users = ] 'disconnect_users']
[, [ @block_size = ] 'block_size']
[, [ @buffer_count = ] 'buffer_count']
[, [ @max_transfer_size = ] 'max_transfer_size']
[, [ @restore_threshold = ] 'restore_threshold']
[, [ @threshold_alert = ] 'threshold_alert']
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled']
[, [ @history_retention_period = ] 'history_retention_period']
引數
- [ @restore_delay = ] 'restore_delay'
在還原給定的備份檔之前,次要伺服器等待的時間 (以分鐘為單位)。restore_delay 是 int,不能是 NULL。預設值是 0。
- [ @restore_all = ] 'restore_all'
如果設為 1,當執行還原作業時,次要伺服器會還原所有可用的交易記錄備份。否則,它會在還原一個檔案之後停止。restore_all 是 bit,不能是 NULL。
[ @restore_mode = ] 'restore_mode'
次要資料庫的還原模式。0 = 以 NORECOVERY 來還原記錄。
1 = 以 STANDBY 來還原記錄。
restore 是 bit,不能是 NULL。
- [ @disconnect_users = ] 'disconnect_users'
如果設為 1,當執行還原作業時,會從次要資料庫中斷使用者的連接。預設值 = 0。disconnect_users 是 bit,不能是 NULL。
- [ @block_size = ] 'block_size'
用來作為備份裝置區塊大小的大小 (以位元組為單位)。block_size 是 int,預設值是 -1。
- [ @buffer_count = ] 'buffer_count'
備份或還原作業所用的緩衝區總數。buffer_count 是 int,預設值是 -1。
- [ @max_transfer_size = ] 'max_transfer_size'
SQL Server 向備份裝置發出的最大輸入或輸出要求大小 (以位元組為單位)。max_transfersize 是 int,可以是 NULL。
- [ @restore_threshold = ] 'restore_threshold'
在產生警示之前,還原作業之間所能經歷的時間 (以分鐘為單位)。restore_threshold 是 int,不能是 NULL。
- [ @threshold_alert = ] 'threshold_alert'
這是在超出備份臨界值時,所產生的警示。threshold_alert 是 int,預設值是 14420。
- [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
指定在超出 backup_threshold 時,是否產生警示。1 = 已啟用;0 = 已停用。threshold_alert_enabled 是 bit,不能是 NULL。
- [ @history_retention_period = ] 'history_retention_period'
這是保留歷程記錄的時間長度 (以分鐘為單位)。history_retention_period 是 int。若未指定,則使用 1440。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
無
備註
sp_change_log_shipping_secondary_database 必須從次要伺服器的 master 資料庫中執行。這個預存程序會執行下列動作:
- 依照需要,變更 log_shipping_secondary_database 記錄中的設定。
- 必要的話,利用提供的引數來變更次要伺服器的 log_shipping_monitor_secondary 中之本機監視記錄。
權限
只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行這個程序。
範例
這個範例說明如何利用 sp_change_log_shipping_secondary_database 來更新 LogShipAdventureWorks 資料庫的次要資料庫參數。
EXEC master.dbo.sp_change_log_shipping_secondary_database
@secondary_database = 'LogShipAdventureWorks'
, @restore_delay = 0
, @restore_all = 1
, @restore_mode = 0
, @disconnect_users = 0
, @threshold_alert = 14420
, @threshold_alert_enabled = 1
, @history_retention_period = 14420