Meilisearch 会定期引入新的实验性功能。这些功能可能尚未准备好投入生产环境,但能为部分用户提供有价值的特性。

实验性功能的 API 可能会在版本更新时发生重大变更,导致不兼容。在生产环境中使用实验性功能时请特别注意这一点。

Meilisearch 提供实验性功能时预期它们会在未来版本中趋于稳定,但这并非绝对保证。

激活实验性功能

根据激活方式的不同,实验性功能分为两类:

  1. 需要通过命令行标志或环境变量在启动时激活
  2. 需要通过 /experimental-features API 路由 激活

启动时激活实验性功能

部分实验性功能可以在启动时激活,例如通过命令行标志:

./meilisearch --experimental-enable-metrics

实验性功能相关的标志和环境变量不会包含在常规配置选项列表中。如需了解具体功能,请查阅该功能专属文档页面(位于实验性功能章节)。

实验性功能的命令行标志始终以 --experimental 作为前缀。对应的环境变量则始终以 MEILI_EXPERIMENTAL 开头。

通过这种方式激活或停用实验性功能需要重启 Meilisearch 服务。

在运行时激活实验性功能

部分实验性功能可以通过 /experimental-features API 路由 使用 HTTP 调用激活:

curl \
  -X PATCH 'MEILISEARCH_URL/experimental-features/' \
  -H 'Content-Type: application/json'  \
  --data-binary '{
    "metrics": true
  }'

通过这种方式激活或停用实验性功能无需重启 Meilisearch。

当前实验性功能

名称描述配置方式
限制任务批次大小限制单批次处理的任务数量CLI 参数或环境变量
日志自定义自定义日志输出并设置日志流CLI 参数或环境变量,API 路由
指标 API提供 Prometheus 兼容的分析数据CLI 参数或环境变量,API 路由
减少索引内存使用优化索引性能CLI 参数或环境变量
复制参数调整任务处理以适应集群兼容性CLI 参数或环境变量
搜索队列大小配置最大并发搜索请求数CLI 参数或环境变量
CONTAINS 过滤运算符启用 CONTAINSfilter 搜索参数的配合使用API 路由
使用函数编辑文档使用 RHAI 函数直接在 Meilisearch 数据库中编辑文档API 路由
/network 路由启用 /network 路由API 路由
无转储升级无需生成转储文件即可升级 MeilisearchAPI 路由
复合嵌入器启用复合嵌入器API 路由
搜索查询嵌入缓存启用搜索查询嵌入缓存CLI 参数或环境变量
未压缩快照禁用快照压缩CLI 参数或环境变量
最大批次负载大小限制批次负载大小CLI 参数或环境变量