카테고리:

테이블 함수

REST_EVENT_HISTORY

지정된 시간 간격 동안 Snowflake에 대해 이루어진 SCIM REST API 요청 목록을 반환합니다.

구문

REST_EVENT_HISTORY(
      REST_SERVICE_TYPE => 'scim'
      [, TIME_RANGE_START => <constant_expr> ]
      [, TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ] )

인자

필수:

REST_SERVICE_TYPE => 'scim'

REST API 서비스의 유형입니다. 현재, Snowflake는 SCIM 만 지원합니다.

선택 사항:

{} => <constant_expr>, . {} => <constant_expr>

로그인 이벤트가 발생한 지난 7일 이내의 시간 범위(TIMESTAMP_LTZ 형식)입니다.

  • {} 가 지정되지 않은 경우, 지난 7일 동안의 모든 로그가 반환됩니다.

  • {} 가 지정되지 않은 경우, 모든 로그가 반환됩니다.

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

사용할 수 있는 함수에 대한 자세한 내용은 날짜 및 시간 함수 를 참조하십시오.

RESULT_LIMIT => <integer>

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

일치하는 행의 수가 이 제한보다 큰 경우, 지정된 제한까지를 범위로 하여 종료 시간이 가장 최근인 쿼리(또는 여전히 실행 중인 쿼리)가 반환됩니다.

범위: 1 ~ 10000

기본값: 100.

사용법 노트

  • 현재, REST_EVENT_HISTORY 테이블 함수는 SCIM 에서만 사용할 수 있습니다.

  • 계정 관리자(즉, ACCOUNTADMIN 역할을 가진 사용자)만 쿼리 결과를 얻을 수 있습니다.

출력

이 함수는 다음 열을 반환합니다.

열 이름

데이터 타입

설명

EVENT_TIMESTAMP

TIMESTAMP_LTZ

이벤트 발생 시간입니다.

EVENT_ID

NUMBER

요청의 고유 식별자입니다.

EVENT_TYPE

TEXT

REST API 이벤트 카테고리입니다. 현재, SCIM 이 유일한 가능한 값입니다.

ENDPOINT

TEXT

API 요청의 엔드포인트(예: scim/v2/Users/<id>)입니다.

METHOD

TEXT

요청에 사용된 HTTP 메서드입니다.

STATUS

TEXT

요청의 HTTP 상태 결과입니다.

ERROR_CODE

TEXT

요청이 성공하지 못한 경우, 오류 코드입니다.

DETAILS

TEXT

JSON 형식의 API 요청 결과에 대한 설명입니다.

CLIENT_IP

TEXT

요청이 시작된 IP 주소입니다.

ACTOR_NAME

TEXT

요청하는 작업자의 이름입니다.

ACTOR_DOMAIN

TEXT

요청이 이루어진 도메인(즉, 보안 통합)입니다.

RESOURCE_NAME

TEXT

요청하는 오브젝트의 이름입니다.

RESOURCE_DOMAIN

TEXT

요청하는 오브젝트 유형(예: 사용자)입니다.

지난 5분 동안 이루어진 SCIM REST API 요청(최대 요청 200개)을 반환합니다.

use role accountadmin;
use database my_db;
use schema information_schema;
select *
  from table(rest_event_history(
      rest_service_type => 'scim',
      time_range_start => dateadd('minutes',-5,current_timestamp()),
      time_range_end => current_timestamp(),
      200))
  order by event_timestamp;
맨 위로 이동