官方数据库为草料提供独立的云数据库，同步你后台的数据。可以使用数据分析软件连接这个云数据库，制作数据报表；或写程序主动调用数据，对接其他系统。

• 官方数据库为只读数据库，不可编辑
  
• 数据库类型为Mysql 5.7

示例

类型：MySQL5.7

主机：rm-bp1m4fy8d66u3c6xmbo.mysql.rds.aliyuncs.com

端口：3306

数据库名：cli_202112111（示例）

用户名：cli_202112111（示例）

密码：eiadk289djlgj（示例）

数据报表示例

如果你需要连接官方数据库，制作自定义报表，查看报表示例

由于涉及了基础的数据库（SQL）操作与BI工具操作，具有一定的使用门槛，使用前请掌握基础的操作能力。查看报表制作教程

通用字段解释

说明：这些字段是一些关键信息，主要用于各表之间数据关联

字段名	类型	说明	示例
code_id	int	码的唯一标识	54349863
tpl_code_id	int	批量模板的唯一标识 如果非模板生码，tpl_code_id与code_id相同	54349863
member_id	int	成员唯一标识	2091263
auth_id	int	填表人唯一标识	12789054
record_id	int	表单数据唯一标识	16759806

常用模型

模型一：设备状态分析

base_codeinfo（码的基本信息表）内关联code_state（码的状态表），得到各设备的状态值与更新时间，分析状态分布。

模型二：计划完成情况

code_task_log（计划执行情况表） 左关联 base_codeinfo（码的基本信息表），得到计划完成情况并与之对应的码信息。

模型三：批量码分析

template_XXXXXX （批量码信息表）左关联 table_dXX（表单数据表）、code_state（码的状态表）。template_XXXXXX可以获取到码的可变内容信息。

各数据表字段说明

1. base_codeinfo 码的基本信息表

字段名	类型	说明	示例
code_id	int	码的唯一标识	54349863
tpl_code_id	int	批量模板的唯一标识 如果非模板生码，tpl_code_id与code_id相同	54349863
码名称	string	码的名称	1号设备
模板名称	string	批量模板的名称 如果非模板生码，“模板名称”与“码名称”相同	1号设备
目录	string	码所在最后一级目录	车间1
标签集	string	码的分组集合	电箱,设备

目录信息：为码所在的最后一级目录，不会显示其上几级目录信息。

2. code_state 码的状态表

字段名	类型	说明	示例
code_id	int	码的唯一标识	54349863
member_id	int	成员唯一标识	2091263
auth_id	int	填表人唯一标识	12789054
更新时间	datetime	状态更新时间	2020-11-20 15:00:00
例：设备运行状态_720	string	状态组名称，后面的数字是为了防重复	正常
......	string	账号下的所有状态组都会列在这里	异常

3. code_state_log 码的状态的更新日志

字段名	类型	说明	示例
id	int	自增长ID，一个序号从1开始递增	1
code_id	int	码的唯一标识	54349863
member_id	int	成员唯一标识	2091263
auth_id	int	填表人唯一标识	12789054
更新时间	datetime	状态更新时间	2020-11-20 15:00:00
状态组	string	状态组的名称	设备运行状态
状态值	string	该状态组的本次的状态	正常

4. table_dXX 表单数据表

说明：表单数据表是以"table_"开头的一批表，一个表单一个表 d104是表单编号（早期的表单数据表，后面跟着的是数字，表单的唯一编号，如：table_D45）

字段名	类型	说明	示例
record_id	int	表单数据唯一标识	record_id
code_id	int	码的唯一标识	54349863
tpl_code_id	int	批量模板的唯一标识	54349863
填写人	string	填表人姓名	李四
码名称	string	码的名称	1号设备
tpl_id	int	表单的唯一标识	1231
表单名称	string	表单名称	设备巡检
记录时间	datetime	添加表单数据时间	2020-11-20 15:20:00
member_id	int	协作成员唯一标识	2091263
auth_id	int	填表人唯一标识	12789054
记录编号	string	表单数据的编号	L1234
处理状态	string	表单数据的处理状态	可选值： 待处理/已完成/无需处理/暂不标记状态
例：设备名称	string	表单的组件名称	1号机
......	string	表单的组件名称会全部展示

