你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
如果要将 PostgreSQL 存档备份还原到现有数据库,或在另一个环境中重新创建内容,请使用连接树中的从文件还原数据库。 Webview 会为你生成 pg_restore 命令,显示有效的还原范围,并要求在启动前进行预检确认。
Prerequisites
- PostgreSQL 扩展中的已连接服务器。
- 已启用备份和还原接口(
pgsql.enablePgDumpRestoreUI默认为true)。 - 安装在扩展主机上的 PostgreSQL 客户端工具,包括与存档和目标服务器兼容版本的
pg_restore。 使用与创建存档的pg_dump的主客户端版本相同的版本,或者使用较新的受支持版本。 较旧的客户端可以拒绝较新的存档格式。 如果扩展找不到已安装的二进制文件,请配置pgsql.pgBinaryDirs并重启编辑器。 此设置不会安装工具。 - 具有所选还原操作所需特权和所有权的数据库角色,包括在启用创建数据库时的
CREATEDB。 - 采用
pg_restore支持的存档格式(如自定义、tar 或目录)的备份。 检测到纯 SQL 文件,但页面会警告应改用psql进行还原。
在另一台服务器上还原时,请在还原所有权和授予之前创建或迁移存档引用的任何角色。 每个数据库存档不包含全局角色定义。 缺少目标角色可能会导致所有权或权限还原错误。 请参阅 使用转储和还原迁移用户和角色。
Warning
仅从受信任的源还原存档。 还原可以在源服务器上执行由超级用户选定的 SQL,包括在部分还原期间。 命令预览显示命令行参数,而不是存档中的所有 SQL。 若要在还原之前检查该 SQL,请使用--filepg_restore引用中所述的选项。
还原数据库
- 在 “连接” 树中,右键单击目标服务器或数据库。
- 选择 备份和还原>从文件还原数据库。
- 在 “还原您的数据库”中,选择 目标数据库 和 备份文件。
- 选择 还原模式:
- 完全 还原存档内容。
- 仅架构 还原没有数据的结构。
- 仅数据 恢复不含架构对象的数据。
- 选择备份文件后,查看检测到的 格式 和 数据库(存储在存档中) 字段。
使用 高级选项 优化还原命令。 抽屉将设置分为范围、还原行为、性能和日志、输出、数据库级设置和安全性。 根据所选模式和存档格式,某些选项会变为不可用,并说明原因。
页面启动时,它还会显示命令预览,以便你可以在运行这些参数之前查看生成的 pg_restore 参数。
确认还原操作
Warning
启用 “创建数据库 ”后,存档中存储的数据库名称是还原目标。 在此模式下,所选连接/数据库仅用于初始维护命令。 如果还启用了 Clean , pg_restore 请删除并重新创建整个存档命名的数据库,删除其现有对象和数据,包括备份中不存在的任何内容。 在继续操作之前,请验证服务器和存档数据库名称,并保留可恢复的备份。
选择“开始还原”以打开“确认还原操作”。 预检对话框在扩展运行任何内容之前汇总了还原目标:
- 还原目标显示服务器、目标或维护连接、存档中存储的数据库、备份文件、还原模式和已启用的部分。
- 范围 显示包含多少个架构、表、索引、函数和触发器。
- 安全设置 汇总了发生错误时停止、单事务模式、所有权还原、订阅、发布、特权和触发器行为等选项。
如果还原具有破坏性,模态框会添加更强烈的警告。 例如:
- 如果没有 Create database,使用 Clean 还原会发出警告,即可以删除并重新创建匹配的恢复对象。
- 使用 Create 数据库 还原会检查存档数据库是否已存在。 如果未启用“ 清理 ”,扩展会阻止还原,而不是允许合并到现有数据库。
- 当需要输入确认信息时,必须先准确输入数据库名称,确认并开始还原 才会可用。
确认后,状态视图会显示进度和日志。 如果还原失败,页面将保留命令预览,并使收集到的输出保持可用,以便查看错误或使用Copilot 调试。