sp_add_log_shipping_secondary_database (Transact-SQL)sp_add_log_shipping_secondary_database (Transact-SQL)

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions)

Настраивает базы данных-получателей для доставки журналов.Sets up a secondary databases for log shipping.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

  
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']  

АргументыArguments

[ @secondary_database = ] 'secondary_database' Имя базы данных-получателя.[ @secondary_database = ] 'secondary_database' Is the name of the secondary database. Аргумент secondary_database имеет тип sysnameи не имеет значения по умолчанию.secondary_database is sysname, with no default.

[ @primary_server = ] 'primary_server' Имя основного экземпляра в MicrosoftMicrosoft Компонент SQL Server Database EngineSQL Server Database Engine конфигурации доставки журналов.[ @primary_server = ] 'primary_server' The name of the primary instance of the MicrosoftMicrosoft Компонент SQL Server Database EngineSQL Server Database Engine in the log shipping configuration. primary_server имеет тип sysname и не может иметь значение null.primary_server is sysname and cannot be NULL.

[ @primary_database = ] 'primary_database' Имя базы данных на сервере-источнике.[ @primary_database = ] 'primary_database' Is the name of the database on the primary server. Аргумент primary_database имеет тип sysnameи не имеет значения по умолчанию.primary_database is sysname, with no default.

[ @restore_delay = ] 'restore_delay' Время в минутах, в течение которого сервер-получатель ждет перед восстановлением заданного файла резервной копии.[ @restore_delay = ] 'restore_delay' The amount of time, in minutes, that the secondary server waits before restoring a given backup file. restore_delay имеет тип int и не может иметь значение null.restore_delay is int and cannot be NULL. Значение по умолчанию — 0.The default value is 0.

[ @restore_all = ] 'restore_all' Если задано значение 1, сервер-получатель восстанавливает все доступные резервные копии журналов транзакций при выполнении задания восстановления.[ @restore_all = ] 'restore_all' If set to 1, the secondary server restores all available transaction log backups when the restore job runs. В противном случае он останавливается после восстановления одного файла.Otherwise, it stops after one file is restored. restore_all имеет бит и не может иметь значение null.restore_all is bit and cannot be NULL.

[ @restore_mode = ] 'restore_mode' Режим восстановления для базы данных-получателя.[ @restore_mode = ] 'restore_mode' The restore mode for the secondary database.

0 = восстановление журнала с аргументом NORECOVERY.0 = Restore log with NORECOVERY.

1 = восстановление журнала с аргументом STANDBY.1 = restore log with STANDBY.

значение RESTORE bit и не может быть равно null.restore is bit and cannot be NULL.

[ @disconnect_users = ] 'disconnect_users' Если задано значение 1, то при выполнении операции восстановления пользователи отключаются от базы данных-получателя.[ @disconnect_users = ] 'disconnect_users' If set to 1, users are disconnected from the secondary database when a restore operation is performed. По умолчанию равно 0.Default = 0. Отключение пользователей имеет бит и не может иметь значение null.disconnect users is bit and cannot be NULL.

[ @block_size = ] 'block_size' Размер в байтах, используемый в качестве размера блока для устройства резервного копирования.[ @block_size = ] 'block_size' The size, in bytes, that is used as the block size for the backup device. block_size имеет тип int и значение по умолчанию-1.block_size is int with a default value of -1.

[ @buffer_count = ] 'buffer_count' Общее число буферов, используемых операцией резервного копирования или восстановления.[ @buffer_count = ] 'buffer_count' The total number of buffers used by the backup or restore operation. buffer_count имеет тип int и значение по умолчанию-1.buffer_count is int with a default value of -1.

[ @max_transfer_size = ] 'max_transfer_size' Размер (в байтах) максимального запроса ввода или вывода, выданного SQL ServerSQL Server устройством резервного копирования.[ @max_transfer_size = ] 'max_transfer_size' The size, in bytes, of the maximum input or output request which is issued by SQL ServerSQL Server to the backup device. max_transfersize имеет тип int и может иметь значение null.max_transfersize is int and can be NULL.

