一、准备工作：启动pgAdmin并连接数据库服务器
在使用pgAdmin执行SQL查询前，需确保已安装PostgreSQL数据库及pgAdmin工具（可通过包管理器如apt安装，或通过Docker拉取镜像运行）。启动pgAdmin后（可通过终端输入pgadmin4或桌面图标打开），需先连接到目标PostgreSQL服务器：
- 在pgAdmin左侧浏览器面板中，右键点击“Servers”节点，选择“Create”→“Server…”。
- 在“General”选项卡中输入服务器名称（如“My PostgreSQL Server”）；切换至“Connection”选项卡，填写服务器连接信息：
- Host name/address：数据库服务器地址（本地为
localhost，远程为IP地址）；
- Port：默认
5432（PostgreSQL标准端口）；
- Maintenance database：通常为
postgres（默认维护数据库）；
- Username/Password：数据库用户名及密码（如
postgres超级用户）。
- 点击“Save”保存配置，完成服务器连接。
二、打开查询工具
连接服务器后，需针对目标数据库打开SQL查询编辑器，有两种常用方式：
- 方式1：通过右键菜单快速打开：在左侧浏览器面板中，展开“Databases”节点，右键点击需要查询的数据库（如
mydb），选择“Query Tool”（查询工具）。
- 方式2：通过菜单栏新建：点击顶部菜单栏“Tools”→“Query Tool”，或在“Query Tool”节点下点击“New Query”图标（+号形状）。
两种方式均会弹出一个新的查询窗口，用于编写SQL语句。
三、编写SQL查询语句
在查询窗口的文本编辑区域，输入需要执行的SQL语句。常见示例包括：
- 查询所有数据：
SELECT * FROM table_name;（替换table_name为实际表名）；
- 带条件查询：
SELECT column1, column2 FROM table_name WHERE condition;（如SELECT name, age FROM users WHERE age > 18;）；
- 插入数据：
INSERT INTO table_name (column1, column2) VALUES ('value1', 'value2');；
- 更新数据：
UPDATE table_name SET column1 = 'new_value' WHERE condition;；
- 删除数据：
DELETE FROM table_name WHERE condition;。
也可编写复杂查询（如联接、分组、排序）或PL/pgSQL存储过程逻辑。
四、执行SQL查询
编写完成后，通过以下方式提交查询：
- 执行全部语句：点击工具栏上的绿色播放按钮（或按
F5键），执行查询窗口中的所有SQL语句；
- 执行选中语句：若只需运行部分语句，可高亮选中目标代码片段，再按
F5或点击播放按钮，仅执行选中部分。
执行后，下方结果面板会显示查询结果（如查询到的数据行），或显示执行状态（如“Query returned successfully”）。
五、查看与管理查询结果
- 浏览结果：结果面板支持滚动查看所有返回的行，可通过列标题排序（点击列名切换升序/降序）；
- 导出数据：点击结果面板顶部的“Export”按钮，可将结果导出为CSV、Excel、JSON等格式；
- 查看执行计划：若需优化查询性能，可在查询语句前添加
EXPLAIN ANALYZE（如EXPLAIN ANALYZE SELECT * FROM mytable;），执行后会显示查询执行计划，帮助分析性能瓶颈。
六、执行SQL文件（可选）
若需批量执行SQL脚本（如建表、插入数据），可通过以下步骤操作：
- 在pgAdmin中连接到目标数据库，右键点击数据库名称，选择“Query Tool”；
- 点击工具栏上的“Open file”图标（文件夹形状），选择本地SQL文件（如
script.sql）；
- 点击“Execute”按钮（或按
F5），执行文件中的所有SQL语句。
执行结果会统一显示在结果面板中，便于查看批量操作的效果。