文档文档

稳定性和兼容性

此页面记录了 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 版本升级到另一个版本时,不会有冗长的迁移。

附加更改

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

持续支持

我们将继续修复 行协议、查询 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 开源版本现已公开发布 Alpha 版

InfluxDB 3 开源版本现已可用于 Alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个作为 Alpha 版本一部分的产品。

InfluxDB 3 Core 是我们新的开源产品。 它是用于时间序列和事件数据的最新数据引擎。 InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询功能、只读副本、高可用性、可扩展性和细粒度的安全性。

有关如何入门的更多信息,请查看