sp_add_log_shipping_secondary_database (Transact-SQL)
Настраивает базы данных-получателей для доставки журналов.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
.gif "Значок ссылки на раздел")
Cинтаксические обозначения в 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 в качестве базы данных-получателя в конфигурацию доставки журналов с базой данных-источником AdventureWorks2012 , находящейся на сервере-источнике TRIBECA.
EXEC master.dbo.sp_add_log_shipping_secondary_database
@secondary_database = N'LogShipAdventureWorks'
,@primary_server = N'TRIBECA'
,@primary_database = N'AdventureWorks2012'
,@restore_delay = 0
,@restore_mode = 1
,@disconnect_users = 0
,@restore_threshold = 45
,@threshold_alert_enabled = 0
,@history_retention_period = 1440 ;
GO
См. также
Справочник
Системные хранимые процедуры (Transact-SQL)