spacetimedb-tables

将此技能用于模块架构和表性能。

表的核心模式

TypeScript 表使用 table(options, columns)，并且必须作为对象传递给 schema()：

import { schema, table, t } from "spacetimedb/server";

const player = table(
  { name: "player", public: true },
  {
    id: t.u64().primaryKey().autoInc(),
    identity: t.identity().unique(),
    name: t.string().index("btree"),
  },
);

export default schema({ player });

各语言的表声明：

• TypeScript：{ name: "player_score" } 会创建 ctx.db.playerScore。
• C#：[SpacetimeDB.Table(Accessor = "Player", Public = true)] 会创建 ctx.Db.Player；类型必须是 partial。
• Rust：#[spacetimedb::table(accessor = player, public)] 会创建 ctx.db.player()；pub struct 不会让表变为公开。
• C++：SPACETIMEDB_TABLE(Type, player, Public) 会创建 ctx.db[player]。

设计规则

• 按访问／更新模式组织数据。将频繁更新的热状态与很少更改的个人资料、设置或统计字段拆分开。
• 客户端可通过订阅查看公开表。将仅供服务器使用的状态设为私有，并在需要时通过视图公开派生子集。
• 主键和唯一约束会自动创建索引；不要为它们添加重复索引。
• 仅在频繁使用等值、范围、订阅或联接查询时添加索引。默认使用 B-tree；直接索引适用于密集的无符号整数键，并非所有语言都普遍支持。
• 在已发布的现有表中新增列时，必须设置默认值，并将新列追加到末尾。更改现有架构前，请检查数据库迁移规则。
• 自增值由数据库生成，事务失败后可能出现间隔。
• 使用事件表发送仅追加的客户端通知；发布后无法更改事件标记。
• 调度表需要 ScheduleAt 列和关联的调度 reducer。在 TypeScript 中，从 spacetimedb 而不是 spacetimedb/server 导入 ScheduleAt。

参考索引

需求	打开
表定义和核心模式	references/tables.md
访问控制	references/tables-access-permissions.md
ID 和默认值	references/tables-auto-increment.md, references/tables-default-values.md
类型和约束	references/tables-column-types.md, references/tables-constraints.md
索引设计	references/tables-indexes.md
事件表和调度表	references/tables-event-tables.md, references/tables-schedule-tables.md
存储和性能	references/tables-file-storage.md, references/tables-performance.md

指南

• 更改现有架构前，请在 spacetimedb-databases 中检查迁移影响。
• 对于频繁运行或涉及大型表的 reducer 路径，优先使用索引查找。
• 使用事件表发送仅追加的客户端通知，尤其是在替换 reducer 结果回调模式时。