Поделиться через

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

  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;

Связанный контент