sp_add_category (Transact-SQL)

Добавляет указанную категорию заданий, предупреждений или операторов на сервер.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_add_category 
     [ [ @class = ] 'class', ] 
     [ [ @type = ] 'type', ] 
     { [ @name = ] 'name' }

Аргументы

  • [ @class = ] 'class'
    Класс добавляемой категории. Аргумент class имеет тип varchar(8) и значение по умолчанию JOB. Также может принимать одно из следующих значений:

    Значение

    Описание

    JOB

    Добавление категории заданий.

    ALERT

    Добавление категории предупреждений.

    OPERATOR

    Добавление категории операторов.

  • [ @type = ] 'type'
    Тип добавляемой категории. Аргумент type имеет тип varchar(12) и значение по умолчанию LOCAL. Также может принимать одно из следующих значений.

    Значение

    Описание

    LOCAL

    Локальная категория заданий.

    MULTI-SERVER

    Многосерверная категория заданий.

    NONE

    Категория, отличная от JOB.

  • [ @name = ] 'name'
    Имя добавляемой категории. Имя должно быть уникальным в пределах указанного класса. Аргумент name имеет тип sysname и не имеет значения по умолчанию.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет

Замечания

Процедура sp_add_category должна быть запущена в базе данных msdb .

Разрешения

Процедуру sp_add_category могут выполнять только члены предопределенной роли сервера sysadmin.

Примеры

В следующем примере создается локальная категория заданий с именем AdminJobs.

USE msdb ;
GO

EXEC dbo.sp_add_category
    @class=N'JOB',
    @type=N'LOCAL',
    @name=N'AdminJobs' ;
GO