云搜索服务
云搜索服务
文档指南
请输入
- 文档首页
云搜索服务用户指南实例管理搜索管理自定义文件管理
复制全文
下载 pdf自定义文件管理
文档反馈
问问助手云搜索服务提供自定义文件管理功能，该功能可以用于非 IK 分词（Mapping Path 配置数据索引的路径映射关系）和同义词的其他分词需求场景，帮助您更加灵活地组织和管理数据，提高搜索服务的性能和准确性。本文介绍如何管理自定义文件。
注意事项
- 仅支持上传 UTF-8 编码的 TXT 文件。
- 最多支持上传 10 个文件，且每个文件最大为 5 MiB。
- 不支持上传已存在的同名文件，若需修改已存在文件请进行冷更新。
- 文件在启用后，最终会上传到 elasticsearch/opensearch 的 config 目录下。
- 无论是启用、冷更新还是删除操作，均只对引用自定义文件相关配置的索引生效。
上传自定义文件
- 登录云搜索服务控制台。
- 在顶部导航栏，选择目标项目和地域。
- 在实例列表页面，单击目标实例名称。
- 在实例基本信息页面的左侧导航栏，选择搜索管理 > 自定义文件管理。
- 在自定义文件管理页面，单击新增文件页签，然后单击新增文件。
- 在新增文件对话框，单击点击或拖拽文件到此处上传，待文件上传完成后，单击关闭。
- 在启用文件对话框，按需是否启用生效文件：
- 启用文件：单击启用，在确定要启用吗？ 对话框，单击确定。启用文件后实例会立即重启，重启后上传的文件会立即生效，建议在业务低峰期启用文件。
- 不启用文件：单击取消，取消后实例既不会重启，文件也不会立即生效，文件将会被保存在文件列表中，您可以按需启用文件，启用后实例会进行重启，建议在业务低峰期进行。
启用文件
说明
启用自定义文件会触发实例重启，实例重启后文件会立即生效，建议在业务低峰期进行。
- 登录云搜索服务控制台。
- 在顶部导航栏，选择目标项目和地域。
- 在实例列表页面，按需启用自定义文件：
- 启动指定文件
- 单击目标实例操作列下的启用。
- 在启用文件对话框，单击启用。
- 在确定要启用吗？对话框，单击确定。
- 批量启用文件
- 勾选目标文件，单击底部菜单栏的启用。
- 在启用文件对话框，单击启用。
- 在确定要启用吗？对话框，单击确定。
其他操作
- 登录云搜索服务控制台。
- 在顶部导航栏，选择目标项目和地域。
- 在实例列表页面，您可以进行以下操作：
- 下载自定义文件
- 单击目标文件操作列的下载，即可完成对自定义文件的下载。
- 冷更新自定义文件
说明
自定义文件需要进行冷更新时，您需关注以下信息：
- 文件配置要求：文件名需与原文件保持一致，文件最大为 5 MiB。
- 文件更新过程：冷更新操作将重启实例，重启完成后即完成对文件的冷更新。
- 单击目标文件操作列的冷更新，在冷更新文件对话框，单击点击或拖拽文件到此处上传，待文件上传完成后，单击关闭。
- 删除自定义文件
注意
- 待删除的自定义文件为待启用的状态，否则无法删除。
- 删除文件前，请确保需删除的文件未被任何集群或索引配置使用，否则删除文件会导致实例异常。
- 删除指定文件：选择目标文件操作列的 ... > 删除，在确定删除所选文件么？ 对话框，单击删除，在确定要删除吗？ 对话框，单击确定。
- 批量删除文件：勾选目标文件，单击底部菜单栏的删除，在确定删除所选文件么？ 对话框，单击删除，在确定要删除吗？ 对话框，单击确定。
最近更新时间：2026.03.30 15:03:42
这个页面对您有帮助吗？
有用
有用
无用
无用