将新数据库添加到现有的日志传送计划。

语法

sp_add_log_shipping_plan_database

    { [ @plan_id = ] plan_id | [ @plan_name = ] 'plan_name' }

    { , [ @source_database = ] 'source_database' }

    { , [ @destination_database = ] 'destination_database' }

    [ , [ @load_delay = ] load_delay ]

    [ , [ @load_all = ] load_all ]

    [ , [ @copy_enabled = ] copy_enabled ]

    [ , [ @load_enabled = ] load_enabled ]

参数

[@plan_id =] plan_id

数据库将被添加到的计划标识号。plan_id 的数据类型为 uniqueidentifier，默认设置为 NULL。

[@plan_name =] 'plan_name'

数据库将要添加到的计划名称。plan_name 的数据类型为 sysname，默认设置为 NULL。

说明  必须指定 plan_id 或 plan_name。二者不能同时指定。

[@source_database =] 'source_database'

源服务器上的数据库名称。source_database 的数据类型为 sysname，没有默认设置。

[@destination_database =] 'destination_database'

目标数据库的名称。destination_database 的数据类型为 sysname，没有默认设置。目标数据库在 log_shipping_plan_database 表中必须唯一。

[@load_delay =] load_delay

在装载事务日志之前要等待的时间，以分钟为单位。load_delay 的数据类型为 int，默认设置为零 (0)。

[@load_all =] load_all

指定当作业运行时应该装载所有新近复制的事务日志。如果将此值设置为零 (0)，则当作业运行时只加载一个事务日志。如果此值为一 (1)，则装载所有复制的事务日志。load_all 的数据类型为 bit，默认设置为一 (1)。

[@copy_enabled =] copy_enabled

指定是否要执行该数据库的复本。copy_enabled 的数据类型为 bit。值为一 (1) 意味着应该执行复本；值为零 (0) 意味着没有制作复本。

[@load_enabled =] load_enabled

指定是否应该执行该数据库的事务日志装载。load_enabled 的数据类型为 bit。值为一 (1) 意味着应该执行装载；值为零 (0) 意味着没有执行装载。

返回代码值

0（成功）或 1（失败）

权限

只有 sysadmin 固定服务器角色的成员才可以执行 sp_add_log_shipping_plan_database。

示例

注意此示例假定 'Pubs database backup' 计划已经存在。

EXECUTE   msdb.dbo.sp_add_log_shipping_plan_database
   @plan_name = N'Pubs database backup',
   @source_database = N'Pubs',
   @destination_database = N'pubs_standby',
   @load_delay = 60  –– wait an hour before loading the transaction logs