sp_add_category (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
指定されたジョブ、警告、またはオペレーターのカテゴリをサーバーに追加します。 別の方法については、「 ジョブ カテゴリの作成」を参照してください。
重要
現在、Azure SQL Managed Instance によって、すべてではありませんが、ほとんどの SQL Server エージェントの機能がサポートされています。 詳細については、Azure SQL Managed Instance と SQL Server の T-SQL の相違点に関するページを参照してください。
構文
sp_add_category
[ [ @class = ] 'class' ]
[ , [ @type = ] 'type' ]
[ , [ @name = ] 'name' ]
[ ; ]
引数
[ @class = ] 'class'
追加するカテゴリのクラスを指定します。 @classは既定値が JOB の varchar(8)であり、これらの値のいずれかを指定できます。
| Value | 説明 |
|---|---|
JOB |
ジョブ カテゴリを追加します。 |
ALERT |
アラート カテゴリを追加します。 |
OPERATOR |
演算子カテゴリを追加します。 |
[ @type = ] 'type'
追加するカテゴリの種類を指定します。 @type は varchar(12)で、既定値は LOCAL で、これらの値のいずれかを指定できます。
| Value | 説明 |
|---|---|
LOCAL |
ローカル ジョブ カテゴリ |
MULTI-SERVER |
マルチサーバー ジョブ カテゴリ。 |
NONE |
JOB以外のクラスのカテゴリ。 |
[ @name = ] 'name'
追加するカテゴリの名前。 名前は、指定したクラス内で一意である必要があります。 @name は sysname で、既定値はありません。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
ありません。
解説
sp_add_category は、 msdb データベースから実行する必要があります。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
次の例では、AdminJobs というローカル ジョブ カテゴリを作成します。
USE msdb;
GO
EXEC dbo.sp_add_category
@class = N'JOB',
@type = N'LOCAL',
@name = N'AdminJobs';
GO