- Elasticsearch 指南其他版本
- 8.17 中的新功能
- Elasticsearch 基础
- 快速入门
- 设置 Elasticsearch
- 升级 Elasticsearch
- 索引模块
- 映射
- 文本分析
- 索引模板
- 数据流
- 摄取管道
- 别名
- 搜索您的数据
- 重新排名
- 查询 DSL
- 聚合
- 地理空间分析
- 连接器
- EQL
- ES|QL
- SQL
- 脚本
- 数据管理
- 自动缩放
- 监视集群
- 汇总或转换数据
- 设置高可用性集群
- 快照和还原
- 保护 Elastic Stack 的安全
- Watcher
- 命令行工具
- elasticsearch-certgen
- elasticsearch-certutil
- elasticsearch-create-enrollment-token
- elasticsearch-croneval
- elasticsearch-keystore
- elasticsearch-node
- elasticsearch-reconfigure-node
- elasticsearch-reset-password
- elasticsearch-saml-metadata
- elasticsearch-service-tokens
- elasticsearch-setup-passwords
- elasticsearch-shard
- elasticsearch-syskeygen
- elasticsearch-users
- 优化
- 故障排除
- 修复常见的集群问题
- 诊断未分配的分片
- 向系统中添加丢失的层
- 允许 Elasticsearch 在系统中分配数据
- 允许 Elasticsearch 分配索引
- 索引将索引分配过滤器与数据层节点角色混合,以在数据层之间移动
- 没有足够的节点来分配所有分片副本
- 单个节点上索引的分片总数已超过
- 每个节点的分片总数已达到
- 故障排除损坏
- 修复磁盘空间不足的数据节点
- 修复磁盘空间不足的主节点
- 修复磁盘空间不足的其他角色节点
- 启动索引生命周期管理
- 启动快照生命周期管理
- 从快照恢复
- 故障排除损坏的存储库
- 解决重复的快照策略失败问题
- 故障排除不稳定的集群
- 故障排除发现
- 故障排除监控
- 故障排除转换
- 故障排除 Watcher
- 故障排除搜索
- 故障排除分片容量健康问题
- 故障排除不平衡的集群
- 捕获诊断信息
- REST API
- API 约定
- 通用选项
- REST API 兼容性
- 自动缩放 API
- 行为分析 API
- 紧凑和对齐文本 (CAT) API
- 集群 API
- 跨集群复制 API
- 连接器 API
- 数据流 API
- 文档 API
- 丰富 API
- EQL API
- ES|QL API
- 功能 API
- Fleet API
- 图表探索 API
- 索引 API
- 别名是否存在
- 别名
- 分析
- 分析索引磁盘使用量
- 清除缓存
- 克隆索引
- 关闭索引
- 创建索引
- 创建或更新别名
- 创建或更新组件模板
- 创建或更新索引模板
- 创建或更新索引模板(旧版)
- 删除组件模板
- 删除悬挂索引
- 删除别名
- 删除索引
- 删除索引模板
- 删除索引模板(旧版)
- 存在
- 字段使用情况统计信息
- 刷新
- 强制合并
- 获取别名
- 获取组件模板
- 获取字段映射
- 获取索引
- 获取索引设置
- 获取索引模板
- 获取索引模板(旧版)
- 获取映射
- 导入悬挂索引
- 索引恢复
- 索引段
- 索引分片存储
- 索引统计信息
- 索引模板是否存在(旧版)
- 列出悬挂索引
- 打开索引
- 刷新
- 解析索引
- 解析集群
- 翻转
- 收缩索引
- 模拟索引
- 模拟模板
- 拆分索引
- 解冻索引
- 更新索引设置
- 更新映射
- 索引生命周期管理 API
- 推理 API
- 信息 API
- 摄取 API
- 许可 API
- Logstash API
- 机器学习 API
- 机器学习异常检测 API
- 机器学习数据帧分析 API
- 机器学习训练模型 API
- 迁移 API
- 节点生命周期 API
- 查询规则 API
- 重新加载搜索分析器 API
- 存储库计量 API
- 汇总 API
- 根 API
- 脚本 API
- 搜索 API
- 搜索应用程序 API
- 可搜索快照 API
- 安全 API
- 身份验证
- 更改密码
- 清除缓存
- 清除角色缓存
- 清除权限缓存
- 清除 API 密钥缓存
- 清除服务帐户令牌缓存
- 创建 API 密钥
- 创建或更新应用程序权限
- 创建或更新角色映射
- 创建或更新角色
- 批量创建或更新角色 API
- 批量删除角色 API
- 创建或更新用户
- 创建服务帐户令牌
- 委托 PKI 身份验证
- 删除应用程序权限
- 删除角色映射
- 删除角色
- 删除服务帐户令牌
- 删除用户
- 禁用用户
- 启用用户
- 注册 Kibana
- 注册节点
- 获取 API 密钥信息
- 获取应用程序权限
- 获取内置权限
- 获取角色映射
- 获取角色
- 查询角色
- 获取服务帐户
- 获取服务帐户凭据
- 获取安全设置
- 获取令牌
- 获取用户权限
- 获取用户
- 授予 API 密钥
- 具有权限
- 使 API 密钥失效
- 使令牌失效
- OpenID Connect 准备身份验证
- OpenID Connect 身份验证
- OpenID Connect 注销
- 查询 API 密钥信息
- 查询用户
- 更新 API 密钥
- 更新安全设置
- 批量更新 API 密钥
- SAML 准备身份验证
- SAML 身份验证
- SAML 注销
- SAML 失效
- SAML 完成注销
- SAML 服务提供商元数据
- SSL 证书
- 激活用户配置文件
- 禁用用户配置文件
- 启用用户配置文件
- 获取用户配置文件
- 建议用户配置文件
- 更新用户配置文件数据
- 具有用户配置文件权限
- 创建跨集群 API 密钥
- 更新跨集群 API 密钥
- 快照和还原 API
- 快照生命周期管理 API
- SQL API
- 同义词 API
- 文本结构 API
- 转换 API
- 使用情况 API
- Watcher API
- 定义
- 迁移指南
- 发行说明
- Elasticsearch 版本 8.17.0
- Elasticsearch 版本 8.16.1
- Elasticsearch 版本 8.16.0
- Elasticsearch 版本 8.15.5
- Elasticsearch 版本 8.15.4
- Elasticsearch 版本 8.15.3
- Elasticsearch 版本 8.15.2
- Elasticsearch 版本 8.15.1
- Elasticsearch 版本 8.15.0
- Elasticsearch 版本 8.14.3
- Elasticsearch 版本 8.14.2
- Elasticsearch 版本 8.14.1
- Elasticsearch 版本 8.14.0
- Elasticsearch 版本 8.13.4
- Elasticsearch 版本 8.13.3
- Elasticsearch 版本 8.13.2
- Elasticsearch 版本 8.13.1
- Elasticsearch 版本 8.13.0
- Elasticsearch 版本 8.12.2
- Elasticsearch 版本 8.12.1
- Elasticsearch 版本 8.12.0
- Elasticsearch 版本 8.11.4
- Elasticsearch 版本 8.11.3
- Elasticsearch 版本 8.11.2
- Elasticsearch 版本 8.11.1
- Elasticsearch 版本 8.11.0
- Elasticsearch 版本 8.10.4
- Elasticsearch 版本 8.10.3
- Elasticsearch 版本 8.10.2
- Elasticsearch 版本 8.10.1
- Elasticsearch 版本 8.10.0
- Elasticsearch 版本 8.9.2
- Elasticsearch 版本 8.9.1
- Elasticsearch 版本 8.9.0
- Elasticsearch 版本 8.8.2
- Elasticsearch 版本 8.8.1
- Elasticsearch 版本 8.8.0
- Elasticsearch 版本 8.7.1
- Elasticsearch 版本 8.7.0
- Elasticsearch 版本 8.6.2
- Elasticsearch 版本 8.6.1
- Elasticsearch 版本 8.6.0
- Elasticsearch 版本 8.5.3
- Elasticsearch 版本 8.5.2
- Elasticsearch 版本 8.5.1
- Elasticsearch 版本 8.5.0
- Elasticsearch 版本 8.4.3
- Elasticsearch 版本 8.4.2
- Elasticsearch 版本 8.4.1
- Elasticsearch 版本 8.4.0
- Elasticsearch 版本 8.3.3
- Elasticsearch 版本 8.3.2
- Elasticsearch 版本 8.3.1
- Elasticsearch 版本 8.3.0
- Elasticsearch 版本 8.2.3
- Elasticsearch 版本 8.2.2
- Elasticsearch 版本 8.2.1
- Elasticsearch 版本 8.2.0
- Elasticsearch 版本 8.1.3
- Elasticsearch 版本 8.1.2
- Elasticsearch 版本 8.1.1
- Elasticsearch 版本 8.1.0
- Elasticsearch 版本 8.0.1
- Elasticsearch 版本 8.0.0
- Elasticsearch 版本 8.0.0-rc2
- Elasticsearch 版本 8.0.0-rc1
- Elasticsearch 版本 8.0.0-beta1
- Elasticsearch 版本 8.0.0-alpha2
- Elasticsearch 版本 8.0.0-alpha1
- 依赖项和版本
检索器
编辑检索器
编辑检索器是在 8.14.0 版本中添加到 Search API 的一个抽象概念,并在 8.16.0 版本中正式发布。此抽象概念允许在单个 _search
调用中配置多阶段检索管道。这简化了您的搜索应用程序逻辑,因为您不再需要通过多次 Elasticsearch 调用配置复杂的搜索,或实现额外的客户端逻辑来合并来自不同查询的结果。
本文档提供了检索器抽象的总体概述。有关实现细节,包括重要的限制,请查阅 _search
API 文档中的 参考文档。
检索器类型
编辑检索器有多种类型,每种类型都针对不同的搜索操作量身定制。目前可用的检索器如下:
-
标准检索器。从传统的 查询返回排名靠前的文档。模拟传统的查询,但在检索器框架的上下文中进行。这确保了向后兼容性,因为仍然支持现有的
_search
请求。这样,您就可以按照自己的节奏过渡到新的抽象概念,而无需混合语法。 - kNN 检索器。在检索器框架的上下文中,从 knn 搜索返回排名靠前的文档。
-
RRF 检索器。使用倒数排名融合 (RRF) 算法合并和排名多个第一阶段检索器。允许您将具有不同相关性指标的多个结果集合并为一个结果集。RRF 检索器是一个 复合检索器,它的
filter
元素会传播到其子检索器。 - 规则检索器。在返回结果之前,将 查询规则应用于查询。
-
文本相似度重排序器检索器。用于语义重排序。需要先使用 Elasticsearch 推理 API 创建
rerank
任务。
检索器有何用处?
编辑以下概述了检索器的用途及其与常规查询的不同之处。
- 简化的用户体验。检索器允许在单个 API 调用中配置整个检索管道,从而简化用户体验。通过自动将传统的查询元素转换为相应的检索器,它保持了与传统查询元素的向后兼容性。
- 结构化检索。检索器提供了一种更结构化的方式来定义搜索操作。它们允许使用“检索器树”来描述搜索,这是一种分层结构,可以清楚地说明操作的顺序和逻辑,使复杂的搜索更易于理解和管理。
- 可组合性和灵活性。检索器支持灵活的可组合性,允许您构建管道,并将不同的检索策略无缝集成到这些管道中。检索器使测试不同的检索策略组合变得容易。
- 复合操作。一个检索器可以有子检索器。这允许复杂的嵌套搜索,其中一个检索器的结果馈入另一个检索器,从而支持可能涉及多个阶段或标准的复杂查询策略。
- 将检索作为第一类概念。与传统的查询(其中查询是更大的搜索 API 调用的一部分)不同,检索器被设计为可以组合或单独使用的独立实体。这使得构建搜索的方法更加模块化和灵活。
-
增强了对文档评分和排名的控制。检索器允许更明确地控制文档的评分和过滤方式。例如,您可以指定最低评分阈值,应用复杂的过滤器而不影响评分,并使用诸如
terminate_after
之类的参数进行性能优化。 -
与现有 Elasticsearch 功能集成。即使可以使用检索器来代替现有的
_search
API 语法(如query
和knn
),它们也被设计为与分页 (search_after
) 和排序等功能无缝集成。通过将所有叶检索器的组合视为布尔查询中的should
子句,它们也保持了与聚合操作的兼容性。 - 更清晰的关注点分离。当使用复合检索器时,只允许使用查询元素,这强制执行更清晰的关注点分离,并防止可能因过度嵌套或相互依赖的配置而引起的复杂性。
示例
编辑以下示例演示了如何使用检索器来简化 RRF 排名查询的可组合性。
GET example-index/_search { "retriever": { "rrf": { "retrievers": [ { "standard": { "query": { "sparse_vector": { "field": "vector.tokens", "inference_id": "my-elser-endpoint", "query": "What blue shoes are on sale?" } } } }, { "standard": { "query": { "match": { "text": "blue shoes sale" } } } } ] } } }
此示例演示了如何将不同的检索策略组合到单个 retriever
管道中。
与使用 sub_searches
方法的 RRF
相比(该方法在 8.16.0 版本中已弃用)
展开查看示例
GET example-index/_search { "sub_searches":[ { "query":{ "match":{ "text":"blue shoes sale" } } }, { "query":{ "sparse_vector": { "field": "vector.tokens", "inference_id": "my-elser-endoint", "query": "What blue shoes are on sale?" } } } ], "rank":{ "rrf":{ "rank_window_size":50, "rank_constant":20 } } }
有关如何使用检索器的更多示例,请参阅 检索器示例。
词汇表
编辑以下是一些重要术语
- 检索管道。定义用于生成排名靠前的命中的整个检索和排名逻辑。
- 检索器树。定义检索器如何交互的分层结构。
- 第一阶段检索器。返回候选文档的初始集合。
- 复合检索器。基于一个或多个检索器构建,增强文档检索和排名逻辑。
- 组合器。合并来自多个子检索器的排名靠前的命中的复合检索器。
- 重排序器。特殊的复合检索器,用于重新排序命中,并可能调整命中次数,区分第一阶段重排序器和第二阶段重排序器。
检索器在实践中
编辑搜索 Playground 使用检索器抽象来构建 Elasticsearch 查询。它会自动检测索引中的字段和类型,并根据您的选择构建检索器树。
您可以使用 Playground 来试验不同的检索器配置,并查看它们如何影响搜索结果。
有关详细信息,请参阅Playground 文档。
API 参考
编辑有关实现细节,包括重要的限制,请查阅 Search API 文档中的 参考文档。
Was this helpful?
Thank you for your feedback.