spacetimedb-views

将此技能用于通过 SpacetimeDB 视图公开的派生数据。

核心视图模式

视图向客户端公开只读派生数据。对于应在服务器端计算而非重复存储到另一个表中的筛选或联接结果，请使用视图。

TypeScript 视图结构：

export const high_scorers = spacetimedb.anonymousView(
  { name: "high_scorers", public: true },
  t.array(players.rowType),
  (ctx) =>
    ctx.from.players
      .where((p) => p.score.gte(1000n))
      .where((p) => p.name.ne("BOT")),
);

设计规则

• 视图必须是公开的，并且必须有明确的名称。
• 视图是只读的。写入请使用 reducer，存储状态请使用表。
• 当所有调用方看到的结果都相同时，请使用 anonymousView/AnonymousViewContext；SpacetimeDB 可以在订阅者之间共享一个物化结果。
• 仅当结果取决于调用方时，才使用按用户区分的 ViewContext，例如“我的库存”或私信。
• 保持读取集较小。筛选和联接时，优先使用索引查找或模块端查询构建器。
• 不要默认在视图中使用 .iter()；请查阅参考资料，了解查询构建器语法、.iter() 的限制以及主键推断的详细信息。

参考索引

需求	打开
视图定义和示例	references/functions-views.md

指引

• 当用户需要派生或筛选后的数据，而非重复存储的行时，请使用视图。
• 如需了解表达式或查询语法的详细信息，请查阅 SQL 参考。
• 在添加可能成为高频订阅路径的视图之前，请检查表索引。