다음을 통해 공유


sp_help_category(Transact-SQL)

지정된 클래스의 작업, 경고 또는 운영자에 관한 정보를 제공합니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

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

인수

  • [ @class=] 'class'
    정보를 요청한 대상 클래스입니다. class는 varchar(8)이며 기본값은 JOB입니다. class는 다음 값 중 하나를 사용할 수 있습니다.

    설명

    JOB

    작업 범주에 관한 정보를 제공합니다.

    ALERT

    경고 범주에 관한 정보를 제공합니다.

    OPERATOR

    운영자 범주에 관한 정보를 제공합니다.

  • [ @type= ] 'type'
    정보를 요청한 대상 범주의 유형입니다. type은 varchar(12)이고 기본값은 NULL이며 다음 값 중 하나를 사용할 수 있습니다.

    설명

    LOCAL

    로컬 작업 범주입니다.

    MULTI -SERVER

    다중 서버 작업 범주입니다.

    NONE

    JOB이 아닌 다른 클래스에 대한 범주입니다.

  • [ @name= ] 'name'
    정보를 요청한 대상 범주의 이름입니다. name은 sysname이며 기본값은 NULL입니다.

  • [ @suffix= ] suffix
    결과 집합의 category_type 열이 ID인지 아니면 이름인지 여부를 지정합니다. suffix는 bit이며 기본값은 0입니다. 1category_type을 이름으로 표시하고 0은 ID로 표시합니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

@suffix0이면 sp_help_category가 다음과 같은 결과 집합을 반환합니다.

열 이름

데이터 형식

설명

category_id

int

범주 ID입니다.

category_type

tinyint

범주의 유형입니다.

1 = 로컬

2 = 다중 서버

3 = 없음

name

sysname

범주의 이름입니다.

@suffix1이면 sp_help_category가 다음과 같은 결과 집합을 반환합니다.

열 이름

데이터 형식

설명

category_id

int

범주 ID입니다.

category_type

sysname

범주의 유형입니다. LOCAL, MULTI-SERVER 또는 NONE 중 하나입니다.

name

sysname

범주의 이름입니다.

주의

sp_help_categorymsdb 데이터베이스에서 실행되어야 합니다.

매개 변수가 지정되지 않은 경우에는 결과 집합이 모든 작업 범주에 관한 정보를 제공합니다.

사용 권한

기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.

1. 로컬 작업 정보 반환

다음 예에서는 로컬로 관리되는 작업에 대한 정보를 반환합니다.

USE msdb ;
GO

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

2. 경고 정보 반환

다음 예에서는 복제 경고 범주에 대한 정보를 반환합니다.

USE msdb ;
GO

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