Condividi tramite


sp_help_category (Transact-SQL)

Restituisce informazioni sulle classi di processi, avvisi o operatori specificate.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @class=] 'class'
    Classe su cui si desidera ottenere informazioni. class è di tipo varchar(8) e il valore predefinito è JOB. I possibili valori per class sono i seguenti.

    Valore

    Descrizione

    JOB

    Restituisce informazioni su una categoria di processi.

    ALERT

    Restituisce informazioni su una categoria di avvisi.

    OPERATOR

    Restituisce informazioni su una categoria di operatori.

  • [ @type= ] 'type'
    Tipo di categoria su cui vengono richieste informazioni. type è di tipo varchar(12) e il valore predefinito è NULL. I possibili valori sono i seguenti.

    Valore

    Descrizione

    LOCAL

    Categoria di processi locali.

    MULTI -SERVER

    Categoria di processi multiserver.

    NONE

    Categoria di una classe diversa da JOB.

  • [ @name= ] 'name'
    Nome della categoria su cui si desidera ottenere informazioni. name è di tipo sysname e il valore predefinito è NULL.

  • [ @suffix= ] suffix
    Specifica se la colonna category_type nel set di risultati è un ID o un nome. suffix è di tipo bit e il valore predefinito è 0. 1 visualizza category_type come nome, mentre 0 lo visualizza come ID.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Quando @suffix è 0, sp_help_category restituisce il set di risultati seguente:

Nome colonna

Tipo di dati

Descrizione

category_id

int

ID della categoria

category_type

tinyint

Tipo di categoria:

1 = Locale

2 = Multiserver

3 = Nessuno

name

sysname

Nome della categoria

Quando @suffix è 1, sp_help_category restituisce il set di risultati seguente:

Nome colonna

Tipo di dati

Descrizione

category_id

int

ID della categoria

category_type

sysname

Tipo di categoria: LOCAL, MULTI-SERVER o NONE

name

sysname

Nome della categoria

Osservazioni

La stored procedure sp_help_category deve essere eseguita dal database msdb.

Se non viene specificato alcun parametro, il set di risultati include informazioni su tutte le categorie dei processi.

Autorizzazioni

Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere a uno dei seguenti ruoli predefiniti del database di SQL Server Agent nel database msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Per informazioni sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.

Esempi

A. Restituzione di informazioni sui processi locali

Nell'esempio seguente vengono restituite informazioni sui processi gestiti a livello locale.

USE msdb ;
GO

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

B. Restituzione di informazioni sugli avvisi

Nell'esempio seguente vengono restituite informazioni sulla categoria di avvisi Replication.

USE msdb ;
GO

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