psql中如何查看当前连接的数据库名和用户？

Question

在使用 `psql` 连接 PostgreSQL 时，常需快速确认当前会话的上下文环境，例如排查连接配置错误、权限问题或调试多环境切换场景。一个典型问题是：**如何在已进入 `psql` 交互终端后，不依赖外部命令或系统表查询，直接、安全、高效地查看当前连接的数据库名和登录用户名？** 开发者可能尝试 `\conninfo`，但误以为它仅显示主机/端口；或执行 `SELECT current_database(), current_user;`，却不清楚其与 `session_user`/`user` 的语义差异（如 `current_user` 受 `SET ROLE` 影响，而 `session_user` 始终反映初始登录身份）。此外，在受限权限环境下，某些元函数可能不可用，需提供兼容性更强的替代方案（如 `\echo :DBNAME / :USER` 变量）。该问题看似简单，实则涉及会话上下文、权限模型与 psql 元命令机制的交叉理解，是 DBA 和应用开发人员高频遇到的“隐性坑”。

Answer 1

```html

一、基础认知：psql 中最直观的连接信息入口

初入 psql 交互终端，最常被忽略却最高效的命令是：\conninfo。它不仅显示主机、端口、SSL 状态，还明确输出 database 和 user 字段——这两个值正是会话初始连接上下文的核心标识。

postgres=# \conninfo
You are connected to database "myapp_prod" as user "app_admin" via socket in "/var/run/postgresql" at port "5432".

⚠️ 注意：\conninfo 的输出中 user 指的是 session_user（即登录认证用户），而非当前生效角色，因此具备最高语义稳定性与权限兼容性。

二、语义辨析：SQL 函数三元组的深层差异

在已建立连接后执行 SQL 查询时，以下三个函数返回值可能不同，其差异源于 PostgreSQL 的权限模型设计：

函数	语义定义	是否受 SET ROLE 影响	典型使用场景
session_user	客户端认证时使用的用户名（不可变）	否	审计日志溯源、连接身份固化
current_user	当前会话生效的角色（可被 SET ROLE 或 SET SESSION AUTHORIZATION 修改）	是	权限调试、模拟多角色行为
user	SQL 标准别名，等价于 current_user	是	跨数据库兼容写法（如兼容 Oracle/MySQL 风格）

三、安全兜底：psql 内置变量的零权限依赖方案

在极受限环境（如只读用户被禁用所有系统函数），psql 启动时自动注入的会话变量成为唯一可靠来源：

• \echo :DBNAME → 返回连接时指定的数据库名（等价于 \conninfo 中的 database）
• \echo :USER → 返回启动 psql 时的 OS 用户名（非数据库用户！需谨慎）
• \echo :USERNAME → 更准确的数据库登录用户变量（自 v12+ 支持，推荐替代 :USER）

✅ 示例验证：

postgres=# \set USERNAME 'app_admin'
postgres=# \echo :USERNAME
app_admin

四、进阶实践：构建可复用的上下文快查宏

为提升多环境调试效率，可在 ~/.psqlrc 中定义快捷元命令：

\new_command \ctx 'SELECT current_database() AS db, session_user AS login_user, current_user AS effective_role, version() ~* "64-bit" AS is_64bit;'
\alias ctx \ctx

执行 \ctx 即输出结构化会话摘要，兼顾数据库名、登录身份、当前角色及平台特征。

五、深度溯源：连接上下文在权限链路中的定位

下图展示了从客户端连接到会话上下文生成的完整控制流，凸显各标识符的注入时机与不可篡改性：

graph LR
A[客户端发起连接] --> B[pg_hba.conf 认证]
B --> C[session_user 固定为认证用户名]
C --> D[pg_authid 查找角色属性]
D --> E[若含 INHERIT 属性，则 current_user = session_user]
E --> F[执行 SET ROLE r2]
F --> G[current_user 更新为 r2，session_user 不变]
G --> H[所有后续权限检查基于 current_user]

六、兼容性矩阵：不同 PostgreSQL 版本支持能力对比

以下关键能力在主流版本中的可用性：

特性	PG 9.6	PG 12	PG 15	说明
:USERNAME 变量	❌	✅	✅	替代易混淆的 :USER，明确指向数据库用户
\conninfo 显示 database/user	✅	✅	✅	全版本稳定支持，首选诊断入口
current_database()	✅	✅	✅	需 SELECT 权限；在空数据库或连接失败时可能报错

七、实战避坑：高频误操作与修复指南

开发者常见陷阱包括：

• 误用 SELECT user; 判断登录身份 → 实际返回 current_user，在 SET ROLE 后失效
• 在 psql -U backup_user -d template0 连接后执行 \conninfo 却未注意 database 显示为 template0，导致误操作生产数据
• 脚本中硬编码 current_database() 而未捕获异常，在连接未完成时崩溃

✅ 推荐防御式写法（Shell + psql 混合）：

DB_NAME=$(psql -t -c "\conninfo" | grep "database" | cut -d'"' -f2)
echo "Target DB: $DB_NAME"

```