DESKTOP-72TV0V4\caoxiaozhu
b2bc9988a9
- 新增 Go 语言后端服务(server/)，包含用户认证、Agent管理、数据库连接等API - 新增 Python Agent 服务(agent/)，实现Agent核心逻辑和工具集 - 前端从原生HTML迁移到Vue.js框架(web/src/) - 添加 Docker Compose 支持(docker-compose.yml) - 添加项目架构文档(docs/ARCHITECTURE.md) - 添加环境变量示例(.env.example)和本地启动脚本(start-local.ps1) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
105 lines
2.5 KiB
Markdown
105 lines
2.5 KiB
Markdown
# 创建数据库配置
|
|
|
|
## 接口地址
|
|
|
|
```
|
|
POST /database/add
|
|
```
|
|
|
|
## 请求参数
|
|
|
|
| 参数 | 类型 | 必填 | 说明 |
|
|
|------|------|------|------|
|
|
| name | string | 是 | 数据库名称 |
|
|
| description | string | 否 | 描述 |
|
|
| db_type | string | 是 | 数据库类型 |
|
|
| host | string | 是 | 主机 |
|
|
| port | int | 是 | 端口 |
|
|
| username | string | 是 | 用户名 |
|
|
| password | string | 否 | 密码 |
|
|
| database | string | 是 | 数据库名 |
|
|
| charset | string | 否 | 字符集 |
|
|
| ssl_mode | string | 否 | SSL 模式 |
|
|
| sub_tables | array | 否 | 子表配置列表 |
|
|
|
|
### sub_tables[] 详情
|
|
|
|
| 参数 | 类型 | 必填 | 说明 |
|
|
|------|------|------|------|
|
|
| parent_table | string | 是 | 原始表名 |
|
|
| sub_table_name | string | 是 | 子表别名 |
|
|
| sub_table_comment | string | 否 | 子表注释 |
|
|
| mapping_type | string | 否 | 映射类型 |
|
|
| relation_field | string | 否 | 关联字段 |
|
|
| relation_type | string | 否 | 关联类型 |
|
|
| fields | array | 否 | 字段映射列表 |
|
|
|
|
### fields[] 详情
|
|
|
|
| 参数 | 类型 | 必填 | 说明 |
|
|
|------|------|------|------|
|
|
| column_name | string | 是 | 列名 |
|
|
| mapped_name | string | 是 | 中文映射名 |
|
|
|
|
## 请求示例
|
|
|
|
```json
|
|
{
|
|
"name": "学生数据库",
|
|
"description": "用于存储学生信息",
|
|
"db_type": "mysql",
|
|
"host": "localhost",
|
|
"port": 3306,
|
|
"username": "root",
|
|
"password": "root",
|
|
"database": "students",
|
|
"charset": "utf8mb4",
|
|
"sub_tables": [
|
|
{
|
|
"parent_table": "users",
|
|
"sub_table_name": "用户表",
|
|
"sub_table_comment": "用户信息",
|
|
"fields": [
|
|
{"column_name": "id", "mapped_name": "用户ID"},
|
|
{"column_name": "name", "mapped_name": "用户名"}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## 返回参数
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|------|------|------|
|
|
| id | string | 数据库记录ID |
|
|
| name | string | 数据库名称 |
|
|
| db_type | string | 数据库类型 |
|
|
| host | string | 主机 |
|
|
| port | int | 端口 |
|
|
| ... | ... | 其他字段 |
|
|
|
|
## 返回示例
|
|
|
|
```json
|
|
{
|
|
"id": "xxx-xxx-xxx",
|
|
"name": "学生数据库",
|
|
"description": "用于存储学生信息",
|
|
"db_type": "mysql",
|
|
"host": "localhost",
|
|
"port": 3306,
|
|
"username": "root",
|
|
"password": "root",
|
|
"database": "students",
|
|
"table_count": 1,
|
|
"charset": "utf8mb4",
|
|
"created_at": "2026-03-06T15:00:00Z"
|
|
}
|
|
```
|
|
|
|
## 说明
|
|
|
|
- 创建时会自动连接数据库获取表结构 DDL
|
|
- 如果传入了 `fields`（字段映射），会自动生成带 COMMENT 的新 DDL 并存储
|