模型与字段

模型是某一类记录的形状,例如页面或产品。你用十六种内置字段类型来组合它,保存记录的模型会在你的 API 中获得自己的类型化查询和 mutation。

十六种字段类型

纯文本是一种类型,富文本是另一种,称为正文。数字同样是两种类型:integer 用于整数,decimal 用于精确的数值。其余的是布尔、日期、JSON、列表、引用和地理点,三种用于文件和媒体(文件、图像和视频),两种选择类型,以及一个存储模型键的字段。

枚举是写在字段上的固定选项列表。选择类型的选项取自另一个模型的记录。两者都可以允许多选。地理点在你声明时会建立索引,因此记录可以按距离查找。

整数与小数

超出 ±2^53 的整数会被拒绝。小数以字符串形式传输并保留其精度,所以 19.90 仍是 19.90,向小数字段发送 JSON 数字会被拒绝。SDK 把小数以其自身的精确类型交给你的代码,因此价格不会经过浮点数。

每个字段都有什么

字段有键、标签、帮助文本、默认值、必填标志,以及一项访问策略,说明谁可以读取和写入它。把字段标记为可查询,它就会被索引以用于过滤和排序。变更发布时,索引会在现有记录上重建。

记录模型与内联模型

模型要么保存记录,要么是内联的。内联模型本身没有记录,它的键会成为一种字段类型,可用于其他模型。

控制台或代码

可以在控制台中、通过 CLI 命令,或在代码中于项目的配置文件中定义模型,由 CLI 推送。编辑模型的字段会创建新的 schema 版本,之前的版本可以恢复。

了解详情

字段类型参考列出每种类型及其选项,以及读取时返回的形状。