카테고리:: Information Schema , 테이블 함수

ALERT_HISTORY¶

이 INFORMATION_SCHEMA 테이블 함수는 지정된 날짜 범위 내의 경고 기록을 쿼리하는 데 사용할 수 있습니다. 이 함수는 전체 Snowflake 계정 또는 지정된 경고에 대한 경고 기록을 반환합니다.

ACCOUNT_USAGE 스키마의 ALERT_HISTORY 뷰를 통해 이 정보에 액세스할 수도 있습니다. 뷰와 테이블 함수의 차이점에 대한 자세한 내용은 Account Usage와 Information Schema의 차이점 섹션을 참조하십시오.

참고

이 함수는 지난 7일 이내의 경고 실행 또는 향후 8일 이내의 예약된 다음 실행을 반환합니다.

구문¶

ALERT_HISTORY(
      [ SCHEDULED_TIME_RANGE_START => <constant_expr> ]
      [, SCHEDULED_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ]
      [, ALERT_NAME => '<string>' ] )

Copy

인자¶

모든 인자는 선택 사항입니다.

SCHEDULED_TIME_RANGE_START => constant_expr , . SCHEDULED_TIME_RANGE_END => constant_expr

경고에 대한 조건 평가가 예약된 지난 7일 이내의 시간 범위(TIMESTAMP_LTZ 형식).

SCHEDULED_TIME_RANGE_END 가 지정되지 않은 경우, 이 함수는 이미 완료되었거나, 현재 실행 중이거나, 앞으로 예약된 경고를 반환합니다.
SCHEDULED_TIME_RANGE_END 가 CURRENT_TIMESTAMP 인 경우, 함수는 이미 완료되었거나, 현재 실행 중인 경고를 반환합니다. 현재 시간 직전에 실행된 경고는 여전히 예약된 것으로 식별될 수 있습니다.

참고

시작 또는 종료 시간을 지정하지 않는 경우, 지정된 RESULT_LIMIT 값까지를 범위로 하여 가장 최근 경고가 반환됩니다.

시간 범위가 지난 7일 이내에 속하지 않는 경우, 오류가 반환됩니다.

RESULT_LIMIT => integer

함수가 반환하는 최대 행 수를 지정하는 숫자입니다.

일치하는 행의 수가 이 제한보다 큰 경우, 지정된 제한까지를 범위로 하여 타임스탬프가 가장 최근인 경고 실행이 반환됩니다.

범위: 1 ~ 10000

기본값: 100.

ALERT_NAME => string

경고를 지정하는, 대/소문자를 구분하지 않는 문자열입니다. 정규화되지 않은 경고 이름만 지원됩니다. 지정된 경고의 실행만 반환됩니다. 여러 경고의 이름이 같은 경우, 이 함수는 이러한 경고 각각에 대한 기록을 반환합니다.

사용법 노트¶

경고 소유자인 ACCOUNTADMIN 역할(즉, 경고에 대한 OWNERSHIP 권한이 있는 역할)에 대한 결과만 반환합니다.
이 함수는 RESULT_LIMIT 인자 값에 설정된 최대 10,000개의 행을 반환합니다. 기본값은 100 입니다.

ALERT_HISTORY 함수를 쿼리할 때 경고 이름, 시간 범위, 결과 제한 인자가 먼저 적용되고, 지정된 경우 각각 WHERE 및 LIMIT 절이 뒤따릅니다. 또한, ALERT_HISTORY 함수는 SCHEDULED_TIME의 내림차순으로 기록을 반환합니다. 완료된 경고(즉, SUCCEEDED, FAILED 또는 CANCELLED 상태)는 더 일찍 예약되는 경향이 있으므로, 일반적으로 검색 결과의 순서대로 나중에 반환됩니다.

실제로, 계정에서 실행 중인 경고가 많은 경우, 함수가 반환한 결과에는 완료된 경고가 예상보다 적거나 예약된 경고만 포함될 수 있습니다. 특히 RESULT_LIMIT 값이 상대적으로 낮은 경우 더욱 그렇습니다. 이미 실행된 경고의 기록을 쿼리하려면 Snowflake는 SCHEDULED_TIME_RANGE_START => constant_expr 및/또는 SCHEDULED_TIME_RANGE_END => constant_expr 인자 조합을 사용할 것을 권장합니다.
Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.
이 함수는 지난 7일 동안 실행된 모든 실행 또는 향후 8일 이내의 예약된 다음 실행을 반환할 수 있습니다.

출력¶

ALERT_HISTORY 테이블 함수는 경고 실행 시마다 행을 하나씩 생성합니다. 각 행에는 다음 열이 포함됩니다.

열 이름	데이터 타입	설명
NAME	TEXT	경고의 이름입니다.
DATABASE_NAME	TEXT	경고를 포함하는 데이터베이스의 이름입니다.
SCHEMA_NAME	TEXT	경고를 포함하는 스키마의 이름입니다.
CONDITION	TEXT	경고 조건으로 사용되는 SQL 문의 텍스트입니다.
CONDITION_QUERY_ID	TEXT	경고 조건으로 실행되는 SQL 문의 내부/시스템 생성 식별자입니다.
ACTION	TEXT	경고의 동작 역할을 하는 SQL 문의 텍스트입니다.
ACTION_QUERY_ID	TEXT	경고의 동작으로 실행되는 SQL 문의 내부/시스템 생성 식별자입니다.
STATE	TEXT	경고의 상태입니다. 이는 다음 중 하나일 수 있습니다. SCHEDULED: 경고는 SCHEDULED_TIME 열에서 지정한 시간에 실행됩니다. EXECUTING: 경고의 조건 또는 동작이 현재 실행 중입니다. FAILED: 경고가 실패했습니다. 경고 조건 또는 경고 동작에서 실행을 방해하는 오류가 발생했습니다. CANCELLED: 경고 실행이 취소되었습니다(예: 경고가 일시 중단된 경우). CONDITION_FALSE: 조건이 성공적으로 평가되었지만 아무런 데이터도 반환되지 않았습니다. 결과적으로 동작이 실행되지 않았습니다. CONDITION_FAILED: 조건 평가에 실패했습니다. 실패에 대한 자세한 내용은 SQL_ERROR_CODE 및 SQL_ERROR_MESSAGE 열을 확인하십시오. ACTION_FAILED: 조건이 성공적으로 평가되었지만 동작 실행에 실패했습니다. 실패에 대한 자세한 내용은 SQL_ERROR_CODE 및 SQL_ERROR_MESSAGE 열을 확인하십시오. TRIGGERED: 조건이 성공적으로 평가되었으며 동작이 성공적으로 실행되었습니다.
SQL_ERROR_CODE	NUMBER	경고가 오류를 반환했거나 실행되지 못한 경우(예: 현재 사용자에게 경고를 실행할 권한이 없는 경우)의 오류 코드입니다.
SQL_ERROR_MESSAGE	VARCHAR	경고가 오류를 반환한 경우 오류 메시지입니다.
SCHEDULED_TIME	TIMESTAMP_LTZ	경고가 실행을 시작하도록 예약된 시간입니다. 저희는 절대적인 정확성을 보장하기 위해 최선을 다하지만, 예약된 시간 이전에 경고가 실행되지 않는다는 것만 보장합니다.
COMPLETED_TIME	TIMESTAMP_LTZ	경고가 완료된 시간입니다. 또는 SCHEDULED_TIME이 미래이거나 경고가 여전히 실행 중인 경우 NULL입니다.

예¶

경고 실행 모니터링하기 섹션을 참조하십시오.