sp_help_category(Transact-SQL)

적용 대상:SQL Server

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

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @class = ] 'class'

요청되는 정보에 대한 클래스를 지정합니다. @class varchar(8)이며 이러한 값 중 하나일 수 있습니다.

값	설명
JOB(기본값)	작업 범주에 대한 정보를 제공합니다.
ALERT	경고 범주에 대한 정보를 제공합니다.
OPERATOR	연산자 범주에 대한 정보를 제공합니다.

[ @type = ] 'type'

정보가 요청되는 범주의 유형입니다. @type varchar(12)이며 이러한 값 중 하나일 수 있습니다.

값	설명
LOCAL	로컬 작업 범주입니다.
MULTI-SERVER	다중 서버 작업 범주입니다.
NONE	이외의 클래스 JOB에 대한 범주입니다.

[ @name = ] N'name'

정보가 요청되는 범주의 이름입니다. @name sysname이며 기본값은 .입니다NULL.

[ @suffix = ] 접미사

결과 집합의 열이 category_type ID인지 이름인지 지정합니다. @suffix 비트이며 기본값은 .입니다0.

• 1 은 category_type 이름으로 표시합니다.
• 0 은 category_type ID로 표시합니다.

반환 코드 값

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

결과 집합

@suffix0sp_help_category 경우 다음 결과 집합을 반환합니다.

열 이름	데이터 형식	설명
category_id	int	범주 ID
category_type	tinyint	범주 유형: 1 = 로컬 2 = 다중 서버 3 = 없음
name	sysname	범주 이름

@suffix1sp_help_category 경우 다음 결과 집합을 반환합니다.

열 이름	데이터 형식	설명
category_id	int	범주 ID
category_type	sysname	범주의 유형입니다. LOCAL, MULTI-SERVER 또는 NONE 중 하나입니다.
name	sysname	범주 이름

설명

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

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

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

다른 사용자에게는 데이터베이스에서 다음 SQL Server 에이전트 고정 데이터베이스 역할 msdb 중 하나가 부여되어야 합니다.

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

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

예제

A. 로컬 작업 정보 반환

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

USE msdb;
GO

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

B. 경고 정보 반환

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

USE msdb;
GO

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

관련 콘텐츠

• sp_add_category(Transact-SQL)
• sp_delete_category(Transact-SQL)
• sp_update_category(Transact-SQL)
• 시스템 저장 프로시저(Transact-SQL)