# 飞书多维表格连接数据库，搭建可视化看板

飞书的多维表格现已支持连接数据库，可将草料收集到的数据推送到飞书的多维表格中，自由应用数据，搭建自己想要的看板内容。

飞书多维表格费用说明：支持一个月试用，免费版只能推送三张数据表，数据同步上限支持1000行，如有需要可购买高级版（2499元/年）或者企业版本（5499元/年） ![file](https://blogcdnimg.clewm.net/2025/04/image-1745225894941_17452258952767.png)
图片说明：MySQL数据同步功能的版本对比与定价页面，展示免费、高级、企业、定制四版功能差异及对应年费价格。

不同表单的数据都可以链接到同一个飞书多维表格中，制作仪表盘看板

## 案例效果

可以快速查看设备巡检的完成情况，巡检次数、设备状态、月检统计等：[点击查看示例](https://ed8ygk2n2j.feishu.cn/base/PYRMbKzUKaASD8slklPcmDsGngf?from=from_copylink "点击查看示例")

![file](https://blogcdnimg.clewm.net/2025/04/image-1745233900919_17452339020073.png)
图片说明：仪表盘展示灭火器与巡检数据，含总数、状态分布、月度完成率及人员统计的可视化图表。

## 使用前须知

### 数据 API 功能介绍

草料提供了官方数据库功能，草料平台中的码数据、表单数据、状态与计划数据等，会实时同步外部工具连接此数据库，数据推送后就可以制作出各类想要的看板效果。[查看官方数据库说明](/help/integration-and-connection/data-api/official-database-guide "查看官方数据库说明")

api数据会根据在草料设置的功能来推送，如： 在草料后台设置了状态功能，就会推送 code_state，即码的状态数据；在草料后台添加了计划并执行后，就会推送 code_task_log，即码的计划完成情况数据；未设置相关功能或者无数据产生时并不会推送。
建议您在使用二维码并有相关数据产生后，再去制作可视化看板。

### 飞书多维表格

飞书多维表格支持从mysql数据库同步数据到多维表。[飞书多维表格介绍](https://www.feishu.cn/product/base "飞书多维表格介绍") ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226682663_17452266837914.png)
图片说明：展示飞书产品功能菜单与AI Ready计划推广区，突出“按需定制专属业务系统”核心卖点。

## 应用教程

### 开启草料的官方数据库

1. 登录草料后台，点击左侧「数据管理」→「数据API」，选择「官方数据库」进行申请：[前往官方数据库](https://user.cli.im/opendata) ![file](https://blogcdnimg.clewm.net/2025/04/image-1744025063142_17440250641307.png)
图片说明：草料二维码后台“数据管理”页的API开通界面，提供Webhook、官方数据库、自有数据库三种数据接口的开通选项及简要说明。

2. 开通后会获得以下示例信息（请以实际开通信息为准）：
    - 类型：MySQL 5.7
    - 主机：`rm-bp1m4fy8d66u3c6xmbo.mysql.rds.aliyuncs.com`
    - 端口：`3306`
    - 数据库名：`cli_13268724`（示例）
    - 用户名：`cli_13268724`（示例）
    - 密码：`ekiji17jd02jk9md`（示例）

### 下载飞书，多维表格连接数据库

1. 打开工作台，新建多维表格  
   ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226797184_17452267986199.png)
图片说明：工作台应用入口页面，展示各类办公应用图标及分类标签，红色箭头指向“多维表格”应用，用于引导用户快速定位和使用该功能。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226805378_17452268059515.png)
图片说明：多维表格首页，展示新建多维表格、收集表、导入Excel等创建入口及热门模板推荐区域。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226854753_17452268561532.png)
图片说明：多维表格模板库界面，展示“为你推荐”区域的模板卡片及左侧导航栏，红色箭头指向新建多维表格按钮。

2. 选择从其他数据源同步，选择mysql  
   ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226885005_17452268854680.png)
图片说明：数据源应用列表页面，展示多种可集成的第三方应用图标及名称，红色箭头指向MySQL应用，用于说明数据源接入选项。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226879775_17452268802211.png)
图片说明：展示飞书多维表格的“从其他数据源同步”功能入口，红色箭头指向该选项，用于引导用户接入外部数据。

3. 填入草料官方数据库信息  
   在连接向导中，输入上一步获取的数据库主机、端口、数据库名、用户名及密码，即可建立连接。可免费试用30天 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226929985_17452269312511.png)
