第一章 PostgreSQL 基础与安装配置

第三节 使用 psql 工具与图形化客户端

目标：掌握 PostgreSQL 自带的命令行工具 psql 的基本使用方法，并了解主流图形化管理工具（如 pgAdmin）的功能和操作方式，为后续数据库开发、管理和调试打下基础。

在完成 PostgreSQL 的安装与基础配置后，下一步就是开始使用数据库。PostgreSQL 提供了强大的命令行工具 psql，同时也支持多种图形化管理工具。本节将重点介绍：

  • 如何使用 psql 连接并操作数据库
  • psql 中常用的元命令与快捷方式
  • 安装与使用图形化工具 pgAdmin 4

📦 一、psql 简介与连接数据库

psql 是 PostgreSQL 自带的交互式命令行工具，功能强大且灵活，是 DBA 和开发者日常管理数据库的主要手段之一。

1. 启动 psql 并连接数据库

1

psql -U 用户名 -d 数据库名 -h 主机地址 -p 端口号

示例：

1
2
3
4
5

# 本地连接 postgres 数据库，用户为 postgres
psql -U postgres -d postgres

# 远程连接，假设数据库运行在 192.168.1.100 上
psql -U testuser -d testdb -h 192.168.1.100 -p 5432

如果未指定 -d 参数，psql 默认会尝试连接与用户名同名的数据库。

🔍 二、psql 常用命令与技巧

进入 psql 后，可以执行 SQL 查询、查看元信息、切换数据库等。以下是一些常用命令和快捷方式：

1. 元命令（Meta-Commands）

命令功能说明
\?查看所有可用的元命令帮助
\l列出所有数据库
\c <dbname> 或 \connect <dbname>切换数据库
\dt列出当前数据库中所有表
\dv列出视图
\df列出函数
\du列出所有角色/用户
\d+ <tablename>查看表结构及详细信息
\echo :AUTOCOMMIT查看是否启用自动提交
\set AUTOCOMMIT off关闭自动提交，用于手动事务控制
\x开启扩展显示模式（适合查看宽表或 JSON 数据）
\timing显示每条 SQL 执行时间

2. 编辑与执行脚本

命令功能说明
\e调用编辑器修改当前查询缓冲区
\i <filename.sql>执行外部 SQL 文件
\o <output.txt>将输出重定向到文件
\q退出 psql

3. 实战示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

-- 查看当前连接的数据库和用户
SELECT current_database(), current_user;

-- 创建测试表
CREATE TABLE employees (
    id SERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    department TEXT,
    salary NUMERIC(10,2)
);

-- 插入数据
INSERT INTO employees (name, department, salary) VALUES
('Alice', 'HR', 70000),
('Bob', 'Engineering', 90000);

-- 查询数据
SELECT * FROM employees;

🖼️ 三、图形化客户端工具：pgAdmin 4

虽然 psql 强大高效，但对于初学者或需要可视化操作的场景，图形化工具更友好。pgAdmin 4 是 PostgreSQL 社区官方推荐的图形化管理工具，支持浏览器访问和桌面应用两种形式。

1. 安装 pgAdmin 4（以 Ubuntu 为例）

1

sudo apt install pgadmin4

安装完成后，可以通过浏览器访问：

1

http://localhost/pgadmin4

首次访问需设置管理员账户。

2. Windows 安装

从 pgAdmin 官网 下载 Windows 安装包，双击安装即可。

3. 连接数据库

  1. 打开 pgAdmin 4。
  2. 点击 “Add New Server”。
  3. 输入连接信息：
    • Host: 数据库服务器 IP（如 localhost）
    • Port: 默认 5432
    • Maintenance DB: 通常为 postgres
    • Username: 数据库用户（如 postgres）
    • Password: 对应密码

点击保存后，即可在左侧树形结构中浏览数据库对象。

4. pgAdmin 4 核心功能简介

功能描述
可视化建模支持通过图形界面设计表、视图、触发器等
查询工具类似 psql 的 SQL 编辑器，支持语法高亮、自动补全
数据导入导出支持 CSV、SQL、JSON 等格式的数据导入导出
图形化执行计划分析可直观查看 SQL 执行路径与性能瓶颈
监控仪表盘实时监控数据库连接数、锁、活动查询等
备份与恢复支持逻辑备份（pg_dump）、物理备份（pg_basebackup）
用户权限管理图形化管理角色、权限分配

💡 四、实用技巧与建议

1. 设置别名提升效率（Linux/macOS）

你可以为 psql 设置别名以简化常用连接：

1

alias devdb='psql -U devuser -d devdb -h localhost'

添加到 .bashrc 或 .zshrc 后即可使用：

1

devdb

2. 使用 .psqlrc 配置默认行为

创建 .psqlrc 文件（位于用户主目录），设置默认参数：

1
2
3

\set AUTOCOMMIT off
\x auto
\timing on

这样每次启动 psql 时都会自动加载这些配置。

3. 使用 psql 的历史记录功能

psql 会自动记录执行过的命令历史，使用上下箭头可快速回溯。

历史记录保存在 .psql_history 文件中。

🧪 五、实战演练：使用 pgAdmin 4 创建一张表并插入数据

步骤 1：打开 pgAdmin 4，连接数据库

确保已成功连接到目标数据库实例。

步骤 2：选择一个数据库，打开“Query Tool”

点击菜单栏中的 “Tools > Query Tool”。

步骤 3：输入并执行 SQL 语句

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

CREATE TABLE customers (
    customer_id SERIAL PRIMARY KEY,
    name VARCHAR(100),
    email VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

INSERT INTO customers (name, email) VALUES
('John Doe', '[email protected]'),
('Jane Smith', '[email protected]');

点击 ▶️ 按钮执行，然后点击 “Data Output” 查看结果。

步骤 4：查看表结构与数据

在左侧对象浏览器中展开数据库 → 表，右键点击 customers 表 → “View/Edit Data > All Rows”，即可查看插入的数据。

📌 小结

工具特点推荐使用场景
psql快速、轻量、灵活日常管理、脚本自动化、远程连接
pgAdmin 4图形化、功能丰富、可视化强新手入门、复杂建模、性能分析

通过本节的学习，你应该已经掌握了如何使用 psql 进行基本的数据库操作，并能够使用 pgAdmin 4 进行图形化管理。下一节我们将介绍 PostgreSQL 的用户权限管理基础，包括角色、权限分配与安全策略等内容。