Windows 10 平台安装 PostgreSQL 14.2 详细教程

发表于 更新于 分类于 阅读次数： 25 本文字数： 1.6k 阅读时长 ≈ 6 分钟

Windows 10 平台安装 postgreSQL 14.2.1，安装步骤很简单，基本上是点击下一步（next）。

使用 SQL Shell（psql）进行交互；使用 pgAdmin 工具进行管理。

tips：注意选择安装目录（请不要放到 C 盘，虚拟机搭建测试环境另说）。如果图片挂了，可以前往个人知乎搜索 Windows 10 平台安装 PostgreSQL 14.2 详细教程 。

img

postgreSQL 安装详细教程

一 postgreSQL 安装步骤

01 下载 postgreSQL

Windows 版本（64 位）postgreSQL 14.2.1 下载地址：

https://www.enterprisedb.com/postgresql-tutorial-resources-training?uuid=db55e32d-e9f0-4d7c-9aef-b17d01210704&campaignId=7012J000001NhszQAC

官网：https://www.postgresql.org

官方文档：

https://www.postgresql.org/docs/ 最新版本 14 的 PDF 下载地址：https://www.postgresql.org/files/documentation/pdf/14/postgresql-14-A4.pdf

02 Windows 10 安装 postgreSQL 14.2

2.1 安装步骤 01

Setup —— PostgreSQL

进入 PostgreSQL 安装界面

img

2.2 安装步骤 02

Installation Directory

注意：选择安装目录，推荐安装至 D 盘或者顺延。

img

2.3 安装步骤 03

Select components

选择需要安装的服务：

  1. PostgreSQL Server：数据库（DBMS）服务，必选项。
  2. pgAdmin 4：客户端管理工具，建议勾选。
  3. Stack Builder：依据需求选择。
  4. Command Line Tools：命令行工具，交互必选项。

img

2.4 安装步骤 04

Data Directory

设置数据库实例化数据存放目录。类似于 MySQ 初始化生成 data 目录。

img

2.5 安装步骤 05

Set Password

设置数据库超级用户（postgres）密码。

如果初始化失败，后续则不会生效。

img

2.6 安装步骤 06

Port

设置默认监听端口（port）：5432

img

2.7 安装步骤 07

Advanced Options

建议选择数据库群组（database cluster），下拉有中文简体可选。

cluster 有集群的意思，但在此处指的是组、群组、国别地区（安装支持的语言）。

注意：这一步初始化后生成的 data 目录是空的，可能是权限问题（会有警告提示，导致初始化失败，虽然最终安装完成）。

img

2.8 安装步骤 08

Pre Installation Summary

打印出安装配置信息，其它数据库厂商（DBMS）提供的可视化界面安装一样会有信息显示，例如 Oracle 数据库。

img

2.9 安装步骤 09

Ready to Install

到了这一步，真正开始执行安装过程。

img

关于遇到的警告问题，会在遇到问题解决方案进行展示说明，并给出个人解决方案。

03 postgreSQL 安装目录说明

3.1 postgreSQL 安装目录重点说明

  1. bin：bin 目录一般存放与数据库服务进行交互的命令脚本。
  2. data：data 目录是初始化完成后生成的数据库文件，包含配置文件 postgresql.conf。
  3. pgAdmin 4 ：存放 pgAdmin 4 客户端管理工具文件。
  4. uninstall-postgresql.dat 与 uninstall-postgresql.exe：提供便捷式卸载。

img

3.2 data 目录

  1. 主要注意 postgresql.conf 配置文件，比如配置监听端口（port）和主机（IP）地址。

img

3.3 配置文件设置

  1. listen_addresses：设置监听主机地址，重启服务生效。
  2. port：设置监听服务默认端口，重启服务生效。

img

二 postgreSQL 遇到问题解决方案

01 遇到问题处理方法

  1. 定位问题：遇到问题别慌，也别急着去使用搜索引擎，先将问题定位好。
  2. 文档：参考官方文档。
  3. 善于使用搜索引擎和 StackOverflow 以及 github 的 Issues。
  4. 使用浏览器过滤方式：-xx 网址或者 - site:xx 网址。

例如，个人安装遇到问题（Warning）警告：

Problem running post-install step. Installation may not complete correctly The database cluster installation failed

img

我第一时间联想到的是初始化出问题了，去检查 data 目录，果不其然是空的。

如果你有一些英语底子（说实话，个人基本是靠平时积累的词汇量和有道），一些命令基本上可以猜个八九不离十。

以前我的同事问我，你是猜的？结果发现还挺准的。后面还有一句话没说出来而已，其实是有一定依据才去试一试的。

02 实际解决方案

个人根据以前使用 MySQL（其它数据库）的经验进行判断，结合官方文档进行思考的临时解决方案。

出现警告后，使用以下方式解决无法启动 postgreSQL：

  1. 检查 data 目录是空的（初始化失败了）。
  2. 使用 cmd（管理员身份）执行 initdb 命令初始化。
1
D:\software\PostgreSQL\14\bin>initdb "D:\software\PostgreSQL\14\data"
  1. 继续在 cmd（管理员身份）窗口执行创建用户。
1
D:\software\PostgreSQL\14\bin>createuser postgres
  1. 普通用户身份启动 postgreSQL。

​ 如果没有配置环境变量，注意在 PostgreSQL\14\bin 目录下执行 postgres 命令。使用这种方式启动服务，使用 Ctrl + c 快捷键即可退出服务。

1
D:\software\PostgreSQL\14\bin>postgres --config-file="D:\\software\\PostgreSQL\\14\\data\\postgresql.conf" -D "D:\\software\\PostgreSQL\\14\\data"
  1. 或者使用 pg_ctl start 命令启动服务（postgreSQL 加入 path 环境变量）。
1
D:\>pg_ctl start -D "D:\software\PostgreSQL\14\data"
  1. 使用 pg_ctl stop 命令关闭服务。
1
D:\>pg_ctl stop -D "D:\software\PostgreSQL\14\data"

如下是使用 pg_ctl 命令启动服务，然后使用 netstat 命令去验证服务是否启动。

img

安装后第二天查阅 StackOverflow：其实解决方案相差不大，和我思考方向是一致的，可以参考。

https://stackoverflow.com/questions/32453451/postgres-installation-the-database-cluster-initialization-failed-postgresql-ve

三 使用 SQL Shell（psql）进行交互

01 使用 select 语句验证

进入 SQL Shell（psql）交互界面，直接回车即可进入（前提是服务启动成功）

如同在 MySQL 中，使用 select 1 直接返回结果，这种方式是不走表的，通过 explain 分析就可看出。

1
select 1;

img

02 使用 explain 进行测试

使用 explain 测试 select 1：

1
explain select 1;

img

四 使用 pgAdmin 进行管理

01 配置服务名称

注意：Name 是必填项。

img

02 配置连接

  1. HOST name、address：配置主机名或者 IP 地址。
  2. Port：配置连接监听端口（启动服务时，在配置文件设置的端口）。
  3. Usernam：用户名。
  4. Password：用户密码。

img

03 初次进入 pgAdmin 需要配置密码

img

04 配置完后的界面

progres 和 test 是自己使用命令创建的：

1
2
createuser progres
createuser test

img

以上是本篇教程所有内容，希望能对你的工作与学习有所帮助。

—END—