次の方法で共有

sp_help_category (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

ジョブ、警告、またはオペレーターについて、指定されたクラスの情報を提供します。

Transact-SQL 構文表記規則

構文

sp_help_category
    [ [ @class = ] 'class' ]
    [ , [ @type = ] 'type' ]
    [ , [ @name = ] N'name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

引数

[ @class = ] 'class'

情報を要求するクラスを指定します。 @classは varchar(8) で、これらの値のいずれかを指定できます。

Value 説明
JOB (既定値) ジョブ カテゴリに関する情報を提供します。
ALERT アラート カテゴリに関する情報を提供します。
OPERATOR オペレーター カテゴリに関する情報

[ @type = ] 'type'

情報が要求されるカテゴリの種類。 @typeは varchar(12) で、これらの値のいずれかを指定できます。

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

[ @name = ] N'name'

要求する情報に関するカテゴリの名前を指定します。 @nameは sysname で、既定値は NULL.

[ @suffix = ] サフィックス

結果セット内の列が category_type ID か名前かを指定します。 @suffixはビットで、既定値は 0.

  • 1 は category_type 名前として表示されます。
  • 0 は ID として表示されます category_type 。

リターン コードの値

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

結果セット

@suffixの場合は0、sp_help_category次の結果セットを返します。

列名 データ型 説明
category_id int カテゴリ ID
category_type tinyint カテゴリの種類:

1 = ローカル
2 = マルチサーバー
3 = なし
name sysname カテゴリ名

@suffixの場合は1、sp_help_category次の結果セットを返します。

列名 データ型 説明
category_id int カテゴリ ID
category_type sysname カテゴリの種類。 LOCAL、MULTI-SERVER、または NONE のいずれか
name sysname カテゴリ名

解説

sp_help_category はデータベースから実行する msdb 必要があります。

パラメーターを指定しない場合、結果セットではすべてのジョブ カテゴリに関する情報が提供されます。

アクセス許可

このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、データベース内の固定データベース ロールSQL Server エージェント次のいずれかを付与するmsdb必要があります。

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。

例

A. ローカル ジョブ情報を返す

次の例では、ローカルで管理されるジョブに関する情報を返します。

USE msdb;
GO

EXEC dbo.sp_help_category @type = N'LOCAL';
GO

B. アラート情報を返す

次の例では、レプリケーション アラート カテゴリに関する情報を返します。

USE msdb;
GO

EXEC dbo.sp_help_category
    @class = N'ALERT',
    @name = N'Replication';
GO

関連するコンテンツ