Partager via


sp_add_maintenance_plan (Transact-SQL)

S'applique à : SQL Server

Ajoute un plan de maintenance et retourne l'ID du plan.

Remarque

Cette procédure stockée s'utilise avec des plans de maintenance de base de données. Cette fonctionnalité a été remplacée par des plans de maintenance qui n’utilisent pas cette procédure stockée. Utilisez cette procédure pour gérer les plans de maintenance de base de données sur les installations qui ont été mises à niveau à partir d’une version précédente de SQL Server.

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @plan_name = ] N’plan_name'

Indique le nom du plan de maintenance à ajouter. @plan_name est varchar(128).

[ @plan_id = ] SORTIE N’plan_id'

Spécifie l'identificateur du plan de maintenance. @plan_id est uniqueidentifier.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_add_maintenance_plan doit être exécuté à partir de la msdb base de données et crée un plan de maintenance vide. Pour ajouter une ou plusieurs bases de données et les associer à un travail ou à des travaux, exécutez sp_add_maintenance_plan_db et sp_add_maintenance_plan_job.

autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

Exemples

Créez un plan de maintenance appelé 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

La réussite de la création du plan de maintenance retourne l’ID du plan.

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