容器数据库入门之PostgreSQL实战

在上一篇容器数据库入门之MySQL实战 里说了下数据库基础知识与MySQL的部署与使用。现在我们继续来PostgreSQL数据库的部署与使用

docker部署

1. services:
   
2.   pgsql:
   
3.     image: postgres:17-alpine # 这里指定了版本号
   
4.     container_name: pgsql
   
5.     restart: unless-stopped
   
6.     network_mode: bridge
   
7.     ports:
   
8.       - 5432:5432
   
9.     volumes:
   
10.         - ./data:/var/lib/postgresql/data
    
11.     environment:
    
12.         POSTGRES_USER: postgres  # 默认管理员用户
    
13.         POSTGRES_PASSWORD: postgres1234 # 默认管理员用户密码
    
14.         POSTGRESQL_WAL_COMPRESSION: lz4  # WAL 日志的压缩方式设置为 lz4
    
15.         POSTGRESQL_MAX_CONNECTIONS: 2048   # 数据库允许的最大连接数

复制代码

psql

psql 是 PostgreSQL官方自带的命令行交互式客户端工具。

常见参数：

参数	全称	作用
-U <用户名>	User	指定连接 PG 的用户名（默认系统当前用户名）
-h <地址>	Host	指定 PG 服务器地址（默认 127.0.0.1）
-p <端口>	Port	指定 PG 端口（默认 5432）
-d <库名>	Database	指定要连接的数据库名，不指定会默认尝试连接和「当前登录用户名同名」的数据库
-c	Command	非交互执行指定 SQL 语句，执行后立即退出（适合脚本）
-f <文件>	File	执行指定 SQL 文件中的所有语句（常用于导入备份、执行脚本）
-V	Version	查看 psql 版本

连接数据库

连接命令：psql -U 用户名 -h 地址 -p 端口 -d 数据库名

1. # 用默认 postgres 用户连接默认 postgres 数据库
   
2. psql -U postgres
   
3. 
   
4. # 连接 192.168.31.15 上端口为15432的 newapi 数据库，用户名 postgres
   
5. psql -U postgres -h 192.168.31.15 -p 15432 -d newapi

复制代码

连接成功后的基础操作：

1. # 查看当前连接的数据库
   
2. SELECT current_database();
   
3. 
   
4. # 列出所有用户
   
5. \du
   
6. SELECT usename FROM pg_user;
   
7. 
   
8. # 列出所有数据库
   
9. \l
   
10. SELECT datname FROM pg_database;
    
11. 
    
12. # 列出当前库的所有表
    
13. \dt
    
14. SELECT tablename FROM pg_tables;
    
15. 
    
16. # 切换数据库
    
17. \c 数据库名
    
18. 
    
19. # 查看表结构（字段 / 类型 / 约束）
    
20. \d 表名
    
21. 
    
22. # 退出 psql 交互界面
    
23. \q

复制代码

创建数据库用户

创建名为 testdbuser 的数据库用户，并设置密码为 test888。

1. # 命令行模式（无需进入psql，直接在系统终端执行）
   
2. psql -U postgres -c 'CREATE USER testdbuser WITH LOGIN PASSWORD "test888";'
   
3. 
   
4. # psql交互模式
   
5. CREATE USER testdbuser WITH LOGIN PASSWORD 'test888';

复制代码

创建数据库

创建名为 testdb、所有者为 testdbuser 的数据库。

1. # 命令行模式（无需进入psql，直接在系统终端执行）
   
2. psql -U postgres -c 'CREATE DATABASE testdb OWNER testdbuser;'
   
3. 
   
4. # psql交互模式
   
5. CREATE DATABASE testdb OWNER testdbuser;

复制代码

数据导出
pg_dump：PostgreSQL 自带的备份工具，专门用来导出数据库的结构/数据。最小有效命令：pg_dump -U 用户名 -d 数据库名 -f 备份文件路径

1. # 导出所有数据库结构 + 数据
   
2. pg_dump -U postgres -d 库名 -f xxxx.sql
   
3. 
   
4. # 只导出数据
   
5. pg_dump -U postgres -d 库名 --data-only -f xxxx.sql

复制代码

参数	作用
-U	指定数据库用户名
-d	指定数据库名，必填
-f	指定导出文件名
-h	指定数据库服务器地址（默认本地 127.0.0.1）
-p	指定数据库端口（默认 5432），端口修改过必用
-t	表名。只导出指定单张表的结构 + 数据，避免全库导出）
-n	模式名。导出指定 Schema（PG 的逻辑分组，默认 public）的内容
-c	导出的 SQL 中添加「先删除表 / 数据」的语句（导入时自动清理旧数据）
-C	导出的 SQL 中添加「创建数据库」的语句（导入时无需提前建库）
-F c	导出为二进制格式（比 SQL 小、导入更快，后缀建议 .dump）
--data-only	只导出数据（不含结构）
--schema-only	只导出表结构（不含数据）

数据导入
注意：
1. 只有用  pg_dump -F c/-F t/-F d 导出的备份，才能用 pg_restore 恢复；纯 SQL 文件只能用 psql 导入；

• pg_restore是PostgreSQL 自带的恢复工具，专门用于恢复由 pg_dump 以「非纯文本格式」（如自定义格式、tar 格式、目录格式）导出的备份文件。
  

2. 导入前需确保目标数据库已创建（比如 `testdb` 需先执行 psql -U admin -c "CREATE DATABASE testdb;"）；

1. # SQL 文件
   
2. psql -U admin -h 127.0.0.1 -p 5432 -d testdb -f /tmp/testdb_full.sql
   
3. 
   
4. # 导入二进制备份文件
   
5. pg_restore -U admin -d testdb -v /tmp/testdb.dump

复制代码

mysql、postgresql、redis这几个常用，我都部署了，有需要连数据库的，直接使用他们。

playok 发表于 2026-3-5 18:46
mysql、postgresql、redis这几个常用，我都部署了，有需要连数据库的，直接使用他们。 ...

数据库还是sqlite和mysql、pgsql用的多，不过sqlite一般不需要额外部署了，所以也就mysql和postgresql了。redis另当别论了。

很牛的教程