--- 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" --- 飞书的多维表格现已支持连接数据库，可将草料收集到的数据推送到飞书的多维表格中，自由应用数据，搭建自己想要的看板内容。 **飞书多维表格费用说明**：支持一个月试用，免费版只能推送三张数据表，数据同步上限支持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 "查看官方数据库说明") > api数据会根据在草料设置的功能来推送，如： 在草料后台设置了状态功能，就会推送 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. **填入草料官方数据库信息** 在连接向导中，输入上一步获取的数据库主机、端口、数据库名、用户名及密码，即可建立连接。可mian f免费试用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) - [飞书多维表官方](https://www.feishu.cn/product/base) > **提示**：由于草料数据库的推送与实际使用场景密切相关，建议在二维码已有数据产生后再去制作可视化看板，确保您获取到的信息更为完整和实时。