绩效审计 p99
识别慢速查询,了解 EXPLAIN ANALYZE、索引策略以及在生产中杀死 Postgres 的 5 种反模式。
该页面已自动翻译。英文版具有权威性。
优化前测量#
审计从数字开始。 Studio 通过端点和查询公开 p50/p95/p99。在进行任何更改之前捕获 7 天的基线。
信息
aura db slow-queries 和 aura db stats CLI 命令查询链接项目上的 pg_stat_statements 和数据库池/大小指标,范围仅限于您的项目(也可在 Studio › 数据库和日志中使用)。 aura db inspect indexes|tables|locks 列出了索引使用情况(标记了未使用的索引)、表大小和死行以及阻塞锁 — /raw 无法运行这些诊断,因为它拒绝系统目录。
bash
# 10 个最昂贵的查询(总时间)
aura db slow-queries --limit 10
# 连接和数据库大小(端点延迟:Studio › 日志)
aura db stats
实时 pg_stat_statements#
pg_stat_statements 在每个新项目上安装并预加载。它将每个规范化查询(不存储文字值)与 mean_exec_time、 calls 和 rows聚合。 /raw 不会直接读取它 - 视图是集群范围的 - 因此请使用上面的命令,这些命令仅返回项目的查询,或 Studio › 数据库。
bash
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增加
sql
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#
- N+1 查询 — 在 SDK 中进行连接或使用
!inner而不是循环 - 按 OFFSET 分页 — 超过 1000,使用基于游标的 (
where id > last_seen) - SELECT * 在大型表上 — 仅请求必要的列
- 长事务 — 这些会阻塞 VACUUM 并导致膨胀。保持 < 1 秒
- 非索引 RLS 策略 — 如果您的策略使用
tenant_id = auth.tenant(),则索引tenant_id