# GreptimeDB v1.3.1 发布：写入可靠性、安全与查询正确性修复

Source: https://greptime.cn/blogs/2026-11-16-greptimedb-v1-3-1-release

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，展示服务间的实时调用关系，基于[语义层](https://docs.greptime.cn/user-guide/semantic-layer/overview)。

<p align="center">
  <img src="/zh/blogs/2026-11-16-greptimedb-v1-3-1-release/service-map.png" alt="Dashboard 信号探索中的 Service Map" width="960"/>
</p>

可以通过在线演示实例 [live.cloud.greptime.cn](https://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](https://github.com/GreptimeTeam/greptimedb/pull/10020) 检查表结构。

分布式部署、日志写入等其他兼容性说明见 [Release Notes](https://docs.greptime.cn/release-notes/release-1-3-1)。

## 获取 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
```

其他部署方式见[安装文档](https://docs.greptime.cn/getting-started/installation/overview)。

安装包和完整变更列表见 [GitHub Release](https://github.com/GreptimeTeam/greptimedb/releases/tag/v1.3.1)。使用中遇到问题，欢迎到 [GitHub Issues](https://github.com/GreptimeTeam/greptimedb/issues) 反馈。

感谢参与本次发布的 19 位贡献者，其中 6 位首次贡献。完整名单见 [贡献者致谢](https://github.com/GreptimeTeam/greptimedb/releases/tag/v1.3.1#all-contributors)。
