类别：

Information Schema、表函数

QUERY_ACCELERATION_HISTORY

QUERY_ACCELERATION_HISTORY 函数用于查询指定日期范围内的 Query Acceleration Service 历史记录。返回的信息包括在给定时间范围内在仓库级别上用于 Query Acceleration Service 的 Credit。

语法

QUERY_ACCELERATION_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , WAREHOUSE_NAME => '<string>' ] )
Copy

参数

所有实参均为可选。

DATE_RANGE_START => constant_expr、. DATE_RANGE_END => constant_expr

显示查询加速历史记录的日期/时间范围。

例如，如果您指定开始日期为 2019-05-03，结束日期为 2019-05-05，则将获得 5 月 3 日、5 月 4 日和 5 月 5 日的数据。（包括端点。）

  • 如果既未指定开始日期也未指定结束日期，则默认为过去 12 小时。

  • 如果未指定结束日期，但指定了开始日期，则会使用午夜时的 CURRENT_DATE 作为范围结束日期。

  • 如果未指定开始日期，但指定了结束日期，则范围从 DATE_RANGE_END 开始前 12 小时算起。

WAREHOUSE_NAME => string

仓库名称。如果指定，则仅显示指定仓库的历史记录。

如果未指定仓库名称，则结果将包括使用 Query Acceleration Service 的每个仓库的历史记录。

输出

该函数返回以下列：

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

该服务处于使用状态的指定时间范围的开始时间。

END_TIME

TIMESTAMP_LTZ

该服务处于使用状态的指定时间范围的结束时间。

CREDITS_USED

NUMBER

该服务使用的 Credit。

WAREHOUSE_NAME

TEXT

使用了该服务的仓库的名称。

NUM_FILES_SCANNED

NUMBER

该服务扫描的文件数。

NUM_BYTES_SCANNED

NUMBER

该服务扫描的字节数。

使用说明

  • 仅为 ACCOUNTADMIN 角色或任何已明确授予 MONITOR USAGE 全局权限的角色返回结果。

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

语言: 中文