升级 timescaleDB 插件 - 公有云文档中心

TimescaleDB 是一个旨在使 SQL 可扩展以适用于时间序列数据的开源数据库。它由 PostgreSQL 设计并打包为 PostgreSQL 扩展，提供跨时间和空间的自动分区（分区键）以及完整的 SQL 支持。

本小节主要介绍如何升级 timescaleDB 插件至 1.7.3 版本。

约束限制

仅支持升级到 PG11-高可用版-1.0.9 及以上版本的集群。
仅支持升级到更高版本。

前提条件

已获取管理控制台登录账号和密码，且已获取集群操作权限。
升级插件前，请执行验证更新版本影响操作。
节点状态活跃，节点服务状态正常。

操作步骤

登录管理控制台。
选择产品与服务 > 数据库与缓存 > 关系型数据库 PostgreSQL，进入集群管理页面。
点击目标集群 ID，进入集群详情页面。

备份集群并验证更新版本影响

备份原集群，详细操作请参见创建备份。
备份数据库并保存备份文件。

由于 timescaleDB 1.6.1 版本 release note 说明，For this release only, you need to restart the database after upgrade before restoring a backup.因此，升级前需要使用 pg_dump 进行数据库的备份工作。

timescaleDB release notes：https://docs.timescale.com/timescaledb/latest/overview/release-notes/#main-content
判断当前备份集群版本是否为 PG11-高可用版-1.0.9 版本。
- 是，执行下一步。
- 否，请升级该集群版本到 PG11-高可用版-1.0.9 版本，详细操作请参见升级版本。

升级备份集群的 timescaleDB 插件。

使用数据库连接软件（PgAdmin、DBeaver 或直接使用 psql）通过 root 账户连接数据库高可用写IP。

如果您正在使用 psql，请与 -X 标志连接，以防止任何命令在 .psqlrc 会话启动时加载以前的 TimescaleDB 版本，示例如下：

psql -U <root> -h <ip> -p <port> -d <serverName> -X

选项说明示例

选项	说明	示例
-U	数据库超级管理员账号名。	root
-h	数据库节点 IP 或集群的高可用写 IP	192.168.100.0
-p	端口号	-
-d	数据库名称。新建数据库默认名称 `qingcloud`。	qingcloud
-X	psql在连接数据库之前，首先会读取并执行改文件中的命令，然后连接到数据库，如果加上-X参数，则跳过该文件。通过该文件可以设置客户端或者是服务端的风格。	-

-U

数据库超级管理员账号名。

root

-h

数据库节点 IP 或集群的高可用写 IP

192.168.100.0

-p

端口号

-d

数据库名称。
新建数据库默认名称 qingcloud。

qingcloud

-X

psql在连接数据库之前，首先会读取并执行改文件中的命令，然后连接到数据库，如果加上-X参数，则跳过该文件。通过该文件可以设置客户端或者是服务端的风格。

执行如下 SQL 语句更新 timescaleDB 版本至 1.7.3：
```
ALTER EXTENSION timescaledb UPDATE TO '1.7.3';
```
注意：需要将更新语句作为连接数据库后的第一条命令执行，否则执行会报如下错误：

验证数据。
- 若数据无误，则升级完成，可升级原集群 timescaleDB 插件。
- 若数据异常，请使用 pg_restore 从备份文件中恢复数据库。若能正常恢复，可升级原集群 timescaleDB 插件；否则，请联系技术支持。

升级原集群插件

备份数据库并保存备份文件。

由于 timescaleDB 1.6.1 版本 release note 说明，For this release only, you need to restart the database after upgrade before restoring a backup.因此，升级前需要使用 pg_dump 进行数据库的备份工作。
判断原集群版本是否为 PG11-高可用版-1.0.9 版本。

说明

执行该操作前，建议备份集群，详细操作请参见创建备份。
- 是，执行下一步。
- 否，请升级该集群版本到 PG11-高可用版-1.0.9 版本，详细操作请参见升级版本。

说明
执行该操作前，建议备份集群，详细操作请参见创建备份。

升级原集群的 timescaleDB 插件