Skip to content

Latest commit

 

History

History
83 lines (58 loc) · 2.84 KB

sp-delete-maintenance-plan-db-transact-sql.md

File metadata and controls

83 lines (58 loc) · 2.84 KB
title description author ms.author ms.reviewer ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs
sp_delete_maintenance_plan_db (Transact-SQL)
Disassociates the specified maintenance plan from the specified database.
markingmyname
maghan
randolphwest
01/23/2024
sql
system-objects
reference
sp_delete_maintenance_plan_db_TSQL
sp_delete_maintenance_plan_db
sp_delete_maintenance_plan_db
maintenance plans [SQL Server], deleting
removing maintenance plan
disassociating maintenance plan
TSQL

sp_delete_maintenance_plan_db (Transact-SQL)

[!INCLUDE 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 [!INCLUDE ssNoVersion].

[!INCLUDE ssNoteDepFutureAvoid]

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: 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

[!INCLUDE msdb-execute-permissions]

Examples

Deletes the maintenance plan in the [!INCLUDE sssampledbobject-md] database, previously added by using sp_add_maintenance_plan_db.

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

Related content