pgAdmin 4 Ubuntu

2025年3月17日 | 阅读 12 分钟

pgAdmin 4 简介

pgAdmin 4 是 PostgreSQL 的主流开源管理工具。pgAdmin 旨在通过一个图形界面管理和监控多个 EDB Postgres Advanced Server 和 PostgreSQL 数据库服务器(包括远程和本地),该界面允许轻松管理和创建数据库对象以及其他用于管理数据库的工具。

pgAdmin 可以以两种模式下载:服务器模式和桌面模式。桌面模式下载为独立应用程序,由同一操作系统用户使用;而服务器模式可在网络中使用,允许更多用户使用。两种模式的实现都遵循三层架构方法。

  • pgAdmin 4 已为多个桌面平台提供预配置和预编译的安装包。
  • 在服务器部署中,pgAdmin 应用程序通过 WSGI 接口部署或置于 Web 服务器之后。
  • 如果我们以服务器模式安装 pgAdmin,在首次连接到 pgAdmin 时,系统会提示我们输入 pgAdmin 密码和角色名。
  • 在桌面部署中,pgAdmin 应用程序配置为使用桌面运行时环境,以便在任何支持的平台上托管该程序。
  • 用户通常会安装预构建的包以在桌面模式下运行 pgAdmin。
  • 然而,也可以安装手动桌面部署,但设置起来要困难得多。
  • 这可能对那些想了解 pgAdmin 工作原理的开发者有所帮助。

pgAdmin 4 中的功能

pgAdmin 4 Ubuntu

登录对话框

我们可以使用登录对话框登录 pgAdmin。我们可以使用登录对话框中的多个字段来访问我们的连接。有两种不同的方式可以访问我们的连接。

  • 从 pgAdmin 4.21 版本开始,增加了对 LDAP 身份验证的支持。如果为我们的 pgAdmin 应用程序启用了 LDAP 身份验证,我们可以使用我们的 LDAP 凭据登录 pgAdmin。
    • 在“用户名/电子邮件地址”字段中输入 LDAP 用户名。
    • 在“密码”字段中输入 LDAP 密码。
  • 我们可以使用以下信息选择性地登录 pgAdmin:
    • 在“用户名/电子邮件地址”字段中输入与我们帐户相关的电子邮件地址。
    • 在“密码”字段中输入密码。
    • 选择“登录”按钮以安全地登录 pgAdmin。

注意:如果 pgAdmin 服务器重启,我们将被注销。我们需要重新登录才能继续。

找回丢失的密码

如果我们忘记了密码,请选择“忘记密码”选项以启动密码恢复实用程序。

  • 在“电子邮件地址”字段中输入与我们帐户相关的电子邮件地址。
  • 选择“恢复密码”选项开始恢复。将发送一封电子邮件到“电子邮件地址”字段中输入的电子邮件地址,其中包含有关如何重置密码的说明。

启用 2FA

双因素身份验证是在登录应用程序或网站时使用的附加安全层。我们需要使用密码和用户名登录,并提供另一个仅我们知道或可以通过 2FA 进行身份验证的形式。

用户管理对话框

在桌面模式下调用 pgAdmin 时,会随机生成一个密码并避免使用。如果我们以服务器模式安装 pgAdmin,系统会要求我们提供 pgAdmin 客户端的管理员密码和电子邮件。

当我们访问 pgAdmin 时,与该登录角色相关的服务器定义会出现在树状控件中。管理员用户可以使用用户管理对话框来:

  • 管理与角色相关的密码
  • 分配权限
  • 添加或删除 pgAdmin 角色。

修改用户密码对话框

定期修改密码是保护数据的良好策略,即使在我们认为环境受保护的情况下也是如此。未能使用适当的密码策略可能会导致我们违反工作场所的数据保护法律。我们在选择密码时可以考虑以下指南:

  • 确保密码长度合适;密码至少应为 6 个字符。
  • 确保密码不易被字典攻击。我们可以使用大小写字母和数字的组合,并避免使用姓名或单词。可以考虑使用我们容易记住但又不寻常的首字母缩略词短语的第一个字母。
  • 确保定期更改密码。

设置 LDAP 身份验证

为了设置 LDAP 身份验证,我们必须在已安装 pgAdmin 的服务器模式系统上的 config_system.py 或 config_local.py 文件中配置 LDAP 设置。我们也可以从 config.py 文件复制设置,并更改以下参数的值。

