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