Поделиться через


sp_add_category (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе Transact-SQL

Внимание

В Управляемом экземпляре Azure SQL в настоящее время поддерживается большинство функций агента SQL Server (но не все). Подробные сведения см. в статье Различия в T-SQL между Управляемым экземпляром SQL Azure и SQL Server.

Синтаксис

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 базы данных.

Разрешения

Вы можете предоставить EXECUTE разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

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

USE msdb;
GO

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