SQLite 文档的学习笔记(1)长期支持计划

2022-08-04
标签: SQLITE

前段时间偶然用了 sqlite,在阅读了文档后,感到 sqlite 背后是一个严谨、负责、专业的团队。通过阅读这些文档能学习到不少专业知识和精神。

可惜这些文档的中文版,看起来是使用机器翻译的。我打算在这里以读书笔记的方式,给出一份自己翻译的中文版。

这篇支持计划可以看做是今天的作者写给未来的参与者的信,讲述了过去和今天的做法,树立了今后 SQLite 的开发活动价值观和方法论。在我们的项目中,有值得学习的地方。

原始材料:Long Term Support,中文版:长期支持

正文

SQLite 开发者的意愿是:一直支持 SQLite 到 2050 年。

在编写本文的时候,距离 2050 年还有 34 年之遥,谁也不知道那时的世界会是什么样子。同时,我们也不能保证,在那么久远的将来,SQLite 仍然可以使用、抑或能不能运行。然而,我们今天作出保证:我们将按照我们能一直支持到 2050 年的假设去规划我们今天的开发活动,这个远期的目标指引着我们今天的价值取向,有如下几点:

  • 跨平台兼容能力

SQLite 要能运行在具备以下条件的所有平台上:8比特长的字节、2补码的二进制、32位或64位、有C编译器。SQLite 针对当前流行的CPU和操作系统积极主动地开展测试。SQLite 自身代码和使用的文件格式具备极高的可移植性,这将保证它在未来仍可以运行。

  • 稳定的、多个平台一致的数据文件

SQLite 保存数据的文件能在 32-bit、64-bit、大端字节、小端字节等各种平台下,做到逐个 bit 的相同。这意味着你从一种平台拷贝数据文件到另一种平台后,不需要转换数据文件格式就能直接读取和运行。而且,数据文件的格式有着详尽而又稳定的文档。几十年后的 SQLite 仍然可以直接读写今天创建的数据文件。

  • 航空级的软件测试过程

SQLite 程序的每一条机器码的分支指令都从两个方向、反复多次、多种平台、多种编译器的 完备测试 这是乘法关系,假设有10万个测试场景、5次、5种平台、5种编译器,完整的测试次数将是:10万×5×5×5=1250万次测试 。这样做的目的是让代码保持健壮,不易出错,以备未来的各种迁移重构。另外,严格充分的测试,还能让 后继 要为后代考虑,现在维护这套代码的人,到 2050 年还有几个能写? 的开发者敢于编写一些具有试验性的新功能,待这些新功能发布后,如果以往的测试集在新代码上都能通过,我们能有理由的认为,至少所有的旧功能仍然正常工作。

  • 丰富、详尽的文档

SQLite 的文档内容诚恳、坦率、对开发者友好、源代码开放。这些文档从程序员中来、到程序员中去,让后继的开发者能迅速的融入 SQLite 的开发过程中。

附:文档的示范

  1. Architecture of SQLite
  2. Database File Format
  3. Query Planning
  4. The SQLite Bytecode Engine
  5. Compile-time Options
  6. Dynamic Memory Allocation In SQLite
  7. Debugging Hints
  8. How To Corrupt An SQLite Database File
  • 大量的代码注释

SQLite 源代码中,注释占到了 35% 以上。而且这些注释都不是言之无物,反而是大有用处。这些注释的内容包括代码中变量和对象的含义、函数方法的设计意图等。这些代码旨在让新加入的程序员能够无压力的阅读,并且能在数十年的跨度内方便维护,而不至于烂到无从下手。

  • 防范灾难

SQLite 源代码的每次更新记录的每个字节都被加密保存,而且被自动地备份在多个数据中心上,这些数据中心不仅在 地理空间 防天灾 上分隔,而且还分属于 不同的公司 避人祸 。此外,还有数以千计的代码备份在世界各地的私有服务器上。SQLite 的主要开发者生活在世界各地。所以即使 地球少了一块 比如行星撞地球 ,也不会影响到 SQLite。

  • 坚持旧时风格

随着软件工业的发展,每个人或多或少会受到所处时代的潮流和时尚的影响,但 SQLite 开发人员努力避免被最新的编程流行做法所吸引。我们的目标是编写永不过时的代码,好让那些今天尚未出生的程序员在以后的日子里,仍然能够阅读、理解和维护这些代码。

除了声明 “支持” 指被动的解决客户的问题 到2050年以外,SQLite 的开发者承诺:将 C 语言的接口和数据文件格式完全向后兼容。这意味着未来的新代码不破坏旧的接口,旧代码仍然能够调用新代码的接口、读取新版本的数据文件,新旧版本可能横跨几十年之久。

我们的目标:您的孙辈拿到您遗留给他们的 SQLite 数据文件,仍然可以用那时的 SQLite 软件轻松的打开,那种轻松的感觉就和你今天打开别无二致。

给个免费的赞吧~

如果您对本文有疑问或者寻求合作,欢迎 联系邮箱邮箱已到剪贴板

标签: SQLITE

精彩评论

欢迎转载本文,惟请保留 原文出处 ,且不得用于商业用途。
本站 是个人网站,若无特别说明,所刊文章均为原创,并采用 署名协议 CC-BY-NC 授权。