Condividi tramite

sp_help_category (Transact-SQL)

  • Articolo

Si applica a: SQL Server

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

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @class = ] 'class'

Specifica la classe relativa alle informazioni richieste. @class è varchar(8)e può essere uno di questi valori.

valore Descrizione
JOB (predefinito) 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 è varchar(12)e può essere uno di questi valori.

valore Descrizione
LOCAL Categoria di processi locali.
MULTI-SERVER Categoria di processi multiserver.
NONE Categoria per una classe diversa da JOB.

[ @name = ] N'name'

Nome della categoria su cui vengono richieste informazioni. @name è sysname, con un valore predefinito .NULL

[ @suffix = ] suffisso

Specifica se la category_type colonna nel set di risultati è un ID o un nome. @suffix è bit, con il valore predefinito 0.

  • 1 visualizza come category_type nome.
  • 0 visualizza come category_type ID.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

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

Nome colonna Tipo di dati Descrizione
category_id int Category ID
category_type tinyint Tipo di categoria:

1 = Locale
2 = Multiserver
3 = Nessuno
name sysname Nome categoria

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

Nome colonna Tipo di dati Descrizione
category_id int Category ID
category_type sysname Tipo di categoria: Uno di LOCAL, MULTI-SERVERo NONE
name sysname Nome categoria

Osservazioni:

sp_help_category deve essere eseguito dal msdb database.

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

Autorizzazioni

È possibile concedere EXECUTE autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero essere sottoposte a override durante un aggiornamento di SQL Server.

È necessario concedere ad altri utenti uno dei ruoli predefiniti del database di SQL Server Agent seguenti:msdb

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

Esempi

R. Restituire informazioni sul processo locale

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. Restituire informazioni sull'avviso

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

Contenuto correlato