ESQL: Skip multivalues in LOOKUP JOIN matches (#120519) (#120646)

Manual 8.x backport of #120519

Author: ivancea

x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/lookup/QueryList.java

@@ -39,9 +39,11 @@
  */
 public abstract class QueryList {
     protected final Block block;
+    protected final boolean onlySingleValues;
 
-    protected QueryList(Block block) {
+    protected QueryList(Block block, boolean onlySingleValues) {
         this.block = block;
+        this.onlySingleValues = onlySingleValues;
     }
 
     /**
@@ -51,6 +53,12 @@ int getPositionCount() {
         return block.getPositionCount();
     }
 
+    /**
+     * Returns a copy of this query list that only returns queries for single-valued positions.
+     * That is, it returns `null` queries for either multivalued or null positions.
+     */
+    public abstract QueryList onlySingleValues();
+
     /**
      * Returns the query at the given position.
      */
@@ -93,7 +101,7 @@ public static QueryList rawTermQueryList(MappedFieldType field, SearchExecutionC
             case COMPOSITE -> throw new IllegalArgumentException("can't read values from [composite] block");
             case UNKNOWN -> throw new IllegalArgumentException("can't read values from [" + block + "]");
         };
-        return new TermQueryList(field, searchExecutionContext, block, blockToJavaObject);
+        return new TermQueryList(field, searchExecutionContext, block, false, blockToJavaObject);
     }
 
     /**
@@ -103,7 +111,7 @@ public static QueryList rawTermQueryList(MappedFieldType field, SearchExecutionC
     public static QueryList ipTermQueryList(MappedFieldType field, SearchExecutionContext searchExecutionContext, BytesRefBlock block) {
         BytesRef scratch = new BytesRef();
         byte[] ipBytes = new byte[InetAddressPoint.BYTES];
-        return new TermQueryList(field, searchExecutionContext, block, offset -> {
+        return new TermQueryList(field, searchExecutionContext, block, false, offset -> {
             final var bytes = block.getBytesRef(offset, scratch);
             if (ipBytes.length != bytes.length) {
                 // Lucene only support 16-byte IP addresses, even IPv4 is encoded in 16 bytes
@@ -123,6 +131,7 @@ public static QueryList dateTermQueryList(MappedFieldType field, SearchExecution
             field,
             searchExecutionContext,
             block,
+            false,
             field instanceof RangeFieldMapper.RangeFieldType rangeFieldType
                 ? offset -> rangeFieldType.dateTimeFormatter().formatMillis(block.getLong(offset))
                 : block::getLong
@@ -133,7 +142,7 @@ public static QueryList dateTermQueryList(MappedFieldType field, SearchExecution
      * Returns a list of geo_shape queries for the given field and the input block.
      */
     public static QueryList geoShapeQueryList(MappedFieldType field, SearchExecutionContext searchExecutionContext, Block block) {
-        return new GeoShapeQueryList(field, searchExecutionContext, block);
+        return new GeoShapeQueryList(field, searchExecutionContext, block, false);
     }
 
     private static class TermQueryList extends QueryList {
@@ -145,18 +154,27 @@ private TermQueryList(
             MappedFieldType field,
             SearchExecutionContext searchExecutionContext,
             Block block,
+            boolean onlySingleValues,
             IntFunction<Object> blockValueReader
         ) {
-            super(block);
+            super(block, onlySingleValues);
             this.field = field;
             this.searchExecutionContext = searchExecutionContext;
             this.blockValueReader = blockValueReader;
         }
 
+        @Override
+        public TermQueryList onlySingleValues() {
+            return new TermQueryList(field, searchExecutionContext, block, true, blockValueReader);
+        }
+
         @Override
         Query getQuery(int position) {
-            final int first = block.getFirstValueIndex(position);
             final int count = block.getValueCount(position);
+            if (onlySingleValues && count != 1) {
+                return null;
+            }
+            final int first = block.getFirstValueIndex(position);
             return switch (count) {
                 case 0 -> null;
                 case 1 -> field.termQuery(blockValueReader.apply(first), searchExecutionContext);
@@ -179,19 +197,32 @@ private static class GeoShapeQueryList extends QueryList {
         private final IntFunction<Geometry> blockValueReader;
         private final IntFunction<Query> shapeQuery;
 
-        private GeoShapeQueryList(MappedFieldType field, SearchExecutionContext searchExecutionContext, Block block) {
-            super(block);
+        private GeoShapeQueryList(
+            MappedFieldType field,
+            SearchExecutionContext searchExecutionContext,
+            Block block,
+            boolean onlySingleValues
+        ) {
+            super(block, onlySingleValues);
 
             this.field = field;
             this.searchExecutionContext = searchExecutionContext;
             this.blockValueReader = blockToGeometry(block);
             this.shapeQuery = shapeQuery();
         }
 
+        @Override
+        public GeoShapeQueryList onlySingleValues() {
+            return new GeoShapeQueryList(field, searchExecutionContext, block, true);
+        }
+
         @Override
         Query getQuery(int position) {
-            final int first = block.getFirstValueIndex(position);
             final int count = block.getValueCount(position);
+            if (onlySingleValues && count != 1) {
+                return null;
+            }
+            final int first = block.getFirstValueIndex(position);
             return switch (count) {
                 case 0 -> null;
                 case 1 -> shapeQuery.apply(first);