弃用 state 字段并提议 last_processed_at 字段¶
本文档提出更改 cloudkitty_storage_states 表中 state 字段的名称。目标是使用更具描述性和意义的名称。 提议的新列名是 last_processed_at。
问题描述¶
cloudkitty_storage_states 表中的 state 列保存了某个 scope 的最后处理周期的时间戳。 该名称的问题在于它不能代表其存储的数据。 像 state 这样的列名会让人期望我们拥有关于资源的一些信息,例如 active/disabled/enabled 或类似的信息。 然而,state 列中并没有这些信息。
提议的变更¶
因此,为了避免混淆,并采用更一致的命名方式,我们建议将该列重命名为 last_processed_at。 此外,我们建议在 scope API 中弃用术语 state,因此,我们不再使用 state 来表示最后处理的时间戳,而是使用 last_processed_at。
备选方案¶
可以考虑其他名称。 由其他人提出,然后我们可以讨论并尝试达成共识。
数据模型影响¶
将 cloudkitty_storage_states 表中的 state 列重命名为 last_processed_at。
REST API 影响¶
在 state 字段旁边引入新的字段 last_processed_at。 然后,我们宣布其弃用,并在 Wallaby 之后完全删除它。
安全影响¶
无
通知影响¶
重命名 cloudkitty_storage_states 表中的 state 字段,并因此在 scope API 中弃用它,同时引入一个与 state 属性并存的新字段。
其他最终用户影响¶
无
性能影响¶
无
其他部署者影响¶
无
开发人员影响¶
无 实现 ==============
负责人¶
- 主要负责人
Rafael <rafael@apache.org>
工作项¶
提议、讨论和合并该规范
执行实现以重命名该列,在 API 中引入新的属性,然后对使用 state 变量发出警告。
在 CloudKitty 客户端中实现更改
在 Wallaby 之后,我们从 API 中删除 state 字段
依赖项¶
无
测试¶
单元测试
文档影响¶
无
参考资料¶
目前没有