sp_help_category (Transact-SQL)

Sintaxe

sp_help_category [ [ @class = ] 'class' ] 
     [ , [ @type = ] 'type' ] 
     [ , [ @name = ] 'name' ] 
     [ , [ @suffix = ] suffix ] 

Argumentos

• [ @class=] 'class'
  A classe sobre a qual as informações são solicitadas. class é varchar(8), com o valor padrão JOB. class pode ser um destes valores.

  Valor	Descrição
  JOB	Fornece informações sobre uma categoria de trabalho.
  ALERT	Fornece informações sobre uma categoria de alerta.
  OPERATOR	Fornece informações sobre uma categoria de operador.

• [ @type= ] 'type'
  O tipo de categoria para a qual as informações são solicitadas. type é varchar(12), com um valor padrão NULL, e pode ser um destes valores.

  Valor	Descrição
  LOCAL	Categoria de trabalho local.
  MULTI -SERVER	Categoria de trabalho multiservidor.
  NONE	Categoria de uma classe diferente de JOB.

• [ @name= ] 'name'
  O nome da categoria para a qual as informações são solicitadas. name é sysname, com um padrão NULL.

• [ @suffix= ] suffix
  Especifica se a coluna category_type do conjunto de resultados é um ID ou um nome. suffix é bit, com um padrão 0. 1 mostra o category_type como um nome e 0 o mostra como um ID.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Quando @suffix for 0, sp_help_category retornará o seguinte conjunto de resultados:

Quando @suffix for 1, sp_help_category retornará o seguinte conjunto de resultados:

Comentários

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

Se nenhum parâmetro for especificado, o conjunto de resultados fornecerá informações sobre todas as categorias de trabalho.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Exemplos

A. Retornando informações do trabalho local

USE msdb ;
GO

EXEC dbo.sp_help_category
    @type = N'LOCAL' ;
GO

B. Retornando informações de alerta

USE msdb ;
GO

EXEC dbo.sp_help_category
    @class = N'ALERT',
    @name = N'Replication' ;
GO

Consulte também

Referência