Share via

sp_add_maintenance_plan (Transact-SQL)

  • [アーティクル]

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

ms173478.note(ja-jp,SQL.90).gifメモ :
このストアド プロシージャは、データベース メンテナンス プランと共に使用できます。ただし、この機能は、このストアド プロシージャを使用しないメンテナンス プランでも実行できます。このプロシージャは、以前のバージョンの 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 です。

解説

sp_add_maintenance_plan は、msdb データベースから実行する必要があります。これを実行することによって、新しい空のメンテナンス プランが作成されます。1 つ以上のデータベースを追加し、ジョブに関連付けるには、sp_add_maintenance_plan_db と sp_add_maintenance_plan_job を実行します。

権限

sp_add_maintenance_plan を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。

戻り値

0 (成功) または 1 (失敗)

例

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

参照

概念

データベース メンテナンス プランのストアド プロシージャ (Transact-SQL)

その他の技術情報

メンテナンス プラン

ヘルプおよび情報

SQL Server 2005 の参考資料の入手