共用方式為

sp_change_log_shipping_secondary_database （Transact-SQL）

  • 發行項

適用於：SQL Server

變更輔助資料庫設定。

Transact-SQL 語法慣例

語法

sp_change_log_shipping_secondary_database
    [ @secondary_database = ] N'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 ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
[ ; ]

引數

[ @secondary_database = ] N'secondary_database'

輔助伺服器上的資料庫名稱。 @secondary_database為 sysname，沒有預設值。

[ @restore_delay = ] restore_delay

輔助伺服器在還原指定的備份檔之前等候的時間量，以分鐘為單位。 @restore_delay為 int，預設值為 0，且不可為 NULL。

[ @restore_all = ] restore_all

如果設定為 1，則輔助伺服器會在還原作業執行時還原所有可用的事務歷史記錄備份。 否則，它會在還原一個檔案之後停止。 @restore_all是位，而且不能是 NULL。

[ @restore_mode = ] restore_mode

輔助資料庫的還原模式。 @restore_mode是位，而且不能是 NULL。

  • 0 = 使用 NORECOVERY還原記錄檔。
  • 1 = 使用 STANDBY還原記錄檔。

[ @disconnect_users = ] disconnect_users

如果設定為 1，則執行還原作業時，用戶會中斷與輔助資料庫的連線。 @disconnect_users是位，預設值為 0，而且不能是。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_transfer_size為 int，預設值為 NULL。

[ @restore_threshold = ] restore_threshold

在產生警示之前，允許在還原作業之間經過的分鐘數。 @restore_threshold為 int，而且不能為 NULL。

[ @threshold_alert = ] threshold_alert

超過還原閾值時要引發的警示。 @threshold_alert為 int，預設值為 14421。

[ @threshold_alert_enabled = ] threshold_alert_enabled

指定是否在超過@restore_threshold時引發警示。

  • 1 = 已啟用
  • 0 = 已停用。

@threshold_alert_enabled是位，而且不能是 NULL。

[ @history_retention_period = ] history_retention_period

保留歷程記錄的分鐘數長度。 @history_retention_period為 int，預設值為 1440。

[ @ignoreremotemonitor = ] ignoreremotemonitor

僅供參考之用。 不支援。 我們無法保證未來的相容性。

傳回碼值

0 (成功) 或 1 (失敗)。

結果集

無。

備註

sp_change_log_shipping_secondary_database 必須在輔助伺服器上從 master 資料庫執行。 此預存程式會執行下列步驟：

  1. 視需要變更記錄中的 log_shipping_secondary_database 設定。

  2. 必要時，使用提供的自變數，在輔助伺服器上變更 中的 log_shipping_monitor_secondary 本機監視器記錄。

權限

只有系統管理員固定伺服器角色的成員才能執行此程式。

範例

此範例說明如何使用 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;

相關內容