# 数据库安装指南 (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;
```
如果不报错，说明安装成功。