5. codeinfo_XXXXX 旧版批量子码的信息

说明：以codeinfo开头的一批表，后面的数字是tpl_code_id，该批量子码的表格信息会存入这张表

字段名	类型	说明	示例
code_id	int	码的唯一标识	54349862
二维码名称	string	该子码名称	1号设备
.....	string	以下字段，是在子码中设置的表格项名称

6. template_codeinfo_DXX 批量模板创建的码信息

说明：以template_codeinfo开头的一批表，后面的编号DXX是批量模板编号，该模板下子码的可变内容会存入这张表

字段名	类型	说明	示例
code_id	int	码的唯一标识	54349863
tpl_code_id	int	批量模板的唯一标识	54349862
.....	string	以下字段，是在批量模板中可变内容的名称

7.record_review_data

说明：动态档案备注和表单数据后续动态

8. base_task 计划基本信息表

说明：计划管理的基本信息

字段名	类型	说明	示例
task_id	int	计划的唯一标识	1
计划名称	string	计划名称	巡检计划
描述	string	计划描述

9. code_task_log 计划执行情况表

说明：计划管理的执行记录，以task_id和开始时间来判定当前这一期的计划执行状态

字段名	类型	说明	示例
log_id	int	当前计划任务的唯一标识	1
task_id	int	计划的唯一标识	1
计划名称	string	计划名称	巡检计划
code_id	int	码的唯一标识	54349863
开始时间	datetime	计划周期开始时间	2020-12-10 12:00:00
执行时间	datetime	该码在本周期的执行时间	2020-12-10 13:00:00
截止时间	datetime	该码在本周期的结束时间	2020-12-10 18:00:00
状态	string	该周期的执行状态	可选值： 完成/未完成/即将超期/ 超期完成/超期未完成
是否过滤	string	根据设置的过滤条件取值	可选值：是/否
变更方式	string	变更状态的方式	记录
来源	int	变更方式为记录时，记录的唯一标识	1342321
来源记录结果	string	变更方式为记录时，记录的记录结果	设备正常

10. code_tags 码的分组

字段名	类型	说明	示例
code_id	int	码的唯一标识	54349863
例：电箱	int	分组名称，如果该码在此分组下，则值为1	1
例：设备	int	分组名称	1
......	int	账号下的所有分组都会列在这里

11. base_members 协作成员信息

现在仅同步高级成员，不同步普通成员信息，开通后数据库后，有成员信息变动后才会触发更新

字段名	类型	说明	示例
member_id	int	协作成员的唯一标识	2091263
姓名	string	协作成员姓名	张三
手机号	string	协作成员手机号	135xxxx8934

12. base_auth_msg 填表人信息

字段名	类型	说明	示例
auth_id	int	填表人的唯一标识	12789054
姓名	string	填表人姓名	李四
手机号	string	填表人手机号	135xxxx8934
工号	string	填表人工号	D234
车牌号	string	填表人车牌	浙A.12342
身份证	string	填表人身份证	343xxxxxxxxxxxxx

常见问题

1. 二维码名称变更后，为什么表单数据表中的二维码没有更新

现在表单中的二维码名称是不更新的，如果你需要取出最新的二维码名称，可以左关联一下 base_codeinfo 这张表，关联的字段为 code_id。

2. 表单中的组件名称修改后，数据表中有两个组件，分别是修改前和修改后的。

这是正常的，修改组件后，会保留原组件字段。

3. 计划中已设置了过滤掉异常状态值码，但在数据表中还存。

数据表中会有所有的计划任务数据，是通过 【是否过滤】这个字段来判识该条计划是否有过滤。（另外，在状态变更后在下个周期过滤才生效）

4. 为什么开通后，连接数据库，推送的数据不全

首次开通后，需要将历史数据所有推送过来，大概需要1-3小时，跟账号的数据量有关。如隔一天了，还是推送不全，可以联系在线客服排查问题。

5. 为什么我修改表单字段后，数据库中的字段没有更新

修改表单后不会触发数据库更新，只有当有新增或修改表单数据时，才会触发更新该数据表。所以只需提交一条新记录可以了。