跳到内容
光环标志
光环基地

绩效审计 p99

识别慢速查询,了解 EXPLAIN ANALYZE、索引策略以及在生产中杀死 Postgres 的 5 种反模式。

操作指南14分钟 读取级别 先进的修改于 2026年4月15日

该页面已自动翻译。英文版具有权威性。

优化前测量#

审计从数字开始。 Studio 通过端点和查询公开 p50/p95/p99。在进行任何更改之前捕获 7 天的基线。

信息

aura db slow-queries 和 aura db stats CLI 命令查询链接项目上的 pg_stat_statements 和数据库池/大小指标,范围仅限于您的项目(也可在 Studio › 数据库和日志中使用)。 aura db inspect indexes|tables|locks 列出了索引使用情况(标记了未使用的索引)、表大小和死行以及阻塞锁 — /raw 无法运行这些诊断,因为它拒绝系统目录。

clibash
# 10 个最昂贵的查询(总时间)
aura db slow-queries --limit 10

# 连接和数据库大小(端点延迟:Studio › 日志)
aura db stats

实时 pg_stat_statements#

pg_stat_statements 在每个新项目上安装并预加载。它将每个规范化查询(不存储文字值)与 mean_exec_time、 calls 和 rows聚合。 /raw 不会直接读取它 - 视图是集群范围的 - 因此请使用上面的命令,这些命令仅返回项目的查询,或 Studio › 数据库。

top-10bash
aura db slow-queries --limit 10 --json
aura db inspect indexes        # idx_scan = 0 并且不是唯一/主要 → 未使用

像专业人士一样阅读计划#

运行时间超过项目语句超时(10 秒)的查询将通过 STATEMENT_TIMEOUT (HTTP 504) / «canceling statements due to statements timeout » in aura db raw取消:减少工作或拆分工作。

该计划告诉您 为什么 查询很慢。需要寻找的 4 个信号:

  • 表 > 10k 行上的 Seq Scan → 缺少索引
  • rows (estimated) ≠ rows (actual) ±10× → 过时的统计数据,analyze table_name
  • 100k+ 行上的 Nested Loop → 首选散列连接,可能缺少 WHERE
  • Materialize 或 Sort Method: external merge → RAM 耗尽,work_mem 增加
debugsql
explain (analyze, buffers, format json)
select * from orders
where customer_id = 'abc' and created_at > now() - interval '30 days';

何时、何事、如何#

  • B 树 (默认):相等、范围、排序依据。 80%的情况。
  • GIN:全文搜索、JSONB、表格。 using gin (to_tsvector('french', body))。
  • GiST:范围类型、排除约束、相似性搜索 (pg_trgm)。
  • HNSW (pgvector):矢量搜索,> 100k 个矢量。
  • 部分:通用条件,where deleted_at is null 用于软删除。
  • 覆盖: include (...) 以避免在表上查找。
注意

每个索引都会减慢 INSERT/UPDATE/DELETE 速度(每个索引约 5-15%)。删除未使用的索引 - aura db inspect indexes 列出它们(从未扫描,不是唯一的,不是主要的)。

是什么杀死了生产中的 Postgres#

  1. N+1 查询 — 在 SDK 中进行连接或使用 !inner 而不是循环
  2. 按 OFFSET 分页 — 超过 1000,使用基于游标的 (where id > last_seen)
  3. SELECT * 在大型表上 — 仅请求必要的列
  4. 长事务 — 这些会阻塞 VACUUM 并导致膨胀。保持 < 1 秒
  5. 非索引 RLS 策略 — 如果您的策略使用 tenant_id = auth.tenant(),则索引 tenant_id

为了走得更远#