sp_add_category （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

將指定的作業、警示或運算符類別新增至伺服器。 如需替代方法，請參閱 使用 SQL Server Management Studio 建立作業類別目錄。

Transact-SQL 語法慣例

重要

Azure SQL 受控執行個體目前支援多數 (但非全部) 的 SQL Server Agent 功能。 如需詳細資料，請參閱 Azure SQL 受控執行個體與 SQL Server 之間的 T-SQL 差異。

語法

sp_add_category
     [ [ @class = ] 'class' ]
     [ , [ @type = ] 'type' ]
     [ , [ @name = ] 'name' ]
[ ; ]

引數

[ @class = ] 'class'

要加入之類別的類別。 @class為 varchar（8），預設值JOB為 ，而且可以是下列其中一個值。

值 Description
JOB 新增作業類別目錄。
ALERT 新增警示類別。
OPERATOR 加入運算子類別。

[ @type = ] 'type'

要加入的類別類型。 @type為 varchar（12），預設值LOCAL為 ，而且可以是下列其中一個值。

值 Description
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

相關內容