--- uuid: "2d81b01c-3c30-4fab-ad2d-e8b5aeb16a6d" type: "scenario" title: "飞书多维表格连接数据库，搭建可视化看板" sidebar_position: 3 description: "开通草料官方数据库，并在飞书多维表格中连接数据库、搭建设备巡检和统计分析等可视化看板。含费用说明：免费版限 3 张数据表、1000 行，高级版 2499 元/年。" keywords: - 飞书多维表格连接草料数据库 - 草料二维码飞书看板 - 飞书官方数据库 - 飞书数据分析 - 飞书多维表格统计 cl_old_blog_id: "101574" cl_old_blog_url: "https://cli.im/help/101574" last_update: date: "2025-09-04" --- 飞书多维表格支持连接数据库，可把草料收集到的数据推送到飞书多维表格中，按需搭建可视化看板。 > 适用于已经在用草料收集数据、希望用飞书多维表格做统计分析的场景。不同表单的数据可以链接到同一个飞书多维表格中，拼接成完整的仪表盘。 **费用说明**：支持一个月试用；免费版只能推送 3 张数据表，数据同步上限 1000 行；如需更多可购买高级版（2499 元/年）或企业版（5499 元/年）。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745225894941_17452258952767.png) ## 案例效果 可查看设备巡检的完成情况，包括巡检次数、设备状态、月检统计等：[查看示例](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 "查看官方数据库说明") > **注**：数据是按你在草料中已设置的功能来推送的。例如：设置了状态功能，会推送 `code_state`（码的状态数据）；创建了计划并执行，会推送 `code_task_log`（计划完成情况）。未设置相关功能或暂无数据产生时，对应的数据表不会推送。 建议在二维码已经有数据产生之后再来搭建看板，看板里的内容才会完整。 ### 飞书多维表格 飞书多维表格支持从 MySQL 数据库同步数据到多维表。[飞书多维表格介绍](https://www.feishu.cn/product/base "飞书多维表格介绍") ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226682663_17452266837914.png) ## 应用教程 ### 一、开启草料的官方数据库 1. 登录草料后台，点击左侧「数据管理」→「数据 API」，选择「官方数据库」进行申请：[前往官方数据库](https://user.cli.im/opendata) ![file](https://blogcdnimg.clewm.net/2025/04/image-1744025063142_17440250641307.png) 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) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226854753_17452268561532.png) 2. **选择从其他数据源同步，选 MySQL**： ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226885005_17452268854680.png) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226879775_17452268802211.png) 3. **填入草料官方数据库信息**：在连接向导中输入上一步获取的主机、端口、数据库名、用户名及密码，即可建立连接（可免费试用 30 天）。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226929985_17452269312511.png) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226949903_17452269509576.png) ### 三、添加数据表 选择需要的数据表添加，添加后即可展示草料平台中的数据。数据表的名称在草料中有统一规范，建议先了解各类数据表的含义：[查看数据表说明](/help/integration-and-connection/data-api/official-database-guide "查看数据表说明") ![file](https://blogcdnimg.clewm.net/2025/04/image-1745226971300_17452269726118.png) #### 常见数据表 1. **`base_codeinfo`**（码的基本信息表） - 账号下有二维码信息时会自动推送此表，包含活码、模板子码等基础信息。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227026402_17452270276064.png) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227033132_17452270341050.png) 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) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227072964_17452270744217.png) 3. **`code_state`**（码的状态表） - 二维码关联了状态时会推送此表。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227091032_17452270926332.png) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227096232_17452270970082.png) 4. **`code_task_log`**（计划执行情况表） - 账号下创建计划并开始执行后，会推送该表。 - 开通数据库时只推送当前周期及后续周期的计划数据，历史周期数据不会推送。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227109600_17452271100652.png) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227115889_17452271165618.png) 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) ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227151744_17452271523138.png) ### 四、创建图表 飞书多维表可制作图表，点击「仪表盘」，通过柱状图、折线图、条形图、饼图等组件完成看板设计。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227186369_17452271879962.png) 下面是几个常见的统计示例： #### 示例 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) #### 示例 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) 3. **添加饼图**，在分组字段中选择需要统计的状态字段。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227415520_17452274170569.png) 4. 点击图表中的扇形区域可查看明细数据。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227423400_17452274237864.png) #### 示例 4：统计计划完成情况 1. 在 `code_task_log`（计划执行情况表）中**新建字段** → **查找引用** → **`template_codeinfo_XXX`**。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227482170_17452274836286.png) 2. 选择引用 `template_codeinfo_XXX` 批量模板子码信息表，选择对应的子码可变内容信息，同样用 `code_id` 字段关联。 ![file](https://blogcdnimg.clewm.net/2025/04/image-1745227507167_17452275075877.png) ![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) - [WPS 多维表格连接数据库](/help/integration-and-connection/data-api/data-reports/wps-connection) - [数据 API+百度 SugarBI 搭建看板](/help/integration-and-connection/data-api/data-reports/api-sugar-bi-data-api) - [看板案例合集](/help/integration-and-connection/data-api/data-reports/case-collection) - [飞书多维表格官网](https://www.feishu.cn/product/base) > **提示**：数据库推送和实际使用场景密切相关，建议在二维码已有数据产生后再制作看板，信息才会更完整、更实时。