了解 PDT 日志操作

系统活动中的 PDT 事件日志会提供有关 PDT 的历史事件的相关信息,包括 PDT 重新构建和错误。

例如,PDT 事件日志探索可以帮助您排查 PDT 构建失败或触发器卡住的问题,或者,在尝试识别特定表的构建时间和构建流程时,它非常有用。

如需详细了解系统活动中提供的探索,请参阅使用系统活动探索创建 Looker 使用情况报告文档页面。

查看 PDT 日志操作

PDT 日志操作会显示在系统活动 PDT 事件日志探索中。您必须是 Looker 管理员或拥有 see_system_activity 权限才能查看 PDT 事件日志探索。

如需查看 PDT 日志操作及其关联日志操作数据的列表,请从 PDT 事件日志“探索”中的 PDT 事件日志视图中选择操作操作数据字段,以及其他所有必需的字段,您可以在探索菜单中查看此类字段。

了解 PDT 日志操作及其对应的 PDT 日志操作数据对

下表分解了 PDT 事件日志“探索”中的不同日志操作,以及每种事件针对每种类型的事件数据的相应值:

下表使用 PDT 事件日志浏览的 PDT 事件日志视图中的操作操作数据字段。

创建活动

记录操作 日志操作说明 记录操作数据 日志操作数据说明
create begin 当再生线程提取 PDT 时发生。 prod-user-x 表示用户通过“探索”查询 PDT,而表不存在,因此 Looker 必须重新构建 PDT。
create begin 当再生线程提取 PDT 时发生。 prod 表示 PDT 是由数据组或 SQL 触发器(由再生器构建)触发。
create begin 当再生线程提取 PDT 时发生。 dev-user-x 表示已构建了新的开发模式 PDT。

通常在 PDT 的 SQL 发生更改后,系统会在“探索模式”下查询 PDT。这会生成一个新表,以避免影响生产表。
create regen requires 通常表示用户查询的 PDT 引用了另一个尚未构建的 PDT,因此触发了重新构建。 null
create user rebuild 表示用户在“探索”中使用重新构建派生表和运行选项手动重新构建了 PDT。 null
create ready PDT 实际开始构建后,create ready 事件和 create begin 事件之间的差额表示子项重建所需的时间。

如果 create ready 事件发生在 create begin 事件之后,则可能不需要重新构建任何表。
null
create complete 在 PDT 完成构建时发生。 production trigger 表示 PDT 是通过触发器检查构建的(即 PDT 是由再生程序构建的)。
create incremental complete 发生在 PDT 构建完毕(对于增量 PDT 构建)时发生。 increment generation 包含增量的序列号。
create incremental rows 显示最近递增的受影响行数。 rows delta 对于添加的行数,包含正值;对于移除的行数,包含负数。
create sql error 表示 PDT 构建失败,并且发生了 SQL 错误。 sql error 包含从数据库返回的 SQL 错误消息。

我们建议您在 SQL Runner 中运行 PDT 的底层 SQL,以确保没有新修改导致错误。
create child error 创建依赖 PDT 时出错时发生。 sql error 包含从数据库返回的 SQL 错误消息。
create cancelled error 表示 PDT 构建因查询取消而失败。 query killed 表示查询已被终止。如果用户从 Looker 取消查询、用户从数据库取消查询或查询在数据库上超时,就可能会发生这种情况。
create trigger old value 表示检查时采用的旧触发器值。 trigger value 返回旧触发器的返回值。
create trigger new value 表示检查时新的触发器值。 trigger value 返回新触发器的返回值。
create trigger missing 当指定的 PDT 不再存在或已丢弃时,发生在触发器检查期间。 null
create trigger datagroup 发生在触发器检查时是否由数据组触发 PDT。 null

重新生成事件

记录操作 日志操作说明 记录操作数据 日志操作数据说明
regenerate begin 表示生成器正在启动一个进程,例如检查触发器或构建表。

通常,当 regenerate begin 事件没有结束事件且当前未构建 PDT 或未检查触发器时,此日志操作会指明挂起生成器。
connection name 显示重新生成器线程正在运行的连接名称。
regenerate end 表示重新生成工具已完成某个进程(例如检查触发器或重新构建 PDT),或者出现错误。 success 表示触发器已完成检查,PDT 已重新构建。
regenerate end 表示重新生成工具已完成某个进程(例如检查触发器或重新构建 PDT),或者出现错误。 error_in_regen 表示此表重新生成周期出错。
regenerate end 表示重新生成工具已完成某个进程(例如检查触发器或重新构建 PDT),或者出现错误。 datagroup_error 表示检查数据组触发器时出错。
regenerate trace 表示生成器的线程跟踪。 hex id 表示运行进程的 Java 线程。

拖放并发布任务事件

记录操作 日志操作说明 记录操作数据 日志操作数据说明
drop table 表示 PDT 或临时表已从数据库中移除。 unreferenced 表示该表因其关联的触发器值已更改而被丢弃。

如果正在使用其他保留方法,则表示该表已过期。
drop table 表示 PDT 或临时表已从数据库中移除。 zombie 表示该表的注册键不是 connection_reg3 中有效注册键集的一部分,因此它被标记为要丢弃的僵尸表。
drop table 表示 PDT 或临时表已从数据库中移除。 pdt_build_failure_cleanup 当构建失败或被检测到取消时,Looker 会删除可能部分创建的表。
drop table failed 尝试删除 PDT 或临时表失败时发生。 zombie 表示尝试丢弃僵尸表失败。
drop table failed 尝试删除 PDT 或临时表失败时发生。 unreferenced 表示尝试删除未引用的表。
drop view 表示 publish_as_db_view 表已被丢弃。 expired 表示表的生命周期已到期,且表已被丢弃。
drop view failed 表示尝试丢弃 publish_as_db_view 表失败。 zombie 表示尝试丢弃 publish_as_db_view 僵尸表失败。
drop view failed 表示尝试丢弃 publish_as_db_view 表失败。 unreferenced 表示尝试删除 publish_as_db_view 未引用的表失败。
publish task complete 表示上一个视图已被舍弃,新视图已发布。 X 成功,X 失败 指示发布任务是成功还是失败。

数据组触发器事件

记录操作 日志操作说明 记录操作数据 日志操作数据说明
datagroup_triggers begin 表示数据组触发器已开始检查连接。

如果连接的最新 datagroup_triggers begin 行之间存在很大差距,并且没有 datagroup_triggers end,则可能表示重新生成器在检查触发器时卡住了。
connection name 显示触发器正在检查的连接名称。
datagroup_triggers end 表示数据组触发器已完成检查。 null

reap 事件

记录操作 日志操作说明 记录操作数据 日志操作数据说明
reap begin 表示服务器已开始检查连接,以查看应从暂存架构中删除哪些非活跃派生表。 connection name 显示死神正在检查的连接名称。
reap end 表示死工已针对给定连接完成其周期。 connection name 显示死机已检查的连接名称。

触发事件

记录操作 日志操作说明 记录操作数据 日志操作数据说明
trigger value 表示触发器在计算时的值。 trigger value 显示实际触发器值。
trigger value compute 指示用于计算触发器值的 SQL。 trigger sql 显示用于计算触发器值的实际 SQL。
trigger value error 表示计算触发器值或运行触发器 SQL 时发生 SQL 错误。 sql error 显示针对触发器查询返回的数据库 SQL 错误。
trigger datagroup check 表示生成器是否对数据库运行 SQL 触发器查询。 布尔值(truefalse
  • true:表示触发器查询已运行。
  • false:表示 SQL 触发器查询尚未运行。