psql 是 PostgreSQL 功能丰富的交互式终端。它可以让你编写和执行查询、检查数据库对象、导入/导出数据、编写批量操作脚本以及自定义输出格式——全部在命令行完成。

使用 psql 之前，请确认它已安装并可用：

# Check if psql is installed
psql --version

# If not found, install PostgreSQL client tools:

# macOS (Homebrew)
brew install libpq
brew link --force libpq

# Ubuntu / Debian
sudo apt install postgresql-client

# CentOS / RHEL
sudo yum install postgresql

# Alpine
apk add postgresql-client

# Windows — install PostgreSQL via the official installer or use WSL

psql 随 postgresql-client 软件包一起提供。不需要服务器（postgresql）——只需客户端即可连接远程 PostgreSQL 实例。

# 1. CLI flags
psql -h host -p port -U user -d dbname

# 2. Connection URI
# WARNING: Password in URI is visible in shell history and process listings.
#          Prefer ~/.pgpass for production use (see method 4 below).
psql "postgresql://user:YOUR_PASSWORD@host:port/dbname"

# 3. Environment variables (no flags needed)
export PGHOST=localhost
export PGPORT=5432
export PGDATABASE=mydb
export PGUSER=postgres
# WARNING: PGPASSWORD is visible in process listings (e.g. `ps aux`).
#          Use ~/.pgpass in production instead.
export PGPASSWORD=YOUR_PASSWORD
psql                       # picks up all params from env

# 4. ~/.pgpass file (RECOMMENDED for passwords)
#    Format: hostname:port:database:username:password
touch ~/.pgpass && chmod 600 ~/.pgpass
# Then manually edit ~/.pgpass and add entries (avoids password in shell history):
# hostname:port:database:username:password
# Example: localhost:5432:mydb:postgres:YOUR_PASSWORD
psql -h localhost -U postgres -d mydb   # no password prompt

# 5. Execute and exit
psql -f script.sql dbname                        # execute file then exit
psql -c "SELECT 1" dbname                        # run single command then exit
psql -1 -f migration.sql dbname                  # run in single transaction

# 6. Service connection (reads from pg_service.conf)
psql service=mydb_prod

# 7. Reconnect within a session
\c dbname                                       # reconnect to different db
\c -reuse-previous=on sslmode=require           # change only sslmode
\c "host=newhost port=5432 dbname=mydb"         # conninfo string

连接失败时：交互模式保持之前的连接；脚本模式会关闭连接，之后的所有数据库命令都会失败，直到下一次成功的 \c。

关键标志：-h 主机，-p 端口，-U 用户，-d 数据库，-w 不提示密码，-W 强制提示密码，-1 单事务，-f 执行文件，-c 执行命令，-t 仅元组，-x 扩展显示，-A 不对齐，-E 回显隐藏查询（\d 内部），-L 日志文件，-X 跳过 ~/.psqlrc。

连接优先级：CLI 标志 > 环境变量 > pg_service.conf > 默认值。密码优先级：连接字符串/密码标志 > PGPASSWORD 环境变量 > ~/.pgpass。生产环境使用 ~/.pgpass 而非 PGPASSWORD——PGPASSWORD 在进程列表中可见（ps aux）。

\d 所有表、视图、物化视图、序列、外表（等价于 \dtvmsE）

\det 外表（助记："external tables"）

\df 函数（使用修饰符：a=聚合，n=普通，p=过程，t=触发器，w=窗口函数）

\drds 按角色和按数据库的配置设置

\l 列出数据库（接受模式：\l test*）

\dAc / \dAf / \dAo / \dAp 运算符类、运算符族、运算符、支持函数

\dconfig 服务器配置参数（\dconfig * 显示全部，PostgreSQL 16+）

\do 运算符（接受参数类型模式）

\dP[itn] 分区表（t=表，i=索引，n=嵌套）

修饰符（追加到大多数 \d 命令）：

提供名称以获取详细信息：\d table_name 显示列、类型、索引、约束、外键。

\g 执行（类似 ;，但可添加选项）

\gx 以扩展输出执行（类似 \g，强制 \x on）

\g filename 执行并将输出发送到文件

`\g \ command` 执行并将输出通过管道传给 shell 命令

\g (format=csv footer=off) file 以一次性格式化选项执行

\gset [prefix] 执行并将结果存储到 psql 变量中

\gexec 将结果的每个单元作为 SQL 命令执行

\crosstabview 以交叉表（透视表）形式显示结果

\watch 定期重新执行查询（见下文）

\bind [params...] 使用带参数扩展的查询协议。适用于 \g、\gx 和 \gset

