跳转到内容
Telemetry
浏览文档
概念与 SQL 模式更新于 2026年7月25日由 Telemetry 编辑团队和产品团队审核阅读约需 1 分钟

随着仪器的增长保持事件字段一致

了解 Telemetry 如何将代理编写的结构化事件转换为稳定、可查询的表。

CamelCase 与 snake_case

在 Telemetry 中,事件字段使用 snake_case。像 total_cost 这样的全小写名称在 SQL 中不需要双引号。像 totalCost 这样的大小写混合名称需要引号来保留大小写。

查询大小写混合的字段

对于 camelCase 字段,写法如下:

SELECT "myFieldName" FROM my_table;

对于 snake_case 字段,写法如下:

SELECT my_field_name FROM my_table;

复制查询或添加连接时,很容易漏掉引号。定义新的事件架构时,选择小写名称,并让各个生产者使用相同的拼写。

现有架构

现有的大小写混合字段可以保留。查询时统一加上引号,导出到其他系统的查询也不例外。如果重命名字段,应同时更新生产者和使用该字段的代码。更改拼写会创建另一个字段,不会重命名历史数据。

修改仪表板或告警正在使用的字段前,请阅读架构演进

相关功能

记录稳定的事件名称、类型明确的字段,以及经过隐私审核的上下文。

页面作者和参考资料

Telemetry 编辑团队负责维护本文;产品团队审核功能行为、示例和适用范围。

我们如何审核文档