日志功能
记录慢查询语句
开启慢查询记录功能，执行时间等于或者大于 log_min_duration_statement 设置值的语句会被记录：
ALTER database postgres SET log_min_duration_statement = '250ms';
1
设置日志记录的语句类型
使用 log_statement 选项设置日志记录的语句类型：
ALTER DATABASE postgres SET log_statement = 'all';
1
有效的取值包括 all、ddl、none 以及 mod。
记录锁等待事件
当数据库出现锁等待事件时记录日志：
ALTER DATABASE postgres SET log_lock_waits = 'on';
1
性能技巧
设置语句的执行超时时间
设置语句的执行超时可以阻止超长运行的语句。超时时间可以基于数据库、用户或者会话进行设置。推荐设置一个全局的超时时间，然后根据需要为具体用户或者会话设置特殊的超时时间。
ALTER DATABASE mydatabase SET statement_timeout = '60s';
1
查找占用资源最多的查询和进程
pg_stat_statements 插件可以帮助我们发现消耗资源最多的查询和进程。
# create extension pg_stat_statements;
SELECT
total_exec_time,
mean_exec_time as avg_ms,
calls,
query
FROM pg_stat_statements
ORDER BY mean_exec_time DESC
LIMIT 10;
1
2
3
4
5
6
7
8
9
10
监控数据库连接
以下查询可以按照状态返回数据库连接的数量：
SELECT count(*),
state
FROM pg_stat_activity
GROUP BY state;
1
2
3
4
如果空闲（idle）连接数量超过了 20，推荐使用连接池，例如 PgBouncer。
查看表的大小
使用以下语句查看表的文件大小：
SELECT pg_relation_size('table_name');
-- 更好的显示格式
SELECT pg_size_pretty(pg_relation_size('table_name'));
1
2
3
4
查看全部表的大小
以下查询返回了数据库中全部表的大小，从大到小进行排序：
SELECT relname AS relation,
pg_size_pretty (
pg_total_relation_size (C .oid)
) AS total_size
FROM pg_class C
LEFT JOIN pg_namespace N ON (N.oid = C .relnamespace)
WHERE nspname NOT IN (
'pg_catalog',
'information_schema'
)
AND C .relkind <> 'i'
AND nspname !~ '^pg_toast'
ORDER BY pg_total_relation_size (C .oid) DESC
1
2
3
4
5
6
7
8
9
10
11
12
13
检查未使用的索引
使用以下查询返回未被使用的索引，按照索引大小降序排列。
SELECT schemaname || '.' || relname AS table,
indexrelname AS index,
pg_size_pretty(pg_relation_size(i.indexrelid)) AS "index size",
idx_scan as "index scans"
FROM pg_stat_user_indexes ui
JOIN pg_index i ON ui.indexrelid = i.indexrelid
WHERE NOT indisunique
AND idx_scan < 50
AND pg_relation_size(relid) > 5 * 8192
ORDER BY
pg_relation_size(i.indexrelid) / nullif(idx_scan, 0) DESC NULLS FIRST,
pg_relation_size(i.indexrelid) DESC;
1
2
3
4
5
6
7
8
9
10
11
12
评估表中的数据量
基于内部统计信息返回表中的近似数据量，可以用于替代大表的 SELECT count(*) 查询。
SELECT reltuples::numeric as count
FROM pg_class
WHERE relname='table_name';
1
2
3
非阻塞式的索引创建
创建索引时使用 CONCURRENTLY 选项可以避免获取表上的锁，该选项不能在事务中使用。
CREATE INDEX CONCURRENTLY foobar ON foo (bar);
1
PSQL 命令
自动记录查询占用的时间
返回每次查询占用的时间，包括网络传输时间。
\timing
1
可以利用 .psqlrc 文件实现默认配置。
自动格式化查询结果
提高查询结果的可读性：
\x auto
1
调用文本编辑器
变量 $EDITOR 用于设置一个默认的文本编辑器，输入以下命令可以打开并编辑最后一次执行的查询语句。
\e
1
保存并关闭编辑器之后，数据库会执行保存的查询语句。
设置空值的显示内容
将空值 null 显示为其它字符，方便区分空值和空字符串。
\pset null ⛔
1
保存查询历史
为指定数据库设置一个保存查询历史的本地文件：
\set HISTFILE ~/.psql_history-:DBNAME
1
显示内部命令对应的查询语句
psql 命令行选项 -E（–echo-hidden）可以显示内部命令（例如 \dt mytable）生成的查询语句：
psql -E
1
只返回结果数据
psql 命令行的 -qtA 选项表示以静默模式运行查询，以非对齐的格式返回结果，并且只返回数据。该选项和 -c 选项结合使用，可以用于脚本文件获取查询结果。
psql -qtA
1
以 HTML 表格形式返回结果
psql 命令行的 -qtH 选项表示以静默模式运行查询，以 HTML 表格形式返回结果，并且只返回数据。
psql -qtH
1
清理屏幕
以下命令可以实现清屏：
\! clear
1
连续运行一个查询语句
以下命令可以每间隔 2 秒自动执行一次最后的查询语句并显示结果：
\watch
1
回退到上一个语句
在交互模式下，设置以下命令可以在执行出错时自动回退到上一个语句执行之前：
\set ON_ERROR_ROLLBACK interactive
1
直接导出 CSV 格式
连接数据库时，指定 --csv 选项和查询语句可以运行查询并以 CSV 格式输出查询结果。
psql <connection-string> --csv -c 'select * from test;'
1
运行脚本文件
以下命令可以在 psql 中执行一个脚本文件：
\i filename
1
设置清晰的边界
以下命令可以在 psql 中为查询结果设置一个显示边界：
\pset border 2
1
将 linestyle 设置为 unicode
将 linestyle 设置为 unicode 时，结合上面的配置可以获得更清晰的显示格式：
\pset linestyle unicode
1
SQL 功能
替换空值
coalesce 函数可以将空值转换为指定的字符串：
SELECT id,
coalesce(ip, 'no IP')
FROM logs;
1
2
3
生成序列数据
generate_series 函数可以生成一个指定间隔的数据序列，包括数字和时间戳。
SELECT * FROM
generate_series(now() - '3 month'::interval, now(), '1 day');
1
2
截断日期
date_trunc 函数可以将日期数据截断为指定的精度，例如月份、星期、日、小时、分钟。
SELECT date_trunc('day', now());
1
时间数据的加减运算
时间戳数据可以直接加减一个时间间隔：
SELECT now() - '1 month'::interval;
1
暂停会话进程
pg_sleep 函数可以将当前会话进程暂停指定的时间：
select pg_sleep(2.5);
1
实用命令
创建只读用户
系统角色 pg_read_all_data 可以用于读取所有的数据表：
GRANT pg_read_all_data TO username;
1
终止指定用户的后台进程
使用以下查询终止用户“test”的所有后台进程：
WITH pids AS (
SELECT pid
FROM pg_stat_activity
WHERE usename='test'
)
SELECT pg_terminate_backend(pid)
FROM pids;
1
2
3
4
5
6
7
取消指定用户正在运行的 SQL 语句
以下查询可以取消用户“test”正在运行的所有 SQL 查询，回滚未提交的事务：
WITH pids AS (
SELECT pid
FROM pg_stat_activity
WHERE username='test'
)
SELECT pg_cancel_backend(pid)
FROM pids;