sp_add_maintenance_plan (Transact-SQL)

适用范围:SQL Server

添加维护计划并返回计划 ID。

注意

数据库维护计划使用这些存储过程。 此功能已替换为不使用此存储过程的维护计划。 使用此过程维护从以前版本的 SQL Server 升级的安装上的数据库维护计划。

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。

Transact-SQL 语法约定

语法

sp_add_maintenance_plan
    [ @plan_name = ] 'plan_name'
    , [ @plan_id = ] 'plan_id' OUTPUT
[ ; ]

参数

[ @plan_name = ] N'plan_name'

指定要添加的维护计划的名称。 @plan_name是 varchar(128)。

[ @plan_id = ] N'plan_id' OUTPUT

指定维护计划的 ID。 @plan_id是 uniqueidentifier

返回代码值

0(成功)或 1(失败)。

注解

sp_add_maintenance_plan 必须从 msdb 数据库运行并创建新的但为空的维护计划。 若要添加一个或多个数据库并将其与作业或作业相关联,请执行sp_add_maintenance_plan_db并执行。sp_add_maintenance_plan_job

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

示例

创建名为 MyPlan 的维护计划。

DECLARE @myplan_id UNIQUEIDENTIFIER;

EXECUTE sp_add_maintenance_plan
    @plan_name = N'MyPlan',
    @plan_id = @myplan_id OUTPUT

PRINT 'The ID for the maintenance plan "MyPlan" is:' + convert(VARCHAR(256), @myplan_id);
GO

成功创建维护计划会返回计划 ID。

The ID for the maintenance plan "MyPlan" is: FAD6F2AB-3571-11D3-9D4A-00C04FB925FC