数据库

扣子的数据库功能提供了一种简单、高效的方式来管理和处理结构化数据，开发者和用户可通过自然语言插入和查询数据库中的数据。同时，也支持开发者开启多用户模式，支持更灵活的读写控制。 ​

功能介绍

扣子提供了类似传统软件开发中数据库的功能，允许用户以表格结构存储数据。这种数据存储方式非常适合组织和管理结构化数据，例如客户信息、产品列表、订单记录等。 ​

扣子数据表支持单用户和多用户两种查询模式。

开发者指创建数据表的开发人员；用户指 Bot 的使用者。

	单用户模式	多用户模式
读写模式	有限读写模式	完整读写模式
读写权限	开发者和用户都可以添加记录，但仅能读/修改/删除自己创建的来自同渠道的数据。	开发者和用户都可读/写/修改/删除表中来自同渠道的任何数据，由业务逻辑控制读写权限。
生效方式	在创建表格时，选择单用户模式。	在创建表格时，选择多用户模式。
调用方式	• 支持在 Prompt、Query 中通过 NL2SQL 方式及代码方式调用 • 支持在工作流中通过 NL2SQL 方式及代码方式调用	• 支持在 Prompt、Query 中通过 NL2SQL 方式及代码方式调用 • 支持在工作流中通过 NL2SQL 方式及代码方式调用
应用场景示例	• 一个记账 Bot，每个用户/开发者,自己记录账单，自己查看。 • 一个金融分析 Bot，开发者导入上市公司近三年财报到数据表用于做金融分析，所有用户都可以读这份数据用于金融分析。	• 一个漂流瓶 Bot，用户可以发布漂流瓶，也可以随机读取别人的漂流瓶。 • 一个联网游戏 Bot，游戏结束后，可以查看排行榜。

创建数据表

参考以下操作，创建数据表：

3.
在 Bots 页面，创建一个 Bot 或打开一个已创建的 Bot。 ​

4.
在 Bot 编排页面，单击数据库对应的创建图标 +。 ​

5.
在弹出的新建表格窗口中，单击自定义表格创建数据表，或单击使用模版，复用示例表再进行修改。 ​

6.
根据以下信息配置数据表，然后单击保存。 ​

配置项	说明
表格名称	输入表名称。
表格描述	输入表的描述信息。
Table 查询模式	扣子数据表支持单用户和多用户两种查询模式。开发者指创建数据表的开发人员；用户指使用 Bot 的终端用户。 • 单用户模式：开发者和用户都可以添加记录，但仅能读/修改/删除自己创建的来自同渠道的数据。 • 多用户模式：开发者和用户都可读/写/修改/删除表中来自同渠道的任何数据，由业务逻辑控制读写权限。 🎈 • 选择多用户模式后，会自动新增一个 uuid 字段，用来标识用户，由系统自动生成。 • 在 Prompt 中，使用 NL2SQL 操作数据表时不需要包含 uuid 字段，但在工作流中使用多用户模式时，需要包含 uuid 字段。
字段	添加字段信息： • 存储字段名称：字段名称。只能包含小写字母或数字或_、必须以英文字母开头、最多 64 字符。 • 描述：存储字段的补充说明，可以是对存储字段的自然语言描述、示例数据，也可以是格式说明等。 • 数据类型：存储字段的数据类型，大语言模型会按照选择的数据类型对用户输入的内容进行处理和保存。目前支持三种数据类型：String、Integer、Time、Number 和 Boolean。 • 是否必要：是否是必要字段。必要字段，是指用户在保存一行数据时必须提供对应字段信息。

使用数据表

扣子支持在 Prompt 通过 NL2SQL 方式对数据表进行操作，也支持在工作流中添加一个数据库节点，调用工作流来执行数据库节点。 ​

为了方便演示和介绍数据功能，本文以一个记录日常开支的 Bot 为例。这个 Bot 中使用的数据表结构如下。 ​

数据库​