当前位置：首页 > news >正文

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

news 2026/6/22 19:55:32

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

在 Teamcenter 日常运维中，查询构建器（Query Builder）是使用频率最高的工具之一。无论是查找零件、追踪变更、生成报表，还是做数据清洗，都离不开高效的查询。但很多用户对查询构建器的理解仅停留在"拖拽几个条件"的层面，遇到慢查询或复杂需求就束手无策。

本文将从 IRB（Information Retrieval Builder）底层原理出发，系统讲解查询构建器的高级用法、自定义报表开发，以及查询性能优化的实战技巧。

一、查询构建器的底层架构

1.1 查询执行流程


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

每次你在查询构建器中点击"执行"，背后都经历了完整的编译链路。理解这个流程，是优化查询性能的第一步。

1.2 IRB 文件结构

Teamcenter 的查询定义存储在 IRB 文件中（.irb 或 XML 格式），核心结构如下：


<?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.3 查询类型分类

| 查询类型 | 说明 | 典型场景 |

|---------|------|---------|

| 标准查询 | 基于单一对象类 | 查找 Item、Revision |

| 交叉查询 | 多对象类关联 | Item + BOMLine + Part |

| 全文查询 | 全文索引搜索 | 文档内容搜索 |

| 保存查询 | 预定义查询模板 | 常用查询快速执行 |

二、查询构建器高级用法

2.1 嵌套条件组合

查询构建器支持 AND / OR / NOT 的任意嵌套组合：


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

操作步骤：

1. 打开查询构建器（工具 → 查询构建器）

2. 点击"新建查询"

3. 选择对象类（如 Item 或 ItemRevision）

4. 添加条件行，使用"添加组"创建嵌套逻辑

5. 保存查询模板

2.2 日期范围查询实战


场景：查询最近 N 天修改的零件条件设置：
├── 最后修改日期 → 大于 → "相对日期"
├── 相对天数 → -30（过去 30 天）
└── 排序 → 最后修改日期 降序

常用日期函数：

| 函数 | 说明 | 示例 |

|------|------|------|

| CURRENT_DATE | 当前日期 | 当天 |

| DATE_SUB(CURRENT_DATE, N) | N 天前 | 过去 N 天 |

| DATE_ADD(CURRENT_DATE, N) | N 天后 | 未来 N 天 |

| TRUNC(CURRENT_DATE, 'MM') | 当月第一天 | 本月 |

2.3 属性关联查询

当需要查询关联对象的属性时，使用"关系"条件：


查询：含有"不锈钢"物料的 BOM├── 对象类：ItemRevision
├── 关系条件
│   ├── 关系类型：IMAN_specification
│   ├── 目标类：ItemRevision
│   └── 目标条件：object_string 包含 "不锈钢"
└── 排序：object_string 升序

2.4 查询结果列定制

查询构建器默认只显示关键列，你可以自定义显示列：

1. 在查询构建器中点击"结果列"选项卡

2. 从左侧属性树拖拽需要的属性到右侧

3. 调整列顺序和宽度

4. 保存查询模板

常用显示列：

`item_id`（零部件编号）

`object_string`（名称）

`object_desc`（描述）

`release_status`（发布状态）

`owning_user`（所有者）

`last_mod_date`（最后修改日期）

三、报告构建器（Report Builder）

3.1 报告与查询的区别

| 维度 | 查询构建器 | 报告构建器 |

|------|-----------|-----------|

| 目的 | 数据检索 | 数据展示与汇总 |

| 输出 | 对象列表 | 格式化报表 |

| 聚合 | 不支持 | 支持 COUNT/SUM/AVG |

| 导出 | 有限 | 支持 Excel/PDF |

| 排版 | 固定列 | 可自定义布局 |

3.2 创建自定义报表

步骤：

1. 选择数据源

工具 → 报告构建器 → 新建报告

→ 选择"查询"作为数据源

→ 选择一个已保存的查询

2. 设计报表布局

拖拽字段到报表区域

→ 设置分组（如按"产品系列"分组）

→ 添加汇总行（COUNT、SUM）

→ 调整列宽和字体

3. 添加条件参数

在查询条件中使用变量：

→ ${start_date}（开始日期）

→ ${end_date}（结束日期）

→ ${product_line}（产品线）

运行时动态输入

4. 导出配置

报告 → 导出 → 选择格式

→ Excel (.xlsx)

→ PDF

→ CSV

3.3 报表模板示例：BOM 汇总表


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

四、查询性能优化

4.1 常见性能瓶颈

| 瓶颈 | 原因 | 影响 |

|------|------|------|

| 全表扫描 | 缺少索引或条件不当 | 查询耗时 10s+ |

| 关联过多 | 多层关系查询 | 数据量指数增长 |

| 通配符前缀 | LIKE '%关键词' | 索引失效 |

| 函数调用 | UPPER(column) = 'XXX' | 索引失效 |

| 大量结果 | 返回 10000+ 条 | 内存溢出 |

4.2 优化策略

策略 1：使用精确匹配代替模糊匹配


-- ❌ 慢：通配符前缀匹配，索引失效
SELECT * FROM PITEM WHERE object_string LIKE '%电机%'-- ✅ 快：前缀匹配，使用索引
SELECT * FROM PITEM WHERE object_string LIKE '电机%'-- ✅ 最快：精确匹配
SELECT * FROM PITEM WHERE object_string = 'YE3-132M-4 电机'

策略 2：限制结果集大小


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

策略 3：优先使用索引字段

Teamcenter 默认索引字段：

`item_id`

`object_string`

`object_type`

`release_status`

`owning_user`

`creation_date`

`last_mod_date`


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

策略 4：减少关联层数


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

4.3 数据库层面的优化

查看执行计划：


-- 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 '电机%';

添加自定义索引：


-- 为常用查询属性添加索引
CREATE INDEX idx_custom_prop ON PPOMY_custom_attr(prop_value);-- 注意：索引会增加写入开销，需权衡

定期维护统计信息：


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

五、实战案例

5.1 案例一：查找重复零部件


需求：找出名称和规格完全相同的重复 Item查询构建器设置：
├── 对象类：ItemRevision
├── 条件：
│   ├── object_string = ${name}（参数）
│   └── POM_specification = ${spec}（参数）
├── 分组：object_string, POM_specification
├── 汇总：COUNT(*) > 1
└── 排序：COUNT(*) 降序执行后导出为 Excel，人工确认重复项

5.2 案例二：变更影响分析


需求：某个零件被哪些 BOM 引用查询构建器设置：
├── 对象类：BOMLine
├── 条件：
│   └── 关系条件
│       ├── 关系类型：IMAN_revision
│       ├── 目标类：ItemRevision
│       └── 目标条件：item_id = "ABC-001"
├── 显示列：
│   ├── bl_find_num（行号）
│   ├── bl_qty（数量）
│   └── 父项 Item ID
└── 排序：父项 Item ID结果：列出所有引用该零件的 BOM 结构

5.3 案例三：过期文档清理


需求：找出超过 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执行后人工确认，批量归档