카테고리:: 테이블 함수

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> ] )

Copy

인자¶

필수:

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;

Copy