数据保留和删除

保留是活动合同的一部分。在发送生产数据之前，确定表的有用时间、它包含哪些标识符，以及法律或客户承诺是否需要缩短生命周期。

按表设置保留

具有不同用途的表不应继承一项偶然的策略。与小批量计费里程碑或审计记录相比，大批量运营事件可能需要更短的窗口。

使用表 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参考 中描述的支持的删除端点。将目标表、谓词、请求者、批准和完成证据保留在负责删除请求的系统中。不要将私有行内容复制到该记录中。

可删除性设计

当表必须支持主题级删除时，请使用稳定的不透明帐户和用户标识符。自由格式的文本和不一致的标识符使得安全地找到每个适用的行变得困难。

首先避免发送机密、支付数据、请求正文或原始提示。删除并不能替代数据最小化。

验证生命周期

更改保留后，获取表元数据并确认存储的策略。删除后，查询精确谓词，直至操作完成。验证仪表板并保存预期已删除历史记录的查询。

当引入新的标识符、事件源、区域或客户承诺时，检查保留情况。继续 脱敏敏感数据 和 分区列。