跳到主要内容
版本：Nightly

从读副本查询

GreptimeDB 允许从读副本 (Follower Region) 读取数据，从而降低写副本 (Leader Region) 的负载并提升查询伸缩性。你可以通过 SQL 与 HTTP 两种方式设置读优先策略。

读优先策略​

READ_PREFERENCE 支持如下取值：

  • leader：始终从写副本读取。
  • follower：仅从读副本读取；若不存在读副本，则查询失败。
  • follower_preferred：优先从读副本读取；若不可用则回退到写副本。

SQL 协议​

在 SQL 会话中设置读优先：

SET READ_PREFERENCE = 'follower';

HTTP 协议​

在 HTTP 请求中通过请求头指定 X-Greptime-Read-Preference：

curl -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "X-Greptime-Read-Preference: follower" \
  -d "sql=select * from monitoring" \
  http://localhost:4000/v1/sql

示例：从读副本读取​

在从读副本读取之前，需要先为表添加读副本。参见副本管理。

向示例表插入数据：

INSERT INTO foo (ts, i, s)
VALUES
  (1, -1, 's1'),
  (2, 0, 's2'),
  (3, 1, 's3');

设置从读副本读取：

SET READ_PREFERENCE = 'follower';

查询数据：

SELECT * FROM foo ORDER BY ts;

+----------------------------+------+------+
| ts                         | i    | s    |
+----------------------------+------+------+
| 1970-01-01 00:00:00.001000 |   -1 | s1   |
| 1970-01-01 00:00:00.002000 |    0 | s2   |
| 1970-01-01 00:00:00.003000 |    1 | s3   |
+----------------------------+------+------+

验证是否从读副本读取​

可以使用 EXPLAIN ANALYZE 进行验证：

EXPLAIN ANALYZE SELECT * FROM foo ORDER BY ts;
  • 当输出中的 other_ranges 大于 0 时，表示查询涉及了读副本。
  • 若使用 VERBOSE 选项，将看到类似如下的详细信息：
extension_ranges: [LeaderMemtableRange{leader: Peer { id: 1, addr: "192.168.50.189:14101" }, num_rows: 2, time_range: (1::Millisecond, 2::Millisecond) ...

如果仅从写副本读取，上述 extension_ranges 段不会出现。