PostgreSQL 的命令行工具 psql
是管理数据库的核心工具,支持执行 SQL 命令、管理用户、导入导出数据等操作,以下是详细操作指南:
前提条件
-
已安装 PostgreSQL
- 确保系统已安装 PostgreSQL(官网下载)。
- 安装时勾选 Command Line Tools(Windows 用户需注意此选项)。
-
配置环境变量(可选但推荐)
- Windows:将 PostgreSQL 的
bin
目录(如C:\Program Files\PostgreSQL\16\bin
)添加到系统PATH
。 - Linux/macOS:默认已配置,若未生效,在终端运行:
export PATH=$PATH:/usr/lib/postgresql/16/bin # 路径根据版本调整
- Windows:将 PostgreSQL 的
打开 pg 命令行的详细步骤
根据操作系统选择对应方法:
Windows 系统
-
方法 1:通过开始菜单
搜索 → 打开 SQL Shell (psql) → 按提示输入服务器、端口、用户名等信息(默认直接回车使用括号内值)。 -
方法 2:命令提示符(CMD/PowerShell)
- 打开 CMD 或 PowerShell。
- 输入命令:
psql -U 用户名 -d 数据库名 -h 主机地址 -p 端口
- 示例(连接本地默认数据库):
psql -U postgres -d postgres -h localhost -p 5432
- 若提示密码,输入安装时设置的密码。
- 示例(连接本地默认数据库):
macOS / Linux 系统
- 打开终端(Terminal)。
- 输入命令:
sudo -u postgres psql # 使用默认管理员账户
- 或指定自定义用户:
psql -U 用户名 -d 数据库名 -h 127.0.0.1 -p 5432
- 成功连接后,终端提示符将变为
数据库名=#
。
- 或指定自定义用户:
连接参数详解
参数 | 作用 | 默认值 |
---|---|---|
-U |
用户名 | 当前系统用户 |
-d |
要连接的数据库名 | 与用户名相同 |
-h |
数据库服务器地址 | localhost |
-p |
端口号 | 5432 |
-W |
强制提示输入密码 | 无 |
示例:
psql -U myuser -d mydb -h 192.168.1.100 -p 5433 -W
常见问题解决
-
错误:
psql: command not found
→ 未正确配置环境变量,需手动添加 PostgreSQL 的bin
目录到PATH
。 -
错误:
Connection refused
→ 检查 PostgreSQL 服务是否启动:- Windows:在服务中启动 postgresql-x64-16。
- Linux:
sudo systemctl start postgresql
。
-
忘记密码
→ 编辑配置文件pg_hba.conf
(位于安装目录的data
文件夹):
将METHOD
改为trust
→ 重启服务 → 用psql
无密码登录 → 执行ALTER USER 用户名 PASSWORD '新密码';
→ 改回md5
并重启服务。
验证连接成功
在 psql
命令行中执行:
SELECT version(); -- 查看 PostgreSQL 版本 \conninfo -- 显示当前连接信息 \l -- 列出所有数据库
安全退出
输入以下命令退出 psql
:
\q
引用说明:本文操作基于 PostgreSQL 官方文档(psql 使用指南)及常见系统管理实践,确保使用最新版本以获得最佳安全性和功能支持。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/6369.html