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


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 для добавления базы данных LogShipAdventureWorks2008R2 в качестве базы данных-получателя в конфигурацию доставки журналов с базой данных-источником База данных AdventureWorks2008R2, находящейся на сервере-источнике TRIBECA.

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