扣子数据库表创建与字段设计实操指南

在扣子平台进行数据库设计时，表名大小写敏感与字段类型误配是两大常见陷阱。一旦违规，后续所有SQL语句均会静默失败，且平台不返回任何错误信息。建表前必须彻底理解命名规则与类型定义。

表名必须以全小写字母开头，后续只能包含小写字母、数字和下划线。例如 visitorLog（驼峰式）或 1visitor（数字开头）均为无效命名。

字段类型的选择同样关键。Time 类型自动包含时分秒，若仅需日期，需在 Prompt 中以自然语言指定“只记日期不记时间”。金额存储必须使用 Number，Integer 不支持小数。电话号码必须声明为 String，若误用 Number，前导零（如区号）会被直接丢弃。

开发智能体之前，必须先行设计好数据库表结构。只有字段类型定义精准，NL2SQL 引擎才能准确解析自然语言指令，将业务数据顺利写入。若表名混入大写字母，即便只有一个，写入操作也会在无任何提示的情况下失败，且无从排查。

进入数据库创建入口流程

登录扣子平台后，在左侧导航栏找到“资源库”。务必确认当前工作空间是“个人空间”还是已加入的“团队空间”。工作空间一旦选错，新建的数据库后续将无法被智能体调用，数据也无法读取。

确认空间无误后，点击右上角“+资源”按钮，从弹出菜单中选择“数据库”。

基础信息填写与表结构设计

在弹出的“新建数据表”对话框中，按以下步骤依次配置。

第一步：输入数据表名称。再次强调命名规范：全小写、字母开头、仅允许字母数字及下划线。例如 visitor_log 通过，visitorLog 或 1visitor 均不合法，创建会直接失败。

第二步：填写数据表描述。例如“记录访客登记信息”，该描述不参与业务逻辑，但便于团队协作时快速识别表用途。

第三步：点击“添加字段”，逐一定义业务所需列。切记先完成所有字段定义再统一保存，避免频繁修改增加冗余操作。

字段类型选择与关键配置要点

字段类型推荐直接记忆以下对应关系，可大幅减少建表时的常见错误。

姓名 → String
电话 → String（避免使用 Number，否则号码如 138****1234 中的前三位 138 会被丢失）
日期 → Time（默认包含时分秒；若只需日期，请在 Prompt 中用自然语言限定）
是否有效 → Boolean
金额 → Number（注意：Integer 不支持小数，故不适用于金额）
状态码 → Integer（例如 0 待处理、1 已登记、2 已拒绝）

字段命名规则：仅允许全小写字母、数字及下划线，长度不超过 64 个字符。建议在描述栏填写示例值，如“电话：138****1234”，便于后期数据核对。“是否必要”勾选项表示该字段不可为空——姓名、电话等关键字段应勾选；备注等非必填项可不勾选。

细节注意：Time 类型字段默认含时分秒。若仅关注日期，需在 Prompt 中明确“只记录来访日期，不记录具体时间”。

保存表结构并执行校验

所有字段添加完成后，点击“保存”。页面自动跳转至数据库列表，找到新创建的数据表，点击右侧的“查看”图标。

在数据表详情页，逐项核对字段名称、类型及是否必填三项是否与设计方案一致。随后手动点击“新增行”，插入一条测试数据——此步骤能有效发现字段类型错误，例如向 Number 字段输入字母时，系统将即时报错拦截，提前暴露问题。