database Cheatsheet

PostgreSQL 常用命令速查表

PostgreSQL 日常运维命令一页速查：连接与角色管理、库表操作、查询分析、锁与事务排查、备份恢复和复制状态检查等 30+ 高频操作，含关键参数说明与典型排障场景示例。

把 PostgreSQL 日常最常敲的命令按连接、库表、查询分析、锁排查、备份恢复和复制分组整理，排障现场直接复制改参数即可。

postgresqlpostgres数据库sql

连接与角色 Connection & Role

EXPLAIN SELECT * FROM t WHERE col = 1;
查看执行计划，不执行查询
EXPLAIN ANALYZE SELECT * FROM t WHERE col = 1;
执行并显示实际耗时，注意会修改数据（DML）
EXPLAIN (ANALYZE, BUFFERS) SELECT ...
含缓冲区命中信息，判断 IO 瓶颈
SELECT * FROM pg_stat_user_tables WHERE seq_scan > 0 ORDER BY seq_scan DESC;
找出频繁全表扫描的表，考虑加索引
SELECT pg_size_pretty(pg_database_size(current_database()));
查看当前数据库大小
SELECT relname, n_dead_tup FROM pg_stat_user_tables ORDER BY n_dead_tup DESC LIMIT 10;
查看死元组最多的表，需要 VACUUM

SELECT pid, state, query FROM pg_stat_activity WHERE state != 'idle';
查看活跃查询，找长查询和卡住的连接
SELECT pg_cancel_backend(<pid>);
取消查询（发 SIGINT），不断开连接
SELECT pg_terminate_backend(<pid>);
终止连接（发 SIGTERM），强制断开
SELECT * FROM pg_locks WHERE NOT granted;
查看等待中的锁
SELECT pid, mode, granted, query FROM pg_locks l JOIN pg_stat_activity a USING(pid) WHERE NOT l.granted;
锁等待关联查询，找阻塞源头
SELECT * FROM pg_stat_activity WHERE state = 'idle in transaction';
找空闲但未提交的事务，这些会持有锁

SELECT application_name, state, sync_state, sent_lsn, write_lsn FROM pg_stat_replication;
主库查看从库同步状态
SELECT status, receive_lsn, replay_lsn FROM pg_stat_wal_receiver;
从库查看接收和回放进度
SELECT NOW() - pg_last_xact_replay_timestamp() AS replication_lag;
查看复制延迟时长
SELECT pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS lag_bytes FROM pg_stat_replication;
查看复制延迟字节数