PostgreSQL / 系统课时

使用 psql 元命令

使用 psql 元命令

本课解决使用 psql 管理 PostgreSQL 时如何快速查看环境信息的问题。通过常用反斜杠命令,你可以查看数据库、表、角色和当前连接,切换目标数据库,并区分客户端元命令与服务器执行的 SQL。

学习目标

  • 掌握 psql 常用元命令及其执行规则。
  • 学会查看数据库、表、角色和当前连接信息。
  • 理解 SQL 与 psql 元命令的区别,并能切换数据库进行验证。

认识 psql 元命令

psql 元命令不是 SQL 语句,而是 psql 客户端提供的管理快捷命令。它们通常以反斜杠 \ 开头,由客户端解析,不会作为普通 SQL 语句发送给 PostgreSQL 服务器。

元命令需要在 psql 交互终端中执行,通常一行输入一条,不需要以分号结尾。例如,已经进入 psql 后,可以输入以下命令查看帮助:

text
\?

预期结果:显示 psql 元命令帮助列表,其中包含 \l、\dt、\du、\c 等命令及其说明。具体帮助内容和排版可能随 psql 版本变化。

如果需要查看 SQL 语句的语法帮助,可以使用 \h SELECT。其中 \? 面向 psql 元命令,\h 面向 SQL 命令,两者用途不同。

查看数据库和表

开发过程中经常需要快速了解当前环境,可以使用 \l 查看服务器上的数据库列表,使用 \dt 查看当前数据库中可见的普通表和分区表。

在已连接的 psql 终端中依次输入:

text
\l
\dt

预期结果:

  • \l 显示数据库列表,包含数据库名称、所有者、编码等信息。默认安装中通常可以看到 postgres、template0 和 template1。
  • \dt 显示当前数据库中符合当前搜索路径的表,包括表名、所属模式和所有者等信息。
  • 如果当前搜索路径下没有匹配的表,\dt 通常显示 Did not find any relations.。

需要特别注意,\l 查询的是数据库列表,而 \dt 查询的是当前连接数据库中的表,不会跨数据库查找。

此外,\dt 默认只显示当前搜索路径下可见的表。如果表存在于其他模式中,可以使用 \dt public.* 查看 public 模式中的表,或使用 \dt *.* 查看所有模式中的匹配表,包括系统模式中的表。

如果知道表名,还可以使用 \d public.users 查看 public.users 表的列、类型、约束和索引等结构信息,前提是该表存在且当前角色具有必要的访问权限。

查看用户和连接信息

管理权限和排查连接问题时,可以使用 \du 查看数据库角色,使用 \conninfo 查看当前连接。

text
\du
\conninfo

预期结果:

  • \du 显示角色列表,包括角色名称、属性及成员关系等信息。例如,具有超级用户权限的角色会显示 Superuser 属性。
  • \conninfo 显示当前连接的数据库、角色,以及服务器地址、端口或 Unix 域套接字等连接信息。

PostgreSQL 使用角色统一管理登录身份和权限,因此 \du 显示的是角色,不只是能够登录的用户。某些角色可能不具有 LOGIN 权限。

排查连接错误时,先通过 \conninfo 确认自己实际连接到哪个数据库、使用哪个角色,再检查目标对象和权限,可以避免在错误的数据库中执行操作。

SQL 与元命令的区别

SQL 由 PostgreSQL 服务器执行,例如查询数据、创建表和修改记录。元命令由 psql 客户端处理,例如显示帮助、列出对象或切换连接。

常见的切换数据库元命令是 \c,其基本用法为 \c 数据库名。下面假设 PostgreSQL 实例中存在默认的 postgres 数据库,并且当前角色具有连接权限。

在 psql 终端中执行:

text
\c postgres
SELECT current_database();

预期结果:\c postgres 成功后,psql 显示已连接到 postgres 数据库的提示,随后 SQL 查询返回:

text
 current_database
------------------
 postgres
(1 row)

这段操作体现了两种命令的分工:\c postgres 由 psql 处理并建立目标数据库连接,SELECT current_database(); 则由 PostgreSQL 服务器执行并返回查询结果。

注意以下边界:

  • 结束符不同:SQL 语句通常使用分号结束,独占一行的 psql 元命令不需要分号。
  • 执行范围不同:\dt 只查询当前连接数据库中的可见表,不能代替跨数据库查询。
  • 连接条件不同:\c 切换数据库要求目标数据库存在,且当前角色具有连接权限;连接失败时应检查数据库名称和权限。
  • 运行环境不同:psql 元命令不能直接作为普通 SQL 通过 JDBC、Python 数据库驱动等接口执行。

实际使用时,可以先通过 \conninfo 确认连接,再用 \l 和 \dt 查看数据库与表,使用 \du 检查角色,需要进入其他数据库时再执行 \c 数据库名。完成检查后可以输入 \q 退出 psql。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 psql 元命令

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通