弃用 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 属性并存的新字段。

其他最终用户影响

性能影响

其他部署者影响

开发人员影响

无 实现 ==============

负责人

主要负责人

工作项

  1. 提议、讨论和合并该规范

  2. 执行实现以重命名该列,在 API 中引入新的属性,然后对使用 state 变量发出警告。

  3. 在 CloudKitty 客户端中实现更改

  4. 在 Wallaby 之后,我们从 API 中删除 state 字段

依赖项

测试

单元测试

文档影响

参考资料

目前没有