有三种方式来构建 LDAP:

  • 专用用户绑定
  • 匿名绑定
  • 以 pgAdmin 用户身份绑定
  • AUTHENTICATION_SOURCES
    此参数默认值为 internal。为了设置 LDAP 身份验证,我们必须将 LDAP 添加到此参数的值列表中。
  • LDAP_AUTO_CREATE_USER
    此参数指定我们是否希望自动创建与 LDAP 用户凭据相关的 pgAdmin 用户。

注意:LDAP 密码不会保存在 pgAdmin 数据库中。

  • LDAP_CONNECTION_TIMEOUT
    此参数描述 LDAP 身份验证的连接超时时间。

设置 Kerberos 身份验证

为了设置 Kerberos 身份验证,我们必须在已安装 pgAdmin 的服务器模式系统上的 config_system.py 或 config_local.py 文件中配置 Kerberos 设置。我们也可以从 config.py 文件复制设置,并更改以下参数的值。

  • AUTHENTICATION_SOURCES
    此参数默认值为 internal。为了设置 Kerberos 身份验证,我们必须将 kerberos 添加到此参数的值列表中。
  • KERBEROS_AUTO_CREATE_USER
    如果希望自动创建一个与已通过身份验证的 Kerberos 用户相关的 pgAdmin 用户,则将此参数设置为 'True'。

注意:密码不会保存在 pgAdmin 数据库中。

  • KRB_APP_HOST_NAME
    此参数指定 pgAdmin Web 服务器主机名的标题。

注意:如果未设置,它将获取 default_server 参数的值。

设置 OAUTH2 身份验证

为了设置 LDAP 身份验证,我们必须在已安装 pgAdmin 的服务器模式系统上的 config_system.py 或 config_local.py 文件中配置 OAUTH2 设置。我们也可以从 config.py 文件复制设置,并更改以下参数的值。

  • AUTHENTICATION_SOURCES
    此参数默认值为 internal。为了设置 OAUTH2 身份验证,我们必须将 oauth2 添加到此参数的值列表中。
  • OAUTH2_NAME
    此参数指定 Oauth2 提供商名称,例如:GitHub, Google
  • OAUTH2_DISPLAY_NAME
    Oauth2 显示名称为 pgAdmin。
  • OAUTH2_CLIENT_ID
    此参数指定 Oauth2 的客户端 ID。
  • OAUTH2_CLIENT_SECRET
    此参数指定 Oauth2 的客户端密钥。
  • OAUTH2_TOKEN_URL
    此参数指定 Oauth2 的访问令牌端点。

设置 Web 服务器身份验证

我们必须使用任何身份验证插件(如 HTTP BASIC 和 Shibboleth 身份验证)来设置我们的 Web 服务器,只要它设置了变量,即 REMOTE_USER 环境。

为了设置 Web 服务器身份验证,我们必须在已安装 pgAdmin 的服务器模式系统上的 config_system.py 或 config_local.py 文件中配置 Web 服务器设置。我们也可以从 config.py 文件复制设置,并更改以下参数的值。

  • AUTHENTICATION_SOURCES
    此参数默认值为 internal。为了设置 Web 服务器身份验证,我们必须将 webserver 添加到此参数的值列表中。
  • WEBSERVER_AUTO_CREATE_USER
    如果希望自动创建一个与已通过身份验证的 Web 服务器用户相关的 pgAdmin 用户,则将此参数设置为 'True'。

注意:密码不会保存在 pgAdmin 数据库中。

  • WEBSERVER_REMOTE_USER
    要获取远程 Web 服务器用户的详细信息,请将此变量设置为从 Web 服务器接收到的环境或标头变量名。默认值为 REMOTE_USER,其可能的值为 X-Forwarded-User、HTTP_X_FORWARDED_USER 和 REMOTE_USER。

用户界面

pgAdmin 4 支持 PostgreSQL 的所有功能,从编写基本 SQL 查询到集成典型数据库。它被设计用于查询数据库,使我们能够及时了解实现和修改。

特点

  • 有关使用 pgAdmin 工具和对话框的在线信息和帮助
  • 有用的提示
  • 支持性的错误消息
  • 上下文相关且响应迅速的行为
  • 强大的管理工具和对话框,用于常见任务
  • 语法高亮 SQL 编辑器
  • 支持管理查询
  • 活动查询工具以及直接数据编辑
  • 运行时对象的支持和自动检测。

