PostgreSQL 备忘清单

切换和连接

$ sudo -u postgres psql

列出所有数据库

postgres=# \l

连接到名为 postgres 的数据库

postgres=# \c postgres

断开

postgres=# \q
postgres=# \!

:-	-
\h	SQL 命令语法帮助
\h DELETE	DELETE SQL 语句语法
\?	PostgreSQL 命令列表

在 PostgreSQL 控制台中运行

显示版本

SHOW SERVER_VERSION;

显示系统状态

\conninfo

显示环境变量

SHOW ALL;

列出用户

SELECT rolname FROM pg_roles;

显示当前用户

SELECT current_user;

显示当前用户的权限

\du

显示当前数据库

SELECT current_database();

显示数据库中的所有表

\dt

列出函数

\df <schema>

列出数据库

\l

连接到数据库

\c <database_name>

显示当前数据库

SELECT current_database();

创建数据库

CREATE DATABASE <database_name> WITH OWNER <username>;

删除数据库

DROP DATABASE IF EXISTS <database_name>;

重命名数据库

ALTER DATABASE <old_name> RENAME TO <new_name>;

列出当前数据库中的表

\dt
SELECT table_schema,table_name FROM information_schema.tables ORDER BY table_schema,table_name;

全局列表

\dt *.*.
SELECT * FROM pg_catalog.pg_tables

列出表结构

\d <table_name>
\d+ <table_name>
SELECT column_name, data_type, character_maximum_length
FROM INFORMATION_SCHEMA.COLUMNS
WHERE table_name = '<table_name>';

创建表

CREATE TABLE <table_name>(
  <column_name> <column_type>,
  <column_name> <column_type>
);

创建表，主键自增

CREATE TABLE <table_name> (
  <column_name> SERIAL PRIMARY KEY
);

删除表

DROP TABLE IF EXISTS <table_name> CASCADE;

成为 postgres 用户，如果您有权限错误

sudo su - postgres
psql

授予 对数据库的所有权限

GRANT ALL PRIVILEGES ON DATABASE <db_name> TO <user_name>;

授予数据库连接权限

GRANT CONNECT ON DATABASE <db_name> TO <user_name>;

授予架构权限

GRANT USAGE ON SCHEMA public TO <user_name>;

授予函数权限

GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO <user_name>;

授予在所有表上选择、更新、插入、删除的权限

GRANT SELECT, UPDATE, INSERT ON ALL TABLES IN SCHEMA public TO <user_name>;

在表上授予权限

GRANT SELECT, UPDATE, INSERT ON <table_name> TO <user_name>;

授予对表的选择权限

GRANT SELECT ON ALL TABLES IN SCHEMA public TO <user_name>;

添加栏目

ALTER TABLE <table_name> IF EXISTS
ADD <column_name> <data_type> [<constraints>];

更新栏

ALTER TABLE <table_name> IF EXISTS
ALTER <column_name> TYPE <data_type> [<constraints>];

删除列

ALTER TABLE <table_name> IF EXISTS
DROP <column_name>;

将列更新为自增主键

ALTER TABLE <table_name>
ADD COLUMN <column_name> SERIAL PRIMARY KEY;

使用自动递增的主键插入表中

INSERT INTO <table_name>
VALUES (DEFAULT, <value1>);
INSERT INTO <table_name> (<column1_name>,<column2_name>)
VALUES ( <value1>,<value2> );

选择 所有数据

SELECT * FROM <table_name>;

读取一行数据

SELECT * FROM <table_name> LIMIT 1;

搜索数据

SELECT * FROM <table_name> WHERE <column_name> = <value>;

插入 数据

INSERT INTO <table_name> VALUES( <value_1>, <value_2> );

更新 数据

UPDATE <table_name>
SET <column_1> = <value_1>, <column_2> = <value_2>
WHERE <column_1> = <value>;

删除 所有数据

DELETE FROM <table_name>;

删除特定数据

DELETE FROM <table_name>
WHERE <column_name> = <value>;

列出 Schemas

\dn
SELECT schema_name FROM information_schema.schemata;
SELECT nspname FROM pg_catalog.pg_namespace;

创建架构

CREATE SCHEMA IF NOT EXISTS <schema_name>;

删除模式

DROP SCHEMA IF EXISTS <schema_name> CASCADE;

