psql

定义

psql 是 PostgreSQL 关系数据库系统随发行版提供的前端程序，以终端为运行环境。用户在提示符下逐条键入查询，程序把语句送往服务器并显示结果；输入同样可以来自文件，因而可兼作脚本执行器^[1]。

它的调用形式为 psql 加若干选项，再接数据库名与用户名；连接目标由主机、端口、数据库名、用户和密码等参数共同确定，参数既可在命令行给出，也可通过环境变量或连接字符串指定^[1]。在 Linux 发行版中，它通常打包在 postgresql-client 系列软件包内，与创建和删除用户、数据库的配套程序一起分发，并依赖 C 客户端库 libpq^[3]。

原理

psql 本身不是数据库服务器，它通过 libpq 与后端进程建立连接，把用户输入按 SQL 语句或元命令分别处理。SQL 语句被原样提交给服务器解析执行；以反斜杠开头的元命令则由客户端自行解释，例如 \d 系列用于列出表、索引、序列、视图、函数、数据类型与权限，\l 列出数据库，\du 列出用户。

查询文本先进入客户端缓冲区，遇到分号才发送到后端，因此一条语句可以跨多行书写；\g 相当于提交缓冲区的分号，\p 显示当前缓冲区内容，\r 清空缓冲区，\e 调用外部编辑器修改缓冲区后再送回解析^[4]。由于这些缓冲区操作都在客户端完成，元命令无法脱离 psql 或兼容客户端在裸 SQL 通道上使用。

输出格式由 \pset 一类参数控制，可在对齐文本、非对齐、HTML 与 LaTeX 等模式间切换，并可设置域分隔符、空值显示方式和标题，从而把结果直接转成其他程序可读的分隔文本^[5]。\copy 是较特殊的一例：它把整行剩余内容都当作参数，并把操作改写为 COPY FROM STDIN 或 COPY TO STDOUT，由客户端读写本地文件后再经连接传输数据^[6]。

发展历程

psql 的出现与查询语言更替直接相关。PostgreSQL 的前身项目使用名为 QUEL 的查询语言，通过 monitor 终端程序交互；1995 年发布的 Postgres95 用 SQL 取代 QUEL，monitor 不再适用，psql 作为新的终端工具被提供出来^[2]。

1996 年，PostgreSQL 6.0 在 PostgreSQL 全球开发组的组织下发布，此后每个大版本都对 psql 追加功能与改进，元命令集合随之扩充^[2]。该工具与服务器同版本号发布，原因是元命令背后查询的系统目录结构会随版本变化，社区在受支持版本范围内维持向后兼容，较新的 psql 一般可连接最近的若干个大版本服务器^[2]。

应用

在运维场景中，psql 用于直接查看和检查数据库中的结构，测试与观察查询及性能表现，以及安装、修改脚本等管理活动^[7]。云数据库服务常把连接串中的命令行部分直接写成 psql 调用，用户据此从本地终端连到远程实例^[7]。

在脚本与自动化方面，-c 选项可执行一条命令后立即退出，-f 选项从文件读取语句，两者都便于放进 shell 脚本；\i 则在交互会话中执行文件内容，效果等同于逐行键入^[1]。多数介绍 PostgreSQL 特性的文章、教程与书籍以 psql 演示操作，熟悉其连接方式与基本元命令有助于复现示例^[2]。

psql 可在 Linux、macOS 与 Windows 上安装使用，既随服务器安装包捆绑，也可借助包管理器或官方安装程序只装命令行工具；安装后需把可执行文件所在目录加入系统搜索路径才能在终端直接调用^[7]。

局限

psql 的元命令只在客户端有效，把含有反斜杠命令的脚本交给其他执行通道时不会生效，这类命令必须由 psql 自己解析；同样，\copy 依赖客户端一侧的文件与权限，无法代替服务器端直接读写主机文件^[6]。

两套数据导入方式不可混用：SQL 的 COPY 由服务器进程打开指定路径或执行 PROGRAM 命令，要求文件位于服务器可访问的位置，且通常只有超级用户或被授予 pg_read_server_files、pg_write_server_files、pg_execute_server_program 等预定义角色的用户才能使用；\copy 则把这些权限要求转由本地用户承担^[6]。托管数据库服务往往不向应用账号开放上述角色，服务器端文件方式的 COPY 因此难以使用^[8]。

作为文本界面工具，psql 只提供命令行层面的交互与结果显示，图形化的表结构浏览、可视化查询构建需要另用其他客户端；此外，它维护的只是会话缓冲区与历史记录，会话断开后未提交的事务不会保留在客户端，语句语义仍完全由服务器决定。

参见

• PostgreSQL —— psql 所连接和操作的对象数据库系统。

• libpq —— psql 所依赖的 C 语言客户端库，负责连接与查询传输。

• SQL —— psql 提交给服务器执行的主要语言。

• COPY 语句 —— 与 \copy 元命令对应、由服务器执行的数据批量导入导出语句。

• 命令行界面 —— psql 所属的交互形式。