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
базы данных на сервере-получателе. Эта хранимая процедура выполняет следующие действия:
При необходимости изменяет параметры записей
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;