QUERY_HISTORY、QUERY_HISTORY_BY_*¶

语法¶

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

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

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

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

实参¶

所有实参均为可选。

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。

INCLUDE_CLIENT_GENERATED_STATEMENT => 'boolean_expr'

指定是否在表函数查询中包含客户端生成的语句（给定 is_client_generated_statement 列的值）。

默认：FALSE。

ACCOUNT_USAGE QUERY_HISTORY 视图 还包含一个 is_client_generated_statement 列，但此视图的查询会返回所有语句，无论它们是否由客户端生成。如由需要，您可以筛选查询结果。

使用说明¶

• 返回当前用户运行的查询。当执行方角色或层次结构中的更高级角色具有以下任一权限时，还会返回任何用户运行的查询：

  • 运行查询的用户管理仓库上的 MONITOR 或 OPERATE 权限。

  • 任务的 MONITOR 或 OPERATE 权限。例外情况：如果任务执行所有者权限的存储过程或 UDF，则该角色至少需要具有执行任务的仓库的 MONITOR 权限，才能查看存储过程查询和 UDF 查询。

  • 任务所在账户的 MONITOR EXECUTION 权限。

  • 例外情况：存储过程 和 用户自定义函数 (UDFs) 都不能运行此查询。

  有关更多信息，请参阅 虚拟仓库权限。

• 调用 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;

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

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY())
  ORDER BY start_time;

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

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY(DATEADD('hours',-1,CURRENT_TIMESTAMP()),CURRENT_TIMESTAMP()))
  ORDER BY start_time;

检索当前用户在过去 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')));

检索针对名为 my_xsmall_wh 的仓库运行的客户端生成的语句数量：

SELECT COUNT(*)
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY_BY_WAREHOUSE(
    WAREHOUSE_NAME => 'my_xsmall_wh',
    INCLUDE_CLIENT_GENERATED_STATEMENT => TRUE));