了解 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 build）。 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 build 因查询取消而失败。 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 显示运行 regenerator 线程的连接名称。
regenerate end 表示再生器已完成某个流程（例如检查触发器或重新构建 PDT），或者发生了错误。 success 表示触发器已检查完毕，PDT 已重新构建。
regenerate end 表示再生器已完成某个流程（例如检查触发器或重新构建 PDT），或者发生了错误。 error_in_regen 表示此表重新生成周期中发生了错误。
regenerate end 表示再生器已完成某个流程（例如检查触发器或重新构建 PDT），或者发生了错误。 datagroup_error 表示在检查数据集触发器时发生了错误。
regenerate trace 表示 regenerator 线程跟踪。 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 begin 表示 Reaper 已开始检查连接，以确定应从起始架构中删除哪些非活动派生表。 connection name 显示 Reaper 正在检查的连接的名称。
reap end 表示 Reaper 已完成给定连接的周期。 connection name 显示 Reaper 已检查的连接的名称。

触发事件

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