sp_change_log_shipping_primary_database (Transact-SQL)
變更主要資料庫設定。
.gif "主題連結圖示")
語法
sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory']
[, [ @backup_share = ] 'backup_share',
[, [ @backup_retention_period = ] 'backup_retention_period']
[, [ @monitor_server_security_mode = ] 'monitor_server_security_mode']
[, [ @monitor_server_login = ] 'monitor_server_login']
[, [ @monitor_server_password = ] 'monitor_server_password']
[, [ @backup_threshold = ] 'backup_threshold']
[, [ @threshold_alert = ] 'threshold_alert']
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled']
[, [ @history_retention_period = ] 'history_retention_period']
引數
- [ @database = ] 'database'
這是主要伺服器的資料庫名稱。primary_database 是 sysname，沒有預設值。
- [ @backup_directory = ] 'backup_directory'
這是主要伺服器備份資料夾的路徑。backup_directory 是 nvarchar(500)，沒有預設值，不能是 NULL。
- [ @backup_share = ] 'backup_share'
是主要伺服器備份目錄的網路路徑。backup_share 是 nvarchar(500)，沒有預設值，不能是 NULL。
- [ @backup_retention_period = ] 'backup_retention_period'
這是將記錄備份檔儲存在主要伺服器備份目錄中的時間 (以分鐘為單位)。backup_retention_period 是 int，沒有預設值，而且不能是 NULL。
[ @monitor_server_security_mode = ] 'monitor_server_security_mode'
用來連接到監視伺服器的安全性模式。1 = Windows 驗證。
0 = SQL Server 驗證。
monitor_server_security_mode 是 bit，不能是 NULL。
- [ @monitor_server_login = ] 'monitor_server_login'
這是用來存取監視伺服器之帳戶的使用者名稱。
- [ @monitor_server_password = ] 'monitor_server_password'
這是用來存取監視伺服器之帳戶的密碼。
- [ @backup_threshold = ] 'backup_threshold'
這是前次備份之後到產生 threshold_alert 錯誤之前的時間長度 (以分鐘為單位)。backup_threshold 是 int，預設值是 60 分。
- [ @threshold_alert = ] 'threshold_alert'
當超出備份臨界值時，所產生的警示。threshold_alert 是 int，不能是 NULL。
[ @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。若未指定，則使用 14420。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
無
備註
sp_change_log_shipping_primary_database 必須從主要伺服器的 master 資料庫中執行。這個預存程序會執行下列動作：
- 必要的話，變更 log_shipping_primary_database 記錄中的設定。
- 必要的話，利用提供的引數來變更主要伺服器的 log_shipping_monitor_primary 中之本機記錄。
- 如果監視伺服器不是主要伺服器，必要的話，利用提供的引數來變更監視伺服器的 log_shipping_monitor_primary 中的記錄。
權限
只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個程序。
範例
這個範例說明利用 sp_change_log_shipping_primary_database 來更新主要資料庫 AdventureWorks 的相關設定。
EXEC master.dbo.sp_change_log_shipping_primary_database
@database = N'AdventureWorks'
, @backup_directory = N'c:\LogShipping'
, @backup_share = N'\\tribeca\LogShipping'
, @backup_retention_period = 1440
, @backup_threshold = 60
, @threshold_alert = 0
, @threshold_alert_enabled = 1
, @history_retention_period = 1440
,@monitor_server_security_mode = 1
請參閱
參考
系統預存程序 (Transact-SQL)
log_shipping_primary_databases (Transact-SQL)