D1 Manager 项目介绍
D1 Manager 是一个专为 Cloudflare D1 设计的网络用户界面和 API,它为这款无服务器 SQL 数据库提供了简单易用的管理功能。通过 D1 Manager,用户可以轻松管理数据库、表格和记录,同时能够通过 API 进行编程操作。这一管理工具简化了数据库管理的过程,让用户能够专注于数据本身。
功能特点
D1 Manager 提供了多种功能,提升了管理数据库的便利性:
- 多数据库支持:用户可以在一个平台上管理多个 D1 数据库。
- 表格管理:可以查看数据库中的所有表格,并展示表格的结构。
- SQL 查询:允许用户运行标准的 SQL 查询以操作数据。
- 语义查询:支持通过 OpenAI API 或 Cloudflare AI Worker 执行语义查询,使得自然语言查询转化为 SQL。
- 数据编辑:用户可以通过用户界面直接编辑表中的数据。
- 多语言支持:提供英文、中文、西班牙文和日文等多语言界面。
- API 支持:通过 API 提供详细操作功能,方便程序化管理数据库。
使用步骤
要设置 D1 Manager,用户需要按照以下步骤操作:
- Fork 仓库:从项目的代码仓库创建一个分支。
- 设置 Cloudflare Pages:使用分支设置 Cloudflare Pages,并选择 "SveltKit" 框架预设。
- 构建命令为:
npm run build
。 - 构建输出目录为:
.svelte-kit/cloudflare
。
- 构建命令为:
- 使用 Cloudflare Access:保护您的站点,确保拦截不必要的访问。
- 绑定数据库:将数据库绑定到环境变量中,如
DB_*
。
环境变量配置
为了使用某些功能,如语义查询,用户需要配置一些额外的环境变量:
-
OpenAI API:
OPENAI_API_KEY
:用于启用语义查询的 OpenAI API 密钥。OPENAI_API_URL
:可以通过 Cloudflare AI Gateway 代理 OpenAI API 请求。OPENAI_MODEL
:用于语义查询的 OpenAI API 模型,默认使用gpt-3.5-turbo-1106
。
-
Cloudflare AI Worker:
AI
:绑定一个 Cloudflare AI Worker。CFAI_MODEL
:用于语义查询的 Cloudflare AI Worker 模型,默认为@cf/mistral/mistral-7b-instruct-v0.1
。
此外,可以通过配置环境变量来显示内部表,例如 splite_*
和 d1_*
。
项目截图
D1 Manager 提供了直观的用户界面,以下是一些功能界面的截图:
- 表格视图:展示数据库中的表格结构和数据。
- 执行查询:用户可以直接在界面中执行 SQL 查询。
- 表格浏览器:方便用户浏览和编辑数据记录。
- 新增记录功能:通过界面简化新增数据的过程。
- 语义查询:利用 OpenAI GPT-3.5 Turbo 将自然语言转换为 SQL 查询。
此项目通过用户友好的页面和强大的功能集成,极大地方便了用户对 Cloudflare D1 数据库的管理和操作。