知识条目 / Couchbase

Couchbase N1QL 查询慢如何优化?

结合执行计划、覆盖索引与索引节点资源,判断是索引缺失、回表过多还是服务资源不足。

Couchbase 的 N1QL 由查询服务解析并路由到索引服务与数据服务。慢查询可能来自索引未命中、大量回表或索引节点内存不足,需要按执行计划逐层确认。

处理步骤

  1. 获取执行计划对慢语句执行 EXPLAIN,查看是否使用索引扫描、扫描的 span 范围以及是否出现全桶扫描。
  2. 设计覆盖索引把过滤、排序和返回字段纳入索引,减少回表取文档的次数。注意索引键顺序要与查询条件匹配。
  3. 检查服务资源观察索引服务与查询服务的 CPU、内存和请求排队。索引节点内存不足会导致索引加载失败或频繁换入换出。
  4. 验证并持续观察优化后对比执行时间、扫描文档数与服务指标,并在慢查询日志中确认同类语句不再出现。

示例

EXPLAIN
SELECT o.orderId, o.amount
FROM orders o
WHERE o.tenantId = "t-1001"
  AND o.status = "PAID"
ORDER BY o.createdAt DESC
LIMIT 50;

CREATE INDEX idx_orders_tenant_status
ON orders(tenantId, status, createdAt DESC)
USING GSI;

SELECT * FROM system:indexes
WHERE keyspace_id = "orders";

索引数量会增加写入与存储开销。删除索引前确认没有查询依赖,并在低峰期执行构建。

关键词

couchbase · n1ql · 索引 · 执行计划 · explain · 覆盖索引 · 查询服务 · 内存 · 慢查询 · bucket