云搜索服务
云搜索服务
文档指南
请输入
- 文档首页
云搜索服务用户指南实例管理搜索管理同义词配置同义词-文件管理
复制全文
下载 pdf同义词-文件管理
文档反馈
问问助手云搜索服务提供搜索管理功能，用于统一维护同义词、IK 分词，以及类目预测。本文为您介绍同义词配置中的文件管理相关操作。
背景信息
您在配置同义词文件时，需要提前了解以下信息：
- 仅支持上传 utf-8 编码的 .txt 文件。
- 一行表示具备关联性的词，用英文逗号（,）分隔。
- 一次最多上传 10 个文件，且单个文件最大为 5 MiB。
- 新增文件时，不支持上传同名的同义词文件；热更新时，上传的文件必须同名。
- 上传新的同义词文件后，需要启用文件同义词才可生效。
- 启用后的同义词文件将对使用同义词（filter 名为 default_dynamic_synonym）的存量、新增索引生效，文件更新后约两分钟才可实际生效。其中存量索引仅新增数据生效，如果您希望对存量索引存量数据生效，可使用数据刷新功能重建索引。
上传同义词文件
- 登录云搜索服务控制台。
- 在顶部导航栏，选择目标项目和地域。
- 在实例列表页面，单击目标实例名称。
- 在左侧导航栏选择搜索管理 > 同义词管理。
- 在同义词管理页面，单击文件管理页签，然后单击新增文件。
- 在新增文件对话框中，单击或者拖拽同义词文件，上传完成后，单击关闭。
- 在弹出的对话框中，选择是否立即生效。
- 立即启用文件：单击启用，启用同义词文件，同义词词条生效。
- 不需要立即启用：单击取消，文件会保存在文件列表中，不会启用。
启用同义词文件
上传的同义词文件需要启用后才可生效。如果上传文件时未启用，请参考以下步骤启用文件，生效同义词。
- 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
- 在同义词文件列表，选择处于待启用状态的文件，然后单击启用。
- 在启用文件对话框，单击确定。
热更新同义词文件
当您需要更新已启用的同义词文件内容时，您可以下载已启用的同义词文件，在本地更新文件内容后，然后进行热更新操作。热更新同义词文件不会触发实例重启，而是在运行过程中加载同义词词库。
- 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
- 在同义词文件列表，选择需要更新的同义词文件，然后单击热更新。
- 在热更新文件对话框，上传已更新的同名文件，然后单击关闭。
- 在弹出的对话框中，单击确定。
下载同义词文件
支持下载同义词文件，可以用来查看同义词词条详情，也可以用来更新文件中的词条内容。
- 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
- 在同义词文件列表，查询并选择目标同义词文件。
- 单击目标文件操作列对应的下载，即可将同义词文件下载至本地。
删除同义词文件
请谨慎执行删除同义词文件的操作。
说明
删除同义词文件，请先了解以下注意事项：
- 请确保删除文件所包含的词条目前没有索引在使用，否则会导致集群状态异常。如果需要更新词条请使用热更新。
- 删除词条文件前，请确认引用该文件的相关索引已经移除，不然会导致集群状态异常。
- 删除同义词文件后，该操作仅对之后新建的索引生效。如果要对存量索引的历史数据生效，需要刷新索引数据，请参见执行数据刷新。
- 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
- 在实例的同义词文件列表，查询并选择目标同义词文件。
- 单击目标文件操作列对应的删除。
- 在弹出的对话框中，查看注意事项并确认需要删除的同义词文件，然后单击删除。
最近更新时间：2026.03.03 17:07:08
这个页面对您有帮助吗？
有用
有用
无用
无用