sp_add_log_shipping_secondary_database (Transact-SQL)
Настраивает базы данных-получателей для доставки журналов.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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 на сервере-получателе. Эта хранимая процедура выполняет следующее:
- Для инициализации данных о базе данных-источнике в доставке журналов на сервере-получателе перед выполнением этой хранимой процедуры должна вызываться процедура sp_add_log_shipping_secondary_primary.
- Добавляет запись о базе данных-получателе в таблицу log_shipping_secondary_databases, используя предоставленные аргументы.
- Добавляет запись о локальном мониторе в таблицу log_shipping_monitor_secondary на сервере-получателе, используя предоставленные аргументы.
- Если сервер мониторинга не совпадает с сервером-получателем, добавляет запись о мониторе в таблицу log_shipping_monitor_secondary на сервере мониторинга, используя предоставленные аргументы.
Разрешения
Эту процедуру могут выполнять только члены фиксированной серверной роли sysadmin.
Примеры
Следующий пример иллюстрирует использование хранимой процедуры sp_add_log_shipping_secondary_database для добавления базы данных LogShipAdventureWorks в качестве базы данных-получателя в конфигурацию доставки журналов с базой данных-источником AdventureWorks, находящейся на сервере-источнике 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)
Другие ресурсы
Доставка журналов
Таблицы доставки журналов и хранимые процедуры