SmartEDT/PostgreSQL及实时数据库安装指南.md

数据库安装指南 (Windows)

由于本项目依赖 TimescaleDB 时序数据库插件，而该插件目前在 Windows 上仅官方支持到 PostgreSQL 17（暂未提供适配 PostgreSQL 18 的 Windows 安装包），因此我们需要安装 PostgreSQL 17。

方案一：使用 Docker（强烈推荐）

如果您已安装 Docker Desktop，这是最简单的方法，无需配置环境。

1. 确保 Docker Desktop 已启动。
2. 在项目根目录打开终端，运行：

   docker-compose up -d
   

3. 完成！数据库已在端口 5432 启动，且已包含 TimescaleDB。

---

方案二：本机手动安装

如果您必须在 Windows 本机安装，请严格按照以下步骤操作。

第一步：安装 PostgreSQL 17

1. 下载：PostgreSQL 17.2 Windows x64 安装程序
   • 或者访问官网：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)
   • 备用链接：访问 GitHub 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：

psql -U postgres

在 SQL 命令行中输入：

CREATE EXTENSION IF NOT EXISTS timescaledb;
SELECT * FROM timescaledb_information.hypertables;

如果不报错，说明安装成功。