PostgreSQL / 系统课时
使用 psql 元命令
使用 psql 元命令
本课解决使用 psql 管理 PostgreSQL 时如何快速查看环境信息的问题。通过常用反斜杠命令,你可以查看数据库、表、角色和当前连接,切换目标数据库,并区分客户端元命令与服务器执行的 SQL。
学习目标
- 掌握 psql 常用元命令及其执行规则。
- 学会查看数据库、表、角色和当前连接信息。
- 理解 SQL 与 psql 元命令的区别,并能切换数据库进行验证。
认识 psql 元命令
psql 元命令不是 SQL 语句,而是 psql 客户端提供的管理快捷命令。它们通常以反斜杠 \ 开头,由客户端解析,不会作为普通 SQL 语句发送给 PostgreSQL 服务器。
元命令需要在 psql 交互终端中执行,通常一行输入一条,不需要以分号结尾。例如,已经进入 psql 后,可以输入以下命令查看帮助:
\?预期结果:显示 psql 元命令帮助列表,其中包含 \l、\dt、\du、\c 等命令及其说明。具体帮助内容和排版可能随 psql 版本变化。
如果需要查看 SQL 语句的语法帮助,可以使用 \h SELECT。其中 \? 面向 psql 元命令,\h 面向 SQL 命令,两者用途不同。
查看数据库和表
开发过程中经常需要快速了解当前环境,可以使用 \l 查看服务器上的数据库列表,使用 \dt 查看当前数据库中可见的普通表和分区表。
在已连接的 psql 终端中依次输入:
\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 查看当前连接。
\du
\conninfo预期结果:
\du显示角色列表,包括角色名称、属性及成员关系等信息。例如,具有超级用户权限的角色会显示Superuser属性。\conninfo显示当前连接的数据库、角色,以及服务器地址、端口或 Unix 域套接字等连接信息。
PostgreSQL 使用角色统一管理登录身份和权限,因此 \du 显示的是角色,不只是能够登录的用户。某些角色可能不具有 LOGIN 权限。
排查连接错误时,先通过 \conninfo 确认自己实际连接到哪个数据库、使用哪个角色,再检查目标对象和权限,可以避免在错误的数据库中执行操作。
SQL 与元命令的区别
SQL 由 PostgreSQL 服务器执行,例如查询数据、创建表和修改记录。元命令由 psql 客户端处理,例如显示帮助、列出对象或切换连接。
常见的切换数据库元命令是 \c,其基本用法为 \c 数据库名。下面假设 PostgreSQL 实例中存在默认的 postgres 数据库,并且当前角色具有连接权限。
在 psql 终端中执行:
\c postgres
SELECT current_database();预期结果:\c postgres 成功后,psql 显示已连接到 postgres 数据库的提示,随后 SQL 查询返回:
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。