sp_delete_maintenance_plan_db (Transact-SQL)

Applies to: SQL Server

Disassociates the specified maintenance plan from the specified database.

Note

This stored procedure is used with database maintenance plans. This feature has been replaced with maintenance plans which don't use this stored procedure. Use this procedure to maintain database maintenance plans on installations that were upgraded from a previous version of SQL Server.

This feature will be removed in a future version of SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

Transact-SQL syntax conventions

Syntax

sp_delete_maintenance_plan_db
    [ @plan_id = ] 'plan_id'
    , [ @db_name = ] N'db_name'
[ ; ]

Arguments

[ @plan_id = ] 'plan_id'

Specifies the maintenance plan ID. @plan_id is uniqueidentifier, with no default.

[ @db_name = ] N'db_name'

Specifies the database name to be deleted from the maintenance plan. @db_name is sysname, with no default.

Return code values

0 (success) or 1 (failure).

Remarks

sp_delete_maintenance_plan_db must be run from the msdb database.

The sp_delete_maintenance_plan_db stored procedure removes the association between the maintenance plan and the specified database; it doesn't drop or destroy the database.

When sp_delete_maintenance_plan_db removes the last database from the maintenance plan, the stored procedure also deletes the maintenance plan.

Permissions

You can grant EXECUTE permissions on this procedure, but these permissions might be overridden during a SQL Server upgrade.

Examples

Deletes the maintenance plan in the AdventureWorks2022 database, previously added by using sp_add_maintenance_plan_db.

EXEC sp_delete_maintenance_plan_db
    N'FAD6F2AB-3571-11D3-9D4A-00C04FB925FC',
    N'AdventureWorks2022';