文档文档

稳定性和兼容性

此页面记录了 InfluxDB OSS 的早期版本。 InfluxDB OSS v2 是最新的稳定版本。 请参阅 InfluxDB v2 文档

1.x API 兼容性和稳定性

1.0 版本更重要的方面之一是,这标志着我们的 API 和存储格式的稳定。 在过去的三年中,我们进行了积极的迭代,经常在此过程中破坏 API。 随着 1.0 版本的发布以及整个 1.x 版本系列,我们承诺以下内容

没有破坏 InfluxDB API 的更改

对于 InfluxDB API,如果一个命令在 1.0 中有效,那么它在所有 1.x 版本中都将保持不变……但有一个例外。 我们将向查询语言添加 关键字。 如果您将所有 标识符 括在双引号中,并将所有字符串文字括在单引号中,则新关键字不会破坏您的查询。 这通常被认为是最佳实践,因此无论如何都应该遵循。 对于遵循该指南的用户,查询和摄取 API 在所有 1.x 版本中都不会有破坏性更改。 请注意,这不包括项目中的 Go 代码。 InfluxDB 中的底层 Go API 在 1.x 开发过程中可能会发生变化。 用户应通过 InfluxDB API 访问 InfluxDB。

存储引擎稳定性

TSM 存储引擎文件格式现在为版本 1。 虽然我们可能会在 1.x 版本中引入新版本的格式,但这些新版本将与以前的版本并行运行。 这对用户意味着,从一个 1.x 版本升级到另一个版本时,不会有漫长的迁移。

附加变更

查询引擎将在新版本发布过程中进行附加变更。 我们将在语言中引入新的查询函数和新功能,而不会破坏向后兼容性。 我们可能会引入新的协议端点(如二进制格式)以及 Line Protocol 和 Query API 的版本,以提高性能和/或功能,但它们必须与现有版本并行运行。 在整个 1.x 版本系列中,将支持现有版本。

持续支持

我们将继续修复 Line Protocol、Query API 和 TSM 存储格式的 1.x 版本中的错误。 用户应期望升级到最新的 1.x.x 版本以获得缺陷修复,但这些版本都将与 1.0 API 兼容,并且不需要数据迁移。 例如,如果用户正在运行 1.2,并且 1.3 中发布了缺陷修复,则他们应升级到 1.3 版本。 在 1.4 发布之前,补丁修复将进入 1.3.x。 因为所有未来的 1.x 版本都可以直接替换以前的 1.x 版本,所以用户应升级到 1.x 系列中的最新版本以获取所有缺陷修复。


此页内容对您有帮助吗?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。 您可以继续像现在一样使用它,而无需对代码进行任何更改。

阅读更多

现已正式发布

InfluxDB 3 Core 和 Enterprise

快速启动。 更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速的最新数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。 InfluxDB 3 Enterprise 以 Core 的基础为构建,增加了高可用性、读取副本、增强的安全性以及数据压缩,从而实现更快的查询和优化的存储。 InfluxDB 3 Enterprise 的免费层可供非商业家庭或爱好者使用。

有关更多信息,请查看