查询构建器与报表开发：IRB 规则、自定义查询与性能优化

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

用户输入查询条件
    ↓
Query Builder UI 解析
    ↓
生成 IRB XML 描述
    ↓
IRB 引擎编译为 SQL
    ↓
数据库执行查询
    ↓
返回结果集 → 客户端渲染

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<?xml version="1.0" encoding="UTF-8"?>
<query>
  <name>MyCustomQuery</name>
  <displayName>自定义零件查询</displayName>
  <description>查找最近 30 天修改的 Item</description>
  <class>Item</class>
  <where>
    <and>
      <condition>
        <property>object_string</property>
        <operator>contains</operator>
        <value>%电机%</value>
      </condition>
      <condition>
        <property>last_mod_date</property>
        <operator>greater_than</operator>
        <value>DATE_SUB(CURRENT_DATE, 30)</value>
      </condition>
    </and>
  </where>
  <orderBy>
    <property>last_mod_date</property>
    <direction>desc</direction>
  </orderBy>
</query>

1
2
3
4
5
6
7
8
9

查询：电机类零件
├── AND
│   ├── object_string 包含 "电机"
│   ├── object_type = "ItemRevision"
│   └── OR
│       ├── release_status = "已发布"
│       └── release_status = "工作中"
└── AND
    └── last_mod_date > 2025-01-01

1
2
3
4
5
6

场景：查询最近 N 天修改的零件

条件设置：
├── 最后修改日期 → 大于 → "相对日期"
├── 相对天数 → -30（过去 30 天）
└── 排序 → 最后修改日期 降序

1
2
3
4
5
6
7
8

查询：含有"不锈钢"物料的 BOM

├── 对象类：ItemRevision
├── 关系条件
│   ├── 关系类型：IMAN_specification
│   ├── 目标类：ItemRevision
│   └── 目标条件：object_string 包含 "不锈钢"
└── 排序：object_string 升序

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

报告名称：BOM 物料汇总表
数据源：BOM 查询（ItemRevision + BOMLine）
分组：父项零部件
汇总字段：
  ├── 子项数量：COUNT(BOMLine.bl_id)
  ├── 总重量：SUM(POM_part_weight)
  └── 物料种类：COUNT(DISTINCT POM_material)

输出列：
  ├── 父项编号
  ├── 父项名称
  ├── 子项数量
  ├── 总重量 (kg)
  └── 物料种类数

1
2
3
4
5
6
7
8

-- ❌ 慢：通配符前缀匹配，索引失效
SELECT * FROM PITEM WHERE object_string LIKE '%电机%'

-- ✅ 快：前缀匹配，使用索引
SELECT * FROM PITEM WHERE object_string LIKE '电机%'

-- ✅ 最快：精确匹配
SELECT * FROM PITEM WHERE object_string = 'YE3-132M-4 电机'

1
2
3
4

查询构建器中：
→ 设置"最大返回行数"为 500 或 1000
→ 避免一次性拉取全部数据
→ 使用分页逐步加载

1
2

✅ 优先使用上述字段作为查询条件
❌ 避免在自定义属性上做大范围查询（除非已建索引）

1
2
3

❌ 3 层关联：Item → BOMLine → ItemRevision → Document
✅ 2 层关联：ItemRevision → Document
✅ 拆分查询：先查 BOM，再查文档

1
2
3
4
5
6
7
8

-- Oracle
EXPLAIN PLAN FOR
SELECT * FROM PITEM WHERE object_string LIKE '电机%';
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY);

-- PostgreSQL
EXPLAIN ANALYZE
SELECT * FROM PITEM WHERE object_string LIKE '电机%';

1
2
3
4

-- 为常用查询属性添加索引
CREATE INDEX idx_custom_prop ON PPOMY_custom_attr(prop_value);

-- 注意：索引会增加写入开销，需权衡

1
2
3
4
5

-- Oracle
EXEC DBMS_STATS.GATHER_SCHEMA_STATS('TC');

-- PostgreSQL
ANALYZE;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

需求：找出名称和规格完全相同的重复 Item

查询构建器设置：
├── 对象类：ItemRevision
├── 条件：
│   ├── object_string = ${name}（参数）
│   └── POM_specification = ${spec}（参数）
├── 分组：object_string, POM_specification
├── 汇总：COUNT(*) > 1
└── 排序：COUNT(*) 降序

执行后导出为 Excel，人工确认重复项

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

需求：某个零件被哪些 BOM 引用

查询构建器设置：
├── 对象类：BOMLine
├── 条件：
│   └── 关系条件
│       ├── 关系类型：IMAN_revision
│       ├── 目标类：ItemRevision
│       └── 目标条件：item_id = "ABC-001"
├── 显示列：
│   ├── bl_find_num（行号）
│   ├── bl_qty（数量）
│   └── 父项 Item ID
└── 排序：父项 Item ID

结果：列出所有引用该零件的 BOM 结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

需求：找出超过 2 年未修改且未发布的文档

查询构建器设置：
├── 对象类：ItemRevision
├── 条件：
│   ├── object_type = "Document"
│   ├── last_mod_date < DATE_SUB(CURRENT_DATE, 730)
│   └── release_status != "已发布"
├── 显示列：item_id, object_string, last_mod_date
├── 排序：last_mod_date 升序
└── 最大返回：2000

执行后人工确认，批量归档