跳至主要內容
Telemetry
瀏覽說明文件
概念與 SQL 模式更新於 2026年7月27日由 Telemetry 編輯團隊和產品團隊審查閱讀約需 2 分鐘

讓程式設計代理使用這篇文件

開啟 Claude Code、Codex、Cursor 或其他編碼代理的集中提示包,然後將其適應此處介紹的工作流程。

本頁內容
  1. 按資料表設定保留
  2. 刪除行或資料表
  3. 可刪除性設計
  4. 驗證生命週期

資料保留和刪除

保留是活動合約的一部分。在傳送生產資料之前,確定資料表的有用時間、它包含哪些識別符號,以及法律或客戶承諾是否需要縮短生命週期。

按資料表設定保留

具有不同用途的資料表不應繼承一項偶然的策略。與小批次計費里程碑或稽核記錄相比,大批次運營事件可能需要更短的視窗。

使用資料表 API 設定或清除保留期:

curl -X PATCH https://api.telemetry.sh/tables/api_requests/retention \
  -H "Authorization: Bearer $TELEMETRY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "retention_days": 30 }'

資料表 API 參考 記錄當前請求和回應合約。

刪除行或資料表

選擇性刪除會非同步重寫受影響的儲存資料。在清理過程中,全資料表刪除會將資料表從正常使用中移除。由於刪除具有破壞性,因此首先使用只讀查詢解析確切的資料表和謂詞。

SELECT COUNT(*) AS rows_to_delete
FROM product_events
WHERE account_id = 'account_123';

然後使用 刪除API參考 中描述的支援的刪除端點。將目標資料表、謂詞、請求者、批准和完成證據保留在負責刪除請求的系統中。不要將私有行內容複製到該記錄中。

可刪除性設計

當資料表必須支援主題級刪除時,請使用穩定的不透明帳戶和使用者識別符號。自由格式的文字和不一致的識別符號使得安全地找到每個適用的行變得困難。

首先避免傳送機密、支付資料、請求正文或原始提示。刪除並不能替代資料最小化。

驗證生命週期

更改保留後,獲取資料表後設資料並確認儲存的策略。刪除後,查詢精確謂詞,直至操作完成。驗證儀表板並儲存預期已刪除歷史記錄的查詢。

當引入新的識別符號、事件源、區域或客戶承諾時,檢查保留情況。繼續 脫敏敏感資料分割區列

相關產品功能

記錄穩定的事件名稱、型別明確的欄位,以及經過隱私審查的上下文。

內容責任與技術參考

Telemetry 編輯團隊負責維護本文;產品團隊審查功能行為、範例和適用範圍。

檢視編輯規範