Partilhar via

sp_help_category (Transact-SQL)

Aplica-se a:SQL Server

Fornece informações sobre as classes especificadas de tarefas, alertas ou operadores.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @class = ] 'turma'

Especifica a classe sobre a qual a informação é solicitada. @class é varchar(8), e pode ser um desses valores.

Valor Description
JOB (padrão) Fornece informações sobre uma categoria de trabalho.
ALERT Fornece informação sobre uma categoria de alerta.
OPERATOR Fornece informação sobre uma categoria de operador.

[ @type = ] 'tipo'

O tipo de categoria para a qual a informação é solicitada. @type é varchar(12), e pode ser um desses valores.

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

[ @name = ] N'nome'

O nome da categoria para a qual a informação é solicitada. @name é sysname, com um padrão de NULL.

[ @suffix = ] sufixo

Especifica se a category_type coluna no conjunto de resultados é um ID ou um nome. @suffix é bit, com um padrão de 0.

  • 1 mostra o category_type como nome.
  • 0 mostra o category_type como um ID.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Quando @suffix é 0, sp_help_category devolve o seguinte conjunto de resultados:

Nome da coluna Tipo de dados Description
category_id int ID da categoria
category_type tinyint Tipo de categoria:

1 = Local
2 = Multiservidor
3 = Nenhum
name sysname Nome da categoria

Quando @suffix é 1, sp_help_category devolve o seguinte conjunto de resultados:

Nome da coluna Tipo de dados Description
category_id int ID da categoria
category_type sysname Tipo de categoria. Uma de LOCAL, MULTI-SERVER, ou NONE
name sysname Nome da categoria

Observações

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

Se não forem especificados parâmetros, o conjunto de resultados fornece informação sobre todas as categorias de funções.

Permissions

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

Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.

Examples

A. Informações locais de emprego de retorno

O exemplo seguinte devolve informações sobre funções que são administradas localmente.

USE msdb;
GO

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

B. Informação de alerta de retorno

O exemplo seguinte devolve informações sobre a categoria de alerta de replicação.

USE msdb;
GO

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

Conteúdo relacionado

  • Last updated on