sp_add_category (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

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

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は、既定値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

関連するコンテンツ