跳至主要內容
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 編輯團隊負責維護本文;產品團隊審查功能行為、範例和適用範圍。

我們如何審查文件