REST_EVENT_HISTORY

REST_EVENT_HISTORY 테이블 함수는 지정된 시간 구간 동안 Snowflake에 대해 이루어진 SCIM REST API 요청 목록을 반환해요.

출처: REST_EVENT_HISTORY

본문

REST_EVENT_HISTORY 함수는 지정된 시간 구간 동안 Snowflake에 대해 이루어진 SCIM REST API 요청 목록을 반환해요.

구문 (Syntax)

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

인자 (Arguments)

필수 (Required):

REST_SERVICE_TYPE => 'scim' — REST API 서비스의 유형이에요. 현재 Snowflake는 SCIM만 지원해요.

선택 (Optional):

TIME_RANGE_START => <constant_expr>, TIME_RANGE_END => <constant_expr> — 로그인 이벤트가 발생한 시간 구간(TIMESTAMP_LTZ 형식, 지난 7일 이내)이에요. TIME_RANGE_START를 지정하지 않으면 지난 7일의 모든 로그를 반환해요. TIME_RANGE_END를 지정하지 않으면 모든 로그를 반환해요. 시간 구간이 지난 7일 내에 속하지 않으면 오류가 반환돼요. 사용할 수 있는 함수에 대한 자세한 내용은 날짜 및 시간 함수(Date & time functions)를 참조해요.
RESULT_LIMIT => — 함수가 반환하는 최대 행 수를 지정하는 숫자예요. 일치하는 행 수가 이 한도를 초과하면 가장 최근 종료 시간(또는 아직 실행 중인)의 쿼리가 지정된 한도까지 반환돼요. 범위: 1 ~ 10000, 기본값: 100.

사용 메모 (Usage notes)

현재 REST_EVENT_HISTORY 테이블 함수는 SCIM에서만 사용할 수 있어요.
계정 관리자(즉 ACCOUNTADMIN 역할을 가진 사용자)만 쿼리 결과를 얻을 수 있어요.

출력 (Output)

함수는 다음 열을 반환해요:

열 이름 (Column Name)	데이터 타입 (Data Type)	설명 (Description)
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 주소. IPv4 또는 IPv6 주소일 수 있어요
ACTOR_NAME	TEXT	요청을 수행한 액터(actor)의 이름
ACTOR_DOMAIN	TEXT	요청이 이루어진 도메인(즉, 보안 통합)
RESOURCE_NAME	TEXT	요청을 수행한 객체의 이름
RESOURCE_DOMAIN	TEXT	요청을 수행한 객체의 유형 (예: user)

예제 (Examples)

지난 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;

더 알아보기 (Learn more)

테이블 함수 (Table functions)
정보 스키마 (Snowflake Information Schema)