65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
|
# 数据库安装指南 (Windows)
|
|||
|
|
|
|||
|
|
由于本项目依赖 **TimescaleDB** 时序数据库插件，而该插件目前在 Windows 上**仅官方支持到 PostgreSQL 17**（暂未提供适配 PostgreSQL 18 的 Windows 安装包），因此我们需要安装 **PostgreSQL 17**。
|
|||
|
|
|
|||
|
|
## 方案一：使用 Docker（强烈推荐）
|
|||
|
|
|
|||
|
|
如果您已安装 Docker Desktop，这是最简单的方法，无需配置环境。
|
|||
|
|
|
|||
|
|
1. 确保 Docker Desktop 已启动。
|
|||
|
|
2. 在项目根目录打开终端，运行：
|
|||
|
|
```powershell
|
|||
|
|
docker-compose up -d
|
|||
|
|
```
|
|||
|
|
3. 完成！数据库已在端口 `5432` 启动，且已包含 TimescaleDB。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 方案二：本机手动安装
|
|||
|
|
|
|||
|
|
如果您必须在 Windows 本机安装，请严格按照以下步骤操作。
|
|||
|
|
|
|||
|
|
### 第一步：安装 PostgreSQL 17
|
|||
|
|
|
|||
|
|
1. **下载**：[PostgreSQL 17.2 Windows x64 安装程序](https://get.enterprisedb.com/postgresql/postgresql-17.2-1-windows-x64.exe)
|
|||
|
|
- 或者访问官网：https://www.postgresql.org/download/windows/
|
|||
|
|
2. **安装**：
|
|||
|
|
- 运行安装程序。
|
|||
|
|
- **记住您设置的密码**（后续配置需要用到，建议设为 `postgres` 或修改项目配置）。
|
|||
|
|
- 端口保持默认 `5432`。
|
|||
|
|
- 安装目录建议保持默认（如 `C:\Program Files\PostgreSQL\17`）。
|
|||
|
|
- **Stack Builder**：安装结束后会询问是否运行 Stack Builder，**取消勾选**，我们不需要它。
|
|||
|
|
|
|||
|
|
### 第二步：安装 TimescaleDB 插件
|
|||
|
|
|
|||
|
|
1. **下载**：[TimescaleDB v2.23.0 for PostgreSQL 17 (Windows zip)](https://github.com/timescale/timescaledb/releases/download/2.23.0/timescaledb-postgresql-17-windows-amd64.zip)
|
|||
|
|
- 备用链接：访问 [GitHub Releases](https://github.com/timescale/timescaledb/releases)，找到 `timescaledb-postgresql-17-windows-amd64.zip`。
|
|||
|
|
2. **解压**：
|
|||
|
|
- 将压缩包解压到一个临时文件夹。
|
|||
|
|
3. **安装**：
|
|||
|
|
- 在解压后的文件夹中找到 `setup.exe`。
|
|||
|
|
- **右键 -> 以管理员身份运行**。
|
|||
|
|
- 按照提示操作：
|
|||
|
|
- 输入 PostgreSQL 的安装路径（通常会自动检测）。
|
|||
|
|
- 输入 `postgres` 用户的密码。
|
|||
|
|
- 允许它修改 `postgresql.conf` 配置（输入 `y`）。
|
|||
|
|
4. **重启服务**：
|
|||
|
|
- 打开 Windows 服务管理器（Win+R -> `services.msc`）。
|
|||
|
|
- 找到 `postgresql-x64-17` 服务。
|
|||
|
|
- 右键 -> **重新启动**。
|
|||
|
|
|
|||
|
|
### 第三步：验证安装
|
|||
|
|
|
|||
|
|
打开项目目录下的 `tools/check_db.py`（如果不存在可手动创建测试），或者使用 `psql`：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
psql -U postgres
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在 SQL 命令行中输入：
|
|||
|
|
```sql
|
|||
|
|
CREATE EXTENSION IF NOT EXISTS timescaledb;
|
|||
|
|
SELECT * FROM timescaledb_information.hypertables;
|
|||
|
|
```
|
|||
|
|
如果不报错，说明安装成功。
|