QUERY_HISTORY、QUERY_HISTORY_BY_*¶

语法¶

QUERY_HISTORY(
      [ END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_SESSION(
      [ SESSION_ID => <constant_expr> ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_USER(
      [ USER_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_WAREHOUSE(
      [ WAREHOUSE_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

实参¶

所有实参均为可选。

END_TIME_RANGE_START => constant_expr、. END_TIME_RANGE_END => constant_expr

过去 7 天内查询完成运行的时间范围（采用 TIMESTAMP_LTZ 格式）：

• 如果未指定 END_TIME_RANGE_END，该函数将返回所有查询，包括仍在运行的查询。

• 如果 END_TIME_RANGE_END 为 CURRENT_TIMESTAMP，该函数仅返回已完成的查询。

如果时间范围不在过去 7 天内，则会返回错误。

备注

如果未指定开始或结束时间，则返回最近的查询，最多不超过指定的限制。

SESSION_ID => constant_expr

仅适用于 QUERY_HISTORY_BY_SESSION

会话或 CURRENT_SESSION 的数字标识符。仅返回来自指定会话的查询。

默认：CURRENT_SESSION

USER_NAME => 'string'

仅适用于 QUERY_HISTORY_BY_USER

指定用户登录名或 CURRENT_USER 的字符串。仅返回指定用户运行的查询。请注意，登录名称必须放在单引号内。此外，如果登录名称包含任何空格、混合大小写字符或特殊字符，则名称必须在单引号内使用双引号（例如 '"User 1"' 和 'user1'）。

默认：CURRENT_USER

WAREHOUSE_NAME => 'string'

仅适用于 QUERY_HISTORY_BY_WAREHOUSE

指定仓库名称或 CURRENT_WAREHOUSE 的字符串。仅返回该仓库执行的查询。注意，仓库名称必须使用单引号括起来。此外，如果仓库名称包含任何空格、混合大小写字符或特殊字符，则名称必须在单引号内使用双引号（例如 '"My Warehouse"' 和 'mywarehouse'）。

默认：CURRENT_WAREHOUSE

RESULT_LIMIT => num

用于指定函数返回的行数上限的数字：

如果匹配的行数大于此限制，则返回具有最近结束时间的查询（或仍在执行的查询），直至达到指定的限制。

范围：1 至 10000

默认：100。

使用说明¶

• 返回当前用户运行的查询。当执行角色或层次结构中的更高角色对运行查询的仓库具有 MONITOR 或 OPERATE 权限时，还会返回任何用户运行的查询。有关更多信息，请参阅 虚拟仓库权限。

• 当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者 函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。

• EXTERNAL_FUNCTION_TOTAL_INVOCATIONS、EXTERNAL_FUNCTION_TOTAL_SENT_ROWS、EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS、EXTERNAL_FUNCTION_TOTAL_SENT_BYTES 和 EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES 列的值受许多因素影响，包括：

  • SQL 语句中外部函数的数量。

  • 发送到每个远程服务的每批的行数。

  • 由于暂时性错误（例如，由于未在预期时间内收到响应）而导致的重试次数。

输出¶

该函数返回以下列：

QUERY_TYPE 列的潜在值包括：

• CREATE_USER

• CREATE_ROLE

• CREATE_NETWORK_POLICY

• ALTER_ROLE

• ALTER_NETWORK_POLICY

• ALTER_ACCOUNT

• DROP_SEQUENCE

• DROP_USER

• DROP_ROLE

• DROP_NETWORK_POLICY

• RENAME_NETWORK_POLICY

• REVOKE

示例¶

检索当前会话中最近运行的最多 100 个查询：

select *
from table(information_schema.query_history_by_session())
order by start_time;

Copy

检索当前用户最近运行的最多 100 个查询（或当前用户拥有 MONITOR 权限的任何仓库上的任何用户运行的查询）：

select *
from table(information_schema.query_history())
order by start_time;

Copy

检索当前用户在过去一小时内最近运行的最多 100 个查询（或当前用户拥有 MONITOR 权限的任何仓库上的任何用户运行的查询）：

select *
from table(information_schema.query_history(dateadd('hours',-1,current_timestamp()),current_timestamp()))
order by start_time;

Copy

检索当前用户在过去 7 天内指定的 30 分钟时间段内运行的所有查询（或当前用户拥有 MONITOR 权限的任何仓库上的任何用户运行的查询）：

select *
  from table(information_schema.query_history(
    END_TIME_RANGE_START=>to_timestamp_ltz('2017-12-4 12:00:00.000 -0700'),
    END_TIME_RANGE_END=>to_timestamp_ltz('2017-12-4 12:30:00.000 -0700')));

Copy