PostgreSQL 入门指南:从安装到第一次查询

举报
yd_231037148 发表于 2026/11/10 14:37:22 2026/11/10
【摘要】 本文是 PostgreSQL 新手入门指南:从认识 PostgreSQL 开始,分别介绍 Windows、macOS、Linux 下的安装方法,验证服务、psql 连接、创建数据库与用户、建表插数据,再到写出第一条 SELECT 查询,并附常用 psql 命令速查与新手常见问题解答。

PostgreSQL 入门指南:从安装到第一次查询

引言

如果你刚刚接触数据库,PostgreSQL(常简称为 Postgres)是一个非常值得作为起点学习的关系型数据库。它开源免费、功能强大、文档完善,被广泛应用于 Web 应用、数据分析、地理信息等场景。本文将带你从零开始,在自己的电脑上安装 PostgreSQL,创建第一个数据库和第一张表,并完成第一次查询。照着做,不到半小时就能跑通全流程。

一、PostgreSQL 是什么

PostgreSQL 是一个开源的对象关系型数据库管理系统,已经有三十多年的发展历史。它支持标准的 SQL 语法,提供事务、视图、存储过程、触发器、外键约束等完整功能,还支持 JSON、数组、全文检索等现代特性。与一些轻量数据库相比,它更适合作为生产环境的主力数据库;与商业数据库相比,它完全免费,社区活跃。

学习 PostgreSQL 的意义不只是学会一个工具:它遵循 SQL 标准,掌握的 SQL 技能可以迁移到大多数关系型数据库上。

二、安装 PostgreSQL

Windows 系统

  1. 打开 PostgreSQL 官网下载页面,选择 Windows 版本的安装包(由 EDB 提供)。
  2. 运行安装程序,一路点击“下一步”。
  3. 在设置密码环节,为超级用户 postgres 设置一个自己能记住的密码,后面连接数据库时会用到。
  4. 端口保持默认的 5432,语言环境(Locale)保持默认即可。
  5. 安装完成后,勾选运行 Stack Builder 的选项可以取消,初学阶段不需要安装额外组件。

macOS 系统

推荐使用 Homebrew 安装,打开终端执行:

brew install postgresql@16

安装完成后启动服务:

brew services start postgresql@16

Linux(以 Ubuntu / Debian 为例)

使用系统自带的包管理器安装:

sudo apt update
sudo apt install postgresql postgresql-contrib

安装完成后服务会自动启动,可以用下面的命令确认状态:

sudo systemctl status postgresql

看到 active(running)就表示数据库服务已经在运行了。

三、验证安装是否成功

安装完成后,先确认数据库服务正在运行,并查看版本信息:

psql --version

如果能正常输出类似 psql (PostgreSQL) 16.x 的版本号,说明命令行客户端已经就绪。接下来要使用 psql 连接到数据库服务器。

四、第一次连接:使用 psql

psql 是 PostgreSQL 自带的交互式命令行工具,是学习阶段最常用的入口。

在 Linux 或 macOS 上,可以切换到 postgres 系统用户后连接:

sudo -u postgres psql

在 Windows 上,打开开始菜单中的 SQL Shell(psql),按提示依次输入服务器地址(直接回车使用 localhost)、数据库名(回车使用 postgres)、端口(回车使用 5432)、用户名(回车使用 postgres),最后输入安装时设置的密码。

连接成功后,提示符会变成类似这样:

postgres=#

这表示你已经进入数据库,可以输入 SQL 命令了。输入 \q 可以退出 psql。

五、创建你的第一个数据库和用户

在实际项目中,我们很少直接在默认的 postgres 数据库里建表,通常会为每个应用创建一个独立的数据库和专属用户。

-- 创建一个名为 mydb 的数据库
CREATE DATABASE mydb;

-- 创建一个应用用户,并设置密码
CREATE USER app_user WITH PASSWORD 'your_password';

