类别：: 表函数

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。

可选：

TIME_RANGE_START => <constant_expr>, . TIME_RANGE_END => <constant_expr>

过去 7 天内发生登录事件的时间范围（TIMESTAMP_LTZ 格式）。

如果未指定 TIME_RANGE_START，则返回过去 7 天的所有日志。
如果未指定 TIME_RANGE_END，则返回所有日志。

如果时间范围不在过去 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	发出请求的对象类型（例如用户）。

示例¶

返回过去五分钟内发出的 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