搜索服务定义概述

什么是搜索服务定义

在工业数字化转型过程中，企业往往面临多源异构数据分散、检索效率低下的挑战。设备档案、工艺参数、质量记录、物料信息等关键数据分散于不同业务系统与数据模型中，传统单库查询方式难以实现跨模型的快速联合检索。

搜索服务定义是工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供的核心能力，旨在解决跨模型、跨实体的复杂数据检索需求。通过可视化配置，用户可将多个相关模型实体或实例逻辑组合，构建统一的检索视图，并提供高性能的全文搜索接口。

该功能底层依托高效搜索引擎接口，具备高并发、低延迟的性能优势，适用于需要快速定位关键工业数据（如设备档案、工艺参数、物料信息等）的场景。

搜索服务定义创建基本流程

创建搜索服务定义是一个从业务抽象到技术实现，再到服务发布的系统化过程。主要包含以下四个关键阶段：

图1 创建搜索服务定义流程图

创建搜索服务定义
在此阶段，用户需根据业务场景需求，完成搜索服务定义的基础信息配置：
- 定义API的唯一英文标识及易读的中文名称。
- 明确该搜索服务所覆盖的业务领域（如“设备全生命周期检索”或“物料综合查询”），为后续的数据关联奠定基础。
配置索引规则
在此阶段，用户需针对不同类型的业务数据，制定精细化的索引策略，以平衡检索的召回率与准确率：
- 设置索引名称、描述及数据类型（文本、日期、数值、JSON等）。
- 根据语义特点选择分词方法（如不分词、普通分词、最全分词、单字分词等），确保关键词能被正确切分。
- 配置匹配方式（精确、模糊、短语、范围），并设定字段是否参与全局搜索、是否作为过滤条件以及是否在结果中展示。
配置服务实体
在此阶段，用户需将抽象的搜索规则映射到具体的物料数据对象上：
- 选择参与搜索的数据模型实体（如“设备主数据”、“维修工单”等）。
- 将已定义的索引字段与实体的具体属性进行绑定，确定哪些数据字段将被纳入索引构建，以及搜索结果中最终展示哪些内容。
发布搜索服务定义
在此阶段，用户确认所有配置无误后，执行发布操作：
- 将搜索服务定义正式发布到运行态，使其对外提供标准的API检索能力。
- 系统自动触发后台任务，将历史存量数据初始化并同步至搜索引擎，确保发布后即可立即进行全量数据检索。

约束与限制

搜索服务定义功能仅适用于标准使用场景的应用，轻量使用场景（即数据建模引擎基础版-Lite）的应用不支持此功能。
默认情况下，所有用户均具备搜索服务定义的使用权限。如果企业希望按组织架构进行精细化管控（如仅允许设备管理部或质量管理部访问），可通过“权限管理 > 授权 > 搜索服务定义”自定义授权策略，实现基于角色或部门的访问控制。更多权限配置详情请参见权限管理。
搜索服务定义不支持对数据实体“Tenant”（租户）的实例进行检索。