你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

Pg 还原

如果要将 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引用中所述的选项。

还原数据库

  1. 在 “连接” 树中,右键单击目标服务器或数据库。
  2. 选择 备份和还原>从文件还原数据库。
  3. 在 “还原您的数据库”中,选择 目标数据库 和 备份文件。
  4. 选择 还原模式:
    • 完全 还原存档内容。
    • 仅架构 还原没有数据的结构。
    • 仅数据 恢复不含架构对象的数据。
  5. 选择备份文件后,查看检测到的 格式 和 数据库(存储在存档中) 字段。

使用 高级选项 优化还原命令。 抽屉将设置分为范围、还原行为、性能和日志、输出、数据库级设置和安全性。 根据所选模式和存档格式,某些选项会变为不可用,并说明原因。

页面启动时,它还会显示命令预览,以便你可以在运行这些参数之前查看生成的 pg_restore 参数。

确认还原操作

Warning

启用 “创建数据库 ”后,存档中存储的数据库名称是还原目标。 在此模式下,所选连接/数据库仅用于初始维护命令。 如果还启用了 Clean , pg_restore 请删除并重新创建整个存档命名的数据库,删除其现有对象和数据,包括备份中不存在的任何内容。 在继续操作之前,请验证服务器和存档数据库名称,并保留可恢复的备份。

选择“开始还原”以打开“确认还原操作”。 预检对话框在扩展运行任何内容之前汇总了还原目标:

  • 还原目标显示服务器、目标或维护连接、存档中存储的数据库、备份文件、还原模式和已启用的部分。
  • 范围 显示包含多少个架构、表、索引、函数和触发器。
  • 安全设置 汇总了发生错误时停止、单事务模式、所有权还原、订阅、发布、特权和触发器行为等选项。

如果还原具有破坏性,模态框会添加更强烈的警告。 例如:

  • 如果没有 Create database,使用 Clean 还原会发出警告,即可以删除并重新创建匹配的恢复对象。
  • 使用 Create 数据库 还原会检查存档数据库是否已存在。 如果未启用“ 清理 ”,扩展会阻止还原,而不是允许合并到现有数据库。
  • 当需要输入确认信息时,必须先准确输入数据库名称,确认并开始还原 才会可用。

确认后,状态视图会显示进度和日志。 如果还原失败,页面将保留命令预览,并使收集到的输出保持可用,以便查看错误或使用Copilot 调试。