数据库管理
概述
数据库管理 API 提供完整的 MySQL 数据库生命周期管理功能,包括创建、删除、列表查看和信息查询等操作。
接口列表
数据库操作
POST /create- 创建新数据库GET /databases- 列出所有数据库DELETE /database/{db_name}- 删除指定数据库GET /database/{db_name}/info- 获取数据库详细信息
通用要求
认证
所有数据库管理接口都需要认证:
http
Authorization: Bearer your_api_key权限要求
- 创建数据库:
create_database权限 - 查看数据库:
list_databases权限 - 删除数据库:
delete_database权限 - 数据库信息:
database_info权限
数据库命名规范
- 只能包含字母、数字和下划线
- 不能是纯数字
- 不能与系统数据库重名
系统数据库
以下系统数据库受保护,无法通过 API 操作:
information_schemamysqlperformance_schemasysapi_auth
使用流程
1. 创建数据库
bash
POST /create → 创建成功 → 自动授予创建者权限2. 管理数据库
bash
GET /databases → 查看列表 → GET /database/{name}/info → 查看详情3. 清理数据库
bash
DELETE /database/{name} → 确认删除 → 清理完成错误处理
常见错误码
| 状态码 | 说明 |
|---|---|
| 400 | 数据库名称格式错误 |
| 401 | 认证失败 |
| 403 | 权限不足 |
| 404 | 数据库不存在 |
| 409 | 数据库已存在 |
| 429 | 操作频率超限 |
错误响应示例
json
{
"error": "数据库名称只能包含字母、数字和下划线"
}安全限制
操作频率限制
- 创建数据库:10次/分钟
- 删除数据库:5次/分钟
权限验证
- 用户只能访问被授权的数据库
- 自动权限授予:数据库创建者自动获得该数据库的 admin 权限
