云搜索服务提供自定义文件管理功能，该功能可以用于非 IK 分词（Mapping Path 配置数据索引的路径映射关系）和同义词的其他分词需求场景，帮助您更加灵活地组织和管理数据，提高搜索服务的性能和准确性。本文介绍如何管理自定义文件。

注意事项

• 仅支持上传 utf-8 编码的 .txt 文件。
• 最多支持上传 10 个文件，且每个文件最大为 5MiB。
• 不支持上传已存在的同名文件，若需修改已存在文件请进行冷更新。
• 文件在启用后，最终会上传到 elasticsearch/opensearch 的 config 目录下。
• 无论是启用、冷更新还是删除操作，均只对引用自定义文件相关配置的索引生效。
• 如需使用同义词或 IK 分词功能，建议使用同义词和分词进行文件管理，同时支持热更新。详细信息，请参见同义词-文件管理和分词-文件管理。

上传自定义文件

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2 页面，单击目标实例名称。
4. 在实例基本信息页面的左侧导航栏，选择搜索管理 > 自定义文件管理。
5. 在自定义文件管理页面，单击新增文件页签，然后单击新增文件。
6. 在新增文件对话框，单击点击或拖拽文件到此处上传，待文件上传完成后，单击关闭。
7. 在启用文件对话框，按需是否启用生效文件：
   • 启用文件：单击启用，在确定要启用吗？ 对话框，单击确定。启用文件后实例会立即重启，重启后上传的文件会立即生效，建议在业务低峰期启用文件。
   • 不启用文件：单击取消，取消后实例既不会重启，文件也不会立即生效，文件将会被保存在文件列表中，您可以按需启用文件，启用后实例会进行重启，建议在业务低峰期进行。

启用文件

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2 页面，按需启用自定义文件：

• 启动指定文件
  1. 单击目标实例操作列下的启用。
  2. 在启用文件对话框，单击启用。
  3. 在确定要启用吗？ 对话框，单击确定。
• 批量启用文件
  1. 勾选目标文件，单击底部菜单栏的启用。
  2. 在启用文件对话框，单击启用。
  3. 在确定要启用吗？ 对话框，单击确定。

其他操作

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2 页面，您可以进行以下操作：
   • 下载自定义文件
     单击目标文件操作列的下载，即可完成对自定义文件的下载。
   • 冷更新自定义文件

     说明

     自定义文件需要进行冷更新时，您需关注以下信息：

     • 文件配置要求：文件名需与原文件保持一致，文件最大为 5MiB。
     • 文件更新过程：冷更新操作将重启实例，重启完成后即完成对文件的冷更新。
     单击目标文件操作列的冷更新，在冷更新文件对话框，单击点击或拖拽文件到此处上传，待文件上传完成后，单击关闭。
   • 删除自定义文件

     注意

     • 待删除的自定义文件为待启用的状态，否则无法删除。
     • 删除文件前，请确保需删除的文件未被任何集群或索引配置使用，否则删除文件会导致实例异常。
     • 删除指定文件：选择目标文件操作列的 ... > 删除，在确定删除所选文件么？ 对话框，单击删除，在确定要删除吗？ 对话框，单击确定。
     • 批量删除文件：勾选目标文件，单击底部菜单栏的删除，在确定删除所选文件么？ 对话框，单击删除，在确定要删除吗？ 对话框，单击确定。