菜单栏

pgAdmin 的菜单栏提供下拉菜单,用于访问实用程序、命令和选项。菜单栏显示以下部分:

  • 帮助
  • 工具
  • 文件
  • Object

选项可能显示为灰色,这意味着它们对于 pgAdmin 树状控件中最近选择的对象是禁用的。

工具栏

它为最常用的功能(如查询工具和查看数据)提供快捷按钮,这些功能在 pgAdmin 中最常用。这在浏览器面板上是显而易见的,按钮根据所选的浏览器模式启用/禁用。

  • 我们可以使用“查询工具”按钮在数据库上下文(当前)中打开它。
  • 我们可以使用“查看数据”按钮来编辑/查看存储在选定表中的数据。
  • 我们可以使用“筛选行”按钮来使用数据过滤器弹出窗口,将过滤器应用于一组数据进行编辑/查看。
  • 我们可以使用“搜索对象”按钮来使用搜索对象对话框。这将帮助我们查找任何数据库对象。
  • 我们可以使用“PSQL 工具”按钮在数据库上下文(当前)中启动 PSQL。

选项卡式浏览器

pgAdmin 窗口的右窗格提供了一组选项卡,显示有关左窗口中 pgAdmin 树状控件中当前选定对象的信息。我们可以选择一个选项卡来使用树状控件中突出显示的对象的有关信息。

统计信息”选项卡显示为树状控件中的所有对象收集的统计信息;以下统计信息因选定的对象类型而异。一些可用的统计信息如下:

  • PID:这是与行相关的进程 ID。
  • 数据库:显示数据库名称。
  • 用户:拥有项目的用户名。
  • 后端:显示当前到数据库的连接数。
  • 后端启动:显示后端进程的启动时间。
  • 大小:显示选定数据库的大小(以 MB 为单位)。

树状控件

主窗口的左窗格显示一个树状控件,用于访问位于服务器上的对象。我们可以展开树状控件中的节点以查看位于选定服务器上的数据库对象。此树状控件展开以显示分层视图。

  • 按节点左侧的减号 (-) 来关闭节点。
  • 使用树状控件节点左侧的加号 (+) 来展开部分。

此外,我们可以将许多对象拖放到查询工具中,从而节省输入长对象名称的时间。具有对象名称的文本将完全限定架构。如果需要,将包含双引号。对于过程和函数,函数名称将与参数名称一起固定在查询工具中。

首选项对话框

在“首选项”对话框中,我们可以使用许多选项来定制客户端的行为。我们需要通过“文件”菜单选择“首选项”来打开它。“首选项”对话框的左窗格显示一个树状控件;树状控件的所有节点都可以访问对应于它们所显示的节点中的选项。

  • 按节点名称左侧的减号 (-) 来关闭节点。
  • 使用节点名称左侧的加号 (+) 来展开树状控件的一部分。

键盘快捷键

pgAdmin 提供键盘快捷键以方便访问特定功能。如果需要,可以在“文件 > 首选项”中配置备用快捷键。

  • 主浏览器窗口
    如果使用主浏览器窗口,则存在以下键盘快捷键:
    • Alt+Shift+F:打开文件菜单。
    • Alt+Shift+L:打开工具菜单。
    • Alt+Shift+O:打开对象菜单。
    • Alt+Shift+B:集中于浏览器树。
    • Alt+Shift+H:打开帮助菜单。
    • Alt+Shift+C:打开上下文菜单。
  • 对话框选项卡
    我们可以使用以下快捷方式来操作对话框中的选项卡集:
    • Control+Shift+[: 用于对话框选项卡向后切换。
    • Control+Shift+]: 用于对话框选项卡向前切换。

搜索对象

我们可以使用此对话框查找数据库中的几乎所有类型的对象。我们可以通过右键单击任何数据库或其任何子节点并选择“选择对象”来使用它。此外,我们还可以通过输入快捷方式(ALT+SHIFT+S)来使用它。

结果显示在网格中,包含对象树路径、对象类型和浏览器中的对象名称。我们可以双击结果行在浏览器中选择对象。

如果对象在首选项中显示为灰色,则表示我们尚未激活那些对象类型,因此我们无法双击它。我们可以选择过程和函数名称旁边的省略号来查看它们的参数。通过从对象类型的下拉列表中进行选择,我们可以根据特定对象类型进行筛选。

