进阶 questdb.com 2026-10-13 06:17:07 · 27 阅读

第12章 QuestDB 运维——升级指南

升级 QuestDB

升级到更新版本的 QuestDB 需要替换服务器二进制文件(或拉取新的 Docker 镜像),然后重启进程。现有的数据目录保持不变。此操作适用于 QuestDB 开源版和企业版。

寻找全新安装指南? 如果你第一次配置 QuestDB,请参阅快速入门指南。

升级前准备

* 阅读发布说明。QuestDB 通常具有向后兼容性,但偶尔会出现破坏性变更,这些变更会在发布说明中记录。 * 备份数据。新版本首次启动时,可能会自动迁移内部元数据。一旦执行此操作,回滚到旧版本可能会产生错误。升级前请创建备份或快照,生产实例尤其需要注意。详情请参阅备份与恢复章节。

升级步骤

Docker

拉取最新镜像并重启容器,指向相同的数据卷:

``` docker pull questdb/questdb:latest ```

然后使用新镜像重新创建容器,并为 QuestDB 根目录使用相同的卷挂载:

``` docker stop questdb docker rm questdb docker run -d --name questdb \ -p 9000:9000 -p 9009:9009 -p 8812:8812 \ -v /path/to/questdb-data:/var/lib/questdb \ questdb/questdb:latest ```

将 /path/to/questdb-data 替换为你现有的数据目录路径。

二进制文件

停止正在运行的 QuestDB 进程。 从 GitHub 发布页面下载新二进制文件(或从源码构建)。 用新二进制文件替换旧文件。 启动 QuestDB,并将其指向相同的根目录。

QuestDB 企业版

QuestDB 企业版 BYOC 如果你是企业版 BYOC 客户,升级将由 QuestDB 托管。详见下文“QuestDB 企业版 BYOC”。 企业版的升级流程与标准版一致:替换二进制文件或拉取新镜像,然后重启。 区别在于获取新版本的方式:

二进制文件:从 QuestDB 在入驻期间提供的 SFTP 或分发渠道下载。 Docker:从为你的 AWS 账号加白名单的企业版 ECR 注册表拉取镜像。

如果你不确定在哪里获取最新的 企业版版本,请联系 support@questdb.com。

复制:升级顺序

在使用具有复制功能的 QuestDB 企业版时,请先升级所有副本,再升级主节点。 主节点可能会向对象存储写入包含新元数据格式的 WAL 段。如果旧版本副本遇到其无法识别的元数据,将会报错。先升级副本可确保它们能够处理主节点升级后产生的任何新元数据。 升级到 4.0.0 或更高版本时,请确保所有节点都运行新版本后,再授予 SWITCH ROLE 权限。该权限以旧版本无法读取的格式存储,且在升级前发出的 GRANT ALL 不包含此权限。在 3.3.x 版本中通过 SYSTEM ADMIN 触发角色切换的账户需要显式执行 GRANT SWITCH ROLE。详见“故障转移操作者”。

QuestDB 企业版 BYOC

对于 QuestDB 企业版 BYOC 客户,升级流程由 QuestDB 托管。当有新版本可用时,QuestDB 团队会主动联系以协调升级。如希望提前升级,请联系 support@questdb.com。

评论 (0)