Django SQL Explorer 安装与配置指南

Django SQL Explorer 安装与配置指南

django-sql-explorer Easily share data across your company via SQL queries. From Grove Collab. 项目地址: https://gitcode.com/gh_mirrors/dja/django-sql-explorer

项目基础介绍

Django SQL Explorer 是一个基于 Django 的开源项目，它提供了一个简单易用的 SQL 编辑器，可以帮助用户快速编写和执行 SQL 查询。该项目适用于需要数据分析、报告或者管理数据库的人员。它支持多种数据库连接，包括 Django 支持的所有数据库以及用户上传的 CSV、JSON 或 SQLite 数据库。SQL Explorer 还集成了 AI 助手，可以帮助编写和调试 SQL 查询。

主要编程语言

• Python
• JavaScript
• HTML
• CSS
• SCSS

关键技术和框架

• Django: Python 的一个高级 Web 框架，鼓励快速开发和干净、实用的设计。
• Vite: 一个现代化的前端构建工具。
• AI 助手: 集成 OpenAI 或其他服务提供的 LLM（大型语言模型）API。

准备工作

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

1. Python 3.8 或更高版本
2. pip（Python 包管理器）
3. Node.js 和 npm（用于前端构建）
4. Docker（如果使用容器化部署）

安装步骤

步骤 1: 克隆项目

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

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

步骤 2: 安装依赖

安装项目所需的 Python 依赖：

pip install -r requirements.txt

然后安装前端依赖：

cd frontend
npm install

步骤 3: 数据库配置

配置你的数据库设置。在 settings.py 文件中，修改 DATABASES 配置项以匹配你的数据库设置。

步骤 4: 迁移数据库

执行以下命令来创建数据库表：

python manage.py migrate

步骤 5: 创建管理员账户

创建一个管理员账户用于登录 SQL Explorer：

python manage.py createsuperuser

按照提示输入用户名和密码。

步骤 6: 运行开发服务器

启动 Django 开发服务器：

python manage.py runserver

然后在浏览器中访问 http://127.0.0.1:8000/explorer/，使用管理员账户登录。

步骤 7: 构建前端

构建前端资源：

cd frontend
npm run build

构建完成后，将前端静态文件复制到 Django 项目的静态文件夹中：

cp -r frontend/dist/* ../sql_explorer/static/

步骤 8: 重启服务器

重新启动 Django 服务器以应用前端更改：

python manage.py runserver

现在你应该能够看到 SQL Explorer 的界面，并且可以开始使用它来执行 SQL 查询了。

以上步骤为 Django SQL Explorer 的基本安装和配置流程。根据个人需求，你可能还需要进行一些额外的配置和优化。

django-sql-explorer Easily share data across your company via SQL queries. From Grove Collab. 项目地址: https://gitcode.com/gh_mirrors/dja/django-sql-explorer