图片说明：MySQL数据同步配置弹窗，用于填写数据库地址、端口、用户名和密码以完成数据源连接。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226949903_17452269509576.png)
图片说明：MySQL数据同步配置弹窗，提示企业版试用到期及行数上限，并引导填写数据库地址、端口、用户名和密码等信息。

### 添加数据表

选择需要的数据表添加，添加后即可展示草料平台中的数据，数据表的名称在草料中有统一规范，需要提前了解各类数据表的说明，[查看数据表说明](/help/integration-and-connection/data-api/official-database-guide "查看数据表说明")

![file](https://blogcdnimg.clewm.net/2025/04/image-1745226971300_17452269726118.png)
图片说明：MySQL数据同步配置弹窗，展示可选数据表列表供用户选择并配置同步关系。

#### 常见表说明

1. `base_codeinfo`
    - 码的基本信息表。
    - 当账号下有二维码信息时会自动推送此表，包含活码、模板子码等基础信息。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227026402_17452270276064.png)
图片说明：MySQL数据同步配置弹窗，用于选择数据库与数据表并重置或继续配置。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227033132_17452270341050.png)
图片说明：这是“未命名多维表格”中“base_codeinfo”数据表的记录列表页，展示设备编码、名称、状态等字段的批量数据，支持新建、导入、筛选等操作。

2. `template_codeinfo_XXX`
    - 批量模板创建的子码信息表。
    - 命名规则为：`template_codeinfo_DXX`，其中 `DXX` 为批量模板编号。
    - 例如：后台批量模板编号为 `M4`，则对应的数据表名为 `template_codeinfo_D4`。
    - 该表会包含子码的可变内容信息。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1744025287941_17440252883039.png)
图片说明：批量活码模板列表页，展示多个模板卡片及操作选项，红色箭头指向“灭火器检查”模板。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227064425_17452270675034.png)
图片说明：MySQL数据同步配置弹窗，展示基础配置与数据库、数据表选择界面，用于设置数据同步任务。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227072964_17452270744217.png)
图片说明：后台数据表“template_codeinfo_d4”的列表视图，展示设备编码、编号、位置、名称、规格型号及生产厂商等字段的配置记录。

3. `code_state`
    - 码的状态表。
    - 当二维码中有关联的状态时会推送此表。 !

[file](https://blogcdnimg.clewm.net/2025/04/image-1745227091032_17452270926332.png)
图片说明：MySQL数据同步配置弹窗，用于选择数据库与数据表并重置配置，当前版本为“企业版（试用）”。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227096232_17452270970082.png)
图片说明：展示“未命名多维表格”中“code_state”数据表的记录列表，含分页、筛选、导出等操作功能。

4. `code_task_log`
    - 计划执行情况表。
    - 当账号下创建计划并开始执行后，会推送该表。
    - 开通数据库后，只推送之后新开始执行的计划周期数据；历史周期、开通时正在执行的当前周期计划数据不会推送。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227109600_17452271100652.png)
图片说明：MySQL数据同步配置弹窗，用于选择数据库与数据表并进行基础设置。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227115889_17452271165618.png)
图片说明：后台数据表“code_task_log”的记录列表页，展示任务执行状态与时间信息，当前提示“数据同步中，请耐心等待”。

5. `table_dXX`
    - 表单数据明细表。
    - 当账号下有表单数据提交时，会推送此表。
    - 命名规则：`table_` 开头，`dXX` 代表表单唯一编号。例如：`table_d45` 表示一个表单编号为 45 的数据表。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1744025369373_17440253703665.png)
图片说明：后台“表单”管理列表页，展示多个业务表单及其记录数、创建时间等信息，支持按创建时间排序与批量操作。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227140693_17452271423188.png)
图片说明：MySQL数据同步配置弹窗，用于选择数据库与数据表并配置同步任务。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227151744_17452271523138.png)
图片说明：后台数据表 `table_d5` 的记录列表页，展示多条“灭火器检查”记录的增删改查操作日志，含时间、操作人、状态等字段。

### 创建图表

飞书多维表可制作图表，点击「仪表盘」，通过柱状图、折线图、条形图、饼状图等方式，完成看板设计。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227186369_17452271879962.png)
图片说明：仪表盘创建界面，展示组件选择区域及左侧导航栏的“仪表盘”与“仪表盘2”选项，用于搭建数据看板。

以下为部分常见统计示例：

#### 示例 1：统计总数

