sp_help_category （Transact-SQL）

  • 發行項

適用於：SQL Server

提供指定之作業、警示或運算子類別的相關資訊。

Transact-SQL 語法慣例

語法

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

引數

[ @class = ] 'class' 關於要求哪些資訊的類別。 類別 為 Varchar（8） ，預設值為 JOB 。 類別 可以是下列其中一個值。

值 Description
工作 提供作業類別目錄的相關資訊。
警報 提供警示類別的相關資訊。
運算元 提供運算子類別的相關資訊。

[ @type = ] 'type' 要求資訊的類別類型。 類型 為 Varchar（12） ，預設值為 Null，而且可以是下列其中一個值。

值 Description
LOCAL 本機作業類別目錄。
MULTI -SERVER 多伺服器作業類別目錄。
NONE JOB 以外的 類別類別分類。

[ @name = ] 'name' 要求資訊的類別名稱。 name 為 sysname ，預設值為 Null。

[ @suffix = ] suffix指定結果集中category_type 資料行是否 為識別碼或名稱。 尾碼 為 bit ，預設值為 0 。 1 會將 category_type 顯示為名稱， 0 會顯示為識別碼。

傳回碼值

0 （成功） 或 1 （失敗）

結果集

當@suffix 為 0 時 ， sp_help_category 會傳回下列結果集：

資料行名稱 資料類型 描述
category_id int 類別識別碼
category_type tinyint 類別類型：

1 = 本機

2 = 多伺服器

3 = 無
name sysname 類別名稱

當@suffix 為 1 時 ， sp_help_category 會傳回下列結果集：

資料行名稱 資料類型 描述
category_id int 類別識別碼
category_type sysname 類別的類型。 其中一個 LOCAL 、 MULTI-SERVER 或 NONE
name sysname 類別名稱

備註

sp_help_category必須從 msdb 資料庫執行。

如果未指定任何參數，結果集會提供所有作業類別的相關資訊。

權限

依預設，只有 系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。 其他使用者必須獲授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色：

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

如需這些角色權限的詳細資訊，請參閱 SQL Server Agent 固定資料庫角色。

範例

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

另請參閱

sp_add_category （Transact-SQL）
sp_delete_category （Transact-SQL）
sp_update_category （Transact-SQL）
系統預存程序 (Transact-SQL)