:-	-
\d <table>	描述表
\d+ <table>	详细描述表格
\dt	列出当前模式中的表
\dt *.*	列出所有模式中的表
\dt <schema>.*	列出架构的表
\dp	列出表访问权限
\det[+]	列出外部表

:-	-
\e [FILE]	编辑查询缓冲区(或文件)
\ef [FUNC]	编辑函数定义
\p	æ˜¾ç¤ºå† å®¹
\r	重置(æ¸ é™¤)查询缓冲区
\s [FILE]	显示历史记录或保存到文件
\w FILE	å°†æŸ¥è¯¢ç¼“å†²åŒºå†™å ¥æ–‡ä»¶

:-	-
\c [DBNAME]	连接到新数据库
\encoding [ENCODING]	显示或设置客户端编码
\password [USER]	更改密码
\conninfo	显示信息

:-	-
\a	在未对齐和对齐之间切换
\C [STRING]	设置表格标题，如果没有则取消设置
\f [STRING]	显示或设置未对齐的字段分隔符
\H	切换 HTML 输出模式
\t [on|off]	ä» æ˜¾ç¤ºè¡Œ
\T [STRING]	设置或取消设置 HTML <table> 标签属性
\x [on|off]	切换扩展输出

:-	-
\copy ...	å¯¼å ¥/导出表 另见： 复制
\echo [STRING]	打印字符串
\i FILE	执行文件
\o [FILE]	将所有结果导出到文件
\qecho [STRING]	输出流的字符串

:-	-
\prompt [TEXT] NAME	设置变量
\set [NAME [VALUE]]	设置变量 (如果没有参数，则列出所有变量)
\unset NAME	删除变量

:-	-
\cd [DIR]	更改目录
\timing [on|off]	切换时间
\! [COMMAND]	在shell中执行
\! ls -l	在shell中列出所有

• \lo_export LOBOID FILE
• \lo_import FILE [COMMENT]
• \lo_list
• \lo_unlink LOBOID

使用 pg_dumpall 备份所有数据库

$ pg_dumpall -U postgres > all.sql

使用 pg_dump 备份数据库

$ pg_dump -d mydb -f mydb_backup.sql

•   -a   只转储数据，而不是模式(schema)
•   -s   只转储模式，不转储数据
•   -c   在重新创建之前删除数据库
•   -C   还原前创建数据库
•   -t   仅转储命名表
•   -F   格式(c：自定义，d：目录，t：tar)

使用 pg_dump -? 获取完整的选项列表

使用 psql 恢复数据库

$ psql -U user mydb < mydb_backup.sql

使用 pg_restore 恢复数据库

$ pg_restore -d mydb mydb_backup.sql -c

•   -U   指定数据库用户
•   -c   在重新创建之前删除数据库
•   -C   还原前创建数据库
•   -e   如果遇到错误退出
•   -F   格式(c:自定义，d:目录，t:tar，p:纯文本sql(默认))

使用 pg_restore -? 获取完整的选项列表

获取 postgresql.conf 的位置

$ psql -U postgres -c 'SHOW config_file'

附加到 postgresql.conf

listen_addresses = '*'

附加到 pg_hba.conf(与 postgresql.conf 相同的位置)

host  all  all  0.0.0.0/0  md5
host  all  all  ::/0       md5

重启 PostgreSQL 服务器

$ sudo systemctl restart postgresql

将表格导出为 CSV 文件

\copy table TO '<path>' CSV
\copy table(col1,col1) TO '<path>' CSV
\copy (SELECT...) TO '<path>' CSV

将 CSV 文件导入表格

\copy table FROM '<path>' CSV
\copy table(col1,col1) FROM '<path>' CSV

另见：复制

pg_upgrade 跨版本升级

$ /usr/lib/postgresql/16/bin/pg_upgrade \
  -b /usr/lib/postgresql/15/bin \
  -B /usr/lib/postgresql/16/bin \
  -d /var/lib/postgresql/15/main \
  -D /var/lib/postgresql/16/main \
  -o " -c config_file=/etc/postgresql/15/main/postgresql.conf" \
  -O " -c config_file=/etc/postgresql/16/main/postgresql.conf"

•   -b   旧版本二进制文件目录
•   -B   新版本二进制文件目录
•   -d   旧版本数据目录
•   -D   新版本数据目录
•   -o   旧版本主配置文件
•   -O   新版本主配置文件
•   -c   仅check，不执行升级，可先加-c检查是否有报错，没有报错再运行升级

使用 pg_upgrade -? 获取完整的选项列表