Skip to content

IndexedDB 表关系 ​

菜单:数据库 → IndexedDB 表关系
深链:/_Admin/database/table-relation?SiteId={站点GUID}

表关系用于声明两张 IndexedDB 表 之间的关联:指定 表 A / 字段 A、关系类型、表 B / 字段 B,并赋予关系一个 名称。保存后,在 KScript 中读取表 A 某行时,可通过 关系名称(或部分场景下的关联表名)访问关联的表 B 数据。

权限

列表与查看:tableRelation(查看)。新建 关系需 tableRelation·edit;多选 删除 需 tableRelation·delete。

前置条件

两张表须已在 IndexedDB 表 中创建,且相关字段已存在于 列设置 中。下拉框中的表与字段来自当前站点 IndexedDB 表结构。

如何打开 ​

  1. 在 编辑菜单 中勾选 数据库 → IndexedDB 表关系。
  2. 左侧 数据库 → IndexedDB 表关系。
表关系列表

关系列表 ​

工具栏 ​

按钮权限说明
新建tableRelation·edit打开 新建关系弹窗
表关系工具栏

列表表格 ​

列说明
名称关系唯一名;脚本中常作为当前表记录上的 属性名 访问关联数据
表 A / 字段 A关系一侧的表与字段
关系关系类型(一对一、一对多、多对多、多对一等,界面文案由系统本地化)
表 B / 字段 B另一侧的表与字段

支持多选 删除。当前界面 不提供行内编辑;需修改时请删除后重新 新建(或通过 TableRelation API 更新)。

表关系列表表格

新建关系弹窗 ​

字段说明
名称必填;1~50 字符;站点内唯一(冲突时提示关系名已存在)
表 A下拉选择 IndexedDB 表
字段 A选定表 A 后的字段列表
关系关系类型,可选:OneOne、OneMany、ManyMany、ManyOne(界面显示为对应中文/英文标签)
表 B另一张 IndexedDB 表
字段 B表 B 上的关联字段

保存后调用 TableRelation/post 写入站点库,列表刷新。

新建表关系弹窗

关系类型含义(使用上) ​

类型典型含义脚本侧展开结果(从表 A 行访问时)
一对一 / 多对一A 的一条记录对应 B 的一条单个关联对象
一对多 / 多对多A 的一条记录对应 B 的多条关联对象 数组

实际联接以 字段 A 与 字段 B 的取值相等为准(例如 users.id 对应 orders.userId)。

在脚本中的效果 ​

关系 不 单独提供 k.* API,而是在查询 IndexedDB 表 得到动态对象后,用 关系名称 取关联数据:

typescript
const user = k.DB.indexedDb.users.get(userId)
// 假定存在名为 userOrders 的关系:users.id → orders.userId,类型为一对多
const orders = user.userOrders
  • 访问名通常与后台填写的 名称 一致。
  • 一对多 / 多对多时返回数组;一对一 / 多对一时返回单条对象。
  • 更多 CRUD 见 k.DB.indexedDb。

典型工作流 ​

  1. 在 IndexedDB 表 中准备好 表 A、表 B 及关联字段。
  2. 在本页 新建 关系,填齐名称、两端表字段与类型。
  3. 在 Code 中 get / find 主表记录后,通过 名称 读取关联集合。
  4. 关系定义变更后,若脚本仍用旧名称,需同步修改代码或删除重建关系。

相关 ​

文档说明
IndexedDB 表建表与列、数据维护
k.DB.indexedDb动态对象与查询
数据库概述数据库分组菜单