Chat-Ollama 项目数据库配置指南

向量数据库部署

在 Chat-Ollama 项目中，向量数据库采用了 ChromaDB 解决方案。ChromaDB 是一个开源的向量数据库，专门为 AI 应用设计，能够高效存储和检索向量数据。

部署 ChromaDB 非常简单，只需执行以下 Docker 命令：

docker pull chromadb/chroma
docker run -d -p 8000:8000 chromadb/chroma

部署完成后，ChromaDB 服务将在本地 8000 端口运行，可以通过 http://localhost:8000 访问。这种容器化部署方式确保了环境一致性，同时简化了安装过程。

SQLite 数据库配置

项目使用 SQLite 作为关系型数据库，配置步骤如下：

1. 复制环境变量模板文件：

cp .env.example .env

2. 修改 .env 文件中的数据库路径配置：

DATABASE_URL=file:/path/to/chatollama.sqlite

注意将路径中的 /path/to/ 替换为实际的项目路径。SQLite 数据库文件将在后续步骤中自动创建。

数据库迁移与初始化

项目使用 Prisma 作为 ORM 工具管理数据库，初始化步骤如下：

1. 全局安装 Prisma CLI：

npm install -g prisma

2. 进入项目目录执行迁移：

cd prisma
prisma migrate dev

执行迁移命令后，Prisma 会自动：

• 创建 SQLite 数据库文件（如果不存在）
• 根据数据模型生成表结构
• 应用所有迁移脚本

环境变量配置技巧

虽然可以通过终端临时变量配置数据库连接，但更推荐使用 .env 文件方式，因为：

1. 配置持久化，不受终端会话影响
2. 便于版本控制（注意将 .env 加入 .gitignore）
3. 支持多环境不同配置

技术选型分析

项目选择 SQLite + ChromaDB 的组合具有以下优势：

• 轻量级：SQLite 无需单独服务，适合开发环境
• 高性能：ChromaDB 专为向量搜索优化
• 易部署：两者都支持容器化部署
• 开发友好：Prisma 提供类型安全的数据库访问

对于生产环境，可以考虑将 SQLite 替换为 PostgreSQL 或 MySQL，只需修改 DATABASE_URL 配置即可，得益于 Prisma 的良好抽象。