---
title: "样本必须至少有一个连接键，但未找到 - 如何解决此Elasticsearch异常"
date: 2026-02-13
lastmod: 2026-02-13
description: "当Elasticsearch尝试执行连接操作但在样本数据中找不到连接键时，会出现此错误。连接键对于在父子关系或嵌套关系中链接文档至关重要。"
tags: ["Elasticsearch异常", "连接操作", "查询错误", "数据映射"]
summary: " 版本： 8.6-8.9
 简要地说，当Elasticsearch尝试执行连接操作但在样本数据中找不到连接键时，就会出现此错误。连接键对于在父子关系或嵌套关系中链接文档至关重要。要解决此问题，请确保您的数据包含一个连接字段。该字段应正确映射并包含必要的父文档和子文档。此外，检查您的查询以确保它正确引用了连接字段。如果连接字段缺失或引用不正确，Elasticsearch将无法执行连接操作，从而导致此错误。
日志上下文 #  日志 “A sample must have at least one join key; found none” 的类名是 LogicalPlanBuilder.java。 我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人参考：
if (queries.size() < 2) { throw new ParsingException(source; "A sample requires a minimum of 2 queries; found [{}]"; queries.size()); } if (hasMissingJoinKeys) { throw new ParsingException(missingJoinKeysSource; "A sample must have at least one join key; found none"); } return new Sample(source; queries); "
---


> **版本：** 8.6-8.9

简要地说，当Elasticsearch尝试执行连接操作但在样本数据中找不到连接键时，就会出现此错误。连接键对于在父子关系或嵌套关系中链接文档至关重要。要解决此问题，请确保您的数据包含一个连接字段。该字段应正确映射并包含必要的父文档和子文档。此外，检查您的查询以确保它正确引用了连接字段。如果连接字段缺失或引用不正确，Elasticsearch将无法执行连接操作，从而导致此错误。

## 日志上下文

日志 "A sample must have at least one join key; found none" 的类名是 [LogicalPlanBuilder.java。](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/) 我们从Elasticsearch源代码中提取了以下内容，供那些寻求深入上下文的人参考：

```java
if (queries.size() < 2) {
    throw new ParsingException(source; "A sample requires a minimum of 2 queries; found [{}]"; queries.size());
}  
 
if (hasMissingJoinKeys) {
    throw new ParsingException(missingJoinKeysSource; "A sample must have at least one join key; found none");
}  
 
return new Sample(source; queries);
```