打开pgAdmin4的第一眼,很多人会懵——满屏的英文菜单,左边一棵树,右边一片白,完全不知道从哪儿下手。别慌,这玩意儿看着唬人,其实连接数据库就三步:找到服务器、填连接信息、点保存。今天这篇教程不讲虚的,就带你一步一步把数据库连上,你照着做,五分钟内肯定能搞定。

先说说pgAdmin4是个啥。它是PostgreSQL官方出的图形化管理工具,相当于给数据库装了个可视化操作面板。你不需要记那些复杂的命令行,鼠标点一点就能建表、查数据、跑SQL。很多新手一上来就急着装这个装那个,其实你只要装好了PostgreSQL,pgAdmin4通常就跟着一起装好了。打开开始菜单搜一下,看到那个大象图标点进去就行。如果你电脑上确实没有,去官网下载一个,免费开源,不用破解,装完就能用。
打开之后,你会看到一个启动界面,可能要等几秒,然后进入主界面。左边那个面板叫“浏览器”,里面默认有一个“Servers”节点,这就是你所有数据库连接的入口。第一次用的时候,这个节点下面通常是空的,或者只有一个默认的“PostgreSQL 16”之类的子节点。别急着点,先右键点击“Servers”这个主节点,在弹出的菜单里选择“Register”再选“Server...”,这就是新建连接的入口。有些版本直接显示“Create”选项,道理一样,都是添加服务器连接。
接下来是重头戏——填连接信息。你会看到一个弹窗,顶部有几个标签页,默认停在“General”页。这里先给这个连接起个名字,比如“我的本地数据库”或者“测试库”,这个名称随便写,纯粹是你自己识别用的,跟实际数据库无关。填完名字,切到“Connection”标签页,这才是关键。Host name/address那一栏,如果你数据库装在本机,填“localhost”或者“127.0.0.1”都行;Port默认是“5432”,除非你当初装的时候改过,否则别动它;Maintenance database填“postgres”,这是系统默认库,用来验证连接的;Username填你安装PostgreSQL时设置的用户名,通常是“postgres”。Password先空着,点“Save”之后它会再问你。
填完这些,先别急着点保存。下面有个“Save password”的复选框,勾上它以后连接就不用重复输密码了,但要注意,这是明文保存,公共电脑上别勾。还有那个“Connect now”选项,默认是勾上的,意思是保存后立即尝试连接。都确认无误了,点右下角的“Save”按钮。这时候如果弹出一个输入密码的框,把你安装时设的密码输进去,再点OK。如果一切顺利,左边树形菜单里“Servers”节点下面就会出现你刚才创建的那个连接,而且图标上会多一个小绿点,这就代表连接成功了。
你可能会遇到连不上的情况,别急,九成是这几个原因。第一,密码输错,这个最常见,注意区分大小写,实在不行去pg_hba.conf文件里改认证方式;第二,端口被占用或者填错,确认你的PostgreSQL服务真的在运行,打开Windows服务管理器看看有没有“postgresql-x64-16”之类的服务,状态必须是“正在运行”;第三,如果你连的是远程服务器,那“localhost”肯定不行,得填服务器的IP地址,而且服务器那边得开放5432端口,云服务器还要在安全组里放行。还有一个坑,有些魔改版的PostgreSQL端口不是5432,那你得自己查配置文件。
连接成功之后,你能干什么?左边展开你新建的连接,看到“Databases”节点,点开它,里面默认有“postgres”这个数据库,还有其他几个系统库。右键点击“postgres”选择“Query Tool”,右边就会打开一个SQL编辑器,你可以在这里输入“SELECT version();”然后按F5运行,如果能看到一串版本号,说明你的连接完全没问题,可以正式使用了。这时候你就算入门了,后面建表、导数据、跑查询,都是在这个基础上延伸出来的。
啰嗦一句,pgAdmin4这个工具虽然界面有点老气,但功能是真全,什么备份恢复、图形化建表、SQL自动补全都有。你把它当成一个数据库的遥控器就行,连接只是第一步,后面还有大量好玩的功能等着你摸索。记住,今天你花五分钟学会连接,明天就能省下大把查文档的时间。如果这篇教程帮你连上了,那就去建个表试试手,实践一次比看十遍教程都管用。


