sp_add_category (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

指定されたジョブ、警告、またはオペレーターのカテゴリをサーバーに追加します。 別の方法については、「 ジョブ カテゴリの作成」を参照してください。

Transact-SQL 構文表記規則

重要

現在、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は既定値が JOBvarchar(8)であり、これらの値のいずれかを指定できます。

Value 説明
JOB ジョブ カテゴリを追加します。
ALERT アラート カテゴリを追加します。
OPERATOR 演算子カテゴリを追加します。

[ @type = ] 'type'

追加するカテゴリの種類を指定します。 @typevarchar(12)で、既定値は LOCAL で、これらの値のいずれかを指定できます。

Value 説明
LOCAL ローカル ジョブ カテゴリ
MULTI-SERVER マルチサーバー ジョブ カテゴリ。
NONE JOB以外のクラスのカテゴリ。

[ @name = ] 'name'

追加するカテゴリの名前。 名前は、指定したクラス内で一意である必要があります。 @namesysname で、既定値はありません。

リターン コードの値

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