云数据库

:::color5 📢 云数据库 将在2023年12月31日停止维护，建议 各位训练师及时将重要数据迁移至 云数据表 控件

:::

:::info 云数据库支持将多行多列、不同类型的数据存储到云端服务器，并在作品中创建、更新、获取、删除数据。

:::

:::danger 我们并不推荐使用第三方的数据存储服务，如“维格表”“飞书多维表格”等，处理不当极有可能发生数据丢失。

:::

特性

1. 跟随账号、不随跟作品

同一账号所有的云数据库在「云数据管理器」中统一管理，可以引用到多个作品中使用，也可以从作品中移除引用。

2. 区分测试数据和正式数据

每个数据库都有一套测试数据和正式数据。

在编辑器内创作、调试过程中使用的都是测试数据，当你将作品打包或分享后，会生成表头一致但是数据内容为空的正式数据，其他小伙伴在使用APP时使用的是正式数据。

测试数据和正式数据互不干扰，即使你已经发布过了，再次编辑调试也不会影响到线上的正式数据。

积木

1. 当 云数据库出错时 (错误数据库名称) (错误信息)

• 运行时所有云数据库出现错误都会触发该事件，并返回出现错误的数据库名称和错误信息。

2. 新增行 (“1,2,3”) 到【云数据库】

• 向数据库中新增一行，新增行用英文**逗号**把每一列的数据隔开，填入输入框中。
• 注意云数据库的唯一列，如果新增数据里面与以前的数据重复，则会报错“唯一列冲突”。
• 数据库存储上限为：500行10列。
• 举个例子：有这么一个数据库，有4列：姓名、年龄、成绩、是否合格。

成功执行积木新增行 (“编程猫,13,90,true”) 到 [云数据库]后的结果为：

:::danger 注：如果输入框中的逗号分隔的项数不等于列数，超过的就舍弃，缺少的就补空。

:::

3. 删除【云数据库】中满足条件 (?)【=】(123) 的行

• (?)下拉框为该数据库所有列的名称。
• 查询数据库中满足条件（红框内设置条件）的数据并将其删除。
• 举个例子：

4. 更新【云数据库】中满足条件 (?)【=】(123) 的行 (?) 为 (456)

• 修改数据库中满足条件的某些数据为新的数据。
• 举个例子：
  • 执行积木后实现的功能是筛选出“成绩”这一列的数据大于等于60的行，将筛选结果的“是否合格”设置为true；筛选出“成绩”这一列的数据小于60的行，将筛选结果的“是否合格”设置为false；

:::danger 数据库单格最长能存储数据长度为3000

:::

5. 查询【云数据库】中满足条件 (?)【=】(123) 的数据

• 筛选出满足条件的数据，返回一个二维列表。
• 举个例子：

- 执行这块积木，查询成功后将查询结果存在“查询结果”返回值中，可以通过用两次列表取项积木取到具体某个值。

6. 查询【云数据库】的【行数/列数】

• 查询数据库的行数或列数。

7. 遍历 (?) 取 (当前项) ，重复执行

• 遍历列表中的每一项，重复执行次数为列表的长度，每次执行将列表中的某一项赋值给当前项。
• 举例，遍历列表1，每次重复执行将当前项打印出来。

• 云数据库的查询结果是二维列表（本质也是列表），所以也可以对查询数据库的查询结果进行遍历。

示例

一、新建数据库或者选择已有的数据库

二、编辑表头

三、编写输入数据的代码

四、编写查询的代码

示例作品文件（导入之后要自己创建自己的数据库）

数据库示例作品.json