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

sp_add_log_shipping_secondary_database (Transact-SQL)

  • Статья

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

Значок ссылки на раздел Синтаксические обозначения Transact-SQL

Синтаксис

sp_add_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[ @primary_server = ] 'primary_server', 
[ @primary_database = ] 'primary_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']

Аргументы

  • [ @secondary_database = ] 'secondary_database'
    Имя базы данных-получателя. Аргумент secondary_database имеет тип sysname и не имеет значения по умолчанию.

  • [ @primary_server = ] 'primary_server'
    Имя первичного экземпляра Microsoft Компонент SQL Server Database Engine в конфигурации доставки журналов. Аргумент primary_server имеет тип sysname и не может иметь значение NULL.

  • [ @primary_database = ] 'primary_database'
    Имя базы данных на сервере-источнике. Аргумент primary_database имеет тип sysname и не имеет значения по умолчанию.

  • [ @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 и значение по умолчанию 14 420.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Указывает, формируется ли предупреждение, если превышается значение аргумента backup_threshold. При значении, равном единице (1), устанавливаемом по умолчанию, предупреждение будет инициировано. Аргумент threshold_alert_enabled имеет тип bit.

  • [ @history_retention_period = ] 'history_retention_period'
    Длительность времени в минутах, в течение которого сохраняется журнал. Аргумент history_retention_period имеет тип int и значение по умолчанию NULL. Если ничего не указано, используется значение 14 420.

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

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Отсутствует

Замечания

Хранимая процедура sp_add_log_shipping_secondary_database должна запускаться из базы данных master на сервере-получателе. Эта хранимая процедура выполняет следующее:

  1. Для инициализации данных о базе данных-источнике в доставке журналов на сервере-получателе перед выполнением этой хранимой процедуры должна вызываться процедура sp_add_log_shipping_secondary_primary.

  2. Добавляет запись о базе данных-получателе в таблицу log_shipping_secondary_databases, используя предоставленные аргументы.

  3. Добавляет запись о локальном мониторе в таблицу log_shipping_monitor_secondary на сервере-получателе, используя предоставленные аргументы.

  4. Если сервер мониторинга не совпадает с сервером-получателем, добавляет запись о мониторе в таблицу log_shipping_monitor_secondary на сервере мониторинга, используя предоставленные аргументы.

Разрешения

Эту процедуру могут выполнять только члены предопределенной роли сервера sysadmin.

Примеры

Следующий пример иллюстрирует использование хранимой процедуры sp_add_log_shipping_secondary_database для добавления базы данных LogShipAdventureWorks в качестве базы данных-получателя в конфигурацию доставки журналов с базой данных-источником AdventureWorks2012 , находящейся на сервере-источнике TRIBECA.

EXEC master.dbo.sp_add_log_shipping_secondary_database 
@secondary_database = N'LogShipAdventureWorks' 
,@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks' 
,@restore_delay = 0 
,@restore_mode = 1 
,@disconnect_users = 0 
,@restore_threshold = 45   
,@threshold_alert_enabled = 0 
,@history_retention_period = 1440 
GO

См. также

Справочник

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

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

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