在排查指标中心相关问题、做数据统计等场景时,经常需要确认指标中心模块背后涉及哪些元数据库表,以及每张表分别保存什么内容。下面按“指标中心专属表”和“复用通用表”两部分整理。 一、指标中心专属表1. metric_projectmetric_project 是指标主题表,用于保存指标中心里的主题信息,例如页面左上角展示的“财务分析主题”。
常见字段包括: | 字段 | 含义 |
|---|
id | 主题唯一 ID | dom_id | 企业域 ID | name | 主题名称 | icon | 主题图标 | icon_color | 图标颜色 | dir_id | 主题对应的目录 ID | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 |
2. metricmetric 是指标正式表,是指标中心最核心的表。页面列表中的指标名称、类型、状态、业务口径、更新时间等信息主要来自这张表。
常见字段包括: | 字段 | 含义 | id | 指标唯一 ID | dom_id | 企业域 ID | project_id | 所属指标主题 ID | dir_id | 所在目录 ID | name | 指标名称 | eng_name | 指标英文名 | sub_type | 指标类型 | format | 数据格式配置 | aggr_type | 聚合方式 | ds_id | 来源数据集 ID | fd_id | 来源字段 ID | fd_redundant_info | 字段冗余信息,JSON 格式 | formula | 指标公式 | derive_setting | 衍生指标配置 | filter | 筛选条件 | description | 业务口径 | display | 指标图展示设置 | business_owner | 业务责任人 | status | 指标状态 | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 | is_del | 逻辑删除标记 | config | 指标配置,JSON 格式 | time_dim_fd_id | 时间维度字段 ID | fd_formula | 来源字段 SQL 表达式 | fd_formula_type | 来源字段表达式的字段类型 | source_metric_id | 加速指标来源 ID | biz_attrs | 业务属性取值,JSON 格式 | link_metric_id | 快捷引用指向的指标 ID | biz_metric_id | 关联的业务指标 ID | dynamic_parameters | 动态参数默认值,JSON 格式 |
3. metric_relmetric_rel 是指标关系表,用于保存正式指标与其他对象之间的关系,例如适用维度、复合指标引用、衍生指标引用、快捷引用等。
常见字段包括: | 字段 | 含义 | id | 自增主键 | dom_id | 企业域 ID | metric_id | 指标 ID | obj_id | 依赖对象 ID | obj_type | 依赖对象类型 | content | 自定义内容,JSON 格式 | ctime | 创建时间 | utime | 更新时间 |
4. metric_draftmetric_draft 是指标草稿表,用于保存编辑中或未上线的指标版本。整体字段与 metric 接近,但它服务于草稿态,不直接代表正式上线指标。
常见字段包括: | 字段 | 含义 | id | 草稿 ID | dom_id | 企业域 ID | project_id | 所属指标主题 ID | name | 指标名称 | eng_name | 指标英文名 | sub_type | 指标类型 | format | 数据格式配置 | aggr_type | 聚合方式 | ds_id | 来源数据集 ID | fd_id | 来源字段 ID | fd_redundant_info | 字段冗余信息 | formula | 指标公式 | derive_setting | 衍生指标配置 | filter | 筛选条件 | description | 业务口径 | display | 指标图展示设置 | status | 草稿状态 | creator | 创建人 | updater | 更新人 | ctime | 创建时间 | utime | 更新时间 | config | 指标配置 | time_dim_fd_id | 时间维度字段 ID | fd_formula | 来源字段 SQL 表达式 | fd_formula_type | 来源字段表达式的字段类型 | biz_attrs | 业务属性 | dynamic_parameters | 动态参数默认值 | biz_metric_id | 关联的业务指标 ID |
5. metric_draft_relmetric_draft_rel 是草稿指标关系表,对应正式关系表 metric_rel,用于保存草稿态指标的适用维度、引用依赖等关系。
常见字段包括: | 字段 | 含义 | id | 自增主键 | dom_id | 企业域 ID | metric_draft_id | 指标草稿 ID | obj_id | 依赖对象 ID | obj_type | 依赖对象类型 | content | 自定义内容,JSON 格式 | ctime | 创建时间 | utime | 更新时间 |
6. metric_snapshotmetric_snapshot 是指标快照表,用于保存指标上线后的历史版本,支持版本查看和回溯。
常见字段包括: | 字段 | 含义 | id | 自增 ID | dom_id | 企业域 ID | metric_id | 指标 ID | snapshot_type | 快照类型 | snapshot_version | 快照版本号 | snapshot_data | 快照数据 | snapshot_schema_version | 快照数据结构版本 | creator | 创建人 | updater | 更新人 | ctime | 创建时间 | utime | 更新时间 |
7. public_dimensionpublic_dimension 是公共维度表,对应指标中心里的“公共维度”模块。
常见字段包括: | 字段 | 含义 | id | 公共维度 ID | dom_id | 企业域 ID | name | 公共维度名称 | business_owner | 业务责任人 | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 |
8. dimension_field_reldimension_field_rel 是公共维度与数据集字段的映射表,用于记录某个公共维度关联了哪些数据集字段。
常见字段包括: | 字段 | 含义 | id | 自增主键 | dom_id | 企业域 ID | public_dimension_id | 公共维度 ID | ds_id | 数据集 ID | fd_id | 字段 ID | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 |
9. metric_attr_configmetric_attr_config 是指标业务属性配置表,用于配置指标上的自定义业务属性,例如枚举单选、枚举多选、文本字段等。
常见字段包括: | 字段 | 含义 | id | 属性配置 ID | dom_id | 企业域 ID | name | 属性名称 | description | 属性描述 | value_type | 属性值类型 | default_value | 默认值 | option_value | 候选值列表 | required | 是否必填 | enabled | 是否启用 | seq_num | 排序号 | show_in_list | 是否展示在指标列表 | searchable | 是否支持搜索 | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 | is_del | 逻辑删除标记 |
10. metric_statisticsmetric_statistics 是指标统计表,用于保存指标引用数、访问数等统计数据。页面列表中的“引用数”“访问数”与该表相关。
常见字段包括: | 字段 | 含义 | id | 自增 ID | dom_id | 企业域 ID | metric_id | 指标 ID | metric_type | 指标类型 | statistics_type | 统计类型 | statistics_value | 统计值 | last_event_time | 最近事件发生时间 | ctime | 创建时间 | utime | 更新时间 |
11. metric_treemetric_tree 是指标树表,用于保存指标树节点和拆解配置。
常见字段包括: | 字段 | 含义 | id | 自增主键 | dom_id | 企业域 ID | metric_tree_id | 指标树 ID | metric_id | 关联指标 ID | name | 指标树名称 | config | 指标树拆解配置,JSON 格式 | parent_dir_id | 父目录 ID | u_id | 用户 ID | ctime | 创建时间 | utime | 更新时间 | is_del | 逻辑删除标记 |
12. business_metricbusiness_metric 是业务指标表,用于保存业务层面的指标定义。正式指标和草稿指标可以通过 biz_metric_id 关联业务指标。
常见字段包括: | 字段 | 含义 | id | 业务指标 ID | dom_id | 企业域 ID | dir_id | 所在目录 ID | name | 业务指标名称 | desc | 业务口径 | biz_attrs | 业务属性,JSON 格式 | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 | is_del | 逻辑删除标记 |
二、指标中心复用的通用表1. directory指标中心的文件夹目录复用通用目录表 directory,不是单独建一张指标目录表。 常见字段包括: | 字段 | 含义 | id | 自增主键 | dom_id | 企业域 ID | u_id | 创建人用户 ID | dir_id | 目录 ID | dir_type | 目录类型 | name | 目录名称 | parent_dir_id | 父目录 ID | config | 目录配置 | ctime | 创建时间 | utime | 更新时间 |
指标中心相关目录类型: dir_type | 含义 | 7 | METRIC_PLATFORM,指标管理目录 | 11 | METRIC_TREE,指标树目录 | 12 | BUSINESS_METRIC,业务指标目录 |
2. card_metric_relcard_metric_rel 用于保存卡片和指标之间的引用关系。当指标被卡片使用时,会通过这张表记录关系。
常见字段包括: | 字段 | 含义 | id | 自增主键 | dom_id | 企业域 ID | cd_id | 卡片 ID | metric_id | 指标 ID | creator | 创建人 | ctime | 创建时间 | utime | 更新时间 | is_del | 逻辑删除标记 |
三、常见枚举说明1. 指标类型字段:metric.sub_type、metric_draft.sub_type、metric_statistics.metric_type | 值 | 含义 | 0 | ATOMIC,原子指标 | 1 | COMPOSITE,复合指标 | 2 | DERIVED,衍生指标 | 3 | SHORTCUT,快捷引用指标 |
2. 指标状态字段:metric.status | 值 | 含义 | 0 | UNPUBLISHED,未上线 | 1 | PUBLISHED,已上线 | 2 | UN_SET,未设置 |
字段:metric_draft.status 3. 指标关系类型字段:metric_rel.obj_type、metric_draft_rel.obj_type | 值 | 含义 | 0 | APPLICABLE_DIM,适用维度 | 1 | COMPOSITE_BASE,复合指标引用的指标 | 2 | DERIVED_BASE,衍生指标引用的指标 | 3 | SHORTCUT_BASE,快捷引用指向的指标 |
4. 聚合方式字段:metric.aggr_type、metric_draft.aggr_type | 值 | 含义 | 0 | SUM,求和 | 1 | CNT,计数 | 2 | MIN,最小值 | 3 | MAX,最大值 | 4 | AVG,平均值 | 5 | STDDEV,标准差 | 6 | VAR,方差 | 7 | CNT_DISTINCT,去重计数 | 8 | NUL,无聚合 | 9 | MED,中位数 | 10 | PERCENTILE,百分位 | 11 | FIRST,首个值 | 12 | LAST,末个值 |
5. 字段类型字段:fd_formula_type 等字段类型相关字段 | 值 | 含义 | 0 | INT | 1 | DOUBLE | 2 | STRING | 3 | TIMESTAMP | 4 | LONG | 5 | SHORT | 6 | FLOAT | 7 | DATE | 8 | BOOL | 9 | DECIMAL | 10 | SUB_DATE | 11 | ARRAY |
6. 指标业务属性类型字段:metric_attr_config.value_type | 值 | 含义 | 0 | ENUM_SINGLE,枚举单选 | 1 | ENUM_MULTIPLE,枚举多选 | 2 | TEXT,单行文本 | 3 | TEXT_AREA,多行文本 |
7. 指标快照类型字段:metric_snapshot.snapshot_type | 值 | 含义 | 0 | PUBLISHED_HISTORY,历史上线版本 |
字段:metric_snapshot.snapshot_schema_version 8. 指标统计类型字段:metric_statistics.statistics_type | 值 | 含义 | REFERENCE_METRIC_CNT | 被其他指标引用的次数 | REFERENCE_CARD_CNT | 被卡片引用的次数 | REFERENCE_CNT | 总引用次数 | VIEW_CNT | 访问次数 |
四、常见 JSON 字段说明部分字段使用 JSON 保存复杂配置,排查时需要重点关注: | 字段 | 说明 | metric.config | 指标配置,包含指标图卡片配置、权限继承、加速优先级等 | metric.biz_attrs | 指标业务属性取值,结构通常包含属性配置 ID 和取值列表 | metric.fd_redundant_info | 来源字段冗余信息,用于字段删除后的展示和提示 | metric.filter | 指标筛选条件 | metric.display | 指标图展示配置 | metric.dynamic_parameters | 动态参数默认值 | metric_tree.config | 指标树拆解配置 | metric_snapshot.snapshot_data | 指标历史版本完整快照 | business_metric.biz_attrs | 业务指标上的业务属性取值 |
五、排查建议如果要定位一个指标中心页面上的数据来源,可以按以下顺序查看: 先通过 metric_project 确认指标主题。 通过 directory 确认目录结构,指标管理目录类型为 METRIC_PLATFORM。 通过 metric 查看正式指标基础信息。 通过 metric_rel 查看适用维度、复合指标、衍生指标、快捷引用等依赖关系。 如指标存在编辑中版本,再查看 metric_draft 和 metric_draft_rel。 如需看历史版本,查看 metric_snapshot。 如需看引用数和访问数,查看 metric_statistics。 如需看业务属性,查看 metric_attr_config 以及 metric.biz_attrs。 如涉及公共维度,查看 public_dimension 和 dimension_field_rel。 如涉及指标树,查看 metric_tree 以及 directory 中的 METRIC_TREE 目录。
|