Django SQL Explorer 安装与配置指南

1. 项目基础介绍

Django SQL Explorer 是一个基于 Django 的开源项目，它旨在提供一个简单、易用的 SQL 编辑器，使用户能够方便地编写和分享 SQL 查询。项目支持多种数据库连接，包括 Django 所支持的任何 SQL 数据库，以及用户上传的 CSV、JSON 或 SQLite 数据库。此外，它还集成了 AI 助手，可以帮助编写和调试查询。

主要编程语言：Python、JavaScript

2. 项目使用的关键技术和框架

• Django: Python 的高级 Web 框架，用于快速开发安全且易于维护的网站。
• Vite: 现代的前端开发与构建工具，用于提高前端开发的效率。
• SQLAlchemy: Python SQL 工具包和对象关系映射（ORM）系统。
• OpenAI: 集成了 OpenAI API，提供 AI 助手功能。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Python 3.8 或更高版本
• pip（Python 包管理器）
• Django 3.x
• Node.js 和 npm（用于前端构建）

详细安装步骤

步骤 1: 克隆项目

首先，从 GitHub 克隆项目到本地计算机：

git clone https://github.com/chrisclark/django-sql-explorer.git
cd django-sql-explorer

步骤 2: 安装依赖

安装项目所需的 Python 依赖：

pip install -r requirements.txt

安装 Node.js 依赖并构建前端：

npm install
npm run build

步骤 3: 配置数据库

在项目根目录下，找到 settings.py 文件，并配置数据库连接信息。例如，使用 SQLite 数据库：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

步骤 4: 迁移数据库

迁移数据库以创建所需的表：

python manage.py migrate

步骤 5: 创建管理员账户

创建一个管理员账户以登录 Django 管理界面：

python manage.py createsuperuser

步骤 6: 运行开发服务器

启动 Django 开发服务器：

python manage.py runserver

现在，您可以在浏览器中访问 http://127.0.0.1:8000/explorer/，使用 admin 用户名和您设置的密码登录，开始使用 Django SQL Explorer。

请注意，以上步骤是在开发环境中进行的。在生产环境中，您需要配置正确的数据库设置、静态文件和媒体文件的存储，并确保所有的安全措施都已到位。