sp_help_category(Transact-SQL)
지정된 클래스의 작업, 경고 또는 운영자에 관한 정보를 제공합니다.
.gif "항목 링크 아이콘")
구문
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입니다. 1은 category_type을 이름으로 표시하고 0은 ID로 표시합니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
@suffix가 0이면 sp_help_category가 다음과 같은 결과 집합을 반환합니다.
열 이름 |
데이터 형식 |
설명 |
|---|---|---|
category_id |
int |
범주 ID입니다. |
category_type |
tinyint |
범주의 유형입니다. 1 = 로컬 2 = 다중 서버 3 = 없음 |
name |
sysname |
범주의 이름입니다. |
@suffix가 1이면 sp_help_category가 다음과 같은 결과 집합을 반환합니다.
열 이름 |
데이터 형식 |
설명 |
|---|---|---|
category_id |
int |
범주 ID입니다. |
category_type |
sysname |
범주의 유형입니다. LOCAL, MULTI-SERVER 또는 NONE 중 하나입니다. |
name |
sysname |
범주의 이름입니다. |
주의
sp_help_category는 msdb 데이터베이스에서 실행되어야 합니다.
매개 변수가 지정되지 않은 경우에는 결과 집합이 모든 작업 범주에 관한 정보를 제공합니다.
사용 권한
기본적으로 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