sp_add_maintenance_plan (Transact-SQL)
メンテナンス プランを追加し、プラン ID を返します。
注意
このストアド プロシージャは、データベース メンテナンス プランと共に使用できます。ただし、この機能は、このストアド プロシージャを使用しないメンテナンス プランでも実行できます。このプロシージャは、以前のバージョンの SQL Server からアップグレードしたプログラムでデータベース メンテナンス プランを管理する場合に使用します。
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。
適用対象: SQL Server (SQL Server 2008 から現在のバージョンまで) |
構文
sp_add_maintenance_plan [ @plan_name = ] 'plan_name' ,
@plan_id = 'plan_id' OUTPUT
引数
[ @plan_name =] 'plan_name'
追加するメンテナンス プランの名前を指定します。 plan_name のデータ型は varchar(128) です。@plan_id = 'plan_id'
メンテナンス プランの ID を指定します。 plan_id のデータ型は uniqueidentifier です。
戻り値
0 (成功) または 1 (失敗)
説明
sp_add_maintenance_plan は、msdb データベースから実行する必要があります。これを実行することによって、新しい空のメンテナンス プランが作成されます。 1 つ以上のデータベースを追加し、ジョブに関連付けるには、sp_add_maintenance_plan_db と sp_add_maintenance_plan_job を実行します。
権限
sp_add_maintenance_plan を実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。
使用例
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
メンテナンス プランが作成されると、プラン ID が返されます。
'The id for the maintenance plan "Myplan" is:' FAD6F2AB-3571-11D3-9D4A-00C04FB925FC