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 обновить параметры базы данных-получателя для базы данных LogShipAdventureWorks2008R2.
EXEC master.dbo.sp_change_log_shipping_secondary_database
@secondary_database = 'LogShipAdventureWorks2008R2'
, @restore_delay = 0
, @restore_all = 1
, @restore_mode = 0
, @disconnect_users = 0
, @threshold_alert = 14420
, @threshold_alert_enabled = 1
, @history_retention_period = 14420
См. также