[ @restore_threshold = ] 'restore_threshold' Количество минут между операциями восстановления до создания предупреждения.[ @restore_threshold = ] 'restore_threshold' The number of minutes allowed to elapse between restore operations before an alert is generated. restore_threshold имеет тип int и не может иметь значение null.restore_threshold is int and cannot be NULL.

[ @threshold_alert = ] 'threshold_alert' Предупреждение, создаваемое при превышении порогового значения резервного копирования.[ @threshold_alert = ] 'threshold_alert' Is the alert to be raised when the backup threshold is exceeded. threshold_alert имеет тип intи значение по умолчанию 14 420.threshold_alert is int, with a default of 14,420.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Указывает, возникает ли предупреждение при превышении backup_threshold .[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Specifies whether an alert is raised when backup_threshold is exceeded. При значении, равном единице (1), устанавливаемом по умолчанию, предупреждение будет инициировано.The value of one (1), the default, means that the alert is raised. threshold_alert_enabled имеет бит.threshold_alert_enabled is bit.

[ @history_retention_period = ] 'history_retention_period' Продолжительность времени в минутах, в течение которого сохраняется журнал.[ @history_retention_period = ] 'history_retention_period' Is the length of time in minutes in which the history is retained. history_retention_period имеет тип intи значение по умолчанию NULL.history_retention_period is int, with a default of NULL. Если ничего не указано, используется значение 14 420.A value of 14420 is used if none is specified.

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

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

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

NoneNone

RemarksRemarks

sp_add_log_shipping_secondary_database должны запускаться из базы данных master на сервере-получателе.sp_add_log_shipping_secondary_database must be run from the master database on the secondary server. Эта хранимая процедура выполняет следующее:This stored procedure does the following:

  1. перед этой хранимой процедурой необходимо вызвать sp_add_log_shipping_secondary_primary , чтобы инициализировать основную информацию о базе данных доставки журналов на сервере-получателе.sp_add_log_shipping_secondary_primary should be called prior to this stored procedure to initialize the primary log shipping database information on the secondary server.

  2. Добавляет запись для базы данных-получателя в log_shipping_secondary_databases с помощью предоставляемых аргументов.Adds an entry for the secondary database in log_shipping_secondary_databases using the supplied arguments.

  3. Добавляет запись локального монитора в log_shipping_monitor_secondary на сервере-получателе с помощью предоставляемых аргументов.Adds a local monitor record in log_shipping_monitor_secondary on the secondary server using supplied arguments.

  4. Если сервер мониторинга отличается от сервера-получателя, добавляет запись монитора в log_shipping_monitor_secondary на сервере мониторинга, используя указанные аргументы.If the monitor server is different from the secondary server, adds a monitor record in log_shipping_monitor_secondary on the monitor server using supplied arguments.

РазрешенияPermissions

Эту процедуру могут выполнять только члены предопределенной роли сервера sysadmin .Only members of the sysadmin fixed server role can run this procedure.

ПримерыExamples

В этом примере показано использование хранимой процедуры sp_add_log_shipping_secondary_database для добавления базы данных LogShipAdventureWorks в качестве базы данных-получателя в конфигурации доставки журналов с базой данных-источником, AdventureWorks2012AdventureWorks2012 находящейся на сервере-источнике Трибека.This example illustrates using the sp_add_log_shipping_secondary_database stored procedure to add the database LogShipAdventureWorks as a secondary database in a log shipping configuration with the primary database AdventureWorks2012AdventureWorks2012 residing on the primary server 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  

См. также:See Also

Сведения о доставке журналов (SQL Server) About Log Shipping (SQL Server)
Системные хранимые процедуры (Transact-SQL)System Stored Procedures (Transact-SQL)