云搜索服务提供搜索管理功能，用于统一维护同义词、IK 分词，以及类目预测。本文为您介绍同义词配置中的文件管理相关操作。

背景信息

您在配置同义词文件时，需要提前了解以下信息：

• 仅支持上传 utf-8 编码的 .txt 文件。
• 一行表示具备关联性的词，用英文逗号（,）分隔。
• 一次最多上传 10 个文件，且单个文件最大为 5MiB。
• 新增文件时，不支持上传同名的同义词文件；热更新时，上传的文件必须同名。
• 上传新的同义词文件后，需要启用文件同义词才可生效。
• 启用后的同义词文件将对使用同义词（filter名为default_dynamic_synonym）的存量、新增索引生效，文件更新后约两分钟才可实际生效。其中存量索引仅新增数据生效，如果您希望对存量索引存量数据生效，可使用数据刷新功能重建索引。

上传同义词文件

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2页面，单击目标实例名称。
4. 在左侧导航栏选择搜索管理 > 同义词管理。
5. 在同义词管理页面，单击文件管理页签，然后单击新增文件。
   
6. 在新增文件对话框中，单击或者拖拽同义词文件，上传完成后，单击关闭。
   
7. 在弹出的对话框中，选择是否立即生效。
   
   • 立即启用文件：单击启用，启用同义词文件，同义词词条生效。
   • 不需要立即启用：单击取消，文件会保存在文件列表中，不会启用。

启用同义词文件

上传的同义词文件需要启用后才可生效。如果上传文件时未启用，请参考以下步骤启用文件，生效同义词。

1. 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
2. 在同义词文件列表，选择处于待启用状态的文件，然后单击启用。
   
3. 在启用文件对话框，单击确定。

热更新同义词文件

当您需要更新已启用的同义词文件内容时，您可以下载已启用的同义词文件，在本地更新文件内容后，然后进行热更新操作。热更新同义词文件不会触发实例重启，而是在运行过程中加载同义词词库。

1. 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
2. 在同义词文件列表，选择需要更新的同义词文件，然后单击热更新。
   
3. 在热更新文件对话框，上传已更新的同名文件，然后单击关闭。
   
4. 在弹出的对话框中，单击确定。
   

下载同义词文件

支持下载同义词文件，可以用来查看同义词词条详情，也可以用来更新文件中的词条内容。

1. 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
2. 在同义词文件列表，查询并选择目标同义词文件。
3. 单击目标文件操作列对应的下载，即可将同义词文件下载至本地。
   

删除同义词文件

请谨慎执行删除同义词文件的操作。

1. 在实例详情的左侧导航栏选择搜索管理 > 同义词管理，然后单击文件管理页签。
2. 在实例的同义词文件列表，查询并选择目标同义词文件。
3. 单击目标文件操作列对应的删除。
4. 在弹出的对话框中，查看注意事项并确认需要删除的同义词文件，然后单击删除。