1. 选择「统计数字」组件；
2. 选择 `template_codeinfo_XXX`（批量模板创建的子码信息表）；
3. 直接统计当前模板下二维码的数量，即可得出灭火器总数。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227220057_17452272214591.png)
图片说明：配置“灭火器总数”数据指标的设置面板，含数据源、范围与统计方式选项。

#### 示例 2：统计巡检次数

1. 选择「统计数字」组件；
2. 选择 `table_dXX`（表单数据明细表），统计表单提交的总条数；
3. 每提交一次巡检表单，即表示巡检完成一次，总条数即可代表巡检次数。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227229584_17452272299840.png)
图片说明：配置“巡检次数”数据项的类型与数据源，用于仪表盘指标展示。

- 折线图：  
  选择 `table_dXX` 表单数据明细表，按照记录时间的维度来统计巡检次数。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227246941_17452272483438.png)
图片说明：图表配置面板，展示折线图数据源、横轴分类字段及主题样式等设置选项。

- 柱状图：  
  选择 `table_dXX` 表单数据明细表，根据「记录人」进行分组统计，可查看不同巡检人员的巡检次数。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227273526_17452272748727.png)
图片说明：图表配置面板，展示如何设置柱状图的数据源（table_d5）、横轴分类字段（记录人）及样式选项。

#### 示例 3：统计灭火器正常/异常情况

1. 在 `template_codeinfo_XXX` 表中，新建字段 → 查找引用 → `code_state`（码的状态表） ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227342213_17452273437260.png)
图片说明：展示数据表字段配置界面，用户正通过右侧面板为“查找引用”字段选择文本类型并确认设置。

2. 选择引用code_state 码的状态表，选择对应的状态字段，两表中均包含 `code_id`，关联后可获取子码对应的状态信息 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227370031_17452273715221.png)
图片说明：展示数据表“template_codeinfo_d4”中字段筛选配置界面，用户正设置“code_state”字段为“检查状态_8807592”，并添加“code_id = code_id”条件。

3. 添加饼状图，在分组字段中选择需要统计的状态字段 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227415520_17452274170569.png)
图片说明：饼图配置面板，展示数据源、图表类型、主题色等设置选项及扇区分组方式选择。

4. 点击图表中的扇形区域可查看明细数据 !

[file](https://blogcdnimg.clewm.net/2025/04/image-1745227423400_17452274237864.png)
图片说明：弹窗展示数据详情表格，含code_id、负责人、联系方式及查找引用状态列，用于查看具体数据记录。

#### 示例 4：统计计划完成情况

1. 在 `code_task_log`（计划执行情况表）中新建字段 → 查找引用 → `template_codeinfo_XXX` ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227482170_17452274836286.png)
图片说明：展示数据表“code_task_log”的字段配置界面，用户正通过右侧弹窗设置字段类型与来源记录结果，用于自定义数据视图。

2. 选择引用 template_codeinfo_XXX 批量模板创建的子码信息表 ，选择对应的子码可变内容信息，同样使用 `code_id` 字段进行关联 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227507167_17452275075877.png)
图片说明：数据表字段配置界面，展示“code_task_log”表的字段设置，含引用字段与查询条件配置区域。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227516646_17452275176265.png)
图片说明：代码任务日志数据表，展示任务执行记录及所在位置、编号等关联信息，用于追踪和定位问题。

3. 添加饼状图，通过筛选日期和状态，查看指定时间内的计划完成情况 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227530511_17452275312356.png)
图片说明：饼图配置界面，展示如何通过“状态”字段分组并可视化任务完成情况的图表设置。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227537196_17452275375889.png)
图片说明：弹窗式筛选条件设置界面，用于按“开始时间”与“具体日期”组合筛选数据，支持添加多条件并保存。
 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227543106_17452275435161.png)
图片说明：饼图配置面板，用于设置“灭火器月检统计”图表的数据源、类型、主题与分组等参数。

## 结语

通过以上步骤，您可以将草料平台收集的多源数据（二维码、表单、状态、计划等）实时同步到飞书多维表格中，并灵活创建可视化图表和看板，满足多种业务分析需求。  
如有更多疑问，可查看以下链接：

- [草料帮助中心](/help/integration-and-connection/data-api/official-database-guide)
- [飞书多维表官方](https://www.feishu.cn/product/base)

提示：由于草料数据库的推送与实际使用场景密切相关，建议在二维码已有数据产生后再去制作可视化看板，确保您获取到的信息更为完整和实时。