将 TimescaleDB 升级到新的小版本

Timescale Cloud：性能、扩展、企业级

自托管产品

MST

小版本升级是指您从 TimescaleDB `<主要版本号>.x` 更新到 TimescaleDB `<主要版本号>.y`。主版本升级是指您从 TimescaleDB `X.<小版本号>` 更新到 `Y.<小版本号>`。
您可以在同一个 PostgreSQL 实例内的不同数据库上运行不同版本的 TimescaleDB。此过程使用 PostgreSQL 的 `ALTER EXTENSION` 函数，在不同数据库上独立升级 TimescaleDB。

在 Timescale 免费试用

Timescale 是一项完全托管的服务，提供自动备份和恢复、带复制功能的高可用性、无缝扩展和调整大小等更多功能。您可以免费试用 Timescale 三十天。

免费试用

本页介绍如何执行小版本升级，有关主版本升级，请参阅将 TimescaleDB 升级到主版本。

先决条件

在您的迁移机器上安装 PostgreSQL 客户端工具。这包括 `psql` 和 `pg_dump`。
阅读您将升级到的 TimescaleDB 版本的发布说明。
对您的数据库执行备份。尽管 Timescale 升级是原地执行的，但升级是一项侵入性操作。请务必随时准备好备份，并确保在发生灾难时备份可读。

检查 TimescaleDB 和 PostgreSQL 版本

查看自托管数据库实例中运行的 PostgreSQL 和 TimescaleDB 版本

设置您的连接字符串
此变量包含要升级的数据库的连接信息
```
export SOURCE="postgres://<user>:<password>@<source host>:<source port>/<db_name>"
```

检索您正在运行的 PostgreSQL 版本


psql -X -d $SOURCE -c "SELECT version();"

PostgreSQL 返回类似如下内容


-----------------------------------------------------------------------------------------------------------------------------------------
PostgreSQL 17.2 (Ubuntu 17.2-1.pgdg22.04+1) on aarch64-unknown-linux-gnu, compiled by gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0, 64-bit
(1 row)

检索您正在运行的 TimescaleDB 版本


psql -X -d $SOURCE -c "\dx timescaledb;"

PostgreSQL 返回类似如下内容


Name     | Version |   Schema   |                             Description
-------------+---------+------------+---------------------------------------------------------------------
timescaledb | 2.17.2   | public     | Enables scalable inserts and complex queries for time-series data
(1 row)

规划您的升级路径

最佳实践是始终使用最新版本的 TimescaleDB。订阅我们在 GitHub 上的发布，或使用 Timescale Cloud，无需任何麻烦即可始终获得最新更新。

对照您当前运行的 TimescaleDB 和 PostgreSQL 版本以及您要更新到的版本，检查以下支持矩阵，然后选择您的升级路径。

例如，要从 PostgreSQL 13 上的 TimescaleDB 2.13 升级到 TimescaleDB 2.18.2，您需要

将 TimescaleDB 升级到 2.15
将 PostgreSQL 升级到 14、15 或 16。
将 TimescaleDB 升级到 2.18.2。

在升级 TimescaleDB 之前，您可能需要升级到最新 PostgreSQL 版本。此外，如果您使用Timescale Toolkit，请确保 `timescaledb_toolkit` 扩展版本 >=
v1.6.0，然后再升级 TimescaleDB 扩展。

TimescaleDB 版本	PostgreSQL 17	PostgreSQL 16	PostgreSQL 15	PostgreSQL 14	PostgreSQL 13	PostgreSQL 12	PostgreSQL 11	PostgreSQL 10
2.20.x	✅	✅	✅	❌	❌	❌	❌	❌
2.19.x	✅	✅	✅	✅	❌	❌	❌	❌
2.18.x	✅	✅	✅	✅	❌	❌	❌	❌
2.17.x	✅	✅	✅	✅	❌	❌	❌	❌
2.16.x	❌	✅	✅	✅	❌	❌	❌	❌
2.15.x	❌	✅	✅	✅	✅	❌	❌	❌
2.14.x	❌	✅	✅	✅	✅	❌	❌	❌
2.13.x	❌	✅	✅	✅	✅	❌	❌	❌
2.12.x	❌	❌	✅	✅	✅	❌	❌	❌
2.10.x	❌	❌	✅	✅	✅	✅	❌	❌
2.5 - 2.9	❌	❌	❌	✅	✅	✅	❌	❌
2.4	❌	❌	❌	❌	✅	✅	❌	❌
2.1 - 2.3	❌	❌	❌	❌	✅	✅	✅	❌
2.0	❌	❌	❌	❌	❌	✅	✅	❌
1.7	❌	❌	❌	❌	❌	✅	✅	✅

我们不建议将 TimescaleDB 与 PostgreSQL 17.1、16.5、15.9、14.14、13.17、12.21 一起使用。
这些小版本引入了破坏性的二进制接口更改，该更改在被识别后已在随后的 PostgreSQL 小版本 17.2、16.6、15.10、14.15、13.18 和 12.22 中恢复。当您从源代码构建时，最佳实践是使用 PostgreSQL 17.2、16.6 等更高版本进行构建。Timescale Cloud以及适用于 Linux、Windows、MacOS、Docker 和 Kubernetes 的平台包不受影响。

实施您的升级路径

您不能同时升级 TimescaleDB 和 PostgreSQL。您需要按照以下步骤分别升级每个产品

升级 TimescaleDB


psql -X -d $SOURCE -c "ALTER EXTENSION timescaledb UPDATE TO '<version number>';"

如果您的迁移路径要求，请升级 PostgreSQL
请遵循升级 PostgreSQL 中的过程。您的 PostgreSQL 部署中安装的 TimescaleDB 版本在 PostgreSQL 升级前后必须保持一致。

如果您的迁移路径要求，请再次升级 TimescaleDB


psql -X -d $SOURCE -c "ALTER EXTENSION timescaledb UPDATE TO '<version number>';"

检查您是否已升级到正确版本的 TimescaleDB


psql -X -d $SOURCE -c "\dx timescaledb;"

PostgreSQL 返回类似如下内容


Name     | Version | Schema |                                      Description                                      
-------------+---------+--------+---------------------------------------------------------------------------------------
timescaledb | 2.17.2  | public | Enables scalable inserts and complex queries for time-series data (Community Edition)

您正在运行全新版本的 TimescaleDB。

将 TimescaleDB 升级到新的小版本

在 Timescale 免费试用

先决条件

检查 TimescaleDB 和 PostgreSQL 版本

规划您的升级路径

实施您的升级路径

相关内容