高级配置中的cava配置主要为用户提供引擎支持cava插件的能力,用户可以自行上传cava脚本实现对function、scorer、summary的定制化。

添加cava配置

  1. 创建/修改在线配置,选择配置中心>高级配置>cava配置

image.png

  1. 选择_edit编辑版本,点击编辑

image.png

用户可以在此处创建目录,或者上传文件:

image.png
说明

上传文件要求:

  • 文件大小不得超过20M。

  • 文件格式必须为:.cava .json .txt .xml

新增目录-目录名要求:

  • 可由英文、数字、下划线构成。

  • 不超过100字符。

  1. cava脚本上传完成后,回到cava配置页面,发布_edit版本:

image.png

发布成功后,系统会自动生成一个cava配置版本:

image.png

此时需要推送在线配置使修改的cava配置生效。

  1. 推送在线配置:在运维管理>配置更新,选择在线配置,找到刚发布的cava配置版本,选择目标集群,点击确定

image.png

  1. 可在变更历史>集群变更中查看在线配置生效进度:

image.png

以上的FSM流程完成后,cava配置文件将在引擎中生效。

cava配置生效

  1. 通过“添加cava配置”将cava脚本上传至实例中后,需要修改高级配置>查询配置>default_biz.json中cava相关参数,才能将cava配置引用的实例中,供查询使用:

image.png

相关配置说明

  • cava_alloc_size_limit:query级别能分配的最大内存, 可省略使用默认

  • cava_compile_thread_num

  • cava_config

  • cava_loop_and_func_limit:

  • cava_max_variable_count

  • cava_module_cache_size:最多缓存query里面传递source code的个数,超过则开始LRU淘汰, 可省略使用默认

  • enable_cava:是否启用cava功能

适配上面default_biz.json的配置目录结构:

├── AliTokenizer.conf
├── analyzer.json
├── cava
│   ├── cache
│   │   └── SampleScorer2.cava
│   ├── lib
│   │   ├── Feature1.cava
│   │   ├── Feature2.cava
│   │   └── FeatureLib.cava
│   └── src
│       ├── DefaultScorer.cava
│       ├── MultiValueScorer.cava
│       ├── MultValueSetScorer.cava
│       ├── SampleScorer.cava
│       ├── ScorerAudition.cava
│       └── UseFeatureLib.cava
├── qrs.json
├── schemas
│   └── simple_schema.json
└── zones
    └── simple
        └── default_biz.json

  1. 修改完成之后,发布_edit查询配置:

image.png

发布成功后,系统会自动生成一个查询配置版本:

image.png

  1. 此时需要推送在线配置使修改的查询配置生效,在运维管理>配置更新,选择在线配置,找到刚发布的查询配置版本,选择目标集群,点击确定

image.png

  1. 可在变更历史>集群变更中查看在线配置生效进度:

image.png

以上的FSM流程完成后,cava配置文件将在引擎中可使用。

删除cava配置

  • 状态为“未使用”的cava配置版本,可以直接在高级配置 > cava配置界面点击删除

image.png

状态为“使用中”的cava配置版本,只可进行“查看”,若需删除,请在运维中心>运维管理>配置更新中选择“cava配置版本”时引用其他在线配置版本,点击确定,当该“cava配置版本”处于“未使用”的状态时即可删除。

image.png

注意事项

  • 线上使用的cava版本只可查看,无法删除。