• [アーティクル]

sp_add_maintenance_plan (Transact-SQL)

メンテナンス プランを追加し、プラン ID を返します。

注意注

このストアド プロシージャは、データベース メンテナンス プランと共に使用できます。ただし、この機能は、このストアド プロシージャを使用しないメンテナンス プランでも実行できます。このプロシージャは、以前のバージョンの SQL Server からアップグレードしたプログラムでデータベース メンテナンス プランを管理する場合に使用します。

この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。

トピック リンク アイコンTransact-SQL 構文表記規則

構文


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