IK 分词插件是云搜索服务实例的默认插件，不能卸载。目前支持可视化配置和上传文件两种方式配置 IK 分词。本文介绍可视化配置 IK 分词的操作步骤。

背景信息

IK 分词包含分词和停用词，添加词条前请先了解以下信息：

• 分词：如果创建索引时使用了分词词典，写入的数据如果包含了分词词条，那么会创建索引，且能通过关键词搜索该索引。
• 停用词：如果创建索引时使用了停用词词典，写入的数据如果包含了停用词词条，该词会被过滤。
• 添加词条时，一行只能写一个词。可以换行添加，从而批量添加词条。

注意事项

• 新添加的分词词条处于未生效状态，需要手动触发（一键生效）分词词条生效。如果是旧版本实例，执行一键生效时会提示需要先重新启动实例升级插件，才可以手动触发分词生效。
• 一键生效会生成词典文件，生成的分词词典文件为SYSTEM_DICTIONARY_MAIN.dic，停用词词典文件为SYSTEM_DICTIONARY_STOPWORD.dic，可在文件管理页签下查看。
• 词典文件将对使用 IK 分词的存量、新增索引生效，操作后约两分钟才可实际生效。无论是添加词条、编辑词条和删除词条，都只对新建索引和存量索引的新增数据生效，如果您希望对存量索引的历史数据生效，可使用数据刷新功能刷新索引数据。相关文档，请参见执行数据刷新。

添加分词词条

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2页面，单击目标实例名称。
4. 在左侧导航栏选择实例管理 > 插件管理，然后单击系统内置插件页签。
5. 在插件列表中，查找analysis-ik插件，然后单击对应操作栏的分词词库/停用词词库。
   OpenSearch 实例的 IK 插件名称为opensearch-analysis-ik。
6. 在分词词库面板页，添加 IK 分词和停用词。

生效词条

新添加的 IK 分词/停用词词条处于未生效状态，需要手动触发（一键生效）词条生效。

1. 登录云搜索服务控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 在实例列表 v2页面，单击目标实例名称。
4. 在左侧导航栏选择实例管理 > 插件管理，然后单击系统内置插件页签。
5. 在插件列表中，查找analysis-ik插件，然后单击对应操作栏的分词词库/停用词词库。
   OpenSearch 实例的 IK 插件名称为opensearch-analysis-ik。
6. 在分词词库/停用词词库面板页，手动触发 IK 分词和停用词生效。

编辑分词和停用词词条

通过可视化添加的 IK 分词/停用词词条，支持编辑。编辑后的分词/停用词词条并未生效，需要重新手动触发词条生效。

1. 在插件列表中，查找analysis-ik插件，然后单击对应操作栏的分词词库/停用词词库。
   OpenSearch 实例的 IK 插件名称为opensearch-analysis-ik。
2. 在分词词库/停用词词库的词条管理页签下，查找目标分词/停用词词条，然后单击操作列中的编辑。
3. 在弹出的对话框中，按需修改词条，然后单击确定。
4. （可选）手动触发词条生效。
   编辑分词/停用词词条后，词条状态为未生效，您需要单击一键生效，然后确认操作。详情请见生效分词词条。

   说明

   该变更只对新建索引和存量索引的新增数据生效，如果您希望对存量索引的历史数据生效，可使用数据刷新功能刷新索引数据。相关文档，请参见执行数据刷新。

删除分词和停用词词条

通过可视化添加的 IK 分词/停用词词条，支持删除，删除后无法恢复，请谨慎执行删除操作。删除后的词条并未生效，需要重新手动触发词条生效。

1. 在插件列表中，查找analysis-ik插件，然后单击对应操作栏的分词词库/停用词词库。
   OpenSearch 实例的 IK 插件名称为opensearch-analysis-ik。
2. 在分词词库/停用词词库的词条管理页签下，查找目标词条，然后单击操作列中的删除。
3. 在删除对话框，单击确定。
4. （可选）手动触发词条生效。
   删除词条后，词条状态为删除待生效，您需要单击一键生效，然后确认操作。详情请见生效分词词条。

   说明

   该变更只对新建索引和存量索引的新增数据生效，如果您希望对存量索引的历史数据生效，可使用数据刷新功能刷新索引数据。相关文档，请参见执行数据刷新。