如何仅通过pg_restore完整恢复PostgreSQL数据库？

问题背景 #

希望实现PostgreSQL数据库的备份与恢复一体化，恢复时仅调用pg_restore即可完成全流程（无需手动创建数据库）。此前尝试两种备份命令后，恢复时出现无响应或报错问题，目前必须手动建库才能完成恢复。

此前操作的错误分析 #

恢复命令参数误用导致无响应 #

执行以下命令时无响应，核心原因是错误使用了-f参数：

pg_restore  -U postgres -fnoc_backup_2022_12_06.dump
pg_restore  -U postgres -fbackup_2022_12_06.dump
pg_restore  -U postgres -C -fbackup_2022_12_06.dump
pg_restore  -U postgres -C -fnoc_backup_2022_12_06.dump

-f在pg_restore中是指定输出文件（将恢复的SQL语句写入文件），而非指定输入的备份文件。直接使用-f会导致pg_restore等待输入或尝试写入文件但无正确交互，因此卡住。

指定不存在数据库导致报错 #

执行以下命令报错“数据库treebase不存在”，原因是-d参数指定的是初始连接的数据库，该数据库必须已存在：

pg_restore  -U postgres -C  -dtreebase backup_2022_12_06.dump
pg_restore  -U postgres -C  -dtreebase noc_backup_2022_12_06.dump
pg_restore  -U postgres -dtreebase noc_backup_2022_12_06.dump
pg_restore  -U postgres -dtreebase backup_2022_12_06.dump

即使加了-C（包含建库语句），pg_restore也需要先连接到一个已存在的数据库（比如默认的postgres库），才能执行CREATE DATABASE语句。

正确的备份与恢复命令 #

备份命令（包含建库逻辑） #

使用带-C参数的pg_dump，将创建数据库的语句包含在备份文件中：

pg_dump -U postgres -C -Fc -f backup_2022_12_06.dump treebase

参数说明：

• -C：在备份文件中嵌入创建目标数据库的SQL语句
• -Fc：使用PostgreSQL自定义格式备份，支持压缩和灵活的恢复选项
• -f：指定备份文件的存储路径

恢复命令（一键完成建库+数据恢复） #

直接连接到已存在的postgres数据库执行恢复，无需手动建库：

pg_restore -U postgres -d postgres backup_2022_12_06.dump

执行逻辑：

1. pg_restore先连接到默认的postgres库
2. 执行备份文件中包含的CREATE DATABASE treebase语句
3. 自动切换到新建的treebase库，完成所有数据和数据库对象的恢复

如果需要覆盖已存在的treebase库，可以添加--clean和--if-exists参数（谨慎使用，会清空目标库现有数据）：

pg_restore -U postgres -d postgres --clean --if-exists backup_2022_12_06.dump

效果验证 #

执行上述恢复命令后，无需手动创建数据库，pg_restore会自动完成建库和数据恢复的全流程，满足终端用户仅用两条命令（备份+恢复）完成操作的需求。

内容的提问来源于stack exchange，提问作者San Pei