sp_change_log_shipping_secondary_database (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server

Меняет настройки базы данных-получателя.

Синтаксис

  
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 бит и не может иметь значение NULL.

[ @restore_mode = ] 'restore_mode' Режим восстановления для базы данных-получателя.

0 = восстановить журнал с аргументом NORECOVERY;

1 = восстановление журнала с аргументом STANDBY.

восстановление имеет битовое значение и не может иметь значение NULL.

[ @disconnect_users = ] 'disconnect_users' Если задано значение 1, пользователи отключены от базы данных-получателя при выполнении операции восстановления. Значение по умолчанию: 0. disconnect_users бит и не может иметь значение NULL.

[ @block_size = ] 'block_size' Размер в байтах, используемый в качестве размера блока для устройства резервного копирования. block_size имеет значение по умолчанию -1.

[ @buffer_count = ] 'buffer_count' Общее количество буферов, используемых операцией резервного копирования или восстановления. buffer_count включено со значением по умолчанию -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 с значением по умолчанию 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 будет использоваться, если он не указан.

Значения кода возврата

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;

См. также

Сведения о доставке журналов (SQL Server)
Системные хранимые процедуры (Transact-SQL)

Share via