云数据表

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

:::

:::color5 💬** “云数据表” 控件特性**

1. “控件”和“数据源”是分开维护的

1）“控件”的创建和保存是跟随作品的

2）“控件”引用的“数据源”是跟随账号的

3）删除“控件”不会删除“数据源”

*一个数据源支持同时被多个作品引用，也可能同时被多份作品影响

1. “云字典”、“云数据表”这类官方云存储控件，不再区分“测试数据”、“正式数据”，测试环境和正式环境的数据都会影响运行时绑定的数据源！

:::

属性

• 属性只有一个功能，即绑定 源码云空间 的 “云数据表”数据源 进行使用，积木也会同步关联绑定的数据源
• 点击 选择数据源 会加载当前账号下已创建的所有“云数据表”数据源列表
• 若需 新建数据源 等相关操作可前往 源码云空间 做进一步了解

协作

• 使用 数据表控件的作品是 支持协作 的
• 不过协助者暂不支持进行 “选择数据源”的工作，必须由创作者完成啦～（⚠️ 协作作品调用的数据源必须是作者账号下创建的数据源）
• 积木等其控件本身的功能，协作者是可以一起参与的～

积木

#修改

1. 当 [云数据表] [新增/删除/替换/查询/清空] 出错时（错误信息）

捕获云数据表积木执行时的错误信息。

2. 新增行（“1，2，3”）到 [云数据表]

在云数据表最后一行新增数据：支持嵌入字符或列表数据，均以逗号为分列标识。

⚠️**当前版本的单元格的值均为字符串类型数据**

3. 删除 [云数据表] 中（第1列）（=） （“123”）的行

删除云数据表中满足条件的行，不可撤销。

4. 更新 [云数据表] 中（第1列）（=）（“123”）的行：（第一列）为 （“123”）

更新云数据表中满足条件的行，不可撤销。

#查询

5. 查询 [云数据表] 中（第1列）（=） （“123”）的数据 +

查询云数据表满足条件的数据：返回列表结构。若能查询到满足条件的行，则返回一个二维列表；否则，返回一个空列表。

⚠️**当前版本的单元格的值均为字符串类型数据**

⛔**请不要使用积木。这块积木接收的参数类型是字符串，然而查询结果是一个列表。**

✅**正确的使用方法是使用积木。用法可参见下方积木解释，或[云数据库中的相关解释](https://codemao.yuque.com/kzbwh0/coco_guide/cloud-db#u9fb440c0)。**

积木解释

假设数据表结构如下：

那么，我们可以使用此积木完成对个数不等于8的行的查询：

其对应的是一个二维列表。可以通过用两次列表取项积木取到对应的个数。

同理，要查询苹果的个数也是如此：

此时，尽管我们很确定苹果的个数一定是唯一的，但是数据表无法自己进行推断，仍会返回一个二维列表，值为[[‘苹果’, ‘8’]]。此时，我们还是需要使用两次列表取项积木来获取个数的值。

6. 查询 [云数据表] 的 [行数/列数]

查询云数据表的行数或列数，返回数字。

#清空

7. 清空 [云数据表] +

清空云数据表所有数据，不可撤销。