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