ONLINE_FEATURE_TABLE_REFRESH_HISTORY¶

此表函数返回有关在线特征表每次刷新（已完成和正在运行）的信息。

此表函数返回所有正在进行的刷新以及当前时间 7 天内具有 REFRESH_START_TIME 的所有刷新。

另请参阅：: CREATE ONLINE FEATURE TABLE、ALTER ONLINE FEATURE TABLE、DESCRIBE ONLINE FEATURE TABLE、DROP ONLINE FEATURE TABLE、SHOW ONLINE FEATURE TABLES

语法¶

ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  [ REFRESH_START_TIMESTAMP => <constant_expr> ]
  [ , REFRESH_END_TIMESTAMP => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , NAME => '<string>' ]
  [ , NAME_PREFIX => '<string>' ]
  [ , ERROR_ONLY => { TRUE | FALSE } ]
)

Copy

实参¶

所有实参均为可选。如果未提供任何实参，则将返回账户中所有在线特征表的 100 次刷新。

REFRESH_START_TIMESTAMP => constant_expr、REFRESH_END_TIMESTAMP => constant_expr

时间范围（以 TIMESTAMP_LTZ 格式），在此期间刷新开始。如果未指定结束版本，则 CURRENT_TIMESTAMP 将用作范围的结束。

RESULT_LIMIT => integer

一个用于指定该函数返回的最大行数的数字。如果匹配的行数大于此限制，则会返回最近完成的刷新（以及仍在运行的刷新），最高不超过指定的限制。

范围：1 至 10000

默认值：None。100。

NAME => 'string'

在线特征表的名称。

可以指定非限定名称 (online_feature_table_name)、部分限定名称 (schema_name.online_feature_table_name) 或完全限定名称 (database_name.schema_name.online_feature_table_name)。

有关对象名称解析的详细信息，请参阅对象名称解析。

函数返回此表的刷新次数。

NAME_PREFIX => 'string'

在线特征表的前缀。

该函数为名称以该前缀开头的表返回刷新。

您可以使用此实参返回特定数据库或架构中在线特征表的刷新次数。

ERROR_ONLY => { TRUE | FALSE }

设置为 TRUE 时，此函数仅返回失败或已取消的刷新次数。

默认：FALSE

输出¶

命令的输出包括以下列，它们描述了对象的属性和元数据：

列	数据类型	描述
`NAME`	TEXT	在线特征表的名称。
`SCHEMA_NAME`	TEXT	包含在线特征表的架构的名称。
`DATABASE_NAME`	TEXT	包含在线特征表的数据库的名称。
`QUALIFIED_NAME`	TEXT	在线特征表的完全限定名称。
`STATE`	TEXT	在线特征表的刷新状态。状态可以是以下状态之一： `EXECUTING`：正在刷新。 `SUCCEEDED`：刷新成功完成。 `FAILED`：刷新在执行期间失败。 `CANCELLED`：刷新在完成前被取消。
`REFRESH_START_TIME`	TIMESTAMP_LTZ	刷新作业开始的时间。
`REFRESH_END_TIME`	TIMESTAMP_LTZ	刷新完成的时间。
`REFRESH_TRIGGER`	TEXT	其中之一： `SCHEDULED`：正常后台刷新以满足目标滞后。 `MANUAL`：用户/任务运行了 `ALTER ONLINE FEATURE TABLE <name> REFRESH` 命令。 `CREATION`：在创建 DDL 语句期间执行的刷新，由创建在线特征表触发。
`REFRESH_ACTION`	TEXT	其中之一： `NO_DATA`：基表中没有新数据。不适用于新建在线特征表的初始刷新，无论基础表是否有数据。 `REINITIALIZE`：基表已更改。 `FULL`：选择使用时默认使用的角色和仓库。完全刷新，因为在线特征表的刷新模式设置为 FULL。 `INCREMENTAL`：正常增量刷新。
`QUERY_ID`	TEXT	为在线特征表生成结果的 SQL 语句的 ID。
`STATE_CODE`	TEXT	表示刷新的当前状态的代码。
`STATE_MESSAGE`	TEXT	刷新的当前状态的说明。

访问控制要求¶

权限	对象	备注
MONITOR	在线特征表	对在线特征表具有 MONITOR 权限的角色。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

使用说明¶

此函数可用于 INFORMATION_SCHEMA。
此函数返回的信息是最新的。ACCOUNT_USAGE.ONLINE_FEATURE_TABLE_REFRESH_HISTORY 视图中的在线特征表刷新历史记录可能会延迟最多 3 小时。

示例¶

以下示例返回账户中所有在线特征表的刷新历史记录：

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY());

Copy

以下示例返回一个名为 my_feature_table 的在线特征表的刷新历史记录：

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME => 'my_feature_table'
));

Copy

以下示例仅返回过去 24 小时内失败的刷新：

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  REFRESH_START_TIMESTAMP => CURRENT_TIMESTAMP - INTERVAL '1 DAY',
  ERROR_ONLY => TRUE
));

Copy

以下示例返回名称以 feature_ 开头的在线特征表的刷新，并将结果限制在 50 行以内：

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME_PREFIX => 'feature_',
  RESULT_LIMIT => 50
));

Copy