上传同义词文件

云搜索服务提供同义词功能，您可以在同义词文件中添加具备关联性的词汇，然后通过上传同义词文件的方式配置同义词，提升检索的准确性。

背景信息

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

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

上传同义词文件

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

启用同义词文件

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

1. 在实例的同义词文件列表，选择处于待启用状态的文件，然后单击启用。
   
2. 在启用文件对话框，单击确定。

热更新同义词文件

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

1. 在实例的同义词文件列表，选择需要更新的同义词文件，然后单击热更新。
   
2. 在热更新文件对话框，上传已更新的同名文件，然后单击关闭。
   
3. 在弹出的对话框中，单击确定。
   

下载同义词文件

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

1. 在实例的同义词文件列表，查询并选择目标同义词文件。
2. 单击目标文件操作列对应的下载，即可将同义词文件下载至本地。
   

删除同义词文件

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

1. 在实例的同义词文件列表，查询并选择目标同义词文件。
2. 单击目标文件操作列对应的删除。
3. 在弹出的对话框中，查看注意事项并确认需要删除的同义词文件，然后单击删除。