选择对象类型后,如果单击搜索按钮,将仅从数据库中检索那些类型的对象。当数据库服务器不支持对象类型或未从首选项中激活时,对象类型将不会显示在下拉列表中。

处理集群对象

一些对象定义保留在集群级别;pgAdmin 4 提供对话框,允许我们创建、处理对象,并控制它们之间的连接。要使用允许我们创建数据库对象的对话框,我们需要右键单击 pgAdmin 树状控件中的对象类型,然后为该对象选择“创建”选项。

处理数据库对象

pgAdmin 4 提供简单而强大的对话框,我们可以使用它们来创建和设计数据库对象。所有对话框都包含一个选项卡系列,我们使用它们来定义将由对话框创建的对象;SQL 选项卡显示服务器在创建对象时将运行的 SQL 命令。

要访问任何允许我们建立数据库对象的对话框,我们需要右键单击 pgAdmin 树状控件中的对象类型,然后为该对象选择“创建”选项。

创建或更改表

pgAdmin 4 提供对话框,允许我们更改表的每个属性和属性。要访问任何允许我们建立数据库对象的对话框,我们需要右键单击 pgAdmin 树状控件中的对象类型,然后为该对象选择“创建”选项。

管理基础

pgAdmin 提供支持我们执行许多服务器管理功能的“指向即点即用”对话框。对话框简化了操作,例如授予用户权限、处理命名恢复点以及执行 REINDEX、ANALYZE 和 VACCUM 函数。

备份和恢复

一个强大但方便的备份和恢复工具提供了一种简单的方法来使用 pg_restore、pg_dumpall 和 pg_dump 来进行备份,并创建数据库对象或数据库副本,供开发环境使用。

开发人员工具

pgAdmin 菜单(即工具)显示了一系列强大的开发人员工具,我们可以使用它们来运行和分析典型 SQL 命令、调试 SQL/PL 代码和管理数据。

  • 调试器
    • 使用调试器
    • 直接调试
    • 上下文调试
  • 编辑/查看数据
    • 筛选/排序选项对话框
    • 数据网格
    • 查看/编辑数据工具栏
  • 查询工具
    • 更改连接
    • 连接状态
    • 查询历史面板
    • 通知面板
    • 消息面板
    • 解释面板
    • 数据输出面板
    • SQL 编辑器面板
    • 工具栏

在 Ubuntu 中安装 pgAdmin 4

pgAdmin 是一款著名的开源开发和管理工具,根据 Artistic/PostgreSQL 许可证发布。通过此软件,可以轻松地从浏览器进行不同的数据库类型操作。它几乎可以在所有流行的操作系统上使用。

pgAdmin 4 目前已发布,它是使用 JQuery 和 Python 开发的。与 pgAdmin 3 相比,pgAdmin 4 实现了一些改进。任何人都可以根据特定操作系统下载该软件的二进制或源代码文件进行安装。

用户需要具备技术知识才能通过编译源代码来下载 pgAdmin,因此安装过程仅适用于高级用户。对于新用户来说,从二进制文件安装 pgAdmin 是一个很好的方法。在本文中,我们将解释如何在 Ubuntu 中下载和使用 pgAdmin。

安装 pgAdmin 4 的步骤

  • 更新系统
    在开始安装过程之前,我们需要通过运行以下命令来更新系统:
  • 安装必要的软件包
    在安装 pgAdmin 之前,需要安装三个软件包:virtualenv、pip 和 python。执行以下命令安装这些软件包:

当出现以下提示时,我们需要按“y”以完成必要软件包的安装过程。

pgAdmin 4 Ubuntu
  • 建立虚拟环境
    执行以下命令在当前位置创建一个名为 pgAdmin 4 的新文件夹,进入新创建的文件夹并创建虚拟环境。

pgAdmin 4 Ubuntu
  • 启用虚拟环境
    我们将进入 pgAdmin4 文件夹内的 pgAdmin4 文件夹并执行以下命令来启用虚拟环境。

pgAdmin 4 Ubuntu
  • 下载 pgAdmin 4
    我们将执行以下命令下载最新的 pgAdmin 4 版本:

完成 pgAdmin 下载过程后,终端将显示如下图像:

pgAdmin 4 Ubuntu
  • 安装 pgAdmin 4
    执行以下命令完成 pgAdmin 4 的安装过程:

pgAdmin 4 Ubuntu

安装过程完成后,将出现以下屏幕:

pgAdmin 4 Ubuntu