本页内容
GreptimeDB v1.3.1 已于 2026 年 11 月 13 日发布。这是 v1.3 的维护版本,主要修复了 v1.3.0 发布后发现的缺陷、性能问题和安全问题。
建议所有 v1.3.0 用户升级。v1.3.0 可以直接原地升级到 v1.3.1,少数情况需要注意,见文末升级说明。
写入可靠性
- 修复重分区(repartition)回滚或 Datanode 重启时,可能丢失部分已写入数据的问题。
- 修复默认配置下,本地 WAL 的周期性刷盘没有真正写入磁盘的问题。
权限与凭据
- 通过 HTTP、MySQL、PostgreSQL 切换数据库时,会检查用户是否有该数据库的访问权限。
- 管理类函数必须具备
ADMIN权限才能执行,通过SELECT调用时同样如此。 - 诊断配置、启动日志和表选项中不再显示密码等凭据。
- 升级 PostgreSQL 协议依赖,修复一个 TLS 安全问题。
查询结果
- 修复分区列变更后,MySQL 和 PostgreSQL 预处理语句(prepared statement)返回错误结果的问题,包括预处理的
INSERT ... SELECT写入错误的行。 - 修复若干 PromQL 结果错误,例如同一时间点存在重复样本时的计算。
- 合入 DataFusion 上游的多项修复,涉及 join 结果错误和查询卡死。
性能
- 修复长时间范围 PromQL 查询读取效率下降的问题。
- 修复部分情况下 compaction 无法结束的问题。
- 分布式 join 查询读取的数据更少,按
trace_id等字段关联的查询更快。
Dashboard
Dashboard 更新到 v0.14.6,信号探索的 Traces 视图新增 Service Map,展示服务间的实时调用关系,基于语义层。

可以通过在线演示实例 live.cloud.greptime.cn 直接体验,实例运行 v1.3.1,持续写入 OpenTelemetry Demo 的指标、日志和链路数据。
升级说明
v1.3.0 可以直接原地升级到 v1.3.1,升级前请备份数据与配置。以下情况需要留意:
- MySQL 应用如果连接时没有指定数据库,且没有默认
public数据库的访问权限,需要先USE一个有权限的数据库,再执行查询。 - PostgreSQL 应用连接时指定的数据库必须存在且有访问权限,否则连接会被拒绝。
- 使用 Prometheus Remote Read 读取的表,标签列需要是字符串类型,否则会返回错误。标签匹配也改为 Prometheus 语义(正则匹配完整字符串,缺失或 NULL 标签按空字符串匹配),已有查询的结果可能变化。
- 如果手动给表配置过稀疏主键编码(
memtable.partition_tree.primary_key_encoding = 'sparse'),升级前请对照 #10020 检查表结构。
分布式部署、日志写入等其他兼容性说明见 Release Notes。
获取 v1.3.1
使用 Docker 单机部署时,镜像为 greptime/greptimedb:v1.3.1,国内可以使用 greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v1.3.1。从 v1.3.0 升级时,停止并删除原容器,再用新镜像、原来的启动参数和数据目录启动。默认配置下的命令如下:
shell
docker run -p 127.0.0.1:4000-4003:4000-4003 \
-v "$(pwd)/greptimedb_data:/greptimedb_data" \
--name greptime --rm \
greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v1.3.1 standalone start \
--http-addr 0.0.0.0:4000 \
--grpc-bind-addr 0.0.0.0:4001 \
--mysql-addr 0.0.0.0:4002 \
--postgres-addr 0.0.0.0:4003其他部署方式见安装文档。
安装包和完整变更列表见 GitHub Release。使用中遇到问题,欢迎到 GitHub Issues 反馈。
感谢参与本次发布的 19 位贡献者,其中 6 位首次贡献。完整名单见 贡献者致谢。


