Skip to content

数据库设计文档

版本号修改修改时间备注
v1.0.0王小琱2024.12.20初次修订

1. 简介

本文档描述了 exchange-market-agg-backend 项目中 Kline(市场K线数据)表的结构设计,包括字段说明及表关系,旨在为开发、测试和运维人员提供参考。

2. 数据库概览

  • 数据库名称:exchange_market_agg
  • 数据库类型:MySQL
  • 编码格式:utf8mb4
  • 存储引擎:InnoDB
  • 排序集:utf8mb4_0900_ai_ci

3. 命名规范

  • 表名使用小写字母+下划线风格,例如:kline
  • 字段名使用小写字母+下划线风格,例如:open_time
  • 主键统一使用 id 或业务唯一主键
  • 外键统一用 xxx_id 格式
  • 时间字段统一使用:created_atupdated_at
  • 逻辑删除字段:deleted_at(如使用软删)

4. 表结构设计

4.1 表:kline(市场K线数据表)

字段名类型长度是否为NULL是否自增是否主键默认值说明
symbolVARCHAR255-货币对符号
periodVARCHAR255-周期 s->秒 m->分 h->小时等
event_timeBIGINT64-事件时间
openDECIMAL(32,16)255-周期内开盘价
closeDECIMAL(32,16)255-周期内收盘价
highDECIMAL(32,16)255-周期内最高成交价
lowDECIMAL(32,16)255-周期内最低成交价
open_timeBIGINT64-开盘时间(主键,自增)
close_timeBIGINT64-收盘时间
quote_volumeDECIMAL(32,16)255-成交额
volumeDECIMAL(32,16)255-成交量
countBIGINT64-周期内总交易笔数
checkedTINYINT80是否已验证:1->已验证;0->未验证

kline 表用于记录市场K线数据,支持多种周期和币对。

5. 表关系设计(ER 图)

6. 安全与审计字段

建议每张表都增加以下字段(如适用):

  • created_atupdated_at:记录操作时间
  • deleted_at:逻辑删除字段

🚀 构建现代化数字资产交易平台