\bind_named stmt_name [params...] 绑定命名预处理语句

\parse stmt_name 从当前查询缓冲区创建预处理语句

\close_prepared stmt_name 关闭预处理语句

-- Server-side (requires superuser for file access, uses server filesystem)
COPY table TO '/path/file.csv' WITH (FORMAT csv, HEADER true);
COPY table FROM '/path/file.csv' WITH (FORMAT csv, HEADER true);

-- Client-side (runs with client permissions, no superuser needed) — preferred
\copy table TO '/path/file.csv' WITH (FORMAT csv, HEADER true)
\copy table FROM '/path/file.csv' WITH (FORMAT csv, HEADER true)
\copy (SELECT ...) TO '/path/output.csv' WITH (FORMAT csv, HEADER true)

-- Advanced: specific columns, NULL handling, custom delimiter
\copy table (col1, col2) FROM 'data.csv' WITH (FORMAT csv, HEADER true, NULL 'N/A')

\copy 是日常工作的首选——它使用客户端的文件系统和权限，而不是服务器的。

-- FROM (import): sources are 'filename', program 'command', stdin, pstdin
\copy table FROM 'file.csv' WITH (FORMAT csv, HEADER true) [ WHERE condition ]

-- TO (export): destinations are 'filename', program 'command', stdout, pstdout
\copy table TO 'file.csv' WITH (FORMAT csv, HEADER true)

对于 \copy ... FROM stdin，数据行持续读入，直到读到只包含 \. 的行或到达 EOF。使用 pstdin/pstdout 可始终读写 psql 的实际标准输入/输出，不受 \o 设置影响。

警告：program 选项会执行 shell 命令。如果由用户输入构造，可能导致命令注入。避免与不可信数据进行字符串拼接。

提示：\copy 将行的其余部分全部作为参数（不进行变量插值）。当需要变量插值或多行查询时，改用带 \g 的 SQL COPY ... TO STDOUT：

-- This allows variable interpolation and multi-line queries
COPY (SELECT * FROM :table WHERE id > :min_id) TO STDOUT WITH (FORMAT csv, HEADER true) \g /tmp/output.csv

\a                  Toggle aligned/unaligned output
\x                  Toggle expanded display (vertical vs table)
\t                  Toggle tuples only (no headers/footers)
\pset format FORMAT  Set output format: aligned, asciidoc, csv, html, latex, latex-longtable, troff-ms, unaligned, wrapped
\pset border N       Set border style (0-2; 3 for latex data-row lines)
\pset null STRING    Display NULL as STRING
\pset pager [off]    Control pager usage
\pset title 'TEXT'   Set table title
\pset recordsep SEP  Set record separator for unaligned mode
\pset fieldsep SEP   Set field separator for unaligned mode (default: |)
\pset footer [on|off] Toggle row count footer
\pset columns N      Set target width for wrapped format
\pset csv_fieldsep C  Set CSV field separator (default: comma)
\pset numericlocale [on|off]  Toggle locale-specific number formatting
\pset linestyle STYLE Set border style: ascii, old-ascii, unicode
\pset pager_min_lines N  Minimum lines before pager activates
\pset xheader_width MODE  Expanded header width: full, column, page, or N (PostgreSQL 17+)
\H                   Toggle HTML output (shortcut)
\C [title]           Set table title (shortcut for \pset title)
\f [string]          Set field separator (shortcut for \pset fieldsep)
\T table_options     Set HTML table attributes (shortcut for \pset tableattr)

\lo_import filename [comment]   Import file as large object, returns OID
\lo_export loid filename        Export large object to file
\lo_list[x+]                    List all large objects
\lo_unlink loid                 Delete large object

大对象 OID 是持久的引用。导入时始终关联一个人类可读的注释。使用 \lo_list 查找 OID。

Postgresql Cli 实用指南

PostgreSQL interactive terminal (psql) reference and usage guide. Use this skill whenever the user mentions psql, PostgreSQL command-line client, backslash commands, meta-commands, \d commands, database inspection, SQL scripting in PostgreSQL, importing/exporting data with psql, \copy,...

人工智能

PostgreSQL CLI工具psql实用指南，涵盖安装、连接、对象检查、数据导入导出、脚本编写及安全操作。提供完整命令速查表，包括\d系列查询、\copy数据迁移、管道模式及\watch监控，助你高效管理数据库。

日志文件

数据丢失

文件系统

PostgreSQL

数据库

服务器

Windows

CentOS

Ubuntu

Debian

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Postgresql Cli 实用指南

Postgresql Cli 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