| title | sp_add_maintenance_plan (Transact-SQL) | Microsoft Docs | ||
|---|---|---|---|
| ms.custom | |||
| ms.date | 03/14/2017 | ||
| ms.prod | sql | ||
| ms.prod_service | database-engine | ||
| ms.reviewer | |||
| ms.technology | system-objects | ||
| ms.topic | language-reference | ||
| f1_keywords |
|
||
| dev_langs |
|
||
| helpviewer_keywords |
|
||
| ms.assetid | 01ab1834-6260-47cb-a1b7-20722217b062 | ||
| author | MashaMSFT | ||
| ms.author | mathoma |
[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]
Adds a maintenance plan and returns the plan ID.
Note
This stored procedure is used with database maintenance plans. This feature has been replaced with maintenance plans which do not use this stored procedure. Use this procedure to maintain database maintenance plans on installations that were upgraded from a previous version of [!INCLUDEssNoVersion].
[!INCLUDEssNoteDepFutureAvoid]
Transact-SQL Syntax Conventions
sp_add_maintenance_plan [ @plan_name = ] 'plan_name' ,
@plan_id = 'plan_id' OUTPUT
[ @plan_name = ] 'plan_name'
Specifies the name of the maintenance plan to be added. plan_name is varchar(128).
@plan_id = ' plan_id '
Specifies the ID of the maintenance plan. plan_id is uniqueidentifier.
0 (success) or 1 (failure)
sp_add_maintenance_plan must be run from the msdb database and creates a new, but empty, maintenance plan. To add one or more databases and associate them with a job or jobs, execute sp_add_maintenance_plan_db and sp_add_maintenance_plan_job.
Only members of the sysadmin fixed server role can execute sp_add_maintenance_plan.
Create a maintenance plan called Myplan.
DECLARE @myplan_id UNIQUEIDENTIFIER;
EXECUTE sp_add_maintenance_plan N'Myplan',@plan_id=@myplan_id OUTPUT
PRINT 'The id for the maintenance plan "Myplan" is:'+convert(varchar(256),@myplan_id);
GO
Success in creating the maintenance plan will return the plan ID.
'The id for the maintenance plan "Myplan" is:' FAD6F2AB-3571-11D3-9D4A-00C04FB925FC
Maintenance Plans
Database Maintenance Plan Stored Procedures (Transact-SQL)