sp_help_alert(Transact-SQL)
서버에 대해 정의된 경고에 관한 정보를 보고합니다.
구문
sp_help_alert [ [ @alert_name = ] 'alert_name' ]
[ , [ @order_by = ] 'order_by' ]
[ , [ @alert_id = ] alert_id ]
[ , [ @category_name = ] 'category' ]
[ , [ @legacy_format = ] legacy_format ]
인수
[ @alert_name =] 'alert_name'
경고 이름입니다. alert_name은 nvarchar(128)입니다. alert_name을 지정하지 않으면 모든 경고에 대한 정보가 반환됩니다.[ @order_by =] 'order_by'
결과를 생성하는 데 사용할 정렬 순서입니다. order_by는 sysname이며 기본값은 N 'name'입니다.[ @alert_id =] alert_id
보고할 정보가 있는 경고의 ID입니다. alert_id는 int이며 기본값은 NULL입니다.[ @category_name =] 'category'
경고의 범주입니다. category는 sysname이며 기본값은 NULL입니다.[ @legacy_format=] legacy_format
레거시 결과 집합을 생성할지 여부입니다. legacy_format은 bit이며 기본값은 0입니다. legacy_format이 1이면 sp_help_alert에서는 Microsoft SQL Server 2000에서 sp_help_alert에 의해 반환된 결과 집합을 반환합니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
@legacy_format이 0인 경우 sp_help_alert는 다음과 같은 결과 집합을 만듭니다.
열 이름 |
데이터 형식 |
설명 |
---|---|---|
id |
int |
시스템이 할당한 고유한 정수 ID입니다. |
name |
sysname |
경고 이름(예: Demo: 전체 msdb 로그)입니다. |
event_source |
nvarchar(100) |
이벤트의 원본입니다. Microsoft SQL Server 버전 7.0의 경우 항상 MSSQLServer입니다. |
event_category_id |
int |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. |
event_id |
int |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. |
message_id |
int |
경고를 정의하는 메시지 오류 번호로서 대부분 sysmessages 테이블의 오류 번호에 해당됩니다. 경고를 정의하는 데 심각도가 사용된 경우 message_id는 0이거나 NULL입니다. |
severity |
int |
경고를 정의하는 심각도 수준(9부터 25, 110, 120, 130 또는 140까지)입니다. |
enabled |
tinyint |
현재 경고를 사용할 수 있는지(1) 또는 없는지(0)에 대한 상태입니다. 사용할 수 없는 경고는 전달되지 않습니다. |
delay_between_responses |
int |
경고에 대한 응답 간의 대기 시간(초)입니다. |
last_occurrence_date |
int |
마지막으로 경고가 발생한 날짜입니다. |
last_occurrence_time |
int |
마지막으로 경고가 발생한 시간입니다. |
last_response_date |
int |
SQLServerAgent 서비스가 마지막으로 경고에 응답한 날짜입니다. |
last_response_time |
int |
SQLServerAgent 서비스가 마지막으로 경고에 응답한 시간입니다. |
notification_message |
nvarchar(512) |
전자 메일 또는 호출기 알림의 일부로서 운영자에게 선택적으로 전달되는 추가 메시지입니다. |
include_event_description |
tinyint |
Microsoft Windows 응용 프로그램 로그의 SQL Server 오류에 대한 설명을 알림 메시지의 일부로 포함할지 여부입니다. |
database_name |
sysname |
오류가 있는 경우 경고가 시작되도록 해 놓은 데이터베이스입니다. 데이터베이스 이름이 NULL인 경우에는 오류 발생 위치에 상관 없이 경고가 시작됩니다. |
event_description_keyword |
nvarchar(100) |
제공된 문자 시퀀스와 동일해야 하는 Windows 응용 프로그램 로그 내의 SQL Server 오류에 대한 설명입니다. |
occurrence_count |
int |
경고가 발생한 횟수입니다. |
count_reset_date |
int |
occurrence_count가 마지막으로 다시 설정된 날짜입니다. |
count_reset_time |
int |
occurrence_count가 마지막으로 다시 설정된 시간입니다. |
job_id |
uniqueidentifier |
경고에 응답하여 실행할 작업의 ID입니다. |
job_name |
sysname |
경고에 대한 응답으로 실행할 작업의 이름입니다. |
has_notification |
int |
이 경고를 한 명 이상의 운영자에게 알려 주는 경우에는 0이 아닌 값을 사용합니다. 값은 다음 중 하나 이상이 될 수 있습니다(OR 연산 사용). 1= 전자 메일 알림 2= 호출기 알림 4= Net Send 알림 |
flags |
int |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. |
performance_condition |
nvarchar(512) |
type이 2인 경우 이 열은 성능 조건의 정의를 표시하고, 그렇지 않은 경우 이 열은 NULL입니다. |
category_name |
sysname |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. SQL Server 7.0의 경우 항상 '[범주화되지 않음]'입니다. |
wmi_namespace |
sysname |
type이 3인 경우 이 열은 WMI 이벤트에 대한 네임스페이스를 보여 줍니다. |
wmi_query |
nvarchar(512) |
type이 3인 경우 이 열은 WMI 이벤트에 대한 쿼리를 보여 줍니다. |
type |
int |
이벤트의 유형은 다음과 같습니다. 1 = SQL Server 이벤트 경고 2 = SQL Server 성능 경고 3 = WMI 이벤트 경고 |
@legacy_format이 1인 경우 sp_help_alert는 다음과 같은 결과 집합을 만듭니다.
열 이름 |
데이터 형식 |
설명 |
---|---|---|
id |
int |
시스템이 할당한 고유한 정수 ID입니다. |
name |
sysname |
경고 이름(예: Demo: 전체 msdb 로그)입니다. |
event_source |
nvarchar(100) |
이벤트의 원본입니다. SQL Server 버전 7.0의 경우 항상 MSSQLServer입니다. |
event_category_id |
int |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. |
event_id |
int |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. |
message_id |
int |
경고를 정의하는 메시지 오류 번호로서 대부분 sysmessages 테이블의 오류 번호에 해당됩니다. 경고를 정의하는 데 심각도가 사용된 경우 message_id는 0이거나 NULL입니다. |
severity |
int |
경고를 정의하는 심각도 수준(9부터 25, 110, 120, 130 또는 140까지)입니다. |
enabled |
tinyint |
현재 경고를 사용할 수 있는지(1) 또는 없는지(0)에 대한 상태입니다. 사용할 수 없는 경고는 전달되지 않습니다. |
delay_between_responses |
int |
경고에 대한 응답 간의 대기 시간(초)입니다. |
last_occurrence_date |
int |
마지막으로 경고가 발생한 날짜입니다. |
last_occurrence_time |
int |
마지막으로 경고가 발생한 시간입니다. |
last_response_date |
int |
SQLServerAgent 서비스가 마지막으로 경고에 응답한 날짜입니다. |
last_response_time |
int |
SQLServerAgent 서비스가 마지막으로 경고에 응답한 시간입니다. |
notification_message |
nvarchar(512) |
전자 메일 또는 호출기 알림의 일부로서 운영자에게 선택적으로 전달되는 추가 메시지입니다. |
include_event_description |
tinyint |
Windows 응용 프로그램 로그의 SQL Server 오류에 대한 설명을 알림 메시지의 일부로 포함할지 여부입니다. |
database_name |
sysname |
오류가 있는 경우 경고가 시작되도록 해 놓은 데이터베이스입니다. 데이터베이스 이름이 NULL인 경우에는 오류 발생 위치에 상관 없이 경고가 시작됩니다. |
event_description_keyword |
nvarchar(100) |
제공된 문자 시퀀스와 동일해야 하는 Windows 응용 프로그램 로그 내의 SQL Server 오류에 대한 설명입니다. |
occurrence_count |
int |
경고가 발생한 횟수입니다. |
count_reset_date |
int |
occurrence_count가 마지막으로 다시 설정된 날짜입니다. |
count_reset_time |
int |
occurrence_count가 마지막으로 다시 설정된 시간입니다. |
job_id |
uniqueidentifier |
작업 ID입니다. |
job_name |
sysname |
요청 시 작업으로서 경고에 대한 응답으로 실행되어야 합니다. |
has_notification |
int |
이 경고를 한 명 이상의 운영자에게 알려 주는 경우에는 0이 아닌 값을 사용합니다. 값은 다음 중 하나 이상이 될 수 있습니다(OR 연산으로 조인). 1= 전자 메일 알림 2= 호출기 알림 4= Net Send 알림 |
flags |
int |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다.. |
performance_condition |
nvarchar(512) |
type이 2인 경우 이 열은 성능 조건에 대한 정의를 보여 줍니다. type이 3인 경우 이 열은 WMI 이벤트에 대한 쿼리를 보여 줍니다. 그렇지 않은 경우 이 열은 NULL입니다. |
category_name |
sysname |
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. SQL Server 7.0의 경우 항상 '[범주화되지 않음]'입니다. |
type |
int |
경고의 유형은 다음과 같습니다. 1 = SQL Server 이벤트 경고 2 = SQL Server 성능 경고 3 = WMI 이벤트 경고 |
주의
sp_help_alert는 msdb 데이터베이스에서 실행되어야 합니다.
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 SQLAgentOperatorRole 고정 데이터베이스 역할을 부여 받아야 합니다.
SQLAgentOperatorRole에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
예
다음 예에서는 Demo: Sev. 25 Errors 경고에 대한 정보를 보고합니다.
USE msdb ;
GO
EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors'
GO