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

sp_add_log_shipping_secondary_primary (Transact-SQL)

  • Статья

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

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

Синтаксис

sp_add_log_shipping_secondary_primary
 [ @primary_server = ] 'primary_server', 
[ @primary_database = ] 'primary_database',
[ @backup_source_directory = ] 'backup_source_directory' , 
[ @backup_destination_directory = ] 'backup_destination_directory'
[ @copy_job_name = ] 'copy_job_name'
[ @restore_job_name = ] 'restore_job_name'
[, [ @file_retention_period = ] 'file_retention_period']
[, [ @monitor_server = ] 'monitor_server']
[, [ @monitor_server_security_mode = ] 'monitor_server_security_mode']
[, [ @monitor_server_login = ] 'monitor_server_login']
[, [ @monitor_server_password = ] 'monitor_server_password']
[, [ @copy_job_id = ] 'copy_job_id' OUTPUT ]
[, [ @restore_job_id = ] 'restore_job_id' OUTPUT ]
[, [ @secondary_id = ] 'secondary_id' OUTPUT]

Аргументы

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

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

  • [ @backup_source_directory = ] 'backup_source_directory'
    Каталог, в котором хранятся файлы резервной копии журнала транзакций с сервера-источника. Аргумент backup_source_directory имеет тип nvarchar(500) и не может иметь значение NULL.

  • [ @backup_destination_directory = ] 'backup_destination_directory'
    Каталог сервера-получателя, в который копируются файлы резервных копий. Аргумент backup_destination_directory имеет тип nvarchar(500) и не может иметь значение NULL.

  • [ @copy_job_name = ] 'copy_job_name'
    Имя создаваемого задания агента SQL Server для копирования резервных копий журналов транзакций на сервер-получатель. Аргумент copy_job_name имеет тип sysname и не может иметь значение NULL.

  • [ @restore_job_name = ] 'restore_job_name'
    Имя задания агента SQL Server на сервере-получателе, которое восстанавливает резервные копии в базе данных-получателе. Аргумент restore_job_name имеет тип sysname и не может иметь значение NULL.

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

  • [ @monitor_server = ] 'monitor_server'
    Имя сервера мониторинга. Аргумент Monitor_server имеет тип sysname, не имеет значения по умолчанию и не может принимать значение NULL.

  • [ @monitor_server_security_mode = ] 'monitor_server_security_mode'
    Режим безопасности при подключении к серверу мониторинга.

    1 = проверка подлинности Windows.

    0 = проверка подлинности SQL Server.

    Аргумент monitor_server_security_mode имеет тип bit и не может иметь значение NULL.

  • [ @monitor_server_login = ] 'monitor_server_login'
    Имя пользователя или учетной записи для доступа к серверу мониторинга.

  • [ @monitor_server_password = ] 'monitor_server_password'
    Пароль учетной записи, используемой для доступа к серверу мониторинга.

  • [ @copy_job_id = ] 'copy_job_id' OUTPUT
    Идентификатор, назначенный заданию копирования на сервере-получателе. Аргумент copy_job_id имеет тип uniqueidentifier и не может иметь значение NULL.

  • [ @restore_job_id = ] 'restore_job_id' OUTPUT
    Идентификатор, назначенный заданию восстановления на сервере-получателе. Аргумент restore_job_id имеет тип uniqueidentifier и не может иметь значение NULL.

  • [ @secondary_id = ] 'secondary_id' OUTPUT
    Идентификатор сервера-получателя в конфигурации доставки журналов. Аргумент secondary_id имеет тип uniqueidentifier и не может иметь значение NULL.

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

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

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

Отсутствует

Замечания

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

  1. Формирует идентификатор получателя для указанного сервера-источника и базы данных-источника.

  2. Выполняет следующее:

    1. добавляет запись для идентификатора получателя в log_shipping_secondary с указанными аргументами;

    2. создает отключенное задание копирования для идентификатора получателя;

    3. сохраняет идентификатор задания копирования в записи log_shipping_secondary, соответствующей идентификатору задания копирования;

    4. создает отключенное задание восстановления для идентификатора получателя;

    5. сохраняет идентификатор задания восстановления в записи log_shipping_secondary, соответствующей идентификатору задания восстановления.

Разрешения

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

Примеры

Следующий пример иллюстрирует применение хранимой процедуры sp_add_log_shipping_secondary_primary для сохранения сведений о базе данных-источнике AdventureWorks2012 на сервере-получателе.

EXEC master.dbo.sp_add_log_shipping_secondary_primary 
@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks' 
,@backup_source_directory = N'\\tribeca\LogShipping' 
,@backup_destination_directory = N'' 
,@copy_job_name = N'' 
,@restore_job_name = N'' 
,@file_retention_period = 1440 
,@monitor_server = N'ROCKAWAY' 
,@monitor_server_security_mode = 1 
,@copy_job_id = @LS_Secondary__CopyJobId OUTPUT 
,@restore_job_id = @LS_Secondary__RestoreJobId OUTPUT 
,@secondary_id = @LS_Secondary__SecondaryId OUTPUT 
GO

См. также

Справочник

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

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

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