# 搜索服务定义概述
#### 什么是搜索服务定义
在工业数字化转型过程中，企业往往面临多源异构数据分散、检索效率低下的挑战。设备档案、工艺参数、质量记录、物料信息等关键数据分散于不同业务系统与数据模型中，传统单库查询方式难以实现跨模型的快速联合检索。
搜索服务定义是工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供的核心能力，旨在解决跨模型、跨实体的复杂数据检索需求。通过可视化配置，用户可将多个相关模型实体或实例逻辑组合，构建统一的检索视图，并提供高性能的全文搜索接口。
该功能底层依托高效搜索引擎接口，具备高并发、低延迟的性能优势，适用于需要快速定位关键工业数据（如设备档案、工艺参数、物料信息等）的场景。
#### 搜索服务定义创建基本流程
创建搜索服务定义是一个从业务抽象到技术实现，再到服务发布的系统化过程。主要包含以下四个关键阶段：
图1创建搜索服务定义流程图   
![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000001631827333.png)
1. **创建搜索服务定义**
   在此阶段，用户需根据业务场景需求，完成搜索服务定义的基础信息配置：
   - 定义API的唯一英文标识及易读的中文名称。
   
   - 明确该搜索服务所覆盖的业务领域（如"设备全生命周期检索"或"物料综合查询"），为后续的数据关联奠定基础。
    
2. **配置索引规则**
   在此阶段，用户需针对不同类型的业务数据，制定精细化的索引策略，以平衡检索的召回率与准确率：
   - 设置索引名称、描述及数据类型（文本、日期、数值、JSON等）。
   
   - 根据语义特点选择分词方法（如不分词、普通分词、最全分词、单字分词等），确保关键词能被正确切分。
   
   - 配置匹配方式（精确、模糊、短语、范围），并设定字段是否参与全局搜索、是否作为过滤条件以及是否在结果中展示。
    
3. **配置服务实体**
   在此阶段，用户需将抽象的搜索规则映射到具体的物料数据对象上：
   - 选择参与搜索的数据模型实体（如"设备主数据"、"维修工单"等）。
   
   - 将已定义的索引字段与实体的具体属性进行绑定，确定哪些数据字段将被纳入索引构建，以及搜索结果中最终展示哪些内容。
    
4. **发布搜索服务定义**
   在此阶段，用户确认所有配置无误后，执行发布操作：
   - 将搜索服务定义正式发布到运行态，使其对外提供标准的API检索能力。
   
   - 系统自动触发后台任务，将历史存量数据初始化并同步至搜索引擎，确保发布后即可立即进行全量数据检索。
    
 
#### 约束与限制
- 搜索服务定义功能仅适用于标准使用场景的应用，轻量使用场景（即数据建模引擎基础版-Lite）的应用不支持此功能。
- 默认情况下，所有用户均具备搜索服务定义的使用权限。如果企业希望按组织架构进行精细化管控（如仅允许设备管理部或质量管理部访问），可通过"权限管理 \> 授权 \> 搜索服务定义"自定义授权策略，实现基于角色或部门的访问控制。更多权限配置详情请参见[权限管理](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0262.html)。
- 搜索服务定义不支持对数据实体"Tenant"（租户）的实例进行检索。