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 过滤运算符启用 CONTAINS 与 filter 搜索参数的配合使用API 路由
使用函数编辑文档使用 RHAI 函数直接在 Meilisearch 数据库中编辑文档API 路由
/network 路由启用 /network 路由API 路由
无转储升级无需生成转储文件即可升级 MeilisearchAPI 路由
复合嵌入器启用复合嵌入器API 路由
搜索查询嵌入缓存启用搜索查询嵌入缓存CLI 参数或环境变量
未压缩快照禁用快照压缩CLI 参数或环境变量
最大批次负载大小限制批次负载大小CLI 参数或环境变量