sp_change_log_shipping_secondary_database (Transact-SQL)

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

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

Синтаксические обозначения в 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'
  Определяет, будет ли выдано предупреждение, если превышено значение restore_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 на сервере-получателе. Эта хранимая процедура выполняет следующее.

1. При необходимости изменяет аргументы log_shipping_secondary_database.

2. При необходимости изменяет запись локального монитора в таблице 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;

См. также

Справочник

Системные хранимые процедуры (Transact-SQL)

Основные понятия

Сведения о доставке журналов (SQL Server)