sp_help_category(Transact-SQL)sp_help_category (Transact-SQL)

적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) 적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions)

지정된 클래스의 작업, 경고 또는 운영자에 관한 정보를 제공합니다.Provides information about the specified classes of jobs, alerts, or operators.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax

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

인수Arguments

[ @class = ] 'class' 정보를 요청 하는 클래스입니다.[ @class = ] 'class' The class about which information is requested. 클래스varchar (8) 이며 기본값은 JOB 입니다.class is varchar(8), with a default value of JOB. 클래스 는 다음 값 중 하나일 수 있습니다.class can be one of these values.

Value DescriptionDescription
직함JOB 작업 범주에 관한 정보를 제공합니다.Provides information about a job category.
오류ALERT 경고 범주에 관한 정보를 제공합니다.Provides information about an alert category.
연산자OPERATOR 운영자 범주에 관한 정보를 제공합니다.Provides information about an operator category.

[ @type = ] 'type' 정보가 요청 되는 범주의 유형입니다.[ @type = ] 'type' The type of category for which information is requested. typevarchar (12) 이며 기본값은 NULL이 고 다음 값 중 하나일 수 있습니다.type is varchar(12), with a default of NULL, and can be one of these values.

Value DescriptionDescription
LOCALLOCAL 로컬 작업 범주입니다.Local job category.
MULTI -SERVERMULTI -SERVER 다중 서버 작업 범주입니다.Multiserver job category.
NONENONE JOB 이 아닌 다른 클래스에 대 한 범주입니다.Category for a class other than JOB.

[ @name = ] 'name' 정보를 요청 하는 범주의 이름입니다.[ @name = ] 'name' The name of the category for which information is requested. namesysname 이며 기본값은 NULL입니다.name is sysname, with a default of NULL.

[ @suffix = ] suffix 결과 집합의 category_type 열이 ID 인지 아니면 이름 인지를 지정 합니다.[ @suffix = ] suffix Specifies whether the category_type column in the result set is an ID or a name. 접미사bit 이며 기본값은 0 입니다.suffix is bit, with a default of 0. 1category_type 를 이름으로 표시 하 고 0 은 ID로 표시 합니다.1 shows the category_type as a name, and 0 shows it as an ID.

반환 코드 값Return Code Values

0 (성공) 또는 1 (실패)0 (success) or 1 (failure)

결과 집합Result Sets

@ 접미사가 0 이면 sp_help_category 는 다음 결과 집합을 반환 합니다.When @suffix is 0, sp_help_category returns the following result set:

열 이름Column name 데이터 형식Data type DescriptionDescription
category_idcategory_id intint 범주 ID입니다.Category ID
category_typecategory_type tinyinttinyint 범주의 유형입니다.Type of category:

1 = 로컬1 = Local

2 = 다중 서버2 = Multiserver

3 = 없음3 = None
namename sysnamesysname 범주의 이름입니다.Category name

@ 접미사1 인 경우 sp_help_category 는 다음 결과 집합을 반환 합니다.When @suffix is 1, sp_help_category returns the following result set:

열 이름Column name 데이터 형식Data type DescriptionDescription
category_idcategory_id intint 범주 ID입니다.Category ID
category_typecategory_type sysnamesysname 범주의 유형입니다.Type of category. 로컬, 다중 서버 또는 없음 중 하나One of LOCAL, MULTI-SERVER, or NONE
namename sysnamesysname 범주의 이름입니다.Category name

설명Remarks

sp_help_categorymsdb 데이터베이스에서 실행 해야 합니다.sp_help_category must be run from the msdb database.

매개 변수가 지정되지 않은 경우에는 결과 집합이 모든 작업 범주에 관한 정보를 제공합니다.If no parameters are specified, the result set provides information about all of the job categories.

사용 권한Permissions

기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다.By default, members of the sysadmin fixed server role can execute this stored procedure. 다른 사용자는 SQL ServerSQL Server msdb 데이터베이스의 다음 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하세요.For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

Examples

A.A. 로컬 작업 정보 반환Returning local job information

다음 예에서는 로컬로 관리되는 작업에 대한 정보를 반환합니다.The following example returns information about jobs that are administered locally.

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

B.B. 경고 정보 반환Returning alert information

다음 예에서는 복제 경고 범주에 대한 정보를 반환합니다.The following example returns information about the Replication alert category.

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

참고 항목See Also

Transact-sql)sp_add_category ( sp_add_category (Transact-SQL)
Transact-sql)sp_delete_category ( sp_delete_category (Transact-SQL)
Transact-sql)sp_update_category ( sp_update_category (Transact-SQL)
시스템 저장 프로시저(Transact-SQL)System Stored Procedures (Transact-SQL)