Compartilhar via


sp_add_category (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Adiciona a categoria especificada de trabalhos, alertas ou operadores ao servidor. Para obter um método alternativo, consulte Criar uma categoria de trabalho.

Convenções de sintaxe de Transact-SQL

Importante

Atualmente, na Instância Gerenciada de SQL do Azure, a maioria dos recursos do SQL Server Agent é compatível, mas não todos. Confira Diferenças entre o T-SQL da Instância Gerenciada de SQL do Azure e o SQL Server para obter detalhes.

Sintaxe

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

Argumentos

@class [ = ] 'classe'

O classe da categoria a ser adicionada. @class é varchar(8) com um valor padrão de JOB, e pode ser um desses valores.

Valor Descrição
JOB Adiciona uma categoria de trabalho.
ALERT Adiciona uma categoria de alerta.
OPERATOR Adiciona uma categoria de operador.

@type [ = ] 'tipo'

O tipo de categoria a ser adicionado. @type é varchar(12), com um valor padrão de LOCAL, e pode ser um desses valores.

Valor Descrição
LOCAL Uma categoria de trabalho local.
MULTI-SERVER Uma categoria de trabalho multisservidor.
NONE Uma categoria para uma classe diferente de JOB.

@name [ = ] 'nome'

O nome da categoria a ser adicionada. O nome deve ser exclusivo na classe especificada. @name é sysname, sem padrão.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sp_add_category deve ser executado a partir do msdb banco de dados.

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

O exemplo a seguir cria uma categoria de trabalho local denominada AdminJobs.

USE msdb;
GO

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