数据库结构总览

需要查某张表有哪些字段、字段类型/外键,或了解平台数据模型按业务域如何分布时

06-二次开发 / 数据库结构
数据库表结构schema字段数据模型ER表清单ab_userprojectpipelinetaskdatasetchatinferenceservice

数据库结构总览

本目录是 CubeStudio 平台数据库表字段清单(参考类),按业务域拆分为多个子文件。每张表对应 myapp/models/ 下一个 ORM 模型,__tablename__ 即表名。字段以 Column(...) 定义,类型/可空/默认值/comment 与各表一一对应。

说明:本清单为某次导出的结构快照,用于快速检索字段含义。字段的最新权威定义请以 myapp/models/*.py 源码为准。已抽样核对 aihub / chat / chat_log / pod / dataset 等表,字段基本一致(个别 comment 文案有漂移,已在对应子文件标注)。

表头字段含义

每张表用统一表头:

列名 类型 是否为空 默认值 描述 是否唯一 外键

(源快照表头原文为「列明 / 谁否为空」,系笔误,本目录统一更正为「列名 / 是否为空」。)

子文件目录(TOC)

子文件 业务域 包含表
01-权限与用户.md 权限与用户(FAB 自带 ab_* ab_permission, ab_permission_view, ab_permission_view_role, ab_register_user, ab_role, ab_user, ab_user_role, ab_view_menu
02-项目计费与账户.md 项目分组、计费、账户审批 project, project_user, bill, pod, invoice, approval
03-数据治理.md 数据集、维表、元数据、收藏 dataset, dimension, metadata_table, metadata_metric, favorite
04-镜像与开发环境.md 镜像仓库、镜像、在线构建、notebook、任务模板 repository, images, docker, notebook, job_template
05-数据开发ETL.md ETL 数据开发 etl_pipeline, etl_task
06-训练任务流.md 任务流编排与分布式训练 CRD pipeline, task, run, workflow, nni, tfjob, pytorchjob, xgbjob
07-模型与服务.md 训练模型、内部服务、推理服务 model, service, inferenceservice
08-智能体与系统.md 智能体、SQL Lab、节点、存储、系统表 chat, chat_log, aihub, sqlab_query, logs, node, storage, alembic_version

快照未含、但代码中存在的表

以下表在 myapp/models/ 中有定义,但不在本快照内(属新增/遗漏,待补):

  • messagemodel_message.py,消息表)
  • model_definemodel_model_define.py,模型定义/模型仓库)
  • ingressmodel_llm_ingress.py,LLM 网关 ingress)
  • rental_instancemodel_rental_instance.py,租用实例)
  • service_pipelinemodel_service_pipeline.py,服务编排流水线)
  • etl_pipeline_runmodel_etl_pipeline.py,ETL 运行记录)
  • user_attributeuser_attributes.py,用户属性扩展)

如需这些表的字段,请直接查阅对应 myapp/models/*.py

最后更新 2026-07-04完整文档以官方仓库为准:GitHub Wiki