-- 把 mydb 的全部权限授予这个用户
GRANT ALL PRIVILEGES ON DATABASE mydb TO app_user;

然后用新用户连接到新数据库:

psql -U app_user -d mydb -h localhost

参数说明:-U 指定用户名,-d 指定数据库名,-h 指定主机地址。

六、创建第一张表并插入数据

以一个简单的图书表为例。建表时要为每一列指定类型,主键用 SERIAL 类型可以实现自增:

CREATE TABLE books (
    id SERIAL PRIMARY KEY,
    title VARCHAR(200) NOT NULL,
    author VARCHAR(100) NOT NULL,
    price NUMERIC(10, 2),
    published DATE,
    in_stock BOOLEAN DEFAULT TRUE
);

这条语句创建了一个 books 表,包含编号、书名、作者、价格、出版日期和是否有库存六列。其中 id 是主键,NOT NULL 表示该列不允许为空。

插入三条示例数据:

INSERT INTO books (title, author, price, published) VALUES
('PostgreSQL 实战指南', '张三', 79.00, '2024-03-01'),
('SQL 必知必会', '李四', 59.50, '2023-08-15'),
('数据库系统概念', '王五', 128.00, '2022-01-10');

七、第一次查询

终于到了最关键的一步:查询数据。最简单的查询是查看表中所有行和所有列:

SELECT * FROM books;

执行后会看到刚才插入的三行数据以表格形式返回。实际工作中很少用星号查全部列,更常见的做法是指定列名并加上筛选和排序条件:

-- 只查询书名和价格
SELECT title, price FROM books;

-- 查询价格低于 100 元的书,并按价格从低到高排序
SELECT title, author, price FROM books
WHERE price < 100
ORDER BY price ASC;

-- 查询价格最贵的一本书
SELECT title, price FROM books
ORDER BY price DESC
LIMIT 1;

再看一个统计查询,统计表里一共有多少本书,以及所有书的总价:

SELECT COUNT(*) AS book_count, SUM(price) AS total_price FROM books;

COUNT(*) 返回行数,SUM() 对数值列求和,AS 后面是给结果列起的别名。到这里,你已经完成了从安装到第一次查询的完整闭环。

八、常用 psql 命令速查

入口命令和 SQL 语句之外的这些斜杠命令也很实用,在 psql 提示符下使用:

\l            列出所有数据库
\c mydb       切换到 mydb 数据库
\dt           列出当前数据库中的所有表
\d books      查看 books 表的结构
\du           列出所有用户和角色
\h SELECT    查看 SELECT 语句的帮助
\?            查看所有 psql 命令的帮助
\q            退出 psql

记住这几个命令,日常操作基本够用。

九、新手常见问题

连接时提示密码认证失败怎么办? 先确认用户名和密码是否正确;使用系统用户连接时注意区分操作系统用户和数据库用户;检查 pg_hba.conf 中的认证方式是否与你使用的方式一致。

端口 5432 被占用怎么办? 可能是已经安装过另一个版本的 PostgreSQL 或者之前安装的服务没有卸载干净。可以用 netstat 或 ss 命令查看占用端口的进程,停止旧服务或改用其他端口。

中文乱码怎么办? 创建数据库时指定编码为 UTF8,客户端编码保持一致;插入数据前可以执行 SHOW client_encoding; 查看当前客户端编码。

忘记 postgres 用户密码怎么办? 可以临时把 pg_hba.conf 中的认证方式改为 trust,重启服务后免密登录改密码,再改回原来的认证方式。操作前建议备份配置文件。

结语

本文从安装开始,依次完成了服务验证、psql 连接、数据库和用户创建、建表、插入数据以及第一次查询,还整理了一份常用命令和常见问题。接下来你可以继续学习 UPDATE 更新数据、DELETE 删除数据、多表 JOIN、索引优化、事务和视图等主题,逐步把 PostgreSQL 用到自己的项目中。动手是最好的学习方式,现在就去跑通你的第一次查询吧。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。