本页定义了 Looker 事件的概念，这是 Looker (Google Cloud Core) 中按用量付费定价模式所使用的主要用量指标。
什么是 Looker 活动？
Looker 事件是 Looker (Google Cloud Core) 实例上消耗的计量单位。它表示 Looker 从语义层生成查询、检索商家数据并为最终用户对该数据应用转换或视觉背景信息所带来的价值。
在内部，每个 Looker 事件都会映射到查询任务的执行。
查询任务的定义
查询任务是查询操作的内部表示形式，无论查询的启动来源是什么。查询任务的示例包括：
- 在 Looker 探索或自助式探索中运行查询
- 刷新信息中心或 Look 中的板块
- 创建探索、Look 或信息中心图块的 PDF
- 通过 Looker API 以程序化请求形式运行的查询，或作为合并结果的探索的一部分运行的辅助查询
- 使用 Looker 调度程序或提醒的自动数据传送
每个任务代表 1 个 Looker 事件。因此，举例来说，刷新包含 10 个图块的信息中心会生成 10 个查询任务，从而产生 10 个可结算的 Looker 事件。
单个查询任务涵盖查询操作的整个生命周期，从查询发起的那一刻起，直到结果开始流式传输回发起来源。
为何查询任务用于按使用量定价
查询任务在 Looker 中具有独特的优势，能够衡量客户价值和系统资源用量，原因如下：
- 核心价值体现：Looker 的每项核心功能（包括信息中心、自动提醒、预定报告和可视化数据探索）最终都会运行查询。查询任务直接反映了这种价值创造活动。
- 覆盖面广：此指标没有缺口。无论请求是如何发起的（例如，通过界面、使用 API 或通过预定传送），每次运行查询时都会生成一个查询任务。
- 归一化值：查询任务指标会归一化数据检索的值，无论结果是从数据库中提取还是从内部 Looker 缓存中提供。
- 一致的衡量标准：与 API 端点（可以是限定范围的，也可以是不限定范围的，从而导致系统利用率差异）不同，查询任务可为所有活动提供一致的衡量单位。
不可结算的查询任务
为确保实例性能良好并提供清晰公平的用户体验，某些类型的查询任务会从结算流水线中排除。针对以下查询任务生成的 Looker 事件不属于可结算的事件：
- 系统活动查询：针对内部插桩模型运行的查询，用于支持 Looker 监控、使用情况报告和系统活动（在 helltool 中使用的
internal_model配置下）。这样可确保管理员始终能够访问性能和遥测信息（例如 Elite 系统活动或 ESA），即使他们超出结算或治理限制也是如此。 - 建议查询：当用户在过滤条件文本字段中输入内容时，系统会自动向数据库发送查询，以生成过滤条件建议。这些费用不代表客户的直接独立价值，因此不会纳入结算范围。
- 永久性派生表 (PDT) 查询执行：为构建或重建 PDT 而运行的查询。由于 PDT 是一种旨在改善用户体验的性能优化工具，因此 PDT 重建命令不会单独收费，以免影响用户使用 PDT 的意愿，而且这些命令还可以在标准查询执行期间内联触发。
- PDF 预渲染查询：在生成 PDF 文档期间运行查询以填充缓存的任务。PDF 打印会为每个图块触发两次查询（一次用于缓存结果，一次用于从缓存中渲染）。只有最终的缓存读取查询会被计为可结算的事件，而预填充查询会被排除。
未成功完成的查询：未能向用户返回结果的任何查询任务。此任务涵盖导致状态不是
COMPLETE的数据库查询，包括以下情况：ERRORKILLEDCACHE_ONLY_MISSREJECTED（治理拒绝）
所有其他查询任务（包括缓存命中）仍需付费，以便正确反映 Looker 实例处理的查询流量。