Partilhar via


sp_add_category (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Adiciona a categoria especificada de tarefas, alertas ou operadores ao servidor. Para métodos alternativos, veja Criar uma Categoria de Trabalho.

Transact-SQL convenções de sintaxe

Importante

No Azure SQL Managed Instance, a maioria dos recursos do SQL Server Agent, mas não todos, são suportados no momento. Consulte as diferenças entre o Azure SQL Managed Instance T-SQL e o SQL Server para mais detalhes.

Sintaxe

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

Arguments

[ @class = ] 'turma'

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

Valor Description
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 adicionar. @type é varchar(12), com um valor padrão de LOCAL, e pode ser um desses valores.

Valor Description
LOCAL Uma categoria de trabalho local.
MULTI-SERVER Uma categoria de trabalho multiservidor.
NONE Uma categoria para uma classe diferente de JOB.

[ @name = ] 'nome'

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

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

sp_add_category deve ser executado a partir da msdb base de dados.

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Examples

O exemplo seguinte cria uma categoria local de trabalho chamada AdminJobs.

USE msdb;
GO

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