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;
复制查询或添加连接时,很容易漏掉引号。定义新的事件架构时,选择小写名称,并让各个生产者使用相同的拼写。
现有架构
现有的大小写混合字段可以保留。查询时统一加上引号,导出到其他系统的查询也不例外。如果重命名字段,应同时更新生产者和使用该字段的代码。更改拼写会创建另一个字段,不会重命名历史数据。
修改仪表板或告警正在使用的字段前,请阅读架构演进。