From df01f8124dd26cb545fd1f797fd48bf492a306e3 Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Mon, 16 Dec 2024 12:35:54 +0100
Subject: [PATCH 001/119] Disable test on release builds (#118752)

Fix https://github.com/elastic/elasticsearch/issues/118707

I plan to manually backport this to un-mute the test on 8.x.
---
 .../xpack/esql/optimizer/PhysicalPlanOptimizerTests.java        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
index dc3ae0a3388cb..d0c7a1cd61010 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
@@ -2331,6 +2331,8 @@ public void testVerifierOnMissingReferences() {
     }
 
     public void testVerifierOnMissingReferencesWithBinaryPlans() throws Exception {
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+
         // Do not assert serialization:
         // This will have a LookupJoinExec, which is not serializable because it doesn't leave the coordinator.
         var plan = physicalPlan("""

From cf7edbbc0f08a0584e5690c7acaa33993078d441 Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Mon, 16 Dec 2024 12:40:35 +0100
Subject: [PATCH 002/119] Properly skip datasets with lookup indices (#118753)

Forward-port of https://github.com/elastic/elasticsearch/pull/118682 to
main

This mostly just minimizes the diff; LOOKUP JOIN is enabled on main, so
we don't need to skip the datasets here.
---
 .../xpack/esql/CsvTestsDataLoader.java        | 43 +++++++++++++------
 1 file changed, 30 insertions(+), 13 deletions(-)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
index 3b656ded94dd7..abfe90f80e372 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
@@ -41,7 +41,6 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
-import java.util.stream.Collectors;
 
 import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
 import static org.elasticsearch.xpack.esql.CsvTestUtils.COMMA_ESCAPING_REGEX;
@@ -260,11 +259,22 @@ public static void main(String[] args) throws IOException {
     public static Set<TestsDataset> availableDatasetsForEs(RestClient client, boolean supportsIndexModeLookup) throws IOException {
         boolean inferenceEnabled = clusterHasInferenceEndpoint(client);
 
-        return CSV_DATASET_MAP.values()
-            .stream()
-            .filter(d -> d.requiresInferenceEndpoint == false || inferenceEnabled)
-            .filter(d -> supportsIndexModeLookup || d.indexName.endsWith("_lookup") == false) // TODO: use actual index settings
-            .collect(Collectors.toCollection(HashSet::new));
+        Set<TestsDataset> testDataSets = new HashSet<>();
+
+        for (TestsDataset dataset : CSV_DATASET_MAP.values()) {
+            if ((inferenceEnabled || dataset.requiresInferenceEndpoint == false)
+                && (supportsIndexModeLookup || isLookupDataset(dataset) == false)) {
+                testDataSets.add(dataset);
+            }
+        }
+
+        return testDataSets;
+    }
+
+    public static boolean isLookupDataset(TestsDataset dataset) throws IOException {
+        Settings settings = dataset.readSettingsFile();
+        String mode = settings.get("index.mode");
+        return (mode != null && mode.equalsIgnoreCase("lookup"));
     }
 
     public static void loadDataSetIntoEs(RestClient client, boolean supportsIndexModeLookup) throws IOException {
@@ -354,13 +364,8 @@ private static void load(RestClient client, TestsDataset dataset, Logger logger,
         if (data == null) {
             throw new IllegalArgumentException("Cannot find resource " + dataName);
         }
-        Settings indexSettings = Settings.EMPTY;
-        final String settingName = dataset.settingFileName != null ? "/" + dataset.settingFileName : null;
-        if (settingName != null) {
-            indexSettings = Settings.builder()
-                .loadFromStream(settingName, CsvTestsDataLoader.class.getResourceAsStream(settingName), false)
-                .build();
-        }
+
+        Settings indexSettings = dataset.readSettingsFile();
         indexCreator.createIndex(client, dataset.indexName, readMappingFile(mapping, dataset.typeMapping), indexSettings);
         loadCsvData(client, dataset.indexName, data, dataset.allowSubFields, logger);
     }
@@ -669,6 +674,18 @@ public TestsDataset withTypeMapping(Map<String, String> typeMapping) {
         public TestsDataset withInferenceEndpoint(boolean needsInference) {
             return new TestsDataset(indexName, mappingFileName, dataFileName, settingFileName, allowSubFields, typeMapping, needsInference);
         }
+
+        private Settings readSettingsFile() throws IOException {
+            Settings indexSettings = Settings.EMPTY;
+            final String settingName = settingFileName != null ? "/" + settingFileName : null;
+            if (settingName != null) {
+                indexSettings = Settings.builder()
+                    .loadFromStream(settingName, CsvTestsDataLoader.class.getResourceAsStream(settingName), false)
+                    .build();
+            }
+
+            return indexSettings;
+        }
     }
 
     public record EnrichConfig(String policyName, String policyFileName) {}

From b461baf1965e7da69c92bca8c97f50ef62bb8c53 Mon Sep 17 00:00:00 2001
From: Tanguy Leroux <tlrx.dev@gmail.com>
Date: Mon, 16 Dec 2024 12:46:36 +0100
Subject: [PATCH 003/119] Skip translog creation and Lucene commits when
 recovering searchable snapshot shards (#118606)

In order to leverage Lucene N-2 version support for searchable snapshots,
we'd like to avoid executing Lucene commits during searchable snapshots
shards recovery. This is because Lucene commits require to open an
IndexWriter, something that Lucene does not support for N-2 versions.

Today when searchable snapshot shards are recovering they create a
translog on disk as well as a Lucene commit:
- the translog is created as an empty translog with a new UUID and an
initial global checkpoint value that is the same as the LOCAL_CHECKPOINT_KEY
stored in the last Lucene commit data from the snapshot.
- a Lucene commit is executed to associate the translog with the Lucene
index by storing new translog UUID in the Lucene commit data.
- later during recovery, the replication tracker is initialized with a global
checkpoint value equals to the LOCAL_CHECKPOINT_KEY stored in the
Lucene commit.

We can skip the creation of the translog because searchable snapshot
shard do not need one, and it's only use to store the local checkpoint
locally to be read later during recovery. If we don't have a translog then
we don't need to associate it with the Lucene index, so we can skip the
commit too.

This change introduce an hasTranslog method that is used to know
when it is safe to NOT create a translog, in which case the global
checkpoint is read from the last Lucene commit during primary shard
recovery from snapshot, peer-recovery and recovery from existing store.

In case an existing translog exist on disk, it will be cleaned up.

They are also few discoveries around some assertions introduced with
snapshot based recoveries, as well as a cached estimation of the size
of directories that was refreshed due to Lucene commit but now
requires to be "marked as stale".
---
 .../index/engine/NoOpEngine.java              |  2 +-
 .../index/engine/ReadOnlyEngine.java          |  3 +-
 .../elasticsearch/index/shard/IndexShard.java | 43 ++++++++++++---
 .../index/shard/StoreRecovery.java            | 53 ++++++++++++-------
 .../index/store/ByteSizeCachingDirectory.java | 27 ++++++++--
 .../org/elasticsearch/index/store/Store.java  |  2 +
 .../index/translog/Translog.java              |  4 ++
 .../index/translog/TranslogConfig.java        |  9 ++++
 .../recovery/PeerRecoveryTargetService.java   | 15 ++----
 .../indices/recovery/RecoveryTarget.java      | 39 ++++++++++----
 .../xpack/lucene/bwc/OldLuceneVersions.java   |  8 +++
 .../xpack/lucene/bwc/OldSegmentInfos.java     |  4 ++
 .../BaseSearchableSnapshotsIntegTestCase.java | 19 ++++---
 .../FrozenSearchableSnapshotsIntegTests.java  | 10 +---
 .../SearchableSnapshotIndexEventListener.java |  7 +++
 15 files changed, 175 insertions(+), 70 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java b/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java
index 8dee39f7050cb..49e0ae0587085 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/NoOpEngine.java
@@ -48,7 +48,7 @@ public final class NoOpEngine extends ReadOnlyEngine {
     public NoOpEngine(EngineConfig config) {
         this(
             config,
-            config.isPromotableToPrimary() ? null : new TranslogStats(0, 0, 0, 0, 0),
+            config.isPromotableToPrimary() && config.getTranslogConfig().hasTranslog() ? null : new TranslogStats(0, 0, 0, 0, 0),
             config.isPromotableToPrimary()
                 ? null
                 : new SeqNoStats(
diff --git a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
index c1d11223fa55e..1d032c1f400ef 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/ReadOnlyEngine.java
@@ -98,7 +98,7 @@ public class ReadOnlyEngine extends Engine {
     public ReadOnlyEngine(
         EngineConfig config,
         SeqNoStats seqNoStats,
-        TranslogStats translogStats,
+        @Nullable TranslogStats translogStats,
         boolean obtainLock,
         Function<DirectoryReader, DirectoryReader> readerWrapperFunction,
         boolean requireCompleteHistory,
@@ -251,6 +251,7 @@ private static SeqNoStats buildSeqNoStats(EngineConfig config, SegmentInfos info
     }
 
     private static TranslogStats translogStats(final EngineConfig config, final SegmentInfos infos) throws IOException {
+        assert config.getTranslogConfig().hasTranslog();
         final String translogUuid = infos.getUserData().get(Translog.TRANSLOG_UUID_KEY);
         if (translogUuid == null) {
             throw new IllegalStateException("commit doesn't contain translog unique id");
diff --git a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
index a76feff84e61b..966764d2797c9 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
@@ -1487,6 +1487,27 @@ public void flush(FlushRequest request, ActionListener<Boolean> listener) {
         });
     }
 
+    /**
+     * @return true the shard has a translog.
+     */
+    public boolean hasTranslog() {
+        return translogConfig.hasTranslog();
+    }
+
+    /**
+     * Reads the global checkpoint from the translog checkpoint file if the shard has a translog. Otherwise, reads the local checkpoint from
+     * the provided commit user data.
+     *
+     * @return the global checkpoint to use for recovery
+     * @throws IOException
+     */
+    public long readGlobalCheckpointForRecovery(Map<String, String> commitUserData) throws IOException {
+        if (hasTranslog()) {
+            return Translog.readGlobalCheckpoint(translogConfig.getTranslogPath(), commitUserData.get(Translog.TRANSLOG_UUID_KEY));
+        }
+        return Long.parseLong(commitUserData.get(SequenceNumbers.LOCAL_CHECKPOINT_KEY));
+    }
+
     /**
      * checks and removes translog files that no longer need to be retained. See
      * {@link org.elasticsearch.index.translog.TranslogDeletionPolicy} for details
@@ -1859,8 +1880,7 @@ public void recoverLocallyUpToGlobalCheckpoint(ActionListener<Long> recoveryStar
         }
         assert routingEntry().recoverySource().getType() == RecoverySource.Type.PEER : "not a peer recovery [" + routingEntry() + "]";
         try {
-            final var translogUUID = store.readLastCommittedSegmentsInfo().getUserData().get(Translog.TRANSLOG_UUID_KEY);
-            final var globalCheckpoint = Translog.readGlobalCheckpoint(translogConfig.getTranslogPath(), translogUUID);
+            final var globalCheckpoint = readGlobalCheckpointForRecovery(store.readLastCommittedSegmentsInfo().getUserData());
             final var safeCommit = store.findSafeIndexCommit(globalCheckpoint);
             ActionListener.run(recoveryStartingSeqNoListener.delegateResponse((l, e) -> {
                 logger.debug(() -> format("failed to recover shard locally up to global checkpoint %s", globalCheckpoint), e);
@@ -2084,8 +2104,7 @@ private void loadGlobalCheckpointToReplicationTracker() throws IOException {
             // we have to set it before we open an engine and recover from the translog because
             // acquiring a snapshot from the translog causes a sync which causes the global checkpoint to be pulled in,
             // and an engine can be forced to close in ctor which also causes the global checkpoint to be pulled in.
-            final String translogUUID = store.readLastCommittedSegmentsInfo().getUserData().get(Translog.TRANSLOG_UUID_KEY);
-            final long globalCheckpoint = Translog.readGlobalCheckpoint(translogConfig.getTranslogPath(), translogUUID);
+            final long globalCheckpoint = readGlobalCheckpointForRecovery(store.readLastCommittedSegmentsInfo().getUserData());
             replicationTracker.updateGlobalCheckpointOnReplica(globalCheckpoint, "read from translog checkpoint");
         } else {
             replicationTracker.updateGlobalCheckpointOnReplica(globalCheckPointIfUnpromotable, "from CleanFilesRequest");
@@ -2162,7 +2181,7 @@ private void innerOpenEngineAndTranslog(LongSupplier globalCheckpointSupplier) t
         // time elapses after the engine is created above (pulling the config settings) until we set the engine reference, during
         // which settings changes could possibly have happened, so here we forcefully push any config changes to the new engine.
         onSettingsChanged();
-        assert assertSequenceNumbersInCommit();
+        assert assertLastestCommitUserData();
         recoveryState.validateCurrentStage(RecoveryState.Stage.TRANSLOG);
         checkAndCallWaitForEngineOrClosedShardListeners();
     }
@@ -2183,9 +2202,13 @@ private Engine createEngine(EngineConfig config) {
         }
     }
 
-    private boolean assertSequenceNumbersInCommit() throws IOException {
+    /**
+     * Asserts that the latest Lucene commit contains expected information about sequence numbers or ES version.
+     */
+    private boolean assertLastestCommitUserData() throws IOException {
         final SegmentInfos segmentCommitInfos = SegmentInfos.readLatestCommit(store.directory());
         final Map<String, String> userData = segmentCommitInfos.getUserData();
+        // Ensure sequence numbers are present in commit data
         assert userData.containsKey(SequenceNumbers.LOCAL_CHECKPOINT_KEY) : "commit point doesn't contains a local checkpoint";
         assert userData.containsKey(SequenceNumbers.MAX_SEQ_NO) : "commit point doesn't contains a maximum sequence number";
         assert userData.containsKey(Engine.HISTORY_UUID_KEY) : "commit point doesn't contains a history uuid";
@@ -2195,10 +2218,16 @@ private boolean assertSequenceNumbersInCommit() throws IOException {
                 + "] is different than engine ["
                 + getHistoryUUID()
                 + "]";
+
         assert userData.containsKey(Engine.MAX_UNSAFE_AUTO_ID_TIMESTAMP_COMMIT_ID)
             : "opening index which was created post 5.5.0 but " + Engine.MAX_UNSAFE_AUTO_ID_TIMESTAMP_COMMIT_ID + " is not found in commit";
+
+        // From 7.16.0, the ES version is included in the Lucene commit user data as well as in the snapshot metadata in the repository.
+        // This is used during primary failover to detect if the latest snapshot can be used to recover the new primary, because the failed
+        // primary may have created new segments in a more recent Lucene version, that may have been later snapshotted, meaning that the
+        // snapshotted files cannot be recovered on a node with a less recent Lucene version. Note that for versions <= 7.15 this assertion
+        // relies in the previous minor having a different lucene version.
         final org.apache.lucene.util.Version commitLuceneVersion = segmentCommitInfos.getCommitLuceneVersion();
-        // This relies in the previous minor having another lucene version
         assert commitLuceneVersion.onOrAfter(RecoverySettings.SEQ_NO_SNAPSHOT_RECOVERIES_SUPPORTED_VERSION.luceneVersion()) == false
             || userData.containsKey(Engine.ES_VERSION)
                 && Engine.readIndexVersion(userData.get(Engine.ES_VERSION)).onOrBefore(IndexVersion.current())
diff --git a/server/src/main/java/org/elasticsearch/index/shard/StoreRecovery.java b/server/src/main/java/org/elasticsearch/index/shard/StoreRecovery.java
index 42f62cf86545b..06f9b3e6c8943 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/StoreRecovery.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/StoreRecovery.java
@@ -315,7 +315,7 @@ void recoverFromRepository(final IndexShard indexShard, Repository repository, A
                 RecoverySource.Type recoveryType = indexShard.recoveryState().getRecoverySource().getType();
                 assert recoveryType == RecoverySource.Type.SNAPSHOT : "expected snapshot recovery type: " + recoveryType;
                 SnapshotRecoverySource recoverySource = (SnapshotRecoverySource) indexShard.recoveryState().getRecoverySource();
-                restore(indexShard, repository, recoverySource, recoveryListener(indexShard, listener).map(ignored -> true));
+                recoverFromRepository(indexShard, repository, recoverySource, recoveryListener(indexShard, listener).map(ignored -> true));
             } else {
                 listener.onResponse(false);
             }
@@ -459,7 +459,7 @@ private void internalRecoverFromStore(IndexShard indexShard, ActionListener<Void
                 }
                 if (recoveryState.getRecoverySource().getType() == RecoverySource.Type.LOCAL_SHARDS) {
                     assert indexShouldExists;
-                    bootstrap(indexShard, store);
+                    bootstrap(indexShard);
                     writeEmptyRetentionLeasesFile(indexShard);
                 } else if (indexShouldExists) {
                     if (recoveryState.getRecoverySource().shouldBootstrapNewHistoryUUID()) {
@@ -523,12 +523,13 @@ private static void addRecoveredFileDetails(SegmentInfos si, Store store, Recove
     /**
      * Restores shard from {@link SnapshotRecoverySource} associated with this shard in routing table
      */
-    private void restore(
+    private void recoverFromRepository(
         IndexShard indexShard,
         Repository repository,
         SnapshotRecoverySource restoreSource,
         ActionListener<Void> outerListener
     ) {
+        assert indexShard.shardRouting.primary() : "only primary shards can recover from snapshot";
         logger.debug("restoring from {} ...", indexShard.recoveryState().getRecoverySource());
 
         record ShardAndIndexIds(IndexId indexId, ShardId shardId) {}
@@ -538,13 +539,13 @@ record ShardAndIndexIds(IndexId indexId, ShardId shardId) {}
             .newForked(indexShard::preRecovery)
 
             .<ShardAndIndexIds>andThen(shardAndIndexIdsListener -> {
-                final RecoveryState.Translog translogState = indexShard.recoveryState().getTranslog();
                 if (restoreSource == null) {
                     throw new IndexShardRestoreFailedException(shardId, "empty restore source");
                 }
                 if (logger.isTraceEnabled()) {
                     logger.trace("[{}] restoring shard [{}]", restoreSource.snapshot(), shardId);
                 }
+                final RecoveryState.Translog translogState = indexShard.recoveryState().getTranslog();
                 translogState.totalOperations(0);
                 translogState.totalOperationsOnStart(0);
                 indexShard.prepareForIndexRecovery();
@@ -588,9 +589,7 @@ record ShardAndIndexIds(IndexId indexId, ShardId shardId) {}
 
             .<Void>andThen(l -> {
                 indexShard.getIndexEventListener().afterFilesRestoredFromRepository(indexShard);
-                final Store store = indexShard.store();
-                bootstrap(indexShard, store);
-                assert indexShard.shardRouting.primary() : "only primary shards can recover from store";
+                bootstrap(indexShard);
                 writeEmptyRetentionLeasesFile(indexShard);
                 indexShard.openEngineAndRecoverFromTranslog(l);
             })
@@ -610,19 +609,37 @@ record ShardAndIndexIds(IndexId indexId, ShardId shardId) {}
             }));
     }
 
+    /**
+     * @deprecated use {@link #bootstrap(IndexShard)} instead
+     */
+    @Deprecated(forRemoval = true)
     public static void bootstrap(final IndexShard indexShard, final Store store) throws IOException {
-        if (indexShard.indexSettings.getIndexMetadata().isSearchableSnapshot() == false) {
-            // not bootstrapping new history for searchable snapshots (which are read-only) allows sequence-number based peer recoveries
+        assert indexShard.store() == store;
+        bootstrap(indexShard);
+    }
+
+    private static void bootstrap(final IndexShard indexShard) throws IOException {
+        assert indexShard.routingEntry().primary();
+        final var store = indexShard.store();
+        store.incRef();
+        try {
+            final var translogLocation = indexShard.shardPath().resolveTranslog();
+            if (indexShard.hasTranslog() == false) {
+                Translog.deleteAll(translogLocation);
+                return;
+            }
             store.bootstrapNewHistory();
+            final SegmentInfos segmentInfos = store.readLastCommittedSegmentsInfo();
+            final long localCheckpoint = Long.parseLong(segmentInfos.userData.get(SequenceNumbers.LOCAL_CHECKPOINT_KEY));
+            final String translogUUID = Translog.createEmptyTranslog(
+                translogLocation,
+                localCheckpoint,
+                indexShard.shardId(),
+                indexShard.getPendingPrimaryTerm()
+            );
+            store.associateIndexWithNewTranslog(translogUUID);
+        } finally {
+            store.decRef();
         }
-        final SegmentInfos segmentInfos = store.readLastCommittedSegmentsInfo();
-        final long localCheckpoint = Long.parseLong(segmentInfos.userData.get(SequenceNumbers.LOCAL_CHECKPOINT_KEY));
-        final String translogUUID = Translog.createEmptyTranslog(
-            indexShard.shardPath().resolveTranslog(),
-            localCheckpoint,
-            indexShard.shardId(),
-            indexShard.getPendingPrimaryTerm()
-        );
-        store.associateIndexWithNewTranslog(translogUUID);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/store/ByteSizeCachingDirectory.java b/server/src/main/java/org/elasticsearch/index/store/ByteSizeCachingDirectory.java
index 166f0eadc62b4..033859bd62128 100644
--- a/server/src/main/java/org/elasticsearch/index/store/ByteSizeCachingDirectory.java
+++ b/server/src/main/java/org/elasticsearch/index/store/ByteSizeCachingDirectory.java
@@ -10,6 +10,7 @@
 package org.elasticsearch.index.store;
 
 import org.apache.lucene.store.Directory;
+import org.apache.lucene.store.FilterDirectory;
 import org.apache.lucene.store.IOContext;
 import org.apache.lucene.store.IndexOutput;
 import org.elasticsearch.common.lucene.store.FilterIndexOutput;
@@ -19,7 +20,7 @@
 import java.io.IOException;
 import java.io.UncheckedIOException;
 
-final class ByteSizeCachingDirectory extends ByteSizeDirectory {
+public final class ByteSizeCachingDirectory extends ByteSizeDirectory {
 
     private static class SizeAndModCount {
         final long size;
@@ -174,9 +175,29 @@ public void deleteFile(String name) throws IOException {
         try {
             super.deleteFile(name);
         } finally {
-            synchronized (this) {
-                modCount++;
+            markEstimatedSizeAsStale();
+        }
+    }
+
+    /**
+     * Mark the cached size as stale so that it is guaranteed to be refreshed the next time.
+     */
+    public void markEstimatedSizeAsStale() {
+        synchronized (this) {
+            modCount++;
+        }
+    }
+
+    public static ByteSizeCachingDirectory unwrapDirectory(Directory dir) {
+        while (dir != null) {
+            if (dir instanceof ByteSizeCachingDirectory) {
+                return (ByteSizeCachingDirectory) dir;
+            } else if (dir instanceof FilterDirectory) {
+                dir = ((FilterDirectory) dir).getDelegate();
+            } else {
+                dir = null;
             }
         }
+        return null;
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/store/Store.java b/server/src/main/java/org/elasticsearch/index/store/Store.java
index e6b499c07f189..322064f09cf77 100644
--- a/server/src/main/java/org/elasticsearch/index/store/Store.java
+++ b/server/src/main/java/org/elasticsearch/index/store/Store.java
@@ -1449,6 +1449,7 @@ public void bootstrapNewHistory() throws IOException {
      * @see SequenceNumbers#MAX_SEQ_NO
      */
     public void bootstrapNewHistory(long localCheckpoint, long maxSeqNo) throws IOException {
+        assert indexSettings.getIndexMetadata().isSearchableSnapshot() == false;
         metadataLock.writeLock().lock();
         try (IndexWriter writer = newTemporaryAppendingIndexWriter(directory, null)) {
             final Map<String, String> map = new HashMap<>();
@@ -1572,6 +1573,7 @@ private IndexWriter newTemporaryEmptyIndexWriter(final Directory dir, final Vers
     }
 
     private IndexWriterConfig newTemporaryIndexWriterConfig() {
+        assert indexSettings.getIndexMetadata().isSearchableSnapshot() == false;
         // this config is only used for temporary IndexWriter instances, used to initialize the index or update the commit data,
         // so we don't want any merges to happen
         var iwc = indexWriterConfigWithNoMerging(null).setSoftDeletesField(Lucene.SOFT_DELETES_FIELD).setCommitOnClose(false);
diff --git a/server/src/main/java/org/elasticsearch/index/translog/Translog.java b/server/src/main/java/org/elasticsearch/index/translog/Translog.java
index 2d3e2d8c20256..75f38ed5f7342 100644
--- a/server/src/main/java/org/elasticsearch/index/translog/Translog.java
+++ b/server/src/main/java/org/elasticsearch/index/translog/Translog.java
@@ -220,6 +220,10 @@ public Translog(
         }
     }
 
+    public static void deleteAll(Path translogLocation) throws IOException {
+        IOUtils.rm(translogLocation);
+    }
+
     /** recover all translog files found on disk */
     private ArrayList<TranslogReader> recoverFromFiles(Checkpoint checkpoint) throws IOException {
         boolean success = false;
diff --git a/server/src/main/java/org/elasticsearch/index/translog/TranslogConfig.java b/server/src/main/java/org/elasticsearch/index/translog/TranslogConfig.java
index 66018092089ce..280e319335b12 100644
--- a/server/src/main/java/org/elasticsearch/index/translog/TranslogConfig.java
+++ b/server/src/main/java/org/elasticsearch/index/translog/TranslogConfig.java
@@ -143,4 +143,13 @@ public OperationListener getOperationListener() {
     public boolean fsync() {
         return fsync;
     }
+
+    /**
+     * @return {@code true} if the configuration allows the Translog files to exist, {@code false} otherwise. In the case there is no
+     * translog, the shard is not writeable.
+     */
+    public boolean hasTranslog() {
+        // Expect no translog files to exist for searchable snapshots
+        return false == indexSettings.getIndexMetadata().isSearchableSnapshot();
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/PeerRecoveryTargetService.java b/server/src/main/java/org/elasticsearch/indices/recovery/PeerRecoveryTargetService.java
index c8d31d2060caf..d069717a66ad0 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/PeerRecoveryTargetService.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/PeerRecoveryTargetService.java
@@ -49,9 +49,7 @@
 import org.elasticsearch.index.shard.ShardId;
 import org.elasticsearch.index.shard.ShardLongFieldRange;
 import org.elasticsearch.index.shard.ShardNotFoundException;
-import org.elasticsearch.index.shard.StoreRecovery;
 import org.elasticsearch.index.store.Store;
-import org.elasticsearch.index.translog.Translog;
 import org.elasticsearch.index.translog.TranslogCorruptedException;
 import org.elasticsearch.indices.recovery.RecoveriesCollection.RecoveryRef;
 import org.elasticsearch.tasks.Task;
@@ -385,15 +383,8 @@ record StartRecoveryRequestToSend(StartRecoveryRequest startRecoveryRequest, Str
                     logger.trace("{} preparing shard for peer recovery", recoveryTarget.shardId());
                     indexShard.prepareForIndexRecovery();
                     if (indexShard.indexSettings().getIndexMetadata().isSearchableSnapshot()) {
-                        // for searchable snapshots, peer recovery is treated similarly to recovery from snapshot
+                        // for archives indices mounted as searchable snapshots, we need to call this
                         indexShard.getIndexEventListener().afterFilesRestoredFromRepository(indexShard);
-                        final Store store = indexShard.store();
-                        store.incRef();
-                        try {
-                            StoreRecovery.bootstrap(indexShard, store);
-                        } finally {
-                            store.decRef();
-                        }
                     }
                     indexShard.recoverLocallyUpToGlobalCheckpoint(ActionListener.assertOnce(l));
                 })
@@ -488,8 +479,8 @@ public static StartRecoveryRequest getStartRecoveryRequest(
                 // Make sure that the current translog is consistent with the Lucene index; otherwise, we have to throw away the Lucene
                 // index.
                 try {
-                    final String expectedTranslogUUID = metadataSnapshot.commitUserData().get(Translog.TRANSLOG_UUID_KEY);
-                    final long globalCheckpoint = Translog.readGlobalCheckpoint(recoveryTarget.translogLocation(), expectedTranslogUUID);
+                    final long globalCheckpoint = recoveryTarget.indexShard()
+                        .readGlobalCheckpointForRecovery(metadataSnapshot.commitUserData());
                     assert globalCheckpoint + 1 >= startingSeqNo : "invalid startingSeqNo " + startingSeqNo + " >= " + globalCheckpoint;
                 } catch (IOException | TranslogCorruptedException e) {
                     logGlobalCheckpointWarning(logger, startingSeqNo, e);
diff --git a/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java b/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java
index ea485a411143e..362a62c838e3b 100644
--- a/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java
+++ b/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryTarget.java
@@ -45,7 +45,6 @@
 import java.io.FilterInputStream;
 import java.io.IOException;
 import java.io.InputStream;
-import java.nio.file.Path;
 import java.util.List;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicBoolean;
@@ -516,13 +515,7 @@ public void cleanFiles(
             try {
                 if (indexShard.routingEntry().isPromotableToPrimary()) {
                     store.cleanupAndVerify("recovery CleanFilesRequestHandler", sourceMetadata);
-                    final String translogUUID = Translog.createEmptyTranslog(
-                        indexShard.shardPath().resolveTranslog(),
-                        globalCheckpoint,
-                        shardId,
-                        indexShard.getPendingPrimaryTerm()
-                    );
-                    store.associateIndexWithNewTranslog(translogUUID);
+                    bootstrap(indexShard, globalCheckpoint);
                 } else {
                     indexShard.setGlobalCheckpointIfUnpromotable(globalCheckpoint);
                 }
@@ -634,7 +627,33 @@ public String getTempNameForFile(String origFile) {
         return multiFileWriter.getTempNameForFile(origFile);
     }
 
-    Path translogLocation() {
-        return indexShard().shardPath().resolveTranslog();
+    private static void bootstrap(final IndexShard indexShard, long globalCheckpoint) throws IOException {
+        assert indexShard.routingEntry().isPromotableToPrimary();
+        final var store = indexShard.store();
+        store.incRef();
+        try {
+            final var translogLocation = indexShard.shardPath().resolveTranslog();
+            if (indexShard.hasTranslog() == false) {
+                if (Assertions.ENABLED) {
+                    if (indexShard.indexSettings().getIndexMetadata().isSearchableSnapshot()) {
+                        long localCheckpoint = Long.parseLong(
+                            store.readLastCommittedSegmentsInfo().getUserData().get(SequenceNumbers.LOCAL_CHECKPOINT_KEY)
+                        );
+                        assert localCheckpoint == globalCheckpoint : localCheckpoint + " != " + globalCheckpoint;
+                    }
+                }
+                Translog.deleteAll(translogLocation);
+                return;
+            }
+            final String translogUUID = Translog.createEmptyTranslog(
+                indexShard.shardPath().resolveTranslog(),
+                globalCheckpoint,
+                indexShard.shardId(),
+                indexShard.getPendingPrimaryTerm()
+            );
+            store.associateIndexWithNewTranslog(translogUUID);
+        } finally {
+            store.decRef();
+        }
     }
 }
diff --git a/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldLuceneVersions.java b/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldLuceneVersions.java
index 42fe09691d249..e36ae4994c872 100644
--- a/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldLuceneVersions.java
+++ b/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldLuceneVersions.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.engine.Engine;
 import org.elasticsearch.index.engine.EngineFactory;
 import org.elasticsearch.index.engine.ReadOnlyEngine;
@@ -34,6 +35,7 @@
 import org.elasticsearch.index.shard.IndexEventListener;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.translog.TranslogStats;
+import org.elasticsearch.indices.recovery.RecoverySettings;
 import org.elasticsearch.license.License;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.license.LicensedFeature;
@@ -201,6 +203,12 @@ private static SegmentInfos convertToNewerLuceneVersion(OldSegmentInfos oldSegme
         if (map.containsKey(Engine.MAX_UNSAFE_AUTO_ID_TIMESTAMP_COMMIT_ID) == false) {
             map.put(Engine.MAX_UNSAFE_AUTO_ID_TIMESTAMP_COMMIT_ID, "-1");
         }
+        if (map.containsKey(Engine.ES_VERSION) == false) {
+            assert oldSegmentInfos.getLuceneVersion()
+                .onOrAfter(RecoverySettings.SEQ_NO_SNAPSHOT_RECOVERIES_SUPPORTED_VERSION.luceneVersion()) == false
+                : oldSegmentInfos.getLuceneVersion() + " should contain the ES_VERSION";
+            map.put(Engine.ES_VERSION, IndexVersions.MINIMUM_COMPATIBLE.toString());
+        }
         segmentInfos.setUserData(map, false);
         for (SegmentCommitInfo infoPerCommit : oldSegmentInfos.asList()) {
             final SegmentInfo newInfo = BWCCodec.wrap(infoPerCommit.info);
diff --git a/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldSegmentInfos.java b/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldSegmentInfos.java
index 18adebb145f98..b2af41653da61 100644
--- a/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldSegmentInfos.java
+++ b/x-pack/plugin/old-lucene-versions/src/main/java/org/elasticsearch/xpack/lucene/bwc/OldSegmentInfos.java
@@ -564,6 +564,10 @@ public long getLastGeneration() {
         return lastGeneration;
     }
 
+    public Version getLuceneVersion() {
+        return luceneVersion;
+    }
+
     /**
      * Prints the given message to the infoStream. Note, this method does not check for null
      * infoStream. It assumes this check has been performed by the caller, which is recommended to
diff --git a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/BaseSearchableSnapshotsIntegTestCase.java b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/BaseSearchableSnapshotsIntegTestCase.java
index 6115bec91ad62..a3ced0bf1b607 100644
--- a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/BaseSearchableSnapshotsIntegTestCase.java
+++ b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/BaseSearchableSnapshotsIntegTestCase.java
@@ -74,7 +74,6 @@
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 import static org.hamcrest.Matchers.instanceOf;
-import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
 
 @ESIntegTestCase.ClusterScope(supportsDedicatedMasters = false, numClientNodes = 0)
@@ -241,7 +240,7 @@ protected void checkSoftDeletesNotEagerlyLoaded(String restoredIndexName) {
         }
     }
 
-    protected void assertShardFolders(String indexName, boolean snapshotDirectory) throws IOException {
+    protected void assertShardFolders(String indexName, boolean isSearchableSnapshot) throws IOException {
         final Index restoredIndex = resolveIndex(indexName);
         final String customDataPath = resolveCustomDataPath(indexName);
         final ShardId shardId = new ShardId(restoredIndex, 0);
@@ -261,16 +260,16 @@ protected void assertShardFolders(String indexName, boolean snapshotDirectory) t
                     translogExists
                 );
                 assertThat(
-                    snapshotDirectory ? "Index file should not exist" : "Index file should exist",
+                    isSearchableSnapshot ? "Index file should not exist" : "Index file should exist",
                     indexExists,
-                    not(snapshotDirectory)
+                    not(isSearchableSnapshot)
                 );
-                assertThat("Translog should exist", translogExists, is(true));
-                try (Stream<Path> dir = Files.list(shardPath.resolveTranslog())) {
-                    final long translogFiles = dir.filter(path -> path.getFileName().toString().contains("translog")).count();
-                    if (snapshotDirectory) {
-                        assertThat("There should be 2 translog files for a snapshot directory", translogFiles, equalTo(2L));
-                    } else {
+                if (isSearchableSnapshot) {
+                    assertThat("Translog should not exist", translogExists, equalTo(false));
+                } else {
+                    assertThat("Translog should exist", translogExists, equalTo(true));
+                    try (Stream<Path> dir = Files.list(shardPath.resolveTranslog())) {
+                        final long translogFiles = dir.filter(path -> path.getFileName().toString().contains("translog")).count();
                         assertThat(
                             "There should be 2+ translog files for a non-snapshot directory",
                             translogFiles,
diff --git a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/FrozenSearchableSnapshotsIntegTests.java b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/FrozenSearchableSnapshotsIntegTests.java
index 67d9d7a82acf3..2797202e5f24e 100644
--- a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/FrozenSearchableSnapshotsIntegTests.java
+++ b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/FrozenSearchableSnapshotsIntegTests.java
@@ -59,7 +59,6 @@
 
 import java.time.ZoneId;
 import java.util.Arrays;
-import java.util.Collections;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -169,12 +168,9 @@ public void testCreateAndRestorePartialSearchableSnapshot() throws Exception {
         logger.info("--> restoring partial index [{}] with cache enabled", restoredIndexName);
 
         Settings.Builder indexSettingsBuilder = Settings.builder().put(SearchableSnapshots.SNAPSHOT_CACHE_ENABLED_SETTING.getKey(), true);
-        final List<String> nonCachedExtensions;
         if (randomBoolean()) {
-            nonCachedExtensions = randomSubsetOf(Arrays.asList("fdt", "fdx", "nvd", "dvd", "tip", "cfs", "dim"));
+            var nonCachedExtensions = randomSubsetOf(Arrays.asList("fdt", "fdx", "nvd", "dvd", "tip", "cfs", "dim"));
             indexSettingsBuilder.putList(SearchableSnapshots.SNAPSHOT_CACHE_EXCLUDED_FILE_TYPES_SETTING.getKey(), nonCachedExtensions);
-        } else {
-            nonCachedExtensions = Collections.emptyList();
         }
         if (randomBoolean()) {
             indexSettingsBuilder.put(
@@ -264,8 +260,6 @@ public void testCreateAndRestorePartialSearchableSnapshot() throws Exception {
             final long originalSize = snapshotShards.get(shardRouting.getId()).getStats().getTotalSize();
             totalExpectedSize += originalSize;
 
-            // an extra segments_N file is created for bootstrapping new history and associating translog. We can extract the size of this
-            // extra file but we have to unwrap the in-memory directory first.
             final Directory unwrappedDir = FilterDirectory.unwrap(
                 internalCluster().getInstance(IndicesService.class, getDiscoveryNodes().resolveNode(shardRouting.currentNodeId()).getName())
                     .indexServiceSafe(shardRouting.index())
@@ -277,7 +271,7 @@ public void testCreateAndRestorePartialSearchableSnapshot() throws Exception {
             assertThat(shardRouting.toString(), unwrappedDir, instanceOf(ByteBuffersDirectory.class));
 
             final ByteBuffersDirectory inMemoryDir = (ByteBuffersDirectory) unwrappedDir;
-            assertThat(inMemoryDir.listAll(), arrayWithSize(1));
+            assertThat(inMemoryDir.listAll(), arrayWithSize(0));
 
             assertThat(shardRouting.toString(), store.totalDataSetSizeInBytes(), equalTo(originalSize));
         }
diff --git a/x-pack/plugin/searchable-snapshots/src/main/java/org/elasticsearch/xpack/searchablesnapshots/allocation/SearchableSnapshotIndexEventListener.java b/x-pack/plugin/searchable-snapshots/src/main/java/org/elasticsearch/xpack/searchablesnapshots/allocation/SearchableSnapshotIndexEventListener.java
index cf0306e3e6ef2..4caf932a99807 100644
--- a/x-pack/plugin/searchable-snapshots/src/main/java/org/elasticsearch/xpack/searchablesnapshots/allocation/SearchableSnapshotIndexEventListener.java
+++ b/x-pack/plugin/searchable-snapshots/src/main/java/org/elasticsearch/xpack/searchablesnapshots/allocation/SearchableSnapshotIndexEventListener.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.index.shard.IndexEventListener;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.index.store.ByteSizeCachingDirectory;
 import org.elasticsearch.indices.cluster.IndicesClusterStateService.AllocatedIndices.IndexRemovalReason;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.searchablesnapshots.SearchableSnapshots;
@@ -61,6 +62,12 @@ public SearchableSnapshotIndexEventListener(
     public void beforeIndexShardRecovery(IndexShard indexShard, IndexSettings indexSettings, ActionListener<Void> listener) {
         assert ThreadPool.assertCurrentThreadPool(ThreadPool.Names.GENERIC);
         ensureSnapshotIsLoaded(indexShard);
+        var sizeCachingDirectory = ByteSizeCachingDirectory.unwrapDirectory(indexShard.store().directory());
+        if (sizeCachingDirectory != null) {
+            // Marks the cached estimation of the directory size as stale in ByteSizeCachingDirectory since we just loaded the snapshot
+            // files list into the searchable snapshot directory.
+            sizeCachingDirectory.markEstimatedSizeAsStale();
+        }
         listener.onResponse(null);
     }
 

From caf8afcb2d412051e6c19ae9ff223d1a396f8aaf Mon Sep 17 00:00:00 2001
From: Ievgen Degtiarenko <ievgen.degtiarenko@elastic.co>
Date: Mon, 16 Dec 2024 13:36:18 +0100
Subject: [PATCH 004/119] Render all datatypes in pipetables error output
 (#118758)

Some types (such as ip or time) require custom formatting logic and were not correctly rendered in actual/expected comparison table.

This change:

* properly formats such data types
* add data types to the column headers
* removes outer pipes
---
 .../elasticsearch/xpack/esql/CsvAssert.java   | 152 +++++++++++-------
 1 file changed, 98 insertions(+), 54 deletions(-)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvAssert.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvAssert.java
index 8a4d44a690571..692c385cef216 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvAssert.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvAssert.java
@@ -8,6 +8,7 @@
 package org.elasticsearch.xpack.esql;
 
 import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.time.DateFormatter;
 import org.elasticsearch.compute.data.Page;
 import org.elasticsearch.logging.Logger;
@@ -197,7 +198,13 @@ public static void assertData(
         for (int row = 0; row < expectedValues.size(); row++) {
             try {
                 if (row >= actualValues.size()) {
-                    dataFailure("Expected more data but no more entries found after [" + row + "]", dataFailures, expected, actualValues);
+                    dataFailure(
+                        "Expected more data but no more entries found after [" + row + "]",
+                        dataFailures,
+                        expected,
+                        actualValues,
+                        valueTransformer
+                    );
                 }
 
                 if (logger != null) {
@@ -208,45 +215,17 @@ public static void assertData(
                 var actualRow = actualValues.get(row);
 
                 for (int column = 0; column < expectedRow.size(); column++) {
-                    var expectedValue = expectedRow.get(column);
-                    var actualValue = actualRow.get(column);
                     var expectedType = expected.columnTypes().get(column);
+                    var expectedValue = convertExpectedValue(expectedType, expectedRow.get(column));
+                    var actualValue = actualRow.get(column);
 
-                    if (expectedValue != null) {
-                        // convert the long from CSV back to its STRING form
-                        if (expectedType == Type.DATETIME) {
-                            expectedValue = rebuildExpected(expectedValue, Long.class, x -> UTC_DATE_TIME_FORMATTER.formatMillis((long) x));
-                        } else if (expectedType == Type.DATE_NANOS) {
-                            expectedValue = rebuildExpected(
-                                expectedValue,
-                                Long.class,
-                                x -> DateFormatter.forPattern("strict_date_optional_time_nanos").formatNanos((long) x)
-                            );
-                        } else if (expectedType == Type.GEO_POINT) {
-                            expectedValue = rebuildExpected(expectedValue, BytesRef.class, x -> GEO.wkbToWkt((BytesRef) x));
-                        } else if (expectedType == Type.CARTESIAN_POINT) {
-                            expectedValue = rebuildExpected(expectedValue, BytesRef.class, x -> CARTESIAN.wkbToWkt((BytesRef) x));
-                        } else if (expectedType == Type.GEO_SHAPE) {
-                            expectedValue = rebuildExpected(expectedValue, BytesRef.class, x -> GEO.wkbToWkt((BytesRef) x));
-                        } else if (expectedType == Type.CARTESIAN_SHAPE) {
-                            expectedValue = rebuildExpected(expectedValue, BytesRef.class, x -> CARTESIAN.wkbToWkt((BytesRef) x));
-                        } else if (expectedType == Type.IP) {
-                            // convert BytesRef-packed IP to String, allowing subsequent comparison with what's expected
-                            expectedValue = rebuildExpected(expectedValue, BytesRef.class, x -> DocValueFormat.IP.format((BytesRef) x));
-                        } else if (expectedType == Type.VERSION) {
-                            // convert BytesRef-packed Version to String
-                            expectedValue = rebuildExpected(expectedValue, BytesRef.class, x -> new Version((BytesRef) x).toString());
-                        } else if (expectedType == UNSIGNED_LONG) {
-                            expectedValue = rebuildExpected(expectedValue, Long.class, x -> unsignedLongAsNumber((long) x));
-                        }
-                    }
                     var transformedExpected = valueTransformer.apply(expectedType, expectedValue);
                     var transformedActual = valueTransformer.apply(expectedType, actualValue);
                     if (Objects.equals(transformedExpected, transformedActual) == false) {
                         dataFailures.add(new DataFailure(row, column, transformedExpected, transformedActual));
                     }
                     if (dataFailures.size() > 10) {
-                        dataFailure("", dataFailures, expected, actualValues);
+                        dataFailure("", dataFailures, expected, actualValues, valueTransformer);
                     }
                 }
 
@@ -255,7 +234,8 @@ public static void assertData(
                         "Plan has extra columns, returned [" + actualRow.size() + "], expected [" + expectedRow.size() + "]",
                         dataFailures,
                         expected,
-                        actualValues
+                        actualValues,
+                        valueTransformer
                     );
                 }
             } catch (AssertionError ae) {
@@ -267,10 +247,16 @@ public static void assertData(
             }
         }
         if (dataFailures.isEmpty() == false) {
-            dataFailure("", dataFailures, expected, actualValues);
+            dataFailure("", dataFailures, expected, actualValues, valueTransformer);
         }
         if (expectedValues.size() < actualValues.size()) {
-            dataFailure("Elasticsearch still has data after [" + expectedValues.size() + "] entries", dataFailures, expected, actualValues);
+            dataFailure(
+                "Elasticsearch still has data after [" + expectedValues.size() + "] entries",
+                dataFailures,
+                expected,
+                actualValues,
+                valueTransformer
+            );
         }
     }
 
@@ -278,42 +264,72 @@ private static void dataFailure(
         String description,
         List<DataFailure> dataFailures,
         ExpectedResults expectedValues,
-        List<List<Object>> actualValues
+        List<List<Object>> actualValues,
+        BiFunction<Type, Object, Object> valueTransformer
     ) {
-        var expected = pipeTable("Expected:", expectedValues.columnNames(), expectedValues.values(), 25);
-        var actual = pipeTable("Actual:", expectedValues.columnNames(), actualValues, 25);
+        var expected = pipeTable(
+            "Expected:",
+            expectedValues.columnNames(),
+            expectedValues.columnTypes(),
+            expectedValues.values(),
+            (type, value) -> valueTransformer.apply(type, convertExpectedValue(type, value))
+        );
+        var actual = pipeTable("Actual:", expectedValues.columnNames(), expectedValues.columnTypes(), actualValues, valueTransformer);
         fail(description + System.lineSeparator() + describeFailures(dataFailures) + actual + expected);
     }
 
-    private static String pipeTable(String description, List<String> headers, List<List<Object>> values, int maxRows) {
+    private static final int MAX_ROWS = 25;
+
+    private static String pipeTable(
+        String description,
+        List<String> headers,
+        List<Type> types,
+        List<List<Object>> values,
+        BiFunction<Type, Object, Object> valueTransformer
+    ) {
+        int rows = Math.min(MAX_ROWS, values.size());
         int[] width = new int[headers.size()];
-        for (int i = 0; i < width.length; i++) {
-            width[i] = headers.get(i).length();
-            for (List<Object> row : values) {
-                width[i] = Math.max(width[i], String.valueOf(row.get(i)).length());
+        String[][] printableValues = new String[rows][headers.size()];
+        for (int c = 0; c < headers.size(); c++) {
+            width[c] = header(headers.get(c), types.get(c)).length();
+        }
+        for (int r = 0; r < rows; r++) {
+            for (int c = 0; c < headers.size(); c++) {
+                printableValues[r][c] = String.valueOf(valueTransformer.apply(types.get(c), values.get(r).get(c)));
+                width[c] = Math.max(width[c], printableValues[r][c].length());
             }
         }
 
         var result = new StringBuilder().append(System.lineSeparator()).append(description).append(System.lineSeparator());
-        for (int c = 0; c < width.length; c++) {
-            appendValue(result, headers.get(c), width[c]);
+        // headers
+        appendPaddedValue(result, header(headers.get(0), types.get(0)), width[0]);
+        for (int c = 1; c < width.length; c++) {
+            result.append(" | ");
+            appendPaddedValue(result, header(headers.get(c), types.get(c)), width[c]);
         }
-        result.append('|').append(System.lineSeparator());
-        for (int r = 0; r < Math.min(maxRows, values.size()); r++) {
-            for (int c = 0; c < width.length; c++) {
-                appendValue(result, values.get(r).get(c), width[c]);
+        result.append(System.lineSeparator());
+        // values
+        for (int r = 0; r < printableValues.length; r++) {
+            appendPaddedValue(result, printableValues[r][0], width[0]);
+            for (int c = 1; c < printableValues[r].length; c++) {
+                result.append(" | ");
+                appendPaddedValue(result, printableValues[r][c], width[c]);
             }
-            result.append('|').append(System.lineSeparator());
+            result.append(System.lineSeparator());
         }
-        if (values.size() > maxRows) {
+        if (values.size() > rows) {
             result.append("...").append(System.lineSeparator());
         }
         return result.toString();
     }
 
-    private static void appendValue(StringBuilder result, Object value, int width) {
-        result.append('|').append(value);
-        for (int i = 0; i < width - String.valueOf(value).length(); i++) {
+    private static String header(String name, Type type) {
+        return name + ':' + Strings.toLowercaseAscii(type.name());
+    }
+
+    private static void appendPaddedValue(StringBuilder result, String value, int width) {
+        result.append(value);
+        for (int i = 0; i < width - (value != null ? value.length() : 4); i++) {
             result.append(' ');
         }
     }
@@ -369,6 +385,34 @@ private static Comparator<List<Object>> resultRowComparator(List<Type> types) {
         };
     }
 
+    private static Object convertExpectedValue(Type expectedType, Object expectedValue) {
+        if (expectedValue == null) {
+            return null;
+        }
+
+        // convert the long from CSV back to its STRING form
+        return switch (expectedType) {
+            case Type.DATETIME -> rebuildExpected(expectedValue, Long.class, x -> UTC_DATE_TIME_FORMATTER.formatMillis((long) x));
+            case Type.DATE_NANOS -> rebuildExpected(
+                expectedValue,
+                Long.class,
+                x -> DateFormatter.forPattern("strict_date_optional_time_nanos").formatNanos((long) x)
+            );
+            case Type.GEO_POINT, Type.GEO_SHAPE -> rebuildExpected(expectedValue, BytesRef.class, x -> GEO.wkbToWkt((BytesRef) x));
+            case Type.CARTESIAN_POINT, Type.CARTESIAN_SHAPE -> rebuildExpected(
+                expectedValue,
+                BytesRef.class,
+                x -> CARTESIAN.wkbToWkt((BytesRef) x)
+            );
+            case Type.IP -> // convert BytesRef-packed IP to String, allowing subsequent comparison with what's expected
+                rebuildExpected(expectedValue, BytesRef.class, x -> DocValueFormat.IP.format((BytesRef) x));
+            case Type.VERSION -> // convert BytesRef-packed Version to String
+                rebuildExpected(expectedValue, BytesRef.class, x -> new Version((BytesRef) x).toString());
+            case UNSIGNED_LONG -> rebuildExpected(expectedValue, Long.class, x -> unsignedLongAsNumber((long) x));
+            default -> expectedValue;
+        };
+    }
+
     private static Object rebuildExpected(Object expectedValue, Class<?> clazz, Function<Object, Object> mapper) {
         if (List.class.isAssignableFrom(expectedValue.getClass())) {
             assertThat(((List<?>) expectedValue).get(0), instanceOf(clazz));

From 709a87e8013503097d55787a8950da34158b6cb1 Mon Sep 17 00:00:00 2001
From: Joan Fontanals <jfontanalsmartinez@gmail.com>
Date: Mon, 16 Dec 2024 14:05:30 +0100
Subject: [PATCH 005/119] Handle `null` text values in
 RankedDocsResults.asMap() (#118597)

---
 .../core/inference/results/RankedDocsResults.java    |  6 +++++-
 .../inference/results/RankedDocsResultsTests.java    | 12 ++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResults.java
index 9c764babe33fc..a5f72bd51c6c6 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResults.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResults.java
@@ -139,7 +139,11 @@ public void writeTo(StreamOutput out) throws IOException {
         }
 
         public Map<String, Object> asMap() {
-            return Map.of(NAME, Map.of(INDEX, index, RELEVANCE_SCORE, relevanceScore, TEXT, text));
+            if (text != null) {
+                return Map.of(NAME, Map.of(INDEX, index, RELEVANCE_SCORE, relevanceScore, TEXT, text));
+            } else {
+                return Map.of(NAME, Map.of(INDEX, index, RELEVANCE_SCORE, relevanceScore));
+            }
         }
 
         @Override
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResultsTests.java
index 46f10928cad08..ff6f6848f4b69 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResultsTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/RankedDocsResultsTests.java
@@ -12,10 +12,12 @@
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.xcontent.XContentParser;
 import org.elasticsearch.xpack.core.ml.AbstractChunkedBWCSerializationTestCase;
+import org.hamcrest.Matchers;
 
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Map;
 
 public class RankedDocsResultsTests extends AbstractChunkedBWCSerializationTestCase<RankedDocsResults> {
 
@@ -37,6 +39,16 @@ public static RankedDocsResults.RankedDoc createRandomDoc() {
         return new RankedDocsResults.RankedDoc(randomIntBetween(0, 100), randomFloat(), randomBoolean() ? null : randomAlphaOfLength(10));
     }
 
+    public void test_asMap() {
+        var index = randomIntBetween(0, 100);
+        var score = randomFloat();
+        var mapNullText = new RankedDocsResults.RankedDoc(index, score, null).asMap();
+        assertThat(mapNullText, Matchers.is(Map.of("ranked_doc", Map.of("index", index, "relevance_score", score))));
+
+        var mapWithText = new RankedDocsResults.RankedDoc(index, score, "Sample text").asMap();
+        assertThat(mapWithText, Matchers.is(Map.of("ranked_doc", Map.of("index", index, "relevance_score", score, "text", "Sample text"))));
+    }
+
     @Override
     protected RankedDocsResults mutateInstance(RankedDocsResults instance) throws IOException {
         List<RankedDocsResults.RankedDoc> copy = new ArrayList<>(List.copyOf(instance.getRankedDocs()));

From 0efdc4741bfb8610528c9db0b2d72030b6a0684b Mon Sep 17 00:00:00 2001
From: Bogdan Pintea <bogdan.pintea@elastic.co>
Date: Mon, 16 Dec 2024 14:12:39 +0100
Subject: [PATCH 006/119] Disable one more test failing on pre-8.13 BWC
 (#118760)

Prevent `stats.ByStringAndLongWithAlias` from running on pre-8.13 BWC.

Related #118655.
---
 .../esql/qa/testFixtures/src/main/resources/dissect.csv-spec | 4 ++--
 .../esql/qa/testFixtures/src/main/resources/grok.csv-spec    | 4 ++--
 .../esql/qa/testFixtures/src/main/resources/stats.csv-spec   | 5 +++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/dissect.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/dissect.csv-spec
index cde5427bf37d6..2b3b0bee93471 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/dissect.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/dissect.csv-spec
@@ -223,7 +223,7 @@ null               | null      | null
 ;
 
 
-// the query is incorrectly physically plan (fails the verification) in pre-8.13.0 versions
+// the query is incorrectly physically planned (fails the verification) in pre-8.13.0 versions
 overwriteName#[skip:-8.12.99]
 from employees | sort emp_no asc | eval full_name = concat(first_name, " ", last_name) | dissect full_name "%{emp_no} %{b}" | keep full_name, emp_no, b | limit 3;
 
@@ -245,7 +245,7 @@ emp_no:integer | first_name:keyword | rest:keyword
 ;
 
 
-// the query is incorrectly physically plan (fails the verification) in pre-8.13.0 versions
+// the query is incorrectly physically planned (fails the verification) in pre-8.13.0 versions
 overwriteNameWhere#[skip:-8.12.99]
 from employees | sort emp_no asc | eval full_name = concat(first_name, " ", last_name) | dissect full_name "%{emp_no} %{b}" | where emp_no == "Bezalel" | keep full_name, emp_no, b | limit 3;
 
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/grok.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/grok.csv-spec
index eece1bdfbffa4..6dc9148ffc0e8 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/grok.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/grok.csv-spec
@@ -199,7 +199,7 @@ null               | null      | null
 ;
 
 
-// the query is incorrectly physically plan (fails the verification) in pre-8.13.0 versions
+// the query is incorrectly physically planned (fails the verification) in pre-8.13.0 versions
 overwriteName#[skip:-8.12.99]
 from employees | sort emp_no asc | eval full_name = concat(first_name, " ", last_name) | grok full_name "%{WORD:emp_no} %{WORD:b}" | keep full_name, emp_no, b | limit 3;
 
@@ -210,7 +210,7 @@ Parto Bamford     | Parto          | Bamford
 ;
 
 
-// the query is incorrectly physically plan (fails the verification) in pre-8.13.0 versions
+// the query is incorrectly physically planned (fails the verification) in pre-8.13.0 versions
 overwriteNameWhere#[skip:-8.12.99]
 from employees | sort emp_no asc | eval full_name = concat(first_name, " ", last_name) | grok full_name "%{WORD:emp_no} %{WORD:b}" | where emp_no == "Bezalel" | keep full_name, emp_no, b | limit 3;
 
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/stats.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/stats.csv-spec
index 100c0d716d65c..80586ce9bcb09 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/stats.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/stats.csv-spec
@@ -564,7 +564,7 @@ c:long | gender:keyword | trunk_worked_seconds:long
  0     | null           | 200000000
 ;
 
-// the query is incorrectly physically plan (fails the verification) in pre-8.13.0 versions
+// the query is incorrectly physically planned (fails the verification) in pre-8.13.0 versions
 byStringAndLongWithAlias#[skip:-8.12.99]
 FROM employees
 | EVAL trunk_worked_seconds = avg_worked_seconds / 100000000 * 100000000
@@ -720,7 +720,8 @@ c:long |           d:date         | gender:keyword | languages:integer
      2 | 1987-01-01T00:00:00.000Z | M              | 1
 ;
 
-byDateAndKeywordAndIntWithAlias
+// the query is incorrectly physically planned (fails the verification) in pre-8.13.0 versions
+byDateAndKeywordAndIntWithAlias#[skip:-8.12.99]
 from employees | eval d = date_trunc(1 year, hire_date) | rename gender as g, languages as l, emp_no as e | keep d, g, l, e | stats c = count(e) by d, g, l | sort c desc, d, l desc, g desc | limit 10;
 
 c:long |           d:date         | g:keyword | l:integer

From 2b8c494b3b8dbca07b90dfed8d6751f15631c814 Mon Sep 17 00:00:00 2001
From: Luigi Dell'Aquila <luigi.dellaquila@gmail.com>
Date: Mon, 16 Dec 2024 14:47:03 +0100
Subject: [PATCH 007/119] ES|QL: Fix RLIKE folding with (unsupported) case
 insensitive pattern (#118454)

---
 docs/changelog/118454.yaml                    |  5 +++
 .../expression/predicate/regex/RLike.java     | 12 +------
 .../predicate/regex/RegexMatch.java           |  7 +---
 .../predicate/regex/WildcardLike.java         | 13 +------
 .../xpack/esql/core/util/TestUtils.java       |  6 ----
 .../src/main/resources/eval.csv-spec          | 36 +++++++++++++++++++
 .../xpack/esql/action/EsqlCapabilities.java   |  7 +++-
 .../function/scalar/string/RLike.java         |  7 +++-
 .../function/scalar/string/WildcardLike.java  |  5 +++
 .../rules/logical/ConstantFoldingTests.java   |  4 +--
 .../PushDownAndCombineFiltersTests.java       |  2 +-
 .../rules/logical/ReplaceRegexMatchTests.java |  4 +--
 12 files changed, 66 insertions(+), 42 deletions(-)
 create mode 100644 docs/changelog/118454.yaml

diff --git a/docs/changelog/118454.yaml b/docs/changelog/118454.yaml
new file mode 100644
index 0000000000000..9a19ede64d705
--- /dev/null
+++ b/docs/changelog/118454.yaml
@@ -0,0 +1,5 @@
+pr: 118454
+summary: Fix RLIKE folding with (unsupported) case insensitive pattern
+area: ES|QL
+type: bug
+issues: []
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RLike.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RLike.java
index 5f095a654fc89..b4bccf162d9e4 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RLike.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RLike.java
@@ -8,12 +8,11 @@
 
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
-import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 
 import java.io.IOException;
 
-public class RLike extends RegexMatch<RLikePattern> {
+public abstract class RLike extends RegexMatch<RLikePattern> {
 
     public RLike(Source source, Expression value, RLikePattern pattern) {
         super(source, value, pattern, false);
@@ -33,13 +32,4 @@ public String getWriteableName() {
         throw new UnsupportedOperationException();
     }
 
-    @Override
-    protected NodeInfo<RLike> info() {
-        return NodeInfo.create(this, RLike::new, field(), pattern(), caseInsensitive());
-    }
-
-    @Override
-    protected RLike replaceChild(Expression newChild) {
-        return new RLike(source(), newChild, pattern(), caseInsensitive());
-    }
 }
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RegexMatch.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RegexMatch.java
index 32e8b04573d2d..0f9116ade5a31 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RegexMatch.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/RegexMatch.java
@@ -7,7 +7,6 @@
 
 package org.elasticsearch.xpack.esql.core.expression.predicate.regex;
 
-import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.Nullability;
 import org.elasticsearch.xpack.esql.core.expression.function.scalar.UnaryScalarFunction;
@@ -64,11 +63,7 @@ public boolean foldable() {
 
     @Override
     public Boolean fold() {
-        Object val = field().fold();
-        if (val instanceof BytesRef br) {
-            val = br.utf8ToString();
-        }
-        return RegexOperation.match(val, pattern().asJavaRegex());
+        throw new UnsupportedOperationException();
     }
 
     @Override
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/WildcardLike.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/WildcardLike.java
index bf54744667217..05027707326bd 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/WildcardLike.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/regex/WildcardLike.java
@@ -8,12 +8,11 @@
 
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
-import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 
 import java.io.IOException;
 
-public class WildcardLike extends RegexMatch<WildcardPattern> {
+public abstract class WildcardLike extends RegexMatch<WildcardPattern> {
 
     public WildcardLike(Source source, Expression left, WildcardPattern pattern) {
         this(source, left, pattern, false);
@@ -33,14 +32,4 @@ public String getWriteableName() {
         throw new UnsupportedOperationException();
     }
 
-    @Override
-    protected NodeInfo<WildcardLike> info() {
-        return NodeInfo.create(this, WildcardLike::new, field(), pattern(), caseInsensitive());
-    }
-
-    @Override
-    protected WildcardLike replaceChild(Expression newLeft) {
-        return new WildcardLike(source(), newLeft, pattern(), caseInsensitive());
-    }
-
 }
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/util/TestUtils.java b/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/util/TestUtils.java
index 9f8e23cb15a97..b37ca0431ec2d 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/util/TestUtils.java
+++ b/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/util/TestUtils.java
@@ -11,8 +11,6 @@
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
 import org.elasticsearch.xpack.esql.core.expression.Literal;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Range;
-import org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLike;
-import org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLikePattern;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.type.DataType;
 import org.elasticsearch.xpack.esql.core.type.EsField;
@@ -46,10 +44,6 @@ public static Range rangeOf(Expression value, Expression lower, boolean includeL
         return new Range(EMPTY, value, lower, includeLower, upper, includeUpper, randomZone());
     }
 
-    public static RLike rlike(Expression left, String exp) {
-        return new RLike(EMPTY, left, new RLikePattern(exp));
-    }
-
     public static FieldAttribute fieldAttribute() {
         return fieldAttribute(randomAlphaOfLength(10), randomFrom(DataType.types()));
     }
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/eval.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/eval.csv-spec
index 592b06107c8b5..72660c11d8b73 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/eval.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/eval.csv-spec
@@ -601,3 +601,39 @@ Mokhtar             |Bernatsky          |38992          |BM
 Parto               |Bamford            |61805          |BP
 Premal              |Baek               |52833          |BP
 ;
+
+
+caseInsensitiveRegex
+from employees | where first_name RLIKE "(?i)geor.*" | keep first_name
+;
+
+first_name:keyword
+;
+
+
+caseInsensitiveRegex2
+from employees | where first_name RLIKE "(?i)Geor.*" | keep first_name
+;
+
+first_name:keyword
+;
+
+
+caseInsensitiveRegexFold
+required_capability: fixed_regex_fold
+row foo = "Bar" | where foo rlike "(?i)ba.*"
+;
+
+foo:keyword
+;
+
+
+caseInsensitiveRegexFold2
+required_capability: fixed_regex_fold
+row foo = "Bar" | where foo rlike "(?i)Ba.*"
+;
+
+foo:keyword
+;
+
+
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index 649ec1eba9785..e9a0f89e4f448 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -577,7 +577,12 @@ public enum Cap {
         /**
          * Additional types for match function and operator
          */
-        MATCH_ADDITIONAL_TYPES;
+        MATCH_ADDITIONAL_TYPES,
+
+        /**
+         * Fix for regex folding with case-insensitive pattern https://github.com/elastic/elasticsearch/issues/118371
+         */
+        FIXED_REGEX_FOLD;
 
         private final boolean enabled;
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/RLike.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/RLike.java
index cd42711177510..996c90a8e40bc 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/RLike.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/RLike.java
@@ -79,7 +79,7 @@ public String getWriteableName() {
     }
 
     @Override
-    protected NodeInfo<org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLike> info() {
+    protected NodeInfo<RLike> info() {
         return NodeInfo.create(this, RLike::new, field(), pattern(), caseInsensitive());
     }
 
@@ -93,6 +93,11 @@ protected TypeResolution resolveType() {
         return isString(field(), sourceText(), DEFAULT);
     }
 
+    @Override
+    public Boolean fold() {
+        return (Boolean) EvaluatorMapper.super.fold();
+    }
+
     @Override
     public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
         return AutomataMatch.toEvaluator(source(), toEvaluator.apply(field()), pattern().createAutomaton());
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/WildcardLike.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/WildcardLike.java
index c1b4f20f41795..d2edb0f92e8f2 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/WildcardLike.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/WildcardLike.java
@@ -99,6 +99,11 @@ protected TypeResolution resolveType() {
         return isString(field(), sourceText(), DEFAULT);
     }
 
+    @Override
+    public Boolean fold() {
+        return (Boolean) EvaluatorMapper.super.fold();
+    }
+
     @Override
     public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
         return AutomataMatch.toEvaluator(
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ConstantFoldingTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ConstantFoldingTests.java
index c2e85cc43284a..c4f4dac67acd3 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ConstantFoldingTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ConstantFoldingTests.java
@@ -17,11 +17,11 @@
 import org.elasticsearch.xpack.esql.core.expression.predicate.logical.And;
 import org.elasticsearch.xpack.esql.core.expression.predicate.logical.Not;
 import org.elasticsearch.xpack.esql.core.expression.predicate.logical.Or;
-import org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLike;
 import org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLikePattern;
-import org.elasticsearch.xpack.esql.core.expression.predicate.regex.WildcardLike;
 import org.elasticsearch.xpack.esql.core.expression.predicate.regex.WildcardPattern;
 import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.scalar.string.RLike;
+import org.elasticsearch.xpack.esql.expression.function.scalar.string.WildcardLike;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.arithmetic.Add;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.arithmetic.Div;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.arithmetic.Mod;
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PushDownAndCombineFiltersTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PushDownAndCombineFiltersTests.java
index e159e5ed0bd7d..bc22fbb6bd828 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PushDownAndCombineFiltersTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PushDownAndCombineFiltersTests.java
@@ -199,7 +199,7 @@ public void testPushDownFilterOnAliasInEval() {
 
     public void testPushDownLikeRlikeFilter() {
         EsRelation relation = relation();
-        org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLike conditionA = rlike(getFieldAttribute("a"), "foo");
+        RLike conditionA = rlike(getFieldAttribute("a"), "foo");
         WildcardLike conditionB = wildcardLike(getFieldAttribute("b"), "bar");
 
         Filter fa = new Filter(EMPTY, relation, conditionA);
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ReplaceRegexMatchTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ReplaceRegexMatchTests.java
index 20d638a113bf2..c7206c6971bde 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ReplaceRegexMatchTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/ReplaceRegexMatchTests.java
@@ -11,11 +11,11 @@
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
 import org.elasticsearch.xpack.esql.core.expression.predicate.nulls.IsNotNull;
-import org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLike;
 import org.elasticsearch.xpack.esql.core.expression.predicate.regex.RLikePattern;
-import org.elasticsearch.xpack.esql.core.expression.predicate.regex.WildcardLike;
 import org.elasticsearch.xpack.esql.core.expression.predicate.regex.WildcardPattern;
 import org.elasticsearch.xpack.esql.core.util.StringUtils;
+import org.elasticsearch.xpack.esql.expression.function.scalar.string.RLike;
+import org.elasticsearch.xpack.esql.expression.function.scalar.string.WildcardLike;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.Equals;
 
 import static java.util.Arrays.asList;

From 6d6eac2c77a94dfdbee01cc1f609354c8c016d2a Mon Sep 17 00:00:00 2001
From: kanoshiou <73424326+kanoshiou@users.noreply.github.com>
Date: Mon, 16 Dec 2024 22:20:58 +0800
Subject: [PATCH 008/119] ESQL: Drop null columns in text formats (#117643)

This PR resolves the issue where, despite setting `drop_null_columns=true`, columns that are entirely null are still returned when using `format=txt`, `format=csv`, or `format=tsv`.

Closes #116848
---
 docs/changelog/117643.yaml                    |  6 +++
 .../xpack/esql/qa/rest/RestEsqlTestCase.java  |  6 +--
 .../xpack/esql/action/EsqlQueryResponse.java  |  2 +-
 .../xpack/esql/formatter/TextFormat.java      | 22 +++++++--
 .../xpack/esql/formatter/TextFormatter.java   | 24 ++++++++--
 .../xpack/esql/formatter/TextFormatTests.java | 47 ++++++++++++++-----
 .../esql/formatter/TextFormatterTests.java    | 41 +++++++++++++---
 7 files changed, 117 insertions(+), 31 deletions(-)
 create mode 100644 docs/changelog/117643.yaml

diff --git a/docs/changelog/117643.yaml b/docs/changelog/117643.yaml
new file mode 100644
index 0000000000000..9105749377d2c
--- /dev/null
+++ b/docs/changelog/117643.yaml
@@ -0,0 +1,6 @@
+pr: 117643
+summary: Drop null columns in text formats
+area: ES|QL
+type: bug
+issues:
+  - 116848
diff --git a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RestEsqlTestCase.java b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RestEsqlTestCase.java
index 6a8779eef4efc..86f8a8c5363f6 100644
--- a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RestEsqlTestCase.java
+++ b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RestEsqlTestCase.java
@@ -1119,7 +1119,7 @@ public void testAsyncGetWithoutContentType() throws IOException {
         var json = entityToMap(entity, requestObject.contentType());
         checkKeepOnCompletion(requestObject, json, true);
         String id = (String) json.get("id");
-        // results won't be returned since keepOnCompletion is true
+        // results won't be returned because wait_for_completion is provided a very small interval
         assertThat(id, is(not(emptyOrNullString())));
 
         // issue an "async get" request with no Content-Type
@@ -1274,11 +1274,11 @@ static String runEsqlAsTextWithFormat(RequestObjectBuilder builder, String forma
                 switch (format) {
                     case "txt" -> assertThat(initialValue, emptyOrNullString());
                     case "csv" -> {
-                        assertEquals(initialValue, "\r\n");
+                        assertEquals("\r\n", initialValue);
                         initialValue = "";
                     }
                     case "tsv" -> {
-                        assertEquals(initialValue, "\n");
+                        assertEquals("\n", initialValue);
                         initialValue = "";
                     }
                 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java
index dc0e9fd1fb06d..4163a222b1a28 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java
@@ -218,7 +218,7 @@ public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params
         });
     }
 
-    private boolean[] nullColumns() {
+    public boolean[] nullColumns() {
         boolean[] nullColumns = new boolean[columns.size()];
         for (int c = 0; c < nullColumns.length; c++) {
             nullColumns[c] = allColumnsAreNull(c);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormat.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormat.java
index 5c0d6b138b326..7a7e4677b0dca 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormat.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormat.java
@@ -39,7 +39,8 @@ public enum TextFormat implements MediaType {
     PLAIN_TEXT() {
         @Override
         public Iterator<CheckedConsumer<Writer, IOException>> format(RestRequest request, EsqlQueryResponse esqlResponse) {
-            return new TextFormatter(esqlResponse).format(hasHeader(request));
+            boolean dropNullColumns = request.paramAsBoolean(DROP_NULL_COLUMNS_OPTION, false);
+            return new TextFormatter(esqlResponse, hasHeader(request), dropNullColumns).format();
         }
 
         @Override
@@ -282,15 +283,21 @@ public Set<HeaderValue> headerValues() {
      */
     public static final String URL_PARAM_FORMAT = "format";
     public static final String URL_PARAM_DELIMITER = "delimiter";
+    public static final String DROP_NULL_COLUMNS_OPTION = "drop_null_columns";
 
     public Iterator<CheckedConsumer<Writer, IOException>> format(RestRequest request, EsqlQueryResponse esqlResponse) {
         final var delimiter = delimiter(request);
+        boolean dropNullColumns = request.paramAsBoolean(DROP_NULL_COLUMNS_OPTION, false);
+        boolean[] dropColumns = dropNullColumns ? esqlResponse.nullColumns() : new boolean[esqlResponse.columns().size()];
         return Iterators.concat(
             // if the header is requested return the info
             hasHeader(request) && esqlResponse.columns() != null
-                ? Iterators.single(writer -> row(writer, esqlResponse.columns().iterator(), ColumnInfo::name, delimiter))
+                ? Iterators.single(writer -> row(writer, esqlResponse.columns().iterator(), ColumnInfo::name, delimiter, dropColumns))
                 : Collections.emptyIterator(),
-            Iterators.map(esqlResponse.values(), row -> writer -> row(writer, row, f -> Objects.toString(f, StringUtils.EMPTY), delimiter))
+            Iterators.map(
+                esqlResponse.values(),
+                row -> writer -> row(writer, row, f -> Objects.toString(f, StringUtils.EMPTY), delimiter, dropColumns)
+            )
         );
     }
 
@@ -313,9 +320,14 @@ public String contentType(RestRequest request) {
     }
 
     // utility method for consuming a row.
-    <F> void row(Writer writer, Iterator<F> row, Function<F, String> toString, Character delimiter) throws IOException {
+    <F> void row(Writer writer, Iterator<F> row, Function<F, String> toString, Character delimiter, boolean[] dropColumns)
+        throws IOException {
         boolean firstColumn = true;
-        while (row.hasNext()) {
+        for (int i = 0; row.hasNext(); i++) {
+            if (dropColumns[i]) {
+                row.next();
+                continue;
+            }
             if (firstColumn) {
                 firstColumn = false;
             } else {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormatter.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormatter.java
index 0535e4adfe346..95b46958be351 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormatter.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/formatter/TextFormatter.java
@@ -30,13 +30,17 @@ public class TextFormatter {
     private final EsqlQueryResponse response;
     private final int[] width;
     private final Function<Object, String> FORMATTER = Objects::toString;
+    private final boolean includeHeader;
+    private final boolean[] dropColumns;
 
     /**
-     * Create a new {@linkplain TextFormatter} for formatting responses.
+     * Create a new {@linkplain TextFormatter} for formatting responses
      */
-    public TextFormatter(EsqlQueryResponse response) {
+    public TextFormatter(EsqlQueryResponse response, boolean includeHeader, boolean dropNullColumns) {
         this.response = response;
         var columns = response.columns();
+        this.includeHeader = includeHeader;
+        this.dropColumns = dropNullColumns ? response.nullColumns() : new boolean[columns.size()];
         // Figure out the column widths:
         // 1. Start with the widths of the column names
         width = new int[columns.size()];
@@ -58,12 +62,12 @@ public TextFormatter(EsqlQueryResponse response) {
     }
 
     /**
-     * Format the provided {@linkplain EsqlQueryResponse} optionally including the header lines.
+     * Format the provided {@linkplain EsqlQueryResponse}
      */
-    public Iterator<CheckedConsumer<Writer, IOException>> format(boolean includeHeader) {
+    public Iterator<CheckedConsumer<Writer, IOException>> format() {
         return Iterators.concat(
             // The header lines
-            includeHeader && response.columns().size() > 0 ? Iterators.single(this::formatHeader) : Collections.emptyIterator(),
+            includeHeader && response.columns().isEmpty() == false ? Iterators.single(this::formatHeader) : Collections.emptyIterator(),
             // Now format the results.
             formatResults()
         );
@@ -71,6 +75,9 @@ public Iterator<CheckedConsumer<Writer, IOException>> format(boolean includeHead
 
     private void formatHeader(Writer writer) throws IOException {
         for (int i = 0; i < width.length; i++) {
+            if (dropColumns[i]) {
+                continue;
+            }
             if (i > 0) {
                 writer.append('|');
             }
@@ -86,6 +93,9 @@ private void formatHeader(Writer writer) throws IOException {
         writer.append('\n');
 
         for (int i = 0; i < width.length; i++) {
+            if (dropColumns[i]) {
+                continue;
+            }
             if (i > 0) {
                 writer.append('+');
             }
@@ -98,6 +108,10 @@ private Iterator<CheckedConsumer<Writer, IOException>> formatResults() {
         return Iterators.map(response.values(), row -> writer -> {
             for (int i = 0; i < width.length; i++) {
                 assert row.hasNext();
+                if (dropColumns[i]) {
+                    row.next();
+                    continue;
+                }
                 if (i > 0) {
                     writer.append('|');
                 }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatTests.java
index fe1ac52427627..ca47e0cb329b3 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatTests.java
@@ -123,17 +123,17 @@ public void testTsvFormatWithEmptyData() {
     public void testCsvFormatWithRegularData() {
         String text = format(CSV, req(), regularData());
         assertEquals("""
-            string,number,location,location2\r
-            Along The River Bank,708,POINT (12.0 56.0),POINT (1234.0 5678.0)\r
-            Mind Train,280,POINT (-97.0 26.0),POINT (-9753.0 2611.0)\r
+            string,number,location,location2,null_field\r
+            Along The River Bank,708,POINT (12.0 56.0),POINT (1234.0 5678.0),\r
+            Mind Train,280,POINT (-97.0 26.0),POINT (-9753.0 2611.0),\r
             """, text);
     }
 
     public void testCsvFormatNoHeaderWithRegularData() {
         String text = format(CSV, reqWithParam("header", "absent"), regularData());
         assertEquals("""
-            Along The River Bank,708,POINT (12.0 56.0),POINT (1234.0 5678.0)\r
-            Mind Train,280,POINT (-97.0 26.0),POINT (-9753.0 2611.0)\r
+            Along The River Bank,708,POINT (12.0 56.0),POINT (1234.0 5678.0),\r
+            Mind Train,280,POINT (-97.0 26.0),POINT (-9753.0 2611.0),\r
             """, text);
     }
 
@@ -146,14 +146,17 @@ public void testCsvFormatWithCustomDelimiterRegularData() {
             "number",
             "location",
             "location2",
+            "null_field",
             "Along The River Bank",
             "708",
             "POINT (12.0 56.0)",
             "POINT (1234.0 5678.0)",
+            "",
             "Mind Train",
             "280",
             "POINT (-97.0 26.0)",
-            "POINT (-9753.0 2611.0)"
+            "POINT (-9753.0 2611.0)",
+            ""
         );
         List<String> expectedTerms = terms.stream()
             .map(x -> x.contains(String.valueOf(delim)) ? '"' + x + '"' : x)
@@ -167,6 +170,8 @@ public void testCsvFormatWithCustomDelimiterRegularData() {
             sb.append(expectedTerms.remove(0));
             sb.append(delim);
             sb.append(expectedTerms.remove(0));
+            sb.append(delim);
+            sb.append(expectedTerms.remove(0));
             sb.append("\r\n");
         } while (expectedTerms.size() > 0);
         assertEquals(sb.toString(), text);
@@ -175,9 +180,9 @@ public void testCsvFormatWithCustomDelimiterRegularData() {
     public void testTsvFormatWithRegularData() {
         String text = format(TSV, req(), regularData());
         assertEquals("""
-            string\tnumber\tlocation\tlocation2
-            Along The River Bank\t708\tPOINT (12.0 56.0)\tPOINT (1234.0 5678.0)
-            Mind Train\t280\tPOINT (-97.0 26.0)\tPOINT (-9753.0 2611.0)
+            string\tnumber\tlocation\tlocation2\tnull_field
+            Along The River Bank\t708\tPOINT (12.0 56.0)\tPOINT (1234.0 5678.0)\t
+            Mind Train\t280\tPOINT (-97.0 26.0)\tPOINT (-9753.0 2611.0)\t
             """, text);
     }
 
@@ -245,6 +250,24 @@ public void testPlainTextEmptyCursorWithoutColumns() {
         );
     }
 
+    public void testCsvFormatWithDropNullColumns() {
+        String text = format(CSV, reqWithParam("drop_null_columns", "true"), regularData());
+        assertEquals("""
+            string,number,location,location2\r
+            Along The River Bank,708,POINT (12.0 56.0),POINT (1234.0 5678.0)\r
+            Mind Train,280,POINT (-97.0 26.0),POINT (-9753.0 2611.0)\r
+            """, text);
+    }
+
+    public void testTsvFormatWithDropNullColumns() {
+        String text = format(TSV, reqWithParam("drop_null_columns", "true"), regularData());
+        assertEquals("""
+            string\tnumber\tlocation\tlocation2
+            Along The River Bank\t708\tPOINT (12.0 56.0)\tPOINT (1234.0 5678.0)
+            Mind Train\t280\tPOINT (-97.0 26.0)\tPOINT (-9753.0 2611.0)
+            """, text);
+    }
+
     private static EsqlQueryResponse emptyData() {
         return new EsqlQueryResponse(singletonList(new ColumnInfoImpl("name", "keyword")), emptyList(), null, false, false, null);
     }
@@ -256,7 +279,8 @@ private static EsqlQueryResponse regularData() {
             new ColumnInfoImpl("string", "keyword"),
             new ColumnInfoImpl("number", "integer"),
             new ColumnInfoImpl("location", "geo_point"),
-            new ColumnInfoImpl("location2", "cartesian_point")
+            new ColumnInfoImpl("location2", "cartesian_point"),
+            new ColumnInfoImpl("null_field", "keyword")
         );
 
         BytesRefArray geoPoints = new BytesRefArray(2, BigArrays.NON_RECYCLING_INSTANCE);
@@ -274,7 +298,8 @@ private static EsqlQueryResponse regularData() {
                 blockFactory.newBytesRefBlockBuilder(2)
                     .appendBytesRef(CARTESIAN.asWkb(new Point(1234, 5678)))
                     .appendBytesRef(CARTESIAN.asWkb(new Point(-9753, 2611)))
-                    .build()
+                    .build(),
+                blockFactory.newConstantNullBlock(2)
             )
         );
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatterTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatterTests.java
index e735ba83168bb..4e90fe53d96d7 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatterTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/formatter/TextFormatterTests.java
@@ -85,8 +85,6 @@ public class TextFormatterTests extends ESTestCase {
         new EsqlExecutionInfo(randomBoolean())
     );
 
-    TextFormatter formatter = new TextFormatter(esqlResponse);
-
     /**
      * Tests for {@link TextFormatter#format} with header, values
      * of exactly the minimum column size, column names of exactly
@@ -95,7 +93,7 @@ public class TextFormatterTests extends ESTestCase {
      * column size.
      */
     public void testFormatWithHeader() {
-        String[] result = getTextBodyContent(formatter.format(true)).split("\n");
+        String[] result = getTextBodyContent(new TextFormatter(esqlResponse, true, false).format()).split("\n");
         assertThat(result, arrayWithSize(4));
         assertEquals(
             "      foo      |      bar      |15charwidename!|  null_field1  |superduperwidename!!!|      baz      |"
@@ -119,6 +117,35 @@ public void testFormatWithHeader() {
         );
     }
 
+    /**
+     * Tests for {@link TextFormatter#format} with drop_null_columns and
+     * truncation of long columns.
+     */
+    public void testFormatWithDropNullColumns() {
+        String[] result = getTextBodyContent(new TextFormatter(esqlResponse, true, true).format()).split("\n");
+        assertThat(result, arrayWithSize(4));
+        assertEquals(
+            "      foo      |      bar      |15charwidename!|superduperwidename!!!|      baz      |"
+                + "          date          |     location     |      location2       ",
+            result[0]
+        );
+        assertEquals(
+            "---------------+---------------+---------------+---------------------+---------------+-------"
+                + "-----------------+------------------+----------------------",
+            result[1]
+        );
+        assertEquals(
+            "15charwidedata!|1              |6.888          |12.0                 |rabbit         |"
+                + "1953-09-02T00:00:00.000Z|POINT (12.0 56.0) |POINT (1234.0 5678.0) ",
+            result[2]
+        );
+        assertEquals(
+            "dog            |2              |123124.888     |9912.0               |goat           |"
+                + "2000-03-15T21:34:37.443Z|POINT (-97.0 26.0)|POINT (-9753.0 2611.0)",
+            result[3]
+        );
+    }
+
     /**
      * Tests for {@link TextFormatter#format} without header and
      * truncation of long columns.
@@ -160,7 +187,7 @@ public void testFormatWithoutHeader() {
             new EsqlExecutionInfo(randomBoolean())
         );
 
-        String[] result = getTextBodyContent(new TextFormatter(response).format(false)).split("\n");
+        String[] result = getTextBodyContent(new TextFormatter(response, false, false).format()).split("\n");
         assertThat(result, arrayWithSize(2));
         assertEquals(
             "doggie         |4              |1.0            |null           |77.0                 |wombat         |"
@@ -199,8 +226,10 @@ public void testVeryLongPadding() {
                         randomBoolean(),
                         randomBoolean(),
                         new EsqlExecutionInfo(randomBoolean())
-                    )
-                ).format(false)
+                    ),
+                    false,
+                    false
+                ).format()
             )
         );
     }

From f2e5430682a194995f0dae87612ab758db0d377e Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@gmail.com>
Date: Mon, 16 Dec 2024 09:24:47 -0500
Subject: [PATCH 009/119] Remove unused method (#118601)

I was looking at some type conversion stuff, and noticed this method is never used. Back porting to reduce possible conflicts with the long term maintenance branch later.
---
 .../xpack/esql/core/planner/TranslatorHandler.java         | 2 --
 .../xpack/esql/planner/EsqlTranslatorHandler.java          | 7 -------
 2 files changed, 9 deletions(-)

diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/TranslatorHandler.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/TranslatorHandler.java
index 1ccbb04f7a69c..b85544905595a 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/TranslatorHandler.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/TranslatorHandler.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
 import org.elasticsearch.xpack.esql.core.expression.function.scalar.ScalarFunction;
 import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
-import org.elasticsearch.xpack.esql.core.type.DataType;
 
 import java.util.function.Supplier;
 
@@ -34,5 +33,4 @@ default Query wrapFunctionQuery(ScalarFunction sf, Expression field, Supplier<Qu
 
     String nameOf(Expression e);
 
-    Object convert(Object value, DataType dataType);
 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlTranslatorHandler.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlTranslatorHandler.java
index c07be82ed2a16..6fce6c43f12d4 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlTranslatorHandler.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlTranslatorHandler.java
@@ -17,9 +17,7 @@
 import org.elasticsearch.xpack.esql.core.expression.predicate.nulls.IsNull;
 import org.elasticsearch.xpack.esql.core.planner.TranslatorHandler;
 import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
-import org.elasticsearch.xpack.esql.core.type.DataType;
 import org.elasticsearch.xpack.esql.querydsl.query.SingleValueQuery;
-import org.elasticsearch.xpack.esql.type.EsqlDataTypeConverter;
 
 import java.util.function.Supplier;
 
@@ -30,11 +28,6 @@ public Query asQuery(Expression e) {
         return EsqlExpressionTranslators.toQuery(e, this);
     }
 
-    @Override
-    public Object convert(Object value, DataType dataType) {
-        return EsqlDataTypeConverter.convert(value, dataType);
-    }
-
     @Override
     public Query wrapFunctionQuery(ScalarFunction sf, Expression field, Supplier<Query> querySupplier) {
         if (field instanceof FieldAttribute fa) {

From b357936227df04f88c980b6cbf7cd7cde982a25b Mon Sep 17 00:00:00 2001
From: Dmitriy Burlutskiy <dmitrii.burlutckii@elastic.co>
Date: Mon, 16 Dec 2024 15:36:50 +0100
Subject: [PATCH 010/119] Revert "Support mTLS in Elastic Inference Service
 plugin (#116423)" (#118765)

This reverts commit 74a4484101dd65a0194f4adc3bd23fe39c2f2bd7.
---
 docs/changelog/116423.yaml                    |   5 -
 .../xpack/core/ssl/SSLService.java            |   2 -
 .../core/LocalStateCompositeXPackPlugin.java  |   2 +-
 .../xpack/core/ssl/SSLServiceTests.java       |   3 +-
 .../ShardBulkInferenceActionFilterIT.java     |   3 +-
 .../integration/ModelRegistryIT.java          |   4 +-
 .../inference/src/main/java/module-info.java  |   1 -
 .../xpack/inference/InferencePlugin.java      | 101 +++++-------------
 .../external/http/HttpClientManager.java      |  44 --------
 .../TextSimilarityRankRetrieverBuilder.java   |  11 +-
 .../ElasticInferenceServiceSettings.java      |  24 +----
 .../SemanticTextClusterMetadataTests.java     |   3 +-
 .../xpack/inference/InferencePluginTests.java |  65 -----------
 .../inference/LocalStateInferencePlugin.java  |  71 ------------
 .../elasticsearch/xpack/inference/Utils.java  |  15 +++
 ...emanticTextNonDynamicFieldMapperTests.java |   3 +-
 .../TextSimilarityRankMultiNodeTests.java     |   4 +-
 ...SimilarityRankRetrieverTelemetryTests.java |   5 +-
 .../TextSimilarityRankTests.java              |   4 +-
 .../xpack/ml/LocalStateMachineLearning.java   |   7 --
 .../xpack/ml/support/BaseMlIntegTestCase.java |   4 +-
 .../security/CrossClusterShardTests.java      |   2 +
 22 files changed, 69 insertions(+), 314 deletions(-)
 delete mode 100644 docs/changelog/116423.yaml
 delete mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java
 delete mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java

diff --git a/docs/changelog/116423.yaml b/docs/changelog/116423.yaml
deleted file mode 100644
index d6d10eab410e4..0000000000000
--- a/docs/changelog/116423.yaml
+++ /dev/null
@@ -1,5 +0,0 @@
-pr: 116423
-summary: Support mTLS for the Elastic Inference Service integration inside the inference API
-area: Machine Learning
-type: feature
-issues: []
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
index d0d5e463f9652..9704335776f11 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
@@ -596,8 +596,6 @@ static Map<String, Settings> getSSLSettingsMap(Settings settings) {
         sslSettingsMap.put(WatcherField.EMAIL_NOTIFICATION_SSL_PREFIX, settings.getByPrefix(WatcherField.EMAIL_NOTIFICATION_SSL_PREFIX));
         sslSettingsMap.put(XPackSettings.TRANSPORT_SSL_PREFIX, settings.getByPrefix(XPackSettings.TRANSPORT_SSL_PREFIX));
         sslSettingsMap.putAll(getTransportProfileSSLSettings(settings));
-        // Mount Elastic Inference Service (part of the Inference plugin) configuration
-        sslSettingsMap.put("xpack.inference.elastic.http.ssl", settings.getByPrefix("xpack.inference.elastic.http.ssl."));
         // Only build remote cluster server SSL if the port is enabled
         if (REMOTE_CLUSTER_SERVER_ENABLED.get(settings)) {
             sslSettingsMap.put(XPackSettings.REMOTE_CLUSTER_SERVER_SSL_PREFIX, getRemoteClusterServerSslSettings(settings));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
index d50f7bb27a5df..1f2c89c473a62 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
@@ -623,7 +623,7 @@ public Map<String, IndexStorePlugin.SnapshotCommitSupplier> getSnapshotCommitSup
     }
 
     @SuppressWarnings("unchecked")
-    protected <T> List<T> filterPlugins(Class<T> type) {
+    private <T> List<T> filterPlugins(Class<T> type) {
         return plugins.stream().filter(x -> type.isAssignableFrom(x.getClass())).map(p -> ((T) p)).collect(Collectors.toList());
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
index bfac286bc3c35..9663e41a647a8 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
@@ -614,8 +614,7 @@ public void testGetConfigurationByContextName() throws Exception {
             "xpack.security.authc.realms.ldap.realm1.ssl",
             "xpack.security.authc.realms.saml.realm2.ssl",
             "xpack.monitoring.exporters.mon1.ssl",
-            "xpack.monitoring.exporters.mon2.ssl",
-            "xpack.inference.elastic.http.ssl" };
+            "xpack.monitoring.exporters.mon2.ssl" };
 
         assumeTrue("Not enough cipher suites are available to support this test", getCipherSuites.length >= contextNames.length);
 
diff --git a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java
index c7b3a9d42f579..3b0fc869c8124 100644
--- a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java
+++ b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.test.ESIntegTestCase;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
 import org.elasticsearch.xpack.inference.Utils;
 import org.elasticsearch.xpack.inference.mock.TestDenseInferenceServiceExtension;
 import org.elasticsearch.xpack.inference.mock.TestSparseInferenceServiceExtension;
@@ -59,7 +58,7 @@ public void setup() throws Exception {
 
     @Override
     protected Collection<Class<? extends Plugin>> nodePlugins() {
-        return Arrays.asList(LocalStateInferencePlugin.class);
+        return Arrays.asList(Utils.TestInferencePlugin.class);
     }
 
     public void testBulkOperations() throws Exception {
diff --git a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java
index d5c156d1d4f46..be6b3725b0f35 100644
--- a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java
+++ b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java
@@ -31,7 +31,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xcontent.ToXContentObject;
 import org.elasticsearch.xcontent.XContentBuilder;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.inference.chunking.ChunkingSettingsTests;
 import org.elasticsearch.xpack.inference.registry.ModelRegistry;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalModel;
@@ -76,7 +76,7 @@ public void createComponents() {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return pluginList(ReindexPlugin.class, LocalStateInferencePlugin.class);
+        return pluginList(ReindexPlugin.class, InferencePlugin.class);
     }
 
     public void testStoreModel() throws Exception {
diff --git a/x-pack/plugin/inference/src/main/java/module-info.java b/x-pack/plugin/inference/src/main/java/module-info.java
index 1c2240e8c5217..53974657e4e23 100644
--- a/x-pack/plugin/inference/src/main/java/module-info.java
+++ b/x-pack/plugin/inference/src/main/java/module-info.java
@@ -34,7 +34,6 @@
     requires software.amazon.awssdk.retries.api;
     requires org.reactivestreams;
     requires org.elasticsearch.logging;
-    requires org.elasticsearch.sslconfig;
 
     exports org.elasticsearch.xpack.inference.action;
     exports org.elasticsearch.xpack.inference.registry;
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
index 93743a5485c2c..ea92b7d98fe30 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.indices.SystemIndexDescriptor;
 import org.elasticsearch.inference.InferenceServiceExtension;
 import org.elasticsearch.inference.InferenceServiceRegistry;
-import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.node.PluginComponentBinding;
 import org.elasticsearch.plugins.ActionPlugin;
 import org.elasticsearch.plugins.ExtensiblePlugin;
@@ -46,7 +45,6 @@
 import org.elasticsearch.threadpool.ScalingExecutorBuilder;
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xpack.core.ClientHelper;
-import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.core.action.XPackUsageFeatureAction;
 import org.elasticsearch.xpack.core.inference.action.DeleteInferenceEndpointAction;
 import org.elasticsearch.xpack.core.inference.action.GetInferenceDiagnosticsAction;
@@ -56,7 +54,6 @@
 import org.elasticsearch.xpack.core.inference.action.PutInferenceModelAction;
 import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
 import org.elasticsearch.xpack.core.inference.action.UpdateInferenceModelAction;
-import org.elasticsearch.xpack.core.ssl.SSLService;
 import org.elasticsearch.xpack.inference.action.TransportDeleteInferenceEndpointAction;
 import org.elasticsearch.xpack.inference.action.TransportGetInferenceDiagnosticsAction;
 import org.elasticsearch.xpack.inference.action.TransportGetInferenceModelAction;
@@ -121,6 +118,7 @@
 import java.util.Map;
 import java.util.function.Predicate;
 import java.util.function.Supplier;
+import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 import static java.util.Collections.singletonList;
@@ -154,7 +152,6 @@ public class InferencePlugin extends Plugin implements ActionPlugin, ExtensibleP
     private final Settings settings;
     private final SetOnce<HttpRequestSender.Factory> httpFactory = new SetOnce<>();
     private final SetOnce<AmazonBedrockRequestSender.Factory> amazonBedrockFactory = new SetOnce<>();
-    private final SetOnce<HttpRequestSender.Factory> elasicInferenceServiceFactory = new SetOnce<>();
     private final SetOnce<ServiceComponents> serviceComponents = new SetOnce<>();
     private final SetOnce<ElasticInferenceServiceComponents> elasticInferenceServiceComponents = new SetOnce<>();
     private final SetOnce<InferenceServiceRegistry> inferenceServiceRegistry = new SetOnce<>();
@@ -237,31 +234,31 @@ public Collection<?> createComponents(PluginServices services) {
         var inferenceServices = new ArrayList<>(inferenceServiceExtensions);
         inferenceServices.add(this::getInferenceServiceFactories);
 
-        if (isElasticInferenceServiceEnabled()) {
-            // Create a separate instance of HTTPClientManager with its own SSL configuration (`xpack.inference.elastic.http.ssl.*`).
-            var elasticInferenceServiceHttpClientManager = HttpClientManager.create(
-                settings,
-                services.threadPool(),
-                services.clusterService(),
-                throttlerManager,
-                getSslService()
-            );
+        // Set elasticInferenceUrl based on feature flags to support transitioning to the new Elastic Inference Service URL without exposing
+        // internal names like "eis" or "gateway".
+        ElasticInferenceServiceSettings inferenceServiceSettings = new ElasticInferenceServiceSettings(settings);
+
+        String elasticInferenceUrl = null;
 
-            var elasticInferenceServiceRequestSenderFactory = new HttpRequestSender.Factory(
-                serviceComponents.get(),
-                elasticInferenceServiceHttpClientManager,
-                services.clusterService()
+        if (ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
+            elasticInferenceUrl = inferenceServiceSettings.getElasticInferenceServiceUrl();
+        } else if (DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
+            log.warn(
+                "Deprecated flag {} detected for enabling {}. Please use {}.",
+                ELASTIC_INFERENCE_SERVICE_IDENTIFIER,
+                DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG,
+                ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG
             );
-            elasicInferenceServiceFactory.set(elasticInferenceServiceRequestSenderFactory);
+            elasticInferenceUrl = inferenceServiceSettings.getEisGatewayUrl();
+        }
 
-            ElasticInferenceServiceSettings inferenceServiceSettings = new ElasticInferenceServiceSettings(settings);
-            String elasticInferenceUrl = this.getElasticInferenceServiceUrl(inferenceServiceSettings);
+        if (elasticInferenceUrl != null) {
             elasticInferenceServiceComponents.set(new ElasticInferenceServiceComponents(elasticInferenceUrl));
 
             inferenceServices.add(
                 () -> List.of(
                     context -> new ElasticInferenceService(
-                        elasicInferenceServiceFactory.get(),
+                        httpFactory.get(),
                         serviceComponents.get(),
                         elasticInferenceServiceComponents.get()
                     )
@@ -384,21 +381,16 @@ public static ExecutorBuilder<?> inferenceUtilityExecutor(Settings settings) {
 
     @Override
     public List<Setting<?>> getSettings() {
-        ArrayList<Setting<?>> settings = new ArrayList<>();
-        settings.addAll(HttpSettings.getSettingsDefinitions());
-        settings.addAll(HttpClientManager.getSettingsDefinitions());
-        settings.addAll(ThrottlerManager.getSettingsDefinitions());
-        settings.addAll(RetrySettings.getSettingsDefinitions());
-        settings.addAll(Truncator.getSettingsDefinitions());
-        settings.addAll(RequestExecutorServiceSettings.getSettingsDefinitions());
-        settings.add(SKIP_VALIDATE_AND_START);
-
-        // Register Elastic Inference Service settings definitions if the corresponding feature flag is enabled.
-        if (isElasticInferenceServiceEnabled()) {
-            settings.addAll(ElasticInferenceServiceSettings.getSettingsDefinitions());
-        }
-
-        return settings;
+        return Stream.of(
+            HttpSettings.getSettingsDefinitions(),
+            HttpClientManager.getSettingsDefinitions(),
+            ThrottlerManager.getSettingsDefinitions(),
+            RetrySettings.getSettingsDefinitions(),
+            ElasticInferenceServiceSettings.getSettingsDefinitions(),
+            Truncator.getSettingsDefinitions(),
+            RequestExecutorServiceSettings.getSettingsDefinitions(),
+            List.of(SKIP_VALIDATE_AND_START)
+        ).flatMap(Collection::stream).collect(Collectors.toList());
     }
 
     @Override
@@ -446,10 +438,7 @@ public List<QueryRewriteInterceptor> getQueryRewriteInterceptors() {
     @Override
     public List<RetrieverSpec<?>> getRetrievers() {
         return List.of(
-            new RetrieverSpec<>(
-                new ParseField(TextSimilarityRankBuilder.NAME),
-                (parser, context) -> TextSimilarityRankRetrieverBuilder.fromXContent(parser, context, getLicenseState())
-            ),
+            new RetrieverSpec<>(new ParseField(TextSimilarityRankBuilder.NAME), TextSimilarityRankRetrieverBuilder::fromXContent),
             new RetrieverSpec<>(new ParseField(RandomRankBuilder.NAME), RandomRankRetrieverBuilder::fromXContent)
         );
     }
@@ -458,36 +447,4 @@ public List<RetrieverSpec<?>> getRetrievers() {
     public Map<String, Highlighter> getHighlighters() {
         return Map.of(SemanticTextHighlighter.NAME, new SemanticTextHighlighter());
     }
-
-    // Get Elastic Inference service URL based on feature flags to support transitioning
-    // to the new Elastic Inference Service URL.
-    private String getElasticInferenceServiceUrl(ElasticInferenceServiceSettings settings) {
-        String elasticInferenceUrl = null;
-
-        if (ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
-            elasticInferenceUrl = settings.getElasticInferenceServiceUrl();
-        } else if (DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
-            log.warn(
-                "Deprecated flag {} detected for enabling {}. Please use {}.",
-                ELASTIC_INFERENCE_SERVICE_IDENTIFIER,
-                DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG,
-                ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG
-            );
-            elasticInferenceUrl = settings.getEisGatewayUrl();
-        }
-
-        return elasticInferenceUrl;
-    }
-
-    protected Boolean isElasticInferenceServiceEnabled() {
-        return (ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled() || DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled());
-    }
-
-    protected SSLService getSslService() {
-        return XPackPlugin.getSharedSslService();
-    }
-
-    protected XPackLicenseState getLicenseState() {
-        return XPackPlugin.getSharedLicenseState();
-    }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java
index 6d09c9e67b363..e5d76b9bb5570 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java
@@ -7,14 +7,9 @@
 
 package org.elasticsearch.xpack.inference.external.http;
 
-import org.apache.http.config.Registry;
-import org.apache.http.config.RegistryBuilder;
 import org.apache.http.impl.nio.conn.PoolingNHttpClientConnectionManager;
 import org.apache.http.impl.nio.reactor.DefaultConnectingIOReactor;
 import org.apache.http.impl.nio.reactor.IOReactorConfig;
-import org.apache.http.nio.conn.NoopIOSessionStrategy;
-import org.apache.http.nio.conn.SchemeIOSessionStrategy;
-import org.apache.http.nio.conn.ssl.SSLIOSessionStrategy;
 import org.apache.http.nio.reactor.ConnectingIOReactor;
 import org.apache.http.nio.reactor.IOReactorException;
 import org.apache.http.pool.PoolStats;
@@ -26,7 +21,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.threadpool.ThreadPool;
-import org.elasticsearch.xpack.core.ssl.SSLService;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
 
 import java.io.Closeable;
@@ -34,13 +28,11 @@
 import java.util.List;
 
 import static org.elasticsearch.core.Strings.format;
-import static org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceSettings.ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX;
 
 public class HttpClientManager implements Closeable {
     private static final Logger logger = LogManager.getLogger(HttpClientManager.class);
     /**
      * The maximum number of total connections the connection pool can lease to all routes.
-     * The configuration applies to each instance of HTTPClientManager (max_total_connections=10 and instances=5 leads to 50 connections).
      * From googling around the connection pools maxTotal value should be close to the number of available threads.
      *
      * https://stackoverflow.com/questions/30989637/how-to-decide-optimal-settings-for-setmaxtotal-and-setdefaultmaxperroute
@@ -55,7 +47,6 @@ public class HttpClientManager implements Closeable {
 
     /**
      * The max number of connections a single route can lease.
-     * This configuration applies to each instance of HttpClientManager.
      */
     public static final Setting<Integer> MAX_ROUTE_CONNECTIONS = Setting.intSetting(
         "xpack.inference.http.max_route_connections",
@@ -107,22 +98,6 @@ public static HttpClientManager create(
         return new HttpClientManager(settings, connectionManager, threadPool, clusterService, throttlerManager);
     }
 
-    public static HttpClientManager create(
-        Settings settings,
-        ThreadPool threadPool,
-        ClusterService clusterService,
-        ThrottlerManager throttlerManager,
-        SSLService sslService
-    ) {
-        // Set the sslStrategy to ensure an encrypted connection, as Elastic Inference Service requires it.
-        SSLIOSessionStrategy sslioSessionStrategy = sslService.sslIOSessionStrategy(
-            sslService.getSSLConfiguration(ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX)
-        );
-
-        PoolingNHttpClientConnectionManager connectionManager = createConnectionManager(sslioSessionStrategy);
-        return new HttpClientManager(settings, connectionManager, threadPool, clusterService, throttlerManager);
-    }
-
     // Default for testing
     HttpClientManager(
         Settings settings,
@@ -146,25 +121,6 @@ public static HttpClientManager create(
         this.addSettingsUpdateConsumers(clusterService);
     }
 
-    private static PoolingNHttpClientConnectionManager createConnectionManager(SSLIOSessionStrategy sslStrategy) {
-        ConnectingIOReactor ioReactor;
-        try {
-            var configBuilder = IOReactorConfig.custom().setSoKeepAlive(true);
-            ioReactor = new DefaultConnectingIOReactor(configBuilder.build());
-        } catch (IOReactorException e) {
-            var message = "Failed to initialize HTTP client manager with SSL.";
-            logger.error(message, e);
-            throw new ElasticsearchException(message, e);
-        }
-
-        Registry<SchemeIOSessionStrategy> registry = RegistryBuilder.<SchemeIOSessionStrategy>create()
-            .register("http", NoopIOSessionStrategy.INSTANCE)
-            .register("https", sslStrategy)
-            .build();
-
-        return new PoolingNHttpClientConnectionManager(ioReactor, registry);
-    }
-
     private static PoolingNHttpClientConnectionManager createConnectionManager() {
         ConnectingIOReactor ioReactor;
         try {
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
index f54696895a818..fd2427dc8ac6a 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.license.LicenseUtils;
-import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.search.rank.RankDoc;
 import org.elasticsearch.search.retriever.CompoundRetrieverBuilder;
@@ -22,6 +21,7 @@
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.XPackPlugin;
 
 import java.io.IOException;
 import java.util.List;
@@ -73,11 +73,8 @@ public class TextSimilarityRankRetrieverBuilder extends CompoundRetrieverBuilder
         RetrieverBuilder.declareBaseParserFields(TextSimilarityRankBuilder.NAME, PARSER);
     }
 
-    public static TextSimilarityRankRetrieverBuilder fromXContent(
-        XContentParser parser,
-        RetrieverParserContext context,
-        XPackLicenseState licenceState
-    ) throws IOException {
+    public static TextSimilarityRankRetrieverBuilder fromXContent(XContentParser parser, RetrieverParserContext context)
+        throws IOException {
         if (context.clusterSupportsFeature(TEXT_SIMILARITY_RERANKER_RETRIEVER_SUPPORTED) == false) {
             throw new ParsingException(parser.getTokenLocation(), "unknown retriever [" + TextSimilarityRankBuilder.NAME + "]");
         }
@@ -86,7 +83,7 @@ public static TextSimilarityRankRetrieverBuilder fromXContent(
                 "[text_similarity_reranker] retriever composition feature is not supported by all nodes in the cluster"
             );
         }
-        if (TextSimilarityRankBuilder.TEXT_SIMILARITY_RERANKER_FEATURE.check(licenceState) == false) {
+        if (TextSimilarityRankBuilder.TEXT_SIMILARITY_RERANKER_FEATURE.check(XPackPlugin.getSharedLicenseState()) == false) {
             throw LicenseUtils.newComplianceException(TextSimilarityRankBuilder.NAME);
         }
         return PARSER.apply(parser, context);
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java
index 431a3647e2879..bc2daddc2a346 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java
@@ -9,9 +9,7 @@
 
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.xpack.core.ssl.SSLConfigurationSettings;
 
-import java.util.ArrayList;
 import java.util.List;
 
 public class ElasticInferenceServiceSettings {
@@ -19,8 +17,6 @@ public class ElasticInferenceServiceSettings {
     @Deprecated
     static final Setting<String> EIS_GATEWAY_URL = Setting.simpleString("xpack.inference.eis.gateway.url", Setting.Property.NodeScope);
 
-    public static final String ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX = "xpack.inference.elastic.http.ssl.";
-
     static final Setting<String> ELASTIC_INFERENCE_SERVICE_URL = Setting.simpleString(
         "xpack.inference.elastic.url",
         Setting.Property.NodeScope
@@ -35,27 +31,11 @@ public class ElasticInferenceServiceSettings {
     public ElasticInferenceServiceSettings(Settings settings) {
         eisGatewayUrl = EIS_GATEWAY_URL.get(settings);
         elasticInferenceServiceUrl = ELASTIC_INFERENCE_SERVICE_URL.get(settings);
-    }
-
-    public static final SSLConfigurationSettings ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_SETTINGS = SSLConfigurationSettings.withPrefix(
-        ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX,
-        false
-    );
 
-    public static final Setting<Boolean> ELASTIC_INFERENCE_SERVICE_SSL_ENABLED = Setting.boolSetting(
-        ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX + "enabled",
-        true,
-        Setting.Property.NodeScope
-    );
+    }
 
     public static List<Setting<?>> getSettingsDefinitions() {
-        ArrayList<Setting<?>> settings = new ArrayList<>();
-        settings.add(EIS_GATEWAY_URL);
-        settings.add(ELASTIC_INFERENCE_SERVICE_URL);
-        settings.add(ELASTIC_INFERENCE_SERVICE_SSL_ENABLED);
-        settings.addAll(ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_SETTINGS.getEnabledSettings());
-
-        return settings;
+        return List.of(EIS_GATEWAY_URL, ELASTIC_INFERENCE_SERVICE_URL);
     }
 
     @Deprecated
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java
index 61033a0211065..bfec2d5ac3484 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java
@@ -14,7 +14,6 @@
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
-import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.hamcrest.Matchers;
 
@@ -29,7 +28,7 @@ public class SemanticTextClusterMetadataTests extends ESSingleNodeTestCase {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(XPackPlugin.class, InferencePlugin.class);
+        return List.of(InferencePlugin.class);
     }
 
     public void testCreateIndexWithSemanticTextField() {
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java
deleted file mode 100644
index d1db5b8b12cc6..0000000000000
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java
+++ /dev/null
@@ -1,65 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.inference;
-
-import org.elasticsearch.common.settings.Setting;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceSettings;
-import org.junit.After;
-import org.junit.Before;
-
-import static org.hamcrest.Matchers.is;
-
-public class InferencePluginTests extends ESTestCase {
-    private InferencePlugin inferencePlugin;
-
-    private Boolean elasticInferenceServiceEnabled = true;
-
-    private void setElasticInferenceServiceEnabled(Boolean elasticInferenceServiceEnabled) {
-        this.elasticInferenceServiceEnabled = elasticInferenceServiceEnabled;
-    }
-
-    @Before
-    public void setUp() throws Exception {
-        super.setUp();
-
-        Settings settings = Settings.builder().build();
-        inferencePlugin = new InferencePlugin(settings) {
-            @Override
-            protected Boolean isElasticInferenceServiceEnabled() {
-                return elasticInferenceServiceEnabled;
-            }
-        };
-    }
-
-    @After
-    public void tearDown() throws Exception {
-        super.tearDown();
-    }
-
-    public void testElasticInferenceServiceSettingsPresent() throws Exception {
-        setElasticInferenceServiceEnabled(true); // enable elastic inference service
-        boolean anyMatch = inferencePlugin.getSettings()
-            .stream()
-            .map(Setting::getKey)
-            .anyMatch(key -> key.startsWith(ElasticInferenceServiceSettings.ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX));
-
-        assertThat("xpack.inference.elastic settings are present", anyMatch, is(true));
-    }
-
-    public void testElasticInferenceServiceSettingsNotPresent() throws Exception {
-        setElasticInferenceServiceEnabled(false); // disable elastic inference service
-        boolean noneMatch = inferencePlugin.getSettings()
-            .stream()
-            .map(Setting::getKey)
-            .noneMatch(key -> key.startsWith(ElasticInferenceServiceSettings.ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX));
-
-        assertThat("xpack.inference.elastic settings are not present", noneMatch, is(true));
-    }
-}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java
deleted file mode 100644
index 68ea175bd9870..0000000000000
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java
+++ /dev/null
@@ -1,71 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.inference;
-
-import org.elasticsearch.action.support.MappedActionFilter;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.index.mapper.Mapper;
-import org.elasticsearch.inference.InferenceServiceExtension;
-import org.elasticsearch.license.XPackLicenseState;
-import org.elasticsearch.plugins.SearchPlugin;
-import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
-import org.elasticsearch.xpack.core.ssl.SSLService;
-import org.elasticsearch.xpack.inference.mock.TestDenseInferenceServiceExtension;
-import org.elasticsearch.xpack.inference.mock.TestSparseInferenceServiceExtension;
-
-import java.nio.file.Path;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static java.util.stream.Collectors.toList;
-
-public class LocalStateInferencePlugin extends LocalStateCompositeXPackPlugin {
-    private final InferencePlugin inferencePlugin;
-
-    public LocalStateInferencePlugin(final Settings settings, final Path configPath) throws Exception {
-        super(settings, configPath);
-        LocalStateInferencePlugin thisVar = this;
-        this.inferencePlugin = new InferencePlugin(settings) {
-            @Override
-            protected SSLService getSslService() {
-                return thisVar.getSslService();
-            }
-
-            @Override
-            protected XPackLicenseState getLicenseState() {
-                return thisVar.getLicenseState();
-            }
-
-            @Override
-            public List<InferenceServiceExtension.Factory> getInferenceServiceFactories() {
-                return List.of(
-                    TestSparseInferenceServiceExtension.TestInferenceService::new,
-                    TestDenseInferenceServiceExtension.TestInferenceService::new
-                );
-            }
-        };
-        plugins.add(inferencePlugin);
-    }
-
-    @Override
-    public List<RetrieverSpec<?>> getRetrievers() {
-        return this.filterPlugins(SearchPlugin.class).stream().flatMap(p -> p.getRetrievers().stream()).collect(toList());
-    }
-
-    @Override
-    public Map<String, Mapper.TypeParser> getMappers() {
-        return inferencePlugin.getMappers();
-    }
-
-    @Override
-    public Collection<MappedActionFilter> getMappedActionFilters() {
-        return inferencePlugin.getMappedActionFilters();
-    }
-
-}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
index 0f322e64755be..9395ae222e9ba 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.index.mapper.vectors.DenseVectorFieldMapper;
+import org.elasticsearch.inference.InferenceServiceExtension;
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.ModelConfigurations;
 import org.elasticsearch.inference.ModelSecrets;
@@ -142,6 +143,20 @@ private static <T> void blockingCall(
         latch.await();
     }
 
+    public static class TestInferencePlugin extends InferencePlugin {
+        public TestInferencePlugin(Settings settings) {
+            super(settings);
+        }
+
+        @Override
+        public List<InferenceServiceExtension.Factory> getInferenceServiceFactories() {
+            return List.of(
+                TestSparseInferenceServiceExtension.TestInferenceService::new,
+                TestDenseInferenceServiceExtension.TestInferenceService::new
+            );
+        }
+    }
+
     public static Model getInvalidModel(String inferenceEntityId, String serviceName) {
         var mockConfigs = mock(ModelConfigurations.class);
         when(mockConfigs.getInferenceEntityId()).thenReturn(inferenceEntityId);
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java
index 24183b21f73e7..1f58c4165056d 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java
@@ -9,7 +9,6 @@
 
 import org.elasticsearch.index.mapper.NonDynamicFieldMapperTests;
 import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
 import org.elasticsearch.xpack.inference.Utils;
 import org.elasticsearch.xpack.inference.mock.TestSparseInferenceServiceExtension;
 import org.junit.Before;
@@ -27,7 +26,7 @@ public void setup() throws Exception {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(LocalStateInferencePlugin.class);
+        return List.of(Utils.TestInferencePlugin.class);
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java
index daed03c198e0d..6d6403b69ea11 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java
@@ -10,7 +10,7 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.search.rank.RankBuilder;
 import org.elasticsearch.search.rank.rerank.AbstractRerankerIT;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 
 import java.util.Collection;
 import java.util.List;
@@ -40,7 +40,7 @@ protected RankBuilder getThrowingRankBuilder(int rankWindowSize, String rankFeat
 
     @Override
     protected Collection<Class<? extends Plugin>> pluginsNeeded() {
-        return List.of(LocalStateInferencePlugin.class, TextSimilarityTestPlugin.class);
+        return List.of(InferencePlugin.class, TextSimilarityTestPlugin.class);
     }
 
     public void testQueryPhaseShardThrowingAllShardsFail() throws Exception {
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java
index ba6924ba0ff3b..084a7f3de4a53 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java
@@ -24,7 +24,8 @@
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentFactory;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.core.XPackPlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.junit.Before;
 
 import java.io.IOException;
@@ -46,7 +47,7 @@ protected boolean addMockHttpTransport() {
 
     @Override
     protected Collection<Class<? extends Plugin>> nodePlugins() {
-        return List.of(LocalStateInferencePlugin.class, TextSimilarityTestPlugin.class);
+        return List.of(InferencePlugin.class, XPackPlugin.class, TextSimilarityTestPlugin.class);
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java
index f81f2965c392e..a042fca44fdb5 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java
@@ -20,7 +20,7 @@
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.test.hamcrest.ElasticsearchAssertions;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.junit.Before;
 
 import java.util.Collection;
@@ -108,7 +108,7 @@ protected InferenceAction.Request generateRequest(List<String> docFeatures) {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(LocalStateInferencePlugin.class, TextSimilarityTestPlugin.class);
+        return List.of(InferencePlugin.class, TextSimilarityTestPlugin.class);
     }
 
     @Before
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java
index ff1a1d19779df..bab012afc3101 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
 import org.elasticsearch.xpack.core.rollup.action.GetRollupIndexCapsAction;
 import org.elasticsearch.xpack.core.ssl.SSLService;
-import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.monitoring.Monitoring;
 import org.elasticsearch.xpack.security.Security;
 
@@ -87,12 +86,6 @@ protected XPackLicenseState getLicenseState() {
             }
         });
         plugins.add(new MockedRollupPlugin());
-        plugins.add(new InferencePlugin(settings) {
-            @Override
-            protected SSLService getSslService() {
-                return thisVar.getSslService();
-            }
-        });
     }
 
     @Override
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
index 5cf15454e47f2..aeebfabdce704 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
@@ -82,6 +82,7 @@
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.DataCounts;
 import org.elasticsearch.xpack.core.ml.utils.MlTaskState;
 import org.elasticsearch.xpack.ilm.IndexLifecycle;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.ml.LocalStateMachineLearning;
 import org.elasticsearch.xpack.ml.MachineLearning;
 import org.elasticsearch.xpack.ml.MlSingleNodeTestCase;
@@ -160,7 +161,8 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
             DataStreamsPlugin.class,
             // To remove errors from parsing build in templates that contain scaled_float
             MapperExtrasPlugin.class,
-            Wildcard.class
+            Wildcard.class,
+            InferencePlugin.class
         );
     }
 
diff --git a/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java b/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java
index 057ebdece5c61..ab5be0f48f5f3 100644
--- a/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java
+++ b/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.xpack.frozen.FrozenIndices;
 import org.elasticsearch.xpack.graph.Graph;
 import org.elasticsearch.xpack.ilm.IndexLifecycle;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.profiling.ProfilingPlugin;
 import org.elasticsearch.xpack.rollup.Rollup;
 import org.elasticsearch.xpack.search.AsyncSearch;
@@ -88,6 +89,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
                 FrozenIndices.class,
                 Graph.class,
                 IndexLifecycle.class,
+                InferencePlugin.class,
                 IngestCommonPlugin.class,
                 IngestTestPlugin.class,
                 MustachePlugin.class,

From e6a27a91eeb4b1876287ce80cffc4efa7c4f3448 Mon Sep 17 00:00:00 2001
From: Alexis Charveriat <alcharveriat@gmail.com>
Date: Mon, 16 Dec 2024 16:34:41 +0100
Subject: [PATCH 011/119] tier_preference and creation_date fields in
 monitoring template (#117851)

* tier_preference and creation_date fields in monitoring template

* Added index version

* Update docs/changelog/117851.yaml

* Updated changelog

* Incremented STACK_MONITORING_REGISTRY_VERSION
---
 docs/changelog/117851.yaml                            |  5 +++++
 .../src/main/resources/monitoring-es-mb.json          | 11 +++++++++++
 .../xpack/monitoring/MonitoringTemplateRegistry.java  |  2 +-
 3 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 docs/changelog/117851.yaml

diff --git a/docs/changelog/117851.yaml b/docs/changelog/117851.yaml
new file mode 100644
index 0000000000000..21888cd6fb80f
--- /dev/null
+++ b/docs/changelog/117851.yaml
@@ -0,0 +1,5 @@
+pr: 117851
+summary: Addition of `tier_preference`, `creation_date` and `version` fields in Elasticsearch monitoring template
+area: Monitoring
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/core/template-resources/src/main/resources/monitoring-es-mb.json b/x-pack/plugin/core/template-resources/src/main/resources/monitoring-es-mb.json
index 2bf7607e86d32..793a8c3035d8e 100644
--- a/x-pack/plugin/core/template-resources/src/main/resources/monitoring-es-mb.json
+++ b/x-pack/plugin/core/template-resources/src/main/resources/monitoring-es-mb.json
@@ -1517,6 +1517,17 @@
                   "ignore_above": 1024,
                   "type": "keyword"
                 },
+                "tier_preference": {
+                  "ignore_above": 1024,
+                  "type": "keyword"
+                },
+                "creation_date": {
+                  "type": "date"
+                },
+                "version": {
+                  "ignore_above": 1024,
+                  "type": "keyword"
+                },
                 "recovery": {
                   "properties": {
                     "stop_time": {
diff --git a/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/MonitoringTemplateRegistry.java b/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/MonitoringTemplateRegistry.java
index e0433ea6fdd71..cfd322d04e92f 100644
--- a/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/MonitoringTemplateRegistry.java
+++ b/x-pack/plugin/monitoring/src/main/java/org/elasticsearch/xpack/monitoring/MonitoringTemplateRegistry.java
@@ -77,7 +77,7 @@ public class MonitoringTemplateRegistry extends IndexTemplateRegistry {
      * writes monitoring data in ECS format as of 8.0. These templates define the ECS schema as well as alias fields for the old monitoring
      * mappings that point to the corresponding ECS fields.
      */
-    public static final int STACK_MONITORING_REGISTRY_VERSION = 8_00_00_99 + 18;
+    public static final int STACK_MONITORING_REGISTRY_VERSION = 8_00_00_99 + 19;
     private static final String STACK_MONITORING_REGISTRY_VERSION_VARIABLE = "xpack.stack.monitoring.template.release.version";
     private static final String STACK_TEMPLATE_VERSION = "8";
     private static final String STACK_TEMPLATE_VERSION_VARIABLE = "xpack.stack.monitoring.template.version";

From bded35bb39c4977c8255c2ffc3e06a7a9fa9b1dc Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Mon, 16 Dec 2024 17:14:16 +0100
Subject: [PATCH 012/119] ESQL: Add LOOKUP JOIN tests with null and mv join
 keys (#118761)

Notable behavior: - `null` join keys never match anything, even a `null`
from the left hand side. - If a lookup index document has multi-valued
join keys, it will match with all left hand side rows that contain any
of the multi-values. - If the left hand side has multi-values, it will
match with any lookup index document whose join key contains any of the
multi-values.
---
 .../resources/languages_non_unique_key.csv    |  4 ++
 .../src/main/resources/lookup-join.csv-spec   | 67 +++++++++++++++++++
 2 files changed, 71 insertions(+)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages_non_unique_key.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages_non_unique_key.csv
index 1578762f8d1cb..d6381b174d739 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages_non_unique_key.csv
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages_non_unique_key.csv
@@ -8,3 +8,7 @@ language_code:integer,language_name:keyword,country:keyword
 2,German,
 4,Quenya,
 5,,Atlantis
+[6,7],Mv-Lang,Mv-Land
+[7,8],Mv-Lang2,Mv-Land2
+,Null-Lang,Null-Land
+,Null-Lang2,Null-Land2
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index c39f4ae7b4e0c..7fed4f377096f 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -178,6 +178,73 @@ language_code:integer | language_name:keyword       | country:keyword
 2                     | [German, German, German]    | [Austria, Germany, Switzerland]
 ;
 
+nullJoinKeyOnTheDataNode
+required_capability: join_lookup_v5
+
+FROM employees
+| WHERE emp_no < 10004
+| EVAL language_code = emp_no % 10, language_code = CASE(language_code == 3, null, language_code)
+| LOOKUP JOIN languages_lookup_non_unique_key ON language_code
+| SORT emp_no
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10001          | 1                     | [English, English, English]
+10002          | 2                     | [German, German, German]
+10003          | null                  | null
+;
+
+
+mvJoinKeyOnTheDataNode
+required_capability: join_lookup_v5
+
+FROM employees
+| WHERE 10003 < emp_no AND emp_no < 10008
+| EVAL language_code = emp_no % 10
+| LOOKUP JOIN languages_lookup_non_unique_key ON language_code
+| SORT emp_no
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10004          | 4                     | Quenya
+10005          | 5                     | null
+10006          | 6                     | Mv-Lang
+10007          | 7                     | [Mv-Lang, Mv-Lang2]
+;
+
+mvJoinKeyFromRow
+required_capability: join_lookup_v5
+
+ROW language_code = [4, 5, 6, 7]
+| LOOKUP JOIN languages_lookup_non_unique_key ON language_code
+| EVAL language_name = MV_SORT(language_name), country = MV_SORT(country)
+| KEEP language_code, language_name, country
+;
+
+language_code:integer | language_name:keyword       | country:keyword
+[4, 5, 6, 7]          | [Mv-Lang, Mv-Lang2, Quenya] | [Atlantis, Mv-Land, Mv-Land2]
+;
+
+mvJoinKeyFromRowExpanded
+required_capability: join_lookup_v5
+
+ROW language_code = [4, 5, 6, 7, 8]
+| MV_EXPAND language_code
+| LOOKUP JOIN languages_lookup_non_unique_key ON language_code
+| EVAL language_name = MV_SORT(language_name), country = MV_SORT(country)
+| KEEP language_code, language_name, country
+;
+
+language_code:integer | language_name:keyword       | country:keyword
+4                     | Quenya                      | null
+5                     | null                        | Atlantis
+6                     | Mv-Lang                     | Mv-Land
+7                     | [Mv-Lang, Mv-Lang2]         | [Mv-Land, Mv-Land2]
+8                     | Mv-Lang2                    | Mv-Land2
+;
+
 lookupIPFromRow
 required_capability: join_lookup_v5
 

From 693bb794bce43eb20d07b08ceba5e796ded6efbd Mon Sep 17 00:00:00 2001
From: Salvatore Campagna
 <93581129+salvatore-campagna@users.noreply.github.com>
Date: Mon, 16 Dec 2024 17:27:45 +0100
Subject: [PATCH 013/119] Expose shard changes action as a rest api (#118608)

This PR adds a new REST API `/{index}/ccr/shard_changes` to retrieve shard-level changes, including translog operations, mapping versions, and sequence numbers. It is required for a new set of Rally benchmarks, which will be used to evaluate the impact of synthetic source on recovery time. The API accepts parameters like `from_seq_no`, `max_batch_size`, `poll_timeout`, and `max_operations_count` and is exposed only in snapshot builds.
---
 x-pack/plugin/ccr/build.gradle                |  11 +
 .../xpack/ccr/rest/ShardChangesRestIT.java    | 281 ++++++++++++++++
 .../java/org/elasticsearch/xpack/ccr/Ccr.java |  50 +--
 .../ccr/rest/RestShardChangesAction.java      | 300 ++++++++++++++++++
 4 files changed, 623 insertions(+), 19 deletions(-)
 create mode 100644 x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java
 create mode 100644 x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java

diff --git a/x-pack/plugin/ccr/build.gradle b/x-pack/plugin/ccr/build.gradle
index f673513950bb4..b5e96ac2a8b34 100644
--- a/x-pack/plugin/ccr/build.gradle
+++ b/x-pack/plugin/ccr/build.gradle
@@ -1,5 +1,6 @@
 apply plugin: 'elasticsearch.internal-es-plugin'
 apply plugin: 'elasticsearch.internal-cluster-test'
+apply plugin: 'elasticsearch.internal-java-rest-test'
 esplugin {
   name 'x-pack-ccr'
   description 'Elasticsearch Expanded Pack Plugin - CCR'
@@ -33,6 +34,16 @@ tasks.named('internalClusterTestTestingConventions').configure {
   baseClass 'org.elasticsearch.test.ESIntegTestCase'
 }
 
+tasks.named("javaRestTest").configure {
+  usesDefaultDistribution()
+}
+
+restResources {
+  restApi {
+    include 'bulk', 'search', '_common', 'indices', 'index', 'cluster', 'data_stream'
+  }
+}
+
 addQaCheckDependencies(project)
 
 dependencies {
diff --git a/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java b/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java
new file mode 100644
index 0000000000000..e5dfea7b772f2
--- /dev/null
+++ b/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java
@@ -0,0 +1,281 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.ccr.rest;
+
+import org.apache.http.util.EntityUtils;
+import org.elasticsearch.Build;
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.Response;
+import org.elasticsearch.client.ResponseException;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.index.IndexSettings;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.test.cluster.ElasticsearchCluster;
+import org.elasticsearch.test.cluster.local.distribution.DistributionType;
+import org.elasticsearch.test.rest.ESRestTestCase;
+import org.elasticsearch.xcontent.json.JsonXContent;
+import org.hamcrest.Matchers;
+import org.junit.Before;
+import org.junit.ClassRule;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+public class ShardChangesRestIT extends ESRestTestCase {
+    private static final String CCR_SHARD_CHANGES_ENDPOINT = "/%s/ccr/shard_changes";
+    private static final String BULK_INDEX_ENDPOINT = "/%s/_bulk";
+
+    private static final String[] SHARD_RESPONSE_FIELDS = new String[] {
+        "took_in_millis",
+        "operations",
+        "shard_id",
+        "index",
+        "settings_version",
+        "max_seq_no_of_updates_or_deletes",
+        "number_of_operations",
+        "mapping_version",
+        "aliases_version",
+        "max_seq_no",
+        "global_checkpoint" };
+    private static final String[] NAMES = { "skywalker", "leia", "obi-wan", "yoda", "chewbacca", "r2-d2", "c-3po", "darth-vader" };
+    @ClassRule
+    public static ElasticsearchCluster cluster = ElasticsearchCluster.local()
+        .distribution(DistributionType.DEFAULT)
+        .setting("xpack.security.enabled", "false")
+        .setting("xpack.license.self_generated.type", "trial")
+        .build();
+
+    @Override
+    protected String getTestRestCluster() {
+        return cluster.getHttpAddresses();
+    }
+
+    @Before
+    public void assumeSnapshotBuild() {
+        assumeTrue("/{index}/ccr/shard_changes endpoint only available in snapshot builds", Build.current().isSnapshot());
+    }
+
+    public void testShardChangesNoOperation() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(
+            indexName,
+            Settings.builder()
+                .put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(IndexSettings.INDEX_TRANSLOG_SYNC_INTERVAL_SETTING.getKey(), "1s")
+                .build()
+        );
+        assertTrue(indexExists(indexName));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        assertOK(client().performRequest(shardChangesRequest));
+    }
+
+    public void testShardChangesDefaultParams() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        final Settings settings = Settings.builder()
+            .put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, 1)
+            .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+            .put(IndexSettings.INDEX_TRANSLOG_SYNC_INTERVAL_SETTING.getKey(), "1s")
+            .build();
+        final String mappings = """
+               {
+                 "properties": {
+                   "name": {
+                     "type": "keyword"
+                   }
+                 }
+               }
+            """;
+        createIndex(indexName, settings, mappings);
+        assertTrue(indexExists(indexName));
+
+        assertOK(client().performRequest(bulkRequest(indexName, randomIntBetween(10, 20))));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        final Response response = client().performRequest(shardChangesRequest);
+        assertOK(response);
+        assertShardChangesResponse(
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false)
+        );
+    }
+
+    public void testShardChangesWithAllParameters() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(
+            indexName,
+            Settings.builder()
+                .put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(IndexSettings.INDEX_TRANSLOG_SYNC_INTERVAL_SETTING.getKey(), "1s")
+                .build()
+        );
+        assertTrue(indexExists(indexName));
+
+        assertOK(client().performRequest(bulkRequest(indexName, randomIntBetween(100, 200))));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        shardChangesRequest.addParameter("from_seq_no", "0");
+        shardChangesRequest.addParameter("max_operations_count", "1");
+        shardChangesRequest.addParameter("poll_timeout", "10s");
+        shardChangesRequest.addParameter("max_batch_size", "1MB");
+
+        final Response response = client().performRequest(shardChangesRequest);
+        assertOK(response);
+        assertShardChangesResponse(
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false)
+        );
+    }
+
+    public void testShardChangesMultipleRequests() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(
+            indexName,
+            Settings.builder()
+                .put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, 1)
+                .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                .put(IndexSettings.INDEX_TRANSLOG_SYNC_INTERVAL_SETTING.getKey(), "1s")
+                .build()
+        );
+        assertTrue(indexExists(indexName));
+
+        assertOK(client().performRequest(bulkRequest(indexName, randomIntBetween(100, 200))));
+
+        final Request firstRequest = new Request("GET", shardChangesEndpoint(indexName));
+        firstRequest.addParameter("from_seq_no", "0");
+        firstRequest.addParameter("max_operations_count", "10");
+        firstRequest.addParameter("poll_timeout", "10s");
+        firstRequest.addParameter("max_batch_size", "1MB");
+
+        final Response firstResponse = client().performRequest(firstRequest);
+        assertOK(firstResponse);
+        assertShardChangesResponse(
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(firstResponse.getEntity()), false)
+        );
+
+        final Request secondRequest = new Request("GET", shardChangesEndpoint(indexName));
+        secondRequest.addParameter("from_seq_no", "10");
+        secondRequest.addParameter("max_operations_count", "10");
+        secondRequest.addParameter("poll_timeout", "10s");
+        secondRequest.addParameter("max_batch_size", "1MB");
+
+        final Response secondResponse = client().performRequest(secondRequest);
+        assertOK(secondResponse);
+        assertShardChangesResponse(
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(secondResponse.getEntity()), false)
+        );
+    }
+
+    public void testShardChangesInvalidFromSeqNo() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(indexName);
+        assertTrue(indexExists(indexName));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        shardChangesRequest.addParameter("from_seq_no", "-1");
+        final ResponseException ex = assertThrows(ResponseException.class, () -> client().performRequest(shardChangesRequest));
+        assertResponseException(ex, RestStatus.BAD_REQUEST, "Validation Failed: 1: fromSeqNo [-1] cannot be lower than 0");
+    }
+
+    public void testShardChangesInvalidMaxOperationsCount() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(indexName);
+        assertTrue(indexExists(indexName));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        shardChangesRequest.addParameter("max_operations_count", "-1");
+        final ResponseException ex = assertThrows(ResponseException.class, () -> client().performRequest(shardChangesRequest));
+        assertResponseException(ex, RestStatus.BAD_REQUEST, "Validation Failed: 1: maxOperationCount [-1] cannot be lower than 0");
+    }
+
+    public void testShardChangesNegativePollTimeout() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(indexName);
+        assertTrue(indexExists(indexName));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        shardChangesRequest.addParameter("poll_timeout", "-1s");
+        assertOK(client().performRequest(shardChangesRequest));
+    }
+
+    public void testShardChangesInvalidMaxBatchSize() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        createIndex(indexName);
+        assertTrue(indexExists(indexName));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        shardChangesRequest.addParameter("max_batch_size", "-1MB");
+        final ResponseException ex = assertThrows(ResponseException.class, () -> client().performRequest(shardChangesRequest));
+        assertResponseException(
+            ex,
+            RestStatus.BAD_REQUEST,
+            "failed to parse setting [max_batch_size] with value [-1MB] as a size in bytes"
+        );
+    }
+
+    public void testShardChangesMissingIndex() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        assertFalse(indexExists(indexName));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
+        final ResponseException ex = assertThrows(ResponseException.class, () -> client().performRequest(shardChangesRequest));
+        assertResponseException(ex, RestStatus.BAD_REQUEST, "Failed to process shard changes for index [" + indexName + "]");
+    }
+
+    private static Request bulkRequest(final String indexName, int numberOfDocuments) {
+        final StringBuilder sb = new StringBuilder();
+
+        for (int i = 0; i < numberOfDocuments; i++) {
+            sb.append(String.format(Locale.ROOT, "{ \"index\": { \"_id\": \"%d\" } }\n{ \"name\": \"%s\" }\n", i + 1, randomFrom(NAMES)));
+        }
+
+        final Request request = new Request("POST", bulkEndpoint(indexName));
+        request.setJsonEntity(sb.toString());
+        request.addParameter("refresh", "true");
+        return request;
+    }
+
+    private static String shardChangesEndpoint(final String indexName) {
+        return String.format(Locale.ROOT, CCR_SHARD_CHANGES_ENDPOINT, indexName);
+    }
+
+    private static String bulkEndpoint(final String indexName) {
+        return String.format(Locale.ROOT, BULK_INDEX_ENDPOINT, indexName);
+    }
+
+    private void assertResponseException(final ResponseException ex, final RestStatus restStatus, final String error) {
+        assertEquals(restStatus.getStatus(), ex.getResponse().getStatusLine().getStatusCode());
+        assertThat(ex.getMessage(), Matchers.containsString(error));
+    }
+
+    private void assertShardChangesResponse(final Map<String, Object> shardChangesResponseBody) {
+        for (final String fieldName : SHARD_RESPONSE_FIELDS) {
+            final Object fieldValue = shardChangesResponseBody.get(fieldName);
+            assertNotNull("Field " + fieldName + " is missing or has a null value.", fieldValue);
+
+            if ("operations".equals(fieldName)) {
+                if (fieldValue instanceof List<?> operationsList) {
+                    assertFalse("Field 'operations' is empty.", operationsList.isEmpty());
+
+                    for (final Object operation : operationsList) {
+                        assertNotNull("Operation is null.", operation);
+                        if (operation instanceof Map<?, ?> operationMap) {
+                            assertNotNull("seq_no is missing in operation.", operationMap.get("seq_no"));
+                            assertNotNull("op_type is missing in operation.", operationMap.get("op_type"));
+                            assertNotNull("primary_term is missing in operation.", operationMap.get("primary_term"));
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java
index 87a4c2c7d4826..5305e179058b2 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/Ccr.java
@@ -7,6 +7,7 @@
 package org.elasticsearch.xpack.ccr;
 
 import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.Build;
 import org.elasticsearch.TransportVersion;
 import org.elasticsearch.TransportVersions;
 import org.elasticsearch.action.ActionRequest;
@@ -91,6 +92,7 @@
 import org.elasticsearch.xpack.ccr.rest.RestPutFollowAction;
 import org.elasticsearch.xpack.ccr.rest.RestResumeAutoFollowPatternAction;
 import org.elasticsearch.xpack.ccr.rest.RestResumeFollowAction;
+import org.elasticsearch.xpack.ccr.rest.RestShardChangesAction;
 import org.elasticsearch.xpack.ccr.rest.RestUnfollowAction;
 import org.elasticsearch.xpack.core.XPackFeatureUsage;
 import org.elasticsearch.xpack.core.XPackField;
@@ -112,6 +114,7 @@
 import org.elasticsearch.xpack.core.ccr.action.ShardFollowTask;
 import org.elasticsearch.xpack.core.ccr.action.UnfollowAction;
 
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
@@ -140,7 +143,34 @@ public class Ccr extends Plugin implements ActionPlugin, PersistentTaskPlugin, E
 
     public static final String REQUESTED_OPS_MISSING_METADATA_KEY = "es.requested_operations_missing";
     public static final TransportVersion TRANSPORT_VERSION_ACTION_WITH_SHARD_ID = TransportVersions.V_8_9_X;
+    private static final List<RestHandler> BASE_REST_HANDLERS = Arrays.asList(
+        // stats API
+        new RestFollowStatsAction(),
+        new RestCcrStatsAction(),
+        new RestFollowInfoAction(),
+        // follow APIs
+        new RestPutFollowAction(),
+        new RestResumeFollowAction(),
+        new RestPauseFollowAction(),
+        new RestUnfollowAction(),
+        // auto-follow APIs
+        new RestDeleteAutoFollowPatternAction(),
+        new RestPutAutoFollowPatternAction(),
+        new RestGetAutoFollowPatternAction(),
+        new RestPauseAutoFollowPatternAction(),
+        new RestResumeAutoFollowPatternAction(),
+        // forget follower API
+        new RestForgetFollowerAction()
+    );
 
+    private static final List<RestHandler> REST_HANDLERS = Collections.unmodifiableList(BASE_REST_HANDLERS);
+
+    private static final List<RestHandler> SNAPSHOT_BUILD_REST_HANDLERS;
+    static {
+        List<RestHandler> snapshotBuildHandlers = new ArrayList<>(BASE_REST_HANDLERS);
+        snapshotBuildHandlers.add(new RestShardChangesAction());
+        SNAPSHOT_BUILD_REST_HANDLERS = Collections.unmodifiableList(snapshotBuildHandlers);
+    }
     private final boolean enabled;
     private final Settings settings;
     private final CcrLicenseChecker ccrLicenseChecker;
@@ -272,25 +302,7 @@ public List<RestHandler> getRestHandlers(
             return emptyList();
         }
 
-        return Arrays.asList(
-            // stats API
-            new RestFollowStatsAction(),
-            new RestCcrStatsAction(),
-            new RestFollowInfoAction(),
-            // follow APIs
-            new RestPutFollowAction(),
-            new RestResumeFollowAction(),
-            new RestPauseFollowAction(),
-            new RestUnfollowAction(),
-            // auto-follow APIs
-            new RestDeleteAutoFollowPatternAction(),
-            new RestPutAutoFollowPatternAction(),
-            new RestGetAutoFollowPatternAction(),
-            new RestPauseAutoFollowPatternAction(),
-            new RestResumeAutoFollowPatternAction(),
-            // forget follower API
-            new RestForgetFollowerAction()
-        );
+        return Build.current().isSnapshot() ? SNAPSHOT_BUILD_REST_HANDLERS : REST_HANDLERS;
     }
 
     public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java
new file mode 100644
index 0000000000000..84171ebce162f
--- /dev/null
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java
@@ -0,0 +1,300 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.ccr.rest;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.action.admin.indices.stats.ShardStats;
+import org.elasticsearch.client.internal.node.NodeClient;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.common.unit.ByteSizeUnit;
+import org.elasticsearch.common.unit.ByteSizeValue;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.engine.Engine;
+import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.index.translog.Translog;
+import org.elasticsearch.rest.BaseRestHandler;
+import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.RestResponse;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.rest.action.RestActionListener;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xpack.ccr.Ccr;
+import org.elasticsearch.xpack.ccr.action.ShardChangesAction;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Comparator;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TimeoutException;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.rest.RestRequest.Method.GET;
+
+/**
+ * A REST handler that retrieves shard changes in a specific index whose name is provided as a parameter.
+ * It handles GET requests to the "/{index}/ccr/shard_changes" endpoint retrieving shard-level changes,
+ * such as translog operations, mapping version, settings version, aliases version, the global checkpoint,
+ * maximum sequence number and maximum sequence number of updates or deletes.
+ * <p>
+ * Note: This handler is only available for snapshot builds.
+ */
+public class RestShardChangesAction extends BaseRestHandler {
+
+    private static final long DEFAULT_FROM_SEQ_NO = 0L;
+    private static final ByteSizeValue DEFAULT_MAX_BATCH_SIZE = new ByteSizeValue(32, ByteSizeUnit.MB);
+    private static final TimeValue DEFAULT_POLL_TIMEOUT = new TimeValue(1, TimeUnit.MINUTES);
+    private static final int DEFAULT_MAX_OPERATIONS_COUNT = 1024;
+    private static final int DEFAULT_TIMEOUT_SECONDS = 60;
+    private static final TimeValue GET_INDEX_UUID_TIMEOUT = new TimeValue(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
+    private static final TimeValue SHARD_STATS_TIMEOUT = new TimeValue(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
+    private static final String INDEX_PARAM_NAME = "index";
+    private static final String FROM_SEQ_NO_PARAM_NAME = "from_seq_no";
+    private static final String MAX_BATCH_SIZE_PARAM_NAME = "max_batch_size";
+    private static final String POLL_TIMEOUT_PARAM_NAME = "poll_timeout";
+    private static final String MAX_OPERATIONS_COUNT_PARAM_NAME = "max_operations_count";
+
+    @Override
+    public String getName() {
+        return "ccr_shard_changes_action";
+    }
+
+    @Override
+    public List<Route> routes() {
+        return List.of(new Route(GET, "/{index}/ccr/shard_changes"));
+    }
+
+    /**
+    * Prepares the request for retrieving shard changes.
+    *
+    * @param restRequest The REST request.
+    * @param client The NodeClient for executing the request.
+    * @return A RestChannelConsumer for handling the request.
+    * @throws IOException If an error occurs while preparing the request.
+    */
+    @Override
+    protected RestChannelConsumer prepareRequest(final RestRequest restRequest, final NodeClient client) throws IOException {
+        final var indexName = restRequest.param(INDEX_PARAM_NAME);
+        final var fromSeqNo = restRequest.paramAsLong(FROM_SEQ_NO_PARAM_NAME, DEFAULT_FROM_SEQ_NO);
+        final var maxBatchSize = restRequest.paramAsSize(MAX_BATCH_SIZE_PARAM_NAME, DEFAULT_MAX_BATCH_SIZE);
+        final var pollTimeout = restRequest.paramAsTime(POLL_TIMEOUT_PARAM_NAME, DEFAULT_POLL_TIMEOUT);
+        final var maxOperationsCount = restRequest.paramAsInt(MAX_OPERATIONS_COUNT_PARAM_NAME, DEFAULT_MAX_OPERATIONS_COUNT);
+
+        final CompletableFuture<String> indexUUIDCompletableFuture = asyncGetIndexUUID(
+            client,
+            indexName,
+            client.threadPool().executor(Ccr.CCR_THREAD_POOL_NAME)
+        );
+        final CompletableFuture<ShardStats> shardStatsCompletableFuture = asyncShardStats(
+            client,
+            indexName,
+            client.threadPool().executor(Ccr.CCR_THREAD_POOL_NAME)
+        );
+
+        return channel -> CompletableFuture.allOf(indexUUIDCompletableFuture, shardStatsCompletableFuture).thenRun(() -> {
+            try {
+                final String indexUUID = indexUUIDCompletableFuture.get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
+                final ShardStats shardStats = shardStatsCompletableFuture.get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
+                final ShardId shardId = shardStats.getShardRouting().shardId();
+                final String expectedHistoryUUID = shardStats.getCommitStats().getUserData().get(Engine.HISTORY_UUID_KEY);
+
+                final ShardChangesAction.Request shardChangesRequest = shardChangesRequest(
+                    indexName,
+                    indexUUID,
+                    shardId,
+                    expectedHistoryUUID,
+                    fromSeqNo,
+                    maxBatchSize,
+                    pollTimeout,
+                    maxOperationsCount
+                );
+                client.execute(ShardChangesAction.INSTANCE, shardChangesRequest, new RestActionListener<>(channel) {
+                    @Override
+                    protected void processResponse(final ShardChangesAction.Response response) {
+                        channel.sendResponse(new RestResponse(RestStatus.OK, shardChangesResponseToXContent(response, indexName, shardId)));
+                    }
+                });
+
+            } catch (InterruptedException | ExecutionException e) {
+                Thread.currentThread().interrupt();
+                throw new IllegalStateException("Error while retrieving shard changes", e);
+            } catch (TimeoutException te) {
+                throw new IllegalStateException("Timeout while waiting for shard stats or index UUID", te);
+            }
+        }).exceptionally(ex -> {
+            channel.sendResponse(new RestResponse(RestStatus.BAD_REQUEST, "Failed to process shard changes for index [" + indexName + "]"));
+            return null;
+        });
+    }
+
+    /**
+     * Creates a ShardChangesAction.Request object with the provided parameters.
+     *
+     * @param indexName The name of the index for which to retrieve shard changes.
+     * @param indexUUID The UUID of the index.
+     * @param shardId The ShardId for which to retrieve shard changes.
+     * @param expectedHistoryUUID The expected history UUID of the shard.
+     * @param fromSeqNo The sequence number from which to start retrieving shard changes.
+     * @param maxBatchSize The maximum size of a batch of operations to retrieve.
+     * @param pollTimeout The maximum time to wait for shard changes.
+     * @param maxOperationsCount The maximum number of operations to retrieve in a single request.
+     * @return A ShardChangesAction.Request object with the provided parameters.
+     */
+    private static ShardChangesAction.Request shardChangesRequest(
+        final String indexName,
+        final String indexUUID,
+        final ShardId shardId,
+        final String expectedHistoryUUID,
+        long fromSeqNo,
+        final ByteSizeValue maxBatchSize,
+        final TimeValue pollTimeout,
+        int maxOperationsCount
+    ) {
+        final ShardChangesAction.Request shardChangesRequest = new ShardChangesAction.Request(
+            new ShardId(new Index(indexName, indexUUID), shardId.id()),
+            expectedHistoryUUID
+        );
+        shardChangesRequest.setFromSeqNo(fromSeqNo);
+        shardChangesRequest.setMaxBatchSize(maxBatchSize);
+        shardChangesRequest.setPollTimeout(pollTimeout);
+        shardChangesRequest.setMaxOperationCount(maxOperationsCount);
+        return shardChangesRequest;
+    }
+
+    /**
+     * Converts the response to XContent JSOn format.
+     *
+     * @param response The ShardChangesAction response.
+     * @param indexName The name of the index.
+     * @param shardId The ShardId.
+     */
+    private static XContentBuilder shardChangesResponseToXContent(
+        final ShardChangesAction.Response response,
+        final String indexName,
+        final ShardId shardId
+    ) {
+        try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
+            builder.startObject();
+            builder.field("index", indexName);
+            builder.field("shard_id", shardId);
+            builder.field("mapping_version", response.getMappingVersion());
+            builder.field("settings_version", response.getSettingsVersion());
+            builder.field("aliases_version", response.getAliasesVersion());
+            builder.field("global_checkpoint", response.getGlobalCheckpoint());
+            builder.field("max_seq_no", response.getMaxSeqNo());
+            builder.field("max_seq_no_of_updates_or_deletes", response.getMaxSeqNoOfUpdatesOrDeletes());
+            builder.field("took_in_millis", response.getTookInMillis());
+            if (response.getOperations() != null && response.getOperations().length > 0) {
+                operationsToXContent(response, builder);
+            }
+            builder.endObject();
+
+            return builder;
+        } catch (IOException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    /**
+     * Converts the operations from a ShardChangesAction response to XContent JSON format.
+     *
+     * @param response The ShardChangesAction response containing the operations to be converted.
+     * @param builder The XContentBuilder to which the converted operations will be added.
+     * @throws IOException If an error occurs while writing to the XContentBuilder.
+     */
+    private static void operationsToXContent(final ShardChangesAction.Response response, final XContentBuilder builder) throws IOException {
+        builder.field("number_of_operations", response.getOperations().length);
+        builder.field("operations");
+        builder.startArray();
+        for (final Translog.Operation operation : response.getOperations()) {
+            builder.startObject();
+            builder.field("op_type", operation.opType());
+            builder.field("seq_no", operation.seqNo());
+            builder.field("primary_term", operation.primaryTerm());
+            builder.endObject();
+        }
+        builder.endArray();
+    }
+
+    /**
+     * Execute an asynchronous task using a task supplier and an executor service.
+     *
+     * @param <T> The type of data to be retrieved.
+     * @param task The supplier task that provides the data.
+     * @param executorService The executorService service for executing the asynchronous task.
+     * @param errorMessage The error message to be thrown if the task execution fails.
+     * @return A CompletableFuture that completes with the retrieved data.
+     */
+    private static <T> CompletableFuture<T> supplyAsyncTask(
+        final Supplier<T> task,
+        final ExecutorService executorService,
+        final String errorMessage
+    ) {
+        return CompletableFuture.supplyAsync(() -> {
+            try {
+                return task.get();
+            } catch (Exception e) {
+                throw new ElasticsearchException(errorMessage, e);
+            }
+        }, executorService);
+    }
+
+    /**
+     * Asynchronously retrieves the shard stats for a given index using an executor service.
+     *
+     * @param client The NodeClient for executing the asynchronous request.
+     * @param indexName The name of the index for which to retrieve shard statistics.
+     * @param executorService The executorService service for executing the asynchronous task.
+     * @return A CompletableFuture that completes with the retrieved ShardStats.
+     * @throws ElasticsearchException If an error occurs while retrieving shard statistics.
+     */
+    private static CompletableFuture<ShardStats> asyncShardStats(
+        final NodeClient client,
+        final String indexName,
+        final ExecutorService executorService
+    ) {
+        return supplyAsyncTask(
+            () -> Arrays.stream(client.admin().indices().prepareStats(indexName).clear().get(SHARD_STATS_TIMEOUT).getShards())
+                .max(Comparator.comparingLong(shardStats -> shardStats.getCommitStats().getGeneration()))
+                .orElseThrow(() -> new ElasticsearchException("Unable to retrieve shard stats for index: " + indexName)),
+            executorService,
+            "Error while retrieving shard stats for index [" + indexName + "]"
+        );
+    }
+
+    /**
+     * Asynchronously retrieves the index UUID for a given index using an executor service.
+     *
+     * @param client The NodeClient for executing the asynchronous request.
+     * @param indexName The name of the index for which to retrieve the index UUID.
+     * @param executorService The executorService service for executing the asynchronous task.
+     * @return A CompletableFuture that completes with the retrieved index UUID.
+     * @throws ElasticsearchException If an error occurs while retrieving the index UUID.
+     */
+    private static CompletableFuture<String> asyncGetIndexUUID(
+        final NodeClient client,
+        final String indexName,
+        final ExecutorService executorService
+    ) {
+        return supplyAsyncTask(
+            () -> client.admin()
+                .indices()
+                .prepareGetIndex()
+                .setIndices(indexName)
+                .get(GET_INDEX_UUID_TIMEOUT)
+                .getSetting(indexName, IndexMetadata.SETTING_INDEX_UUID),
+            executorService,
+            "Error while retrieving index UUID for index [" + indexName + "]"
+        );
+    }
+}

From 8d1f4565a6b4ef169e926d356519963fdbe78436 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Mon, 16 Dec 2024 08:45:06 -0800
Subject: [PATCH 014/119] Update IronBank hardening manifest maintainers
 (#118175)

---
 .../docker/src/docker/iron_bank/hardening_manifest.yaml  | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/distribution/docker/src/docker/iron_bank/hardening_manifest.yaml b/distribution/docker/src/docker/iron_bank/hardening_manifest.yaml
index f4364c5008c09..e3bdac51cc5c5 100644
--- a/distribution/docker/src/docker/iron_bank/hardening_manifest.yaml
+++ b/distribution/docker/src/docker/iron_bank/hardening_manifest.yaml
@@ -50,9 +50,12 @@ resources:
 
 # List of project maintainers
 maintainers:
-  - name: "Rory Hunter"
-    email: "rory.hunter@elastic.co"
-    username: "rory"
+  - name: "Mark Vieira"
+    email: "mark.vieira@elastic.co"
+    username: "mark-vieira"
+  - name: "Rene Gröschke"
+    email: "rene.groschke@elastic.co"
+    username: "breskeby"
   - email: "klepal_alexander@bah.com"
     name: "Alexander Klepal"
     username: "alexander.klepal"

From bf1c0fe0778f1c5af90e6ad1b3da38f444ad114c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Slobodan=20Adamovi=C4=87?=
 <slobodanadamovic@users.noreply.github.com>
Date: Mon, 16 Dec 2024 19:15:28 +0100
Subject: [PATCH 015/119] Make reserved built-in roles queryable (#117581)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR makes reserved [built-in
roles](https://www.elastic.co/guide/en/elasticsearch/reference/current/built-in-roles.html)
queryable via [Query Role
API](https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-query-role.html)
by indexing them into the `.security` index.

Currently, the built-in roles were only available via [Get Role
API](https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-get-role.html).

The built-in roles are synced into the `.security` index on cluster
recovery. The `.security` index will be created (if it's not existing)
before built-in roles are synced. In order to avoid concurrent updates,
the built-in roles will only be synced by a master node.

Once the built-in roles are synced, the information about indexed roles
is kept in the cluster state as part of the `.security` index's
metadata. The map containing role names and their digests is persisted
as part of `queryable_built_in_roles_digest` property:

```
GET /_cluster/state/metadata/.security
"queryable_built_in_roles_digest": {
   "superuser": "lRRmA3kPO1/ztr3ESAlTetOuDjgUC3fKcGS3ZCqM+6k=",
    ...
}
```

Important: The reserved roles stored in the `.security` index are only
intended to be used for querying and retrieving. The role resolution and
mapping during authentication will remain the same and give a priority
to static/file role definitions. This is ensured by the [order in which
role providers (built-in, file and native) are
invoked](https://github.com/elastic/elasticsearch/blob/71c252c274aa967d5a66f7d081291ac5d87d27a9/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/RoleProviders.java#L77-L81).
It’s important to note this because there can be a short period of time
where we have a temporary inconsistency between actual built-in role
definitions and what is stored in the `.security` index.

---

Note: The functionality is temporarily hidden behind the
`es.queryable_built_in_roles_enabled` system property. By default, the
flag is disabled and will become enabled in a followup PR. The reason
for this is to keep this PR as small as possible and to avoid the need
to adjust a large number of tests that don't expect `.security` index to
exist.

Testing: To run and test locally execute `./gradlew run
-Dtests.jvm.argline="-Des.queryable_built_in_roles_enabled=true"`. To
query all reserved built-in roles execute:

```
POST /_security/_query/role
{
  "query": {
    "bool": {
      "must": {
        "term": {
          "metadata._reserved": true
        }
      }
    }
  }
}
```
---
 docs/changelog/117581.yaml                    |   5 +
 .../test/rest/ESRestTestCase.java             |   2 +-
 .../security/qa/security-basic/build.gradle   |  17 +-
 .../xpack/security/QueryRoleIT.java           |   2 +-
 .../security/QueryableReservedRolesIT.java    | 354 ++++++++++++
 .../src/main/java/module-info.java            |   6 +
 .../role/QueryableBuiltInRolesTestPlugin.java |  22 +
 .../security/src/main/java/module-info.java   |   2 +
 .../xpack/security/Security.java              |  23 +-
 .../xpack/security/SecurityFeatures.java      |   8 +-
 .../action/role/TransportGetRolesAction.java  |  12 +-
 .../security/authz/store/FileRolesStore.java  |   9 +
 .../authz/store/NativeRolesStore.java         |  50 +-
 .../rest/action/role/RestQueryRoleAction.java |   3 +
 .../support/FeatureNotEnabledException.java   |   1 +
 .../support/QueryableBuiltInRoles.java        |  52 ++
 .../QueryableBuiltInRolesProviderFactory.java |  23 +
 .../QueryableBuiltInRolesSynchronizer.java    | 532 ++++++++++++++++++
 .../support/QueryableBuiltInRolesUtils.java   | 101 ++++
 .../QueryableReservedRolesProvider.java       |  56 ++
 .../support/SecurityIndexManager.java         |   2 +-
 .../QueryableBuiltInRolesUtilsTests.java      | 296 ++++++++++
 .../QueryableReservedRolesProviderTests.java  |  31 +
 23 files changed, 1585 insertions(+), 24 deletions(-)
 create mode 100644 docs/changelog/117581.yaml
 create mode 100644 x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryableReservedRolesIT.java
 create mode 100644 x-pack/plugin/security/qa/security-basic/src/main/java/module-info.java
 create mode 100644 x-pack/plugin/security/qa/security-basic/src/main/java/org/elasticsearch/xpack/security/role/QueryableBuiltInRolesTestPlugin.java
 create mode 100644 x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRoles.java
 create mode 100644 x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesProviderFactory.java
 create mode 100644 x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesSynchronizer.java
 create mode 100644 x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtils.java
 create mode 100644 x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProvider.java
 create mode 100644 x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtilsTests.java
 create mode 100644 x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProviderTests.java

diff --git a/docs/changelog/117581.yaml b/docs/changelog/117581.yaml
new file mode 100644
index 0000000000000..b88017f45e9c9
--- /dev/null
+++ b/docs/changelog/117581.yaml
@@ -0,0 +1,5 @@
+pr: 117581
+summary: Make reserved built-in roles queryable
+area: Authorization
+type: enhancement
+issues: []
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index 4428afaaeabe5..fa525705a9b39 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -1138,7 +1138,7 @@ protected static void wipeAllIndices(boolean preserveSecurityIndices) throws IOE
         }
     }
 
-    private static boolean ignoreSystemIndexAccessWarnings(List<String> warnings) {
+    protected static boolean ignoreSystemIndexAccessWarnings(List<String> warnings) {
         for (String warning : warnings) {
             if (warning.startsWith("this request accesses system indices:")) {
                 SUITE_LOGGER.warn("Ignoring system index access warning during test cleanup: {}", warning);
diff --git a/x-pack/plugin/security/qa/security-basic/build.gradle b/x-pack/plugin/security/qa/security-basic/build.gradle
index 8740354646346..e6caf943dc023 100644
--- a/x-pack/plugin/security/qa/security-basic/build.gradle
+++ b/x-pack/plugin/security/qa/security-basic/build.gradle
@@ -4,20 +4,31 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-
+apply plugin: 'elasticsearch.base-internal-es-plugin'
 apply plugin: 'elasticsearch.internal-java-rest-test'
 
+
+esplugin {
+  name 'queryable-reserved-roles-test'
+  description 'A test plugin for testing that changes to reserved roles are made queryable'
+  classname 'org.elasticsearch.xpack.security.role.QueryableBuiltInRolesTestPlugin'
+  extendedPlugins = ['x-pack-core', 'x-pack-security']
+}
 dependencies {
   javaRestTestImplementation(testArtifact(project(xpackModule('security'))))
   javaRestTestImplementation(testArtifact(project(xpackModule('core'))))
+  compileOnly project(':x-pack:plugin:core')
+  compileOnly project(':x-pack:plugin:security')
+  clusterPlugins project(':x-pack:plugin:security:qa:security-basic')
 }
 
 tasks.named('javaRestTest') {
   usesDefaultDistribution()
 }
 
+tasks.named("javadoc").configure { enabled = false }
 
-if (buildParams.inFipsJvm){
+if (buildParams.inFipsJvm) {
   // This test cluster is using a BASIC license and FIPS 140 mode is not supported in BASIC
-  tasks.named("javaRestTest").configure{enabled = false }
+  tasks.named("javaRestTest").configure { enabled = false }
 }
diff --git a/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryRoleIT.java b/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryRoleIT.java
index 1588749b9a331..311510352d805 100644
--- a/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryRoleIT.java
+++ b/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryRoleIT.java
@@ -496,7 +496,7 @@ private RoleDescriptor createRole(
         );
     }
 
-    private void assertQuery(String body, int total, Consumer<List<Map<String, Object>>> roleVerifier) throws IOException {
+    static void assertQuery(String body, int total, Consumer<List<Map<String, Object>>> roleVerifier) throws IOException {
         assertQuery(client(), body, total, roleVerifier);
     }
 
diff --git a/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryableReservedRolesIT.java b/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryableReservedRolesIT.java
new file mode 100644
index 0000000000000..7adff21d8df4f
--- /dev/null
+++ b/x-pack/plugin/security/qa/security-basic/src/javaRestTest/java/org/elasticsearch/xpack/security/QueryableReservedRolesIT.java
@@ -0,0 +1,354 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security;
+
+import com.carrotsearch.randomizedtesting.annotations.TestCaseOrdering;
+
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.RequestOptions;
+import org.elasticsearch.client.Response;
+import org.elasticsearch.client.ResponseException;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.settings.SecureString;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.test.AnnotationTestOrdering;
+import org.elasticsearch.test.AnnotationTestOrdering.Order;
+import org.elasticsearch.test.cluster.ElasticsearchCluster;
+import org.elasticsearch.test.cluster.MutableSettingsProvider;
+import org.elasticsearch.test.cluster.local.distribution.DistributionType;
+import org.elasticsearch.test.cluster.local.model.User;
+import org.elasticsearch.test.cluster.util.resource.Resource;
+import org.elasticsearch.test.rest.ESRestTestCase;
+import org.elasticsearch.test.rest.ObjectPath;
+import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+import org.elasticsearch.xpack.core.security.test.TestRestrictedIndices;
+import org.elasticsearch.xpack.security.support.QueryableBuiltInRolesSynchronizer;
+import org.elasticsearch.xpack.security.support.SecurityMigrations;
+import org.junit.BeforeClass;
+import org.junit.ClassRule;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.TimeUnit;
+
+import static org.elasticsearch.xpack.core.security.test.TestRestrictedIndices.INTERNAL_SECURITY_MAIN_INDEX_7;
+import static org.elasticsearch.xpack.security.QueryRoleIT.assertQuery;
+import static org.elasticsearch.xpack.security.QueryRoleIT.waitForMigrationCompletion;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.iterableWithSize;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.nullValue;
+import static org.hamcrest.Matchers.oneOf;
+
+@TestCaseOrdering(AnnotationTestOrdering.class)
+public class QueryableReservedRolesIT extends ESRestTestCase {
+
+    protected static final String REST_USER = "security_test_user";
+    private static final SecureString REST_PASSWORD = new SecureString("security-test-password".toCharArray());
+    private static final String ADMIN_USER = "admin_user";
+    private static final SecureString ADMIN_PASSWORD = new SecureString("admin-password".toCharArray());
+    protected static final String READ_SECURITY_USER = "read_security_user";
+    private static final SecureString READ_SECURITY_PASSWORD = new SecureString("read-security-password".toCharArray());
+
+    @BeforeClass
+    public static void setup() {
+        new ReservedRolesStore();
+    }
+
+    @Override
+    protected boolean preserveClusterUponCompletion() {
+        return true;
+    }
+
+    private static MutableSettingsProvider clusterSettings = new MutableSettingsProvider() {
+        {
+            put("xpack.license.self_generated.type", "basic");
+            put("xpack.security.enabled", "true");
+            put("xpack.security.http.ssl.enabled", "false");
+            put("xpack.security.transport.ssl.enabled", "false");
+        }
+    };
+
+    @ClassRule
+    public static ElasticsearchCluster cluster = ElasticsearchCluster.local()
+        .distribution(DistributionType.DEFAULT)
+        .nodes(2)
+        .settings(clusterSettings)
+        .rolesFile(Resource.fromClasspath("roles.yml"))
+        .user(ADMIN_USER, ADMIN_PASSWORD.toString(), User.ROOT_USER_ROLE, true)
+        .user(REST_USER, REST_PASSWORD.toString(), "security_test_role", false)
+        .user(READ_SECURITY_USER, READ_SECURITY_PASSWORD.toString(), "read_security_user_role", false)
+        .systemProperty("es.queryable_built_in_roles_enabled", "true")
+        .plugin("queryable-reserved-roles-test")
+        .build();
+
+    private static Set<String> PREVIOUS_RESERVED_ROLES;
+    private static Set<String> CONFIGURED_RESERVED_ROLES;
+
+    @Override
+    protected String getTestRestCluster() {
+        return cluster.getHttpAddresses();
+    }
+
+    @Override
+    protected Settings restAdminSettings() {
+        String token = basicAuthHeaderValue(ADMIN_USER, ADMIN_PASSWORD);
+        return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
+    }
+
+    @Override
+    protected Settings restClientSettings() {
+        String token = basicAuthHeaderValue(REST_USER, REST_PASSWORD);
+        return Settings.builder().put(ThreadContext.PREFIX + ".Authorization", token).build();
+    }
+
+    @Order(10)
+    public void testQueryDeleteOrUpdateReservedRoles() throws Exception {
+        waitForMigrationCompletion(adminClient(), SecurityMigrations.ROLE_METADATA_FLATTENED_MIGRATION_VERSION);
+
+        final String[] allReservedRoles = ReservedRolesStore.names().toArray(new String[0]);
+        assertQuery(client(), """
+            { "query": { "bool": { "must": { "term": { "metadata._reserved": true } } } }, "size": 100 }
+            """, allReservedRoles.length, roles -> {
+            assertThat(roles, iterableWithSize(allReservedRoles.length));
+            for (var role : roles) {
+                assertThat((String) role.get("name"), is(oneOf(allReservedRoles)));
+            }
+        });
+
+        final String roleName = randomFrom(allReservedRoles);
+        assertQuery(client(), String.format("""
+            { "query": { "bool": { "must": { "term": { "name": "%s" } } } } }
+            """, roleName), 1, roles -> {
+            assertThat(roles, iterableWithSize(1));
+            assertThat((String) roles.get(0).get("name"), equalTo(roleName));
+        });
+
+        assertCannotDeleteReservedRoles();
+        assertCannotCreateOrUpdateReservedRole(roleName);
+    }
+
+    @Order(11)
+    public void testGetReservedRoles() throws Exception {
+        final String[] allReservedRoles = ReservedRolesStore.names().toArray(new String[0]);
+        final String roleName = randomFrom(allReservedRoles);
+        Request request = new Request("GET", "/_security/role/" + roleName);
+        Response response = adminClient().performRequest(request);
+        assertOK(response);
+        var responseMap = responseAsMap(response);
+        assertThat(responseMap.size(), equalTo(1));
+        assertThat(responseMap.containsKey(roleName), is(true));
+    }
+
+    @Order(20)
+    public void testRestartForConfiguringReservedRoles() throws Exception {
+        configureReservedRoles(List.of("editor", "viewer", "kibana_system", "apm_system", "beats_system", "logstash_system"));
+        cluster.restart(false);
+        closeClients();
+    }
+
+    @Order(30)
+    public void testConfiguredReservedRoles() throws Exception {
+        assert CONFIGURED_RESERVED_ROLES != null;
+
+        // Test query roles API
+        assertBusy(() -> {
+            assertQuery(client(), """
+                { "query": { "bool": { "must": { "term": { "metadata._reserved": true } } } }, "size": 100 }
+                """, CONFIGURED_RESERVED_ROLES.size(), roles -> {
+                assertThat(roles, iterableWithSize(CONFIGURED_RESERVED_ROLES.size()));
+                for (var role : roles) {
+                    assertThat((String) role.get("name"), is(oneOf(CONFIGURED_RESERVED_ROLES.toArray(new String[0]))));
+                }
+            });
+        }, 30, TimeUnit.SECONDS);
+
+        // Test get roles API
+        assertBusy(() -> {
+            final Response response = adminClient().performRequest(new Request("GET", "/_security/role"));
+            assertOK(response);
+            final Map<String, Object> responseMap = responseAsMap(response);
+            assertThat(responseMap.keySet(), equalTo(CONFIGURED_RESERVED_ROLES));
+        });
+    }
+
+    @Order(40)
+    public void testRestartForConfiguringReservedRolesAndClosingIndex() throws Exception {
+        configureReservedRoles(List.of("editor", "viewer"));
+        closeSecurityIndex();
+        cluster.restart(false);
+        closeClients();
+    }
+
+    @Order(50)
+    public void testConfiguredReservedRolesAfterClosingAndOpeningIndex() throws Exception {
+        assert CONFIGURED_RESERVED_ROLES != null;
+        assert PREVIOUS_RESERVED_ROLES != null;
+        assertThat(PREVIOUS_RESERVED_ROLES, is(not(equalTo(CONFIGURED_RESERVED_ROLES))));
+
+        // Test configured roles did not get updated because the security index is closed
+        assertMetadataContainsBuiltInRoles(PREVIOUS_RESERVED_ROLES);
+
+        // Open the security index
+        openSecurityIndex();
+
+        // Test that the roles are now updated after index got opened
+        assertBusy(() -> {
+            assertQuery(client(), """
+                { "query": { "bool": { "must": { "term": { "metadata._reserved": true } } } }, "size": 100 }
+                """, CONFIGURED_RESERVED_ROLES.size(), roles -> {
+                assertThat(roles, iterableWithSize(CONFIGURED_RESERVED_ROLES.size()));
+                for (var role : roles) {
+                    assertThat((String) role.get("name"), is(oneOf(CONFIGURED_RESERVED_ROLES.toArray(new String[0]))));
+                }
+            });
+        }, 30, TimeUnit.SECONDS);
+
+    }
+
+    @Order(60)
+    public void testDeletingAndCreatingSecurityIndexTriggersSynchronization() throws Exception {
+        deleteSecurityIndex();
+
+        assertBusy(this::assertSecurityIndexDeleted, 30, TimeUnit.SECONDS);
+
+        // Creating a user will trigger .security index creation
+        createUser("superman", "superman", "superuser");
+
+        // Test that the roles are now updated after index got created
+        assertBusy(() -> {
+            assertQuery(client(), """
+                { "query": { "bool": { "must": { "term": { "metadata._reserved": true } } } }, "size": 100 }
+                """, CONFIGURED_RESERVED_ROLES.size(), roles -> {
+                assertThat(roles, iterableWithSize(CONFIGURED_RESERVED_ROLES.size()));
+                for (var role : roles) {
+                    assertThat((String) role.get("name"), is(oneOf(CONFIGURED_RESERVED_ROLES.toArray(new String[0]))));
+                }
+            });
+        }, 30, TimeUnit.SECONDS);
+    }
+
+    private void createUser(String name, String password, String role) throws IOException {
+        Request request = new Request("PUT", "/_security/user/" + name);
+        request.setJsonEntity("{ \"password\": \"" + password + "\", \"roles\": [ \"" + role + "\"] }");
+        assertOK(adminClient().performRequest(request));
+    }
+
+    private void deleteSecurityIndex() throws IOException {
+        final Request deleteRequest = new Request("DELETE", INTERNAL_SECURITY_MAIN_INDEX_7);
+        deleteRequest.setOptions(RequestOptions.DEFAULT.toBuilder().setWarningsHandler(ESRestTestCase::ignoreSystemIndexAccessWarnings));
+        final Response response = adminClient().performRequest(deleteRequest);
+        try (InputStream is = response.getEntity().getContent()) {
+            assertTrue((boolean) XContentHelper.convertToMap(XContentType.JSON.xContent(), is, true).get("acknowledged"));
+        }
+    }
+
+    private void assertMetadataContainsBuiltInRoles(Set<String> builtInRoles) throws IOException {
+        final Request request = new Request("GET", "_cluster/state/metadata/" + INTERNAL_SECURITY_MAIN_INDEX_7);
+        final Response response = adminClient().performRequest(request);
+        assertOK(response);
+        final Map<String, String> builtInRolesDigests = ObjectPath.createFromResponse(response)
+            .evaluate("metadata.indices.\\.security-7." + QueryableBuiltInRolesSynchronizer.METADATA_QUERYABLE_BUILT_IN_ROLES_DIGEST_KEY);
+        assertThat(builtInRolesDigests.keySet(), equalTo(builtInRoles));
+    }
+
+    private void assertSecurityIndexDeleted() throws IOException {
+        final Request request = new Request("GET", "_cluster/state/metadata/" + INTERNAL_SECURITY_MAIN_INDEX_7);
+        final Response response = adminClient().performRequest(request);
+        assertOK(response);
+        final Map<String, String> securityIndexMetadata = ObjectPath.createFromResponse(response)
+            .evaluate("metadata.indices.\\.security-7");
+        assertThat(securityIndexMetadata, is(nullValue()));
+    }
+
+    private void configureReservedRoles(List<String> reservedRoles) throws Exception {
+        PREVIOUS_RESERVED_ROLES = CONFIGURED_RESERVED_ROLES;
+        CONFIGURED_RESERVED_ROLES = new HashSet<>();
+        CONFIGURED_RESERVED_ROLES.add("superuser"); // superuser must always be included
+        CONFIGURED_RESERVED_ROLES.addAll(reservedRoles);
+        clusterSettings.put("xpack.security.reserved_roles.include", Strings.collectionToCommaDelimitedString(CONFIGURED_RESERVED_ROLES));
+    }
+
+    private void closeSecurityIndex() throws Exception {
+        Request request = new Request("POST", "/" + TestRestrictedIndices.INTERNAL_SECURITY_MAIN_INDEX_7 + "/_close");
+        request.setOptions(
+            expectWarnings(
+                "this request accesses system indices: [.security-7], but in a future major version, "
+                    + "direct access to system indices will be prevented by default"
+            )
+        );
+        Response response = adminClient().performRequest(request);
+        assertOK(response);
+    }
+
+    private void openSecurityIndex() throws Exception {
+        Request request = new Request("POST", "/" + TestRestrictedIndices.INTERNAL_SECURITY_MAIN_INDEX_7 + "/_open");
+        request.setOptions(
+            expectWarnings(
+                "this request accesses system indices: [.security-7], but in a future major version, "
+                    + "direct access to system indices will be prevented by default"
+            )
+        );
+        Response response = adminClient().performRequest(request);
+        assertOK(response);
+    }
+
+    private void assertCannotDeleteReservedRoles() throws Exception {
+        {
+            String roleName = randomFrom(ReservedRolesStore.names());
+            Request request = new Request("DELETE", "/_security/role/" + roleName);
+            var e = expectThrows(ResponseException.class, () -> adminClient().performRequest(request));
+            assertThat(e.getMessage(), containsString("role [" + roleName + "] is reserved and cannot be deleted"));
+        }
+        {
+            Request request = new Request("DELETE", "/_security/role/");
+            request.setJsonEntity(
+                """
+                    {
+                      "names": [%s]
+                    }
+                    """.formatted(
+                    ReservedRolesStore.names().stream().map(name -> "\"" + name + "\"").reduce((a, b) -> a + ", " + b).orElse("")
+                )
+            );
+            Response response = adminClient().performRequest(request);
+            assertOK(response);
+            String responseAsString = responseAsMap(response).toString();
+            for (String roleName : ReservedRolesStore.names()) {
+                assertThat(responseAsString, containsString("role [" + roleName + "] is reserved and cannot be deleted"));
+            }
+        }
+    }
+
+    private void assertCannotCreateOrUpdateReservedRole(String roleName) throws Exception {
+        Request request = new Request(randomBoolean() ? "PUT" : "POST", "/_security/role/" + roleName);
+        request.setJsonEntity("""
+            {
+              "cluster": ["all"],
+              "indices": [
+                {
+                  "names": ["*"],
+                  "privileges": ["all"]
+                }
+              ]
+            }
+            """);
+        var e = expectThrows(ResponseException.class, () -> adminClient().performRequest(request));
+        assertThat(e.getMessage(), containsString("Role [" + roleName + "] is reserved and may not be used."));
+    }
+
+}
diff --git a/x-pack/plugin/security/qa/security-basic/src/main/java/module-info.java b/x-pack/plugin/security/qa/security-basic/src/main/java/module-info.java
new file mode 100644
index 0000000000000..00c8e480cfbaf
--- /dev/null
+++ b/x-pack/plugin/security/qa/security-basic/src/main/java/module-info.java
@@ -0,0 +1,6 @@
+module org.elasticsearch.internal.security {
+    requires org.elasticsearch.base;
+    requires org.elasticsearch.server;
+    requires org.elasticsearch.xcore;
+    requires org.elasticsearch.security;
+}
diff --git a/x-pack/plugin/security/qa/security-basic/src/main/java/org/elasticsearch/xpack/security/role/QueryableBuiltInRolesTestPlugin.java b/x-pack/plugin/security/qa/security-basic/src/main/java/org/elasticsearch/xpack/security/role/QueryableBuiltInRolesTestPlugin.java
new file mode 100644
index 0000000000000..ba5538d992cfb
--- /dev/null
+++ b/x-pack/plugin/security/qa/security-basic/src/main/java/org/elasticsearch/xpack/security/role/QueryableBuiltInRolesTestPlugin.java
@@ -0,0 +1,22 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.role;
+
+import org.elasticsearch.common.settings.Setting;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+
+import java.util.List;
+
+public class QueryableBuiltInRolesTestPlugin extends Plugin {
+
+    @Override
+    public List<Setting<?>> getSettings() {
+        return List.of(ReservedRolesStore.INCLUDED_RESERVED_ROLES_SETTING);
+    }
+}
diff --git a/x-pack/plugin/security/src/main/java/module-info.java b/x-pack/plugin/security/src/main/java/module-info.java
index a072b34da7e96..947211559b0c2 100644
--- a/x-pack/plugin/security/src/main/java/module-info.java
+++ b/x-pack/plugin/security/src/main/java/module-info.java
@@ -70,6 +70,8 @@
     exports org.elasticsearch.xpack.security.slowlog to org.elasticsearch.server;
     exports org.elasticsearch.xpack.security.authc.support to org.elasticsearch.internal.security;
     exports org.elasticsearch.xpack.security.rest.action.apikey to org.elasticsearch.internal.security;
+    exports org.elasticsearch.xpack.security.support to org.elasticsearch.internal.security;
+    exports org.elasticsearch.xpack.security.authz.store to org.elasticsearch.internal.security;
 
     provides org.elasticsearch.index.SlowLogFieldProvider with org.elasticsearch.xpack.security.slowlog.SecuritySlowLogFieldProvider;
 
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
index ef66392a87260..fd530a338b26c 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/Security.java
@@ -411,6 +411,8 @@
 import org.elasticsearch.xpack.security.rest.action.user.RestSetEnabledAction;
 import org.elasticsearch.xpack.security.support.CacheInvalidatorRegistry;
 import org.elasticsearch.xpack.security.support.ExtensionComponents;
+import org.elasticsearch.xpack.security.support.QueryableBuiltInRolesProviderFactory;
+import org.elasticsearch.xpack.security.support.QueryableBuiltInRolesSynchronizer;
 import org.elasticsearch.xpack.security.support.ReloadableSecurityComponent;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 import org.elasticsearch.xpack.security.support.SecurityMigrationExecutor;
@@ -461,6 +463,7 @@
 import static org.elasticsearch.xpack.core.security.SecurityField.FIELD_LEVEL_SECURITY_FEATURE;
 import static org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore.INCLUDED_RESERVED_ROLES_SETTING;
 import static org.elasticsearch.xpack.security.operator.OperatorPrivileges.OPERATOR_PRIVILEGES_ENABLED;
+import static org.elasticsearch.xpack.security.support.QueryableBuiltInRolesSynchronizer.QUERYABLE_BUILT_IN_ROLES_ENABLED;
 import static org.elasticsearch.xpack.security.transport.SSLEngineUtils.extractClientCertificates;
 
 public class Security extends Plugin
@@ -631,7 +634,7 @@ public class Security extends Plugin
     private final SetOnce<ReservedRoleNameChecker.Factory> reservedRoleNameCheckerFactory = new SetOnce<>();
     private final SetOnce<FileRoleValidator> fileRoleValidator = new SetOnce<>();
     private final SetOnce<SecondaryAuthActions> secondaryAuthActions = new SetOnce<>();
-
+    private final SetOnce<QueryableBuiltInRolesProviderFactory> queryableRolesProviderFactory = new SetOnce<>();
     private final SetOnce<SecurityMigrationExecutor> securityMigrationExecutor = new SetOnce<>();
 
     // Node local retry count for migration jobs that's checked only on the master node to make sure
@@ -1202,6 +1205,23 @@ Collection<Object> createComponents(
 
         reservedRoleMappingAction.set(new ReservedRoleMappingAction());
 
+        if (QUERYABLE_BUILT_IN_ROLES_ENABLED) {
+            if (queryableRolesProviderFactory.get() == null) {
+                queryableRolesProviderFactory.set(new QueryableBuiltInRolesProviderFactory.Default());
+            }
+            components.add(
+                new QueryableBuiltInRolesSynchronizer(
+                    clusterService,
+                    featureService,
+                    queryableRolesProviderFactory.get(),
+                    nativeRolesStore,
+                    reservedRolesStore,
+                    fileRolesStore.get(),
+                    threadPool
+                )
+            );
+        }
+
         cacheInvalidatorRegistry.validate();
 
         final List<ReloadableSecurityComponent> reloadableComponents = new ArrayList<>();
@@ -2317,6 +2337,7 @@ public void loadExtensions(ExtensionLoader loader) {
         loadSingletonExtensionAndSetOnce(loader, grantApiKeyRequestTranslator, RestGrantApiKeyAction.RequestTranslator.class);
         loadSingletonExtensionAndSetOnce(loader, fileRoleValidator, FileRoleValidator.class);
         loadSingletonExtensionAndSetOnce(loader, secondaryAuthActions, SecondaryAuthActions.class);
+        loadSingletonExtensionAndSetOnce(loader, queryableRolesProviderFactory, QueryableBuiltInRolesProviderFactory.class);
     }
 
     private <T> void loadSingletonExtensionAndSetOnce(ExtensionLoader loader, SetOnce<T> setOnce, Class<T> clazz) {
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/SecurityFeatures.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/SecurityFeatures.java
index 53ecafa280715..84749d895a44e 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/SecurityFeatures.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/SecurityFeatures.java
@@ -12,6 +12,7 @@
 
 import java.util.Set;
 
+import static org.elasticsearch.xpack.security.support.QueryableBuiltInRolesSynchronizer.QUERYABLE_BUILT_IN_ROLES_FEATURE;
 import static org.elasticsearch.xpack.security.support.SecuritySystemIndices.SECURITY_MIGRATION_FRAMEWORK;
 import static org.elasticsearch.xpack.security.support.SecuritySystemIndices.SECURITY_ROLES_METADATA_FLATTENED;
 import static org.elasticsearch.xpack.security.support.SecuritySystemIndices.SECURITY_ROLE_MAPPING_CLEANUP;
@@ -20,6 +21,11 @@ public class SecurityFeatures implements FeatureSpecification {
 
     @Override
     public Set<NodeFeature> getFeatures() {
-        return Set.of(SECURITY_ROLE_MAPPING_CLEANUP, SECURITY_ROLES_METADATA_FLATTENED, SECURITY_MIGRATION_FRAMEWORK);
+        return Set.of(
+            SECURITY_ROLE_MAPPING_CLEANUP,
+            SECURITY_ROLES_METADATA_FLATTENED,
+            SECURITY_MIGRATION_FRAMEWORK,
+            QUERYABLE_BUILT_IN_ROLES_FEATURE
+        );
     }
 }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/role/TransportGetRolesAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/role/TransportGetRolesAction.java
index e019f168cf8c0..cdeac51e1f492 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/role/TransportGetRolesAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/action/role/TransportGetRolesAction.java
@@ -20,11 +20,9 @@
 import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
 import org.elasticsearch.xpack.security.authz.store.NativeRolesStore;
 
-import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
-import java.util.HashSet;
-import java.util.List;
+import java.util.LinkedHashSet;
 import java.util.Set;
 import java.util.stream.Collectors;
 
@@ -51,8 +49,8 @@ protected void doExecute(Task task, final GetRolesRequest request, final ActionL
             return;
         }
 
-        final Set<String> rolesToSearchFor = new HashSet<>();
-        final List<RoleDescriptor> reservedRoles = new ArrayList<>();
+        final Set<String> rolesToSearchFor = new LinkedHashSet<>();
+        final Set<RoleDescriptor> reservedRoles = new LinkedHashSet<>();
         if (specificRolesRequested) {
             for (String role : requestedRoles) {
                 if (ReservedRolesStore.isReserved(role)) {
@@ -80,10 +78,10 @@ protected void doExecute(Task task, final GetRolesRequest request, final ActionL
     }
 
     private void getNativeRoles(Set<String> rolesToSearchFor, ActionListener<GetRolesResponse> listener) {
-        getNativeRoles(rolesToSearchFor, new ArrayList<>(), listener);
+        getNativeRoles(rolesToSearchFor, new LinkedHashSet<>(), listener);
     }
 
-    private void getNativeRoles(Set<String> rolesToSearchFor, List<RoleDescriptor> foundRoles, ActionListener<GetRolesResponse> listener) {
+    private void getNativeRoles(Set<String> rolesToSearchFor, Set<RoleDescriptor> foundRoles, ActionListener<GetRolesResponse> listener) {
         nativeRolesStore.getRoleDescriptors(rolesToSearchFor, ActionListener.wrap((retrievalResult) -> {
             if (retrievalResult.isSuccess()) {
                 foundRoles.addAll(retrievalResult.getDescriptors());
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java
index 7618135c8662f..87378ac0b9f25 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/FileRolesStore.java
@@ -44,6 +44,7 @@
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -173,6 +174,14 @@ public Path getFile() {
         return file;
     }
 
+    /**
+     * @return a map of all file role definitions. The returned map is unmodifiable.
+     */
+    public Map<String, RoleDescriptor> getAllRoleDescriptors() {
+        final Map<String, RoleDescriptor> localPermissions = permissions;
+        return Collections.unmodifiableMap(localPermissions);
+    }
+
     // package private for testing
     Set<String> getAllRoleNames() {
         return permissions.keySet();
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java
index 23a1fc188e4a0..0a5865ecfe9bf 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java
@@ -63,13 +63,13 @@
 import org.elasticsearch.xpack.core.security.authz.privilege.ConfigurableClusterPrivileges;
 import org.elasticsearch.xpack.core.security.authz.store.RoleRetrievalResult;
 import org.elasticsearch.xpack.core.security.authz.support.DLSRoleQueryValidator;
-import org.elasticsearch.xpack.core.security.support.NativeRealmValidationUtil;
 import org.elasticsearch.xpack.security.authz.ReservedRoleNameChecker;
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collection;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.HashSet;
@@ -169,6 +169,10 @@ public NativeRolesStore(
         this.enabled = settings.getAsBoolean(NATIVE_ROLES_ENABLED, true);
     }
 
+    public boolean isEnabled() {
+        return enabled;
+    }
+
     @Override
     public void accept(Set<String> names, ActionListener<RoleRetrievalResult> listener) {
         getRoleDescriptors(names, listener);
@@ -263,6 +267,10 @@ public boolean isMetadataSearchable() {
     }
 
     public void queryRoleDescriptors(SearchSourceBuilder searchSourceBuilder, ActionListener<QueryRoleResult> listener) {
+        if (enabled == false) {
+            listener.onResponse(QueryRoleResult.EMPTY);
+            return;
+        }
         SearchRequest searchRequest = new SearchRequest(new String[] { SECURITY_MAIN_ALIAS }, searchSourceBuilder);
         SecurityIndexManager frozenSecurityIndex = securityIndex.defensiveCopy();
         if (frozenSecurityIndex.indexExists() == false) {
@@ -345,6 +353,15 @@ public void deleteRoles(
         final List<String> roleNames,
         WriteRequest.RefreshPolicy refreshPolicy,
         final ActionListener<BulkRolesResponse> listener
+    ) {
+        deleteRoles(roleNames, refreshPolicy, true, listener);
+    }
+
+    public void deleteRoles(
+        final Collection<String> roleNames,
+        WriteRequest.RefreshPolicy refreshPolicy,
+        boolean validateRoleNames,
+        final ActionListener<BulkRolesResponse> listener
     ) {
         if (enabled == false) {
             listener.onFailure(new IllegalStateException("Native role management is disabled"));
@@ -355,7 +372,7 @@ public void deleteRoles(
         Map<String, Exception> validationErrorByRoleName = new HashMap<>();
 
         for (String roleName : roleNames) {
-            if (reservedRoleNameChecker.isReserved(roleName)) {
+            if (validateRoleNames && reservedRoleNameChecker.isReserved(roleName)) {
                 validationErrorByRoleName.put(
                     roleName,
                     new IllegalArgumentException("role [" + roleName + "] is reserved and cannot be deleted")
@@ -402,7 +419,7 @@ public void onFailure(Exception e) {
     }
 
     private void bulkResponseAndRefreshRolesCache(
-        List<String> roleNames,
+        Collection<String> roleNames,
         BulkResponse bulkResponse,
         Map<String, Exception> validationErrorByRoleName,
         ActionListener<BulkRolesResponse> listener
@@ -430,7 +447,7 @@ private void bulkResponseAndRefreshRolesCache(
     }
 
     private void bulkResponseWithOnlyValidationErrors(
-        List<String> roleNames,
+        Collection<String> roleNames,
         Map<String, Exception> validationErrorByRoleName,
         ActionListener<BulkRolesResponse> listener
     ) {
@@ -542,7 +559,16 @@ public void onFailure(Exception e) {
 
     public void putRoles(
         final WriteRequest.RefreshPolicy refreshPolicy,
-        final List<RoleDescriptor> roles,
+        final Collection<RoleDescriptor> roles,
+        final ActionListener<BulkRolesResponse> listener
+    ) {
+        putRoles(refreshPolicy, roles, true, listener);
+    }
+
+    public void putRoles(
+        final WriteRequest.RefreshPolicy refreshPolicy,
+        final Collection<RoleDescriptor> roles,
+        boolean validateRoleDescriptors,
         final ActionListener<BulkRolesResponse> listener
     ) {
         if (enabled == false) {
@@ -555,7 +581,7 @@ public void putRoles(
         for (RoleDescriptor role : roles) {
             Exception validationException;
             try {
-                validationException = validateRoleDescriptor(role);
+                validationException = validateRoleDescriptors ? validateRoleDescriptor(role) : null;
             } catch (Exception e) {
                 validationException = e;
             }
@@ -621,8 +647,6 @@ private DeleteRequest createRoleDeleteRequest(final String roleName) {
 
     // Package private for testing
     XContentBuilder createRoleXContentBuilder(RoleDescriptor role) throws IOException {
-        assert NativeRealmValidationUtil.validateRoleName(role.getName(), false) == null
-            : "Role name was invalid or reserved: " + role.getName();
         assert false == role.hasRestriction() : "restriction is not supported for native roles";
 
         XContentBuilder builder = jsonBuilder().startObject();
@@ -671,7 +695,11 @@ public void usageStats(ActionListener<Map<String, Object>> listener) {
                     client.prepareMultiSearch()
                         .add(
                             client.prepareSearch(SECURITY_MAIN_ALIAS)
-                                .setQuery(QueryBuilders.termQuery(RoleDescriptor.Fields.TYPE.getPreferredName(), ROLE_TYPE))
+                                .setQuery(
+                                    QueryBuilders.boolQuery()
+                                        .must(QueryBuilders.termQuery(RoleDescriptor.Fields.TYPE.getPreferredName(), ROLE_TYPE))
+                                        .mustNot(QueryBuilders.termQuery("metadata_flattened._reserved", true))
+                                )
                                 .setTrackTotalHits(true)
                                 .setSize(0)
                         )
@@ -680,6 +708,7 @@ public void usageStats(ActionListener<Map<String, Object>> listener) {
                                 .setQuery(
                                     QueryBuilders.boolQuery()
                                         .must(QueryBuilders.termQuery(RoleDescriptor.Fields.TYPE.getPreferredName(), ROLE_TYPE))
+                                        .mustNot(QueryBuilders.termQuery("metadata_flattened._reserved", true))
                                         .must(
                                             QueryBuilders.boolQuery()
                                                 .should(existsQuery("indices.field_security.grant"))
@@ -697,6 +726,7 @@ public void usageStats(ActionListener<Map<String, Object>> listener) {
                                 .setQuery(
                                     QueryBuilders.boolQuery()
                                         .must(QueryBuilders.termQuery(RoleDescriptor.Fields.TYPE.getPreferredName(), ROLE_TYPE))
+                                        .mustNot(QueryBuilders.termQuery("metadata_flattened._reserved", true))
                                         .filter(existsQuery("indices.query"))
                                 )
                                 .setTrackTotalHits(true)
@@ -708,6 +738,7 @@ public void usageStats(ActionListener<Map<String, Object>> listener) {
                                 .setQuery(
                                     QueryBuilders.boolQuery()
                                         .must(QueryBuilders.termQuery(RoleDescriptor.Fields.TYPE.getPreferredName(), ROLE_TYPE))
+                                        .mustNot(QueryBuilders.termQuery("metadata_flattened._reserved", true))
                                         .filter(existsQuery("remote_indices"))
                                 )
                                 .setTrackTotalHits(true)
@@ -718,6 +749,7 @@ public void usageStats(ActionListener<Map<String, Object>> listener) {
                                 .setQuery(
                                     QueryBuilders.boolQuery()
                                         .must(QueryBuilders.termQuery(RoleDescriptor.Fields.TYPE.getPreferredName(), ROLE_TYPE))
+                                        .mustNot(QueryBuilders.termQuery("metadata_flattened._reserved", true))
                                         .filter(existsQuery("remote_cluster"))
                                 )
                                 .setTrackTotalHits(true)
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java
index c2dc7166bd3b6..3637159479463 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java
@@ -14,6 +14,8 @@
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.Scope;
+import org.elasticsearch.rest.ServerlessScope;
 import org.elasticsearch.rest.action.RestToXContentListener;
 import org.elasticsearch.search.searchafter.SearchAfterBuilder;
 import org.elasticsearch.search.sort.FieldSortBuilder;
@@ -32,6 +34,7 @@
 import static org.elasticsearch.rest.RestRequest.Method.POST;
 import static org.elasticsearch.xcontent.ConstructingObjectParser.optionalConstructorArg;
 
+@ServerlessScope(Scope.INTERNAL)
 public final class RestQueryRoleAction extends NativeRoleBaseRestHandler {
 
     @SuppressWarnings("unchecked")
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/FeatureNotEnabledException.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/FeatureNotEnabledException.java
index 87c23284c5819..8ba3ebad8a851 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/FeatureNotEnabledException.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/FeatureNotEnabledException.java
@@ -29,6 +29,7 @@ public enum Feature {
         }
     }
 
+    @SuppressWarnings("this-escape")
     public FeatureNotEnabledException(Feature feature, String message, Object... args) {
         super(message, args);
         addMetadata(DISABLED_FEATURE_METADATA, feature.featureName);
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRoles.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRoles.java
new file mode 100644
index 0000000000000..ec38e4951f45c
--- /dev/null
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRoles.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
+
+import java.util.Collection;
+import java.util.Map;
+
+/**
+ * A class that holds the built-in roles and their hash digests.
+ */
+public record QueryableBuiltInRoles(Map<String, String> rolesDigest, Collection<RoleDescriptor> roleDescriptors) {
+
+    /**
+     * A listener that is notified when the built-in roles change.
+     */
+    public interface Listener {
+
+        /**
+         * Called when the built-in roles change.
+         *
+         * @param roles the new built-in roles.
+         */
+        void onRolesChanged(QueryableBuiltInRoles roles);
+
+    }
+
+    /**
+     * A provider that provides the built-in roles and can notify subscribed listeners when the built-in roles change.
+     */
+    public interface Provider {
+
+        /**
+         * @return the built-in roles.
+         */
+        QueryableBuiltInRoles getRoles();
+
+        /**
+         * Adds a listener to be notified when the built-in roles change.
+         *
+         * @param listener the listener to add.
+         */
+        void addListener(Listener listener);
+
+    }
+}
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesProviderFactory.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesProviderFactory.java
new file mode 100644
index 0000000000000..c29b64836d1a5
--- /dev/null
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesProviderFactory.java
@@ -0,0 +1,23 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+import org.elasticsearch.xpack.security.authz.store.FileRolesStore;
+
+public interface QueryableBuiltInRolesProviderFactory {
+
+    QueryableBuiltInRoles.Provider createProvider(ReservedRolesStore reservedRolesStore, FileRolesStore fileRolesStore);
+
+    class Default implements QueryableBuiltInRolesProviderFactory {
+        @Override
+        public QueryableBuiltInRoles.Provider createProvider(ReservedRolesStore reservedRolesStore, FileRolesStore fileRolesStore) {
+            return new QueryableReservedRolesProvider(reservedRolesStore);
+        }
+    }
+}
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesSynchronizer.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesSynchronizer.java
new file mode 100644
index 0000000000000..60163434e212f
--- /dev/null
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesSynchronizer.java
@@ -0,0 +1,532 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.ResourceAlreadyExistsException;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.TransportActions;
+import org.elasticsearch.action.support.WriteRequest;
+import org.elasticsearch.cluster.ClusterChangedEvent;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateListener;
+import org.elasticsearch.cluster.ClusterStateTaskListener;
+import org.elasticsearch.cluster.NotMasterException;
+import org.elasticsearch.cluster.SimpleBatchedExecutor;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.Metadata;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.cluster.service.MasterServiceTaskQueue;
+import org.elasticsearch.common.Priority;
+import org.elasticsearch.common.collect.ImmutableOpenMap;
+import org.elasticsearch.common.component.LifecycleListener;
+import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.core.Nullable;
+import org.elasticsearch.core.Strings;
+import org.elasticsearch.core.Tuple;
+import org.elasticsearch.features.FeatureService;
+import org.elasticsearch.features.NodeFeature;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.index.engine.DocumentMissingException;
+import org.elasticsearch.index.engine.VersionConflictEngineException;
+import org.elasticsearch.indices.IndexClosedException;
+import org.elasticsearch.indices.IndexPrimaryShardNotAllocatedException;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.core.security.action.role.BulkRolesResponse;
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+import org.elasticsearch.xpack.security.authz.store.FileRolesStore;
+import org.elasticsearch.xpack.security.authz.store.NativeRolesStore;
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.concurrent.Executor;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+import static java.util.stream.Collectors.toMap;
+import static java.util.stream.Collectors.toSet;
+import static org.elasticsearch.xpack.security.support.QueryableBuiltInRolesUtils.determineRolesToDelete;
+import static org.elasticsearch.xpack.security.support.QueryableBuiltInRolesUtils.determineRolesToUpsert;
+import static org.elasticsearch.xpack.security.support.SecuritySystemIndices.SECURITY_MAIN_ALIAS;
+
+/**
+ * Synchronizes built-in roles to the .security index.
+ * The .security index is created if it does not exist.
+ * <p>
+ * The synchronization is executed only on the elected master node
+ * after the cluster has recovered and roles need to be synced.
+ * The goal is to reduce the potential for conflicting operations.
+ * While in most cases, there should be only a single node that’s
+ * attempting to create/update/delete roles, it’s still possible
+ * that the master node changes in the middle of the syncing process.
+ */
+public final class QueryableBuiltInRolesSynchronizer implements ClusterStateListener {
+
+    private static final Logger logger = LogManager.getLogger(QueryableBuiltInRolesSynchronizer.class);
+
+    /**
+     * This is a temporary feature flag to allow enabling the synchronization of built-in roles to the .security index.
+     * Initially, it is disabled by default due to the number of tests that need to be adjusted now that .security index
+     * is created earlier in the cluster lifecycle.
+     * <p>
+     * Once all tests are adjusted, this flag will be set to enabled by default and later removed altogether.
+     */
+    public static final boolean QUERYABLE_BUILT_IN_ROLES_ENABLED;
+    static {
+        final var propertyValue = System.getProperty("es.queryable_built_in_roles_enabled");
+        if (propertyValue == null || propertyValue.isEmpty() || "false".equals(propertyValue)) {
+            QUERYABLE_BUILT_IN_ROLES_ENABLED = false;
+        } else if ("true".equals(propertyValue)) {
+            QUERYABLE_BUILT_IN_ROLES_ENABLED = true;
+        } else {
+            throw new IllegalStateException(
+                "system property [es.queryable_built_in_roles_enabled] may only be set to [true] or [false], but was ["
+                    + propertyValue
+                    + "]"
+            );
+        }
+    }
+
+    public static final NodeFeature QUERYABLE_BUILT_IN_ROLES_FEATURE = new NodeFeature("security.queryable_built_in_roles");
+
+    /**
+     * Index metadata key of the digest of built-in roles indexed in the .security index.
+     * <p>
+     * The value is a map of built-in role names to their digests (calculated by sha256 of the role definition).
+     */
+    public static final String METADATA_QUERYABLE_BUILT_IN_ROLES_DIGEST_KEY = "queryable_built_in_roles_digest";
+
+    private static final SimpleBatchedExecutor<MarkRolesAsSyncedTask, Map<String, String>> MARK_ROLES_AS_SYNCED_TASK_EXECUTOR =
+        new SimpleBatchedExecutor<>() {
+            @Override
+            public Tuple<ClusterState, Map<String, String>> executeTask(MarkRolesAsSyncedTask task, ClusterState clusterState) {
+                return task.execute(clusterState);
+            }
+
+            @Override
+            public void taskSucceeded(MarkRolesAsSyncedTask task, Map<String, String> value) {
+                task.success(value);
+            }
+        };
+
+    private final MasterServiceTaskQueue<MarkRolesAsSyncedTask> markRolesAsSyncedTaskQueue;
+
+    private final ClusterService clusterService;
+    private final FeatureService featureService;
+    private final QueryableBuiltInRoles.Provider rolesProvider;
+    private final NativeRolesStore nativeRolesStore;
+    private final Executor executor;
+    private final AtomicBoolean synchronizationInProgress = new AtomicBoolean(false);
+
+    private volatile boolean securityIndexDeleted = false;
+
+    /**
+     * Constructs a new built-in roles synchronizer.
+     *
+     * @param clusterService the cluster service to register as a listener
+     * @param featureService the feature service to check if the cluster has the queryable built-in roles feature
+     * @param rolesProviderFactory the factory to create the built-in roles provider
+     * @param nativeRolesStore the native roles store to sync the built-in roles to
+     * @param reservedRolesStore the reserved roles store to fetch the built-in roles from
+     * @param fileRolesStore the file roles store to fetch the built-in roles from
+     * @param threadPool the thread pool
+     */
+    public QueryableBuiltInRolesSynchronizer(
+        ClusterService clusterService,
+        FeatureService featureService,
+        QueryableBuiltInRolesProviderFactory rolesProviderFactory,
+        NativeRolesStore nativeRolesStore,
+        ReservedRolesStore reservedRolesStore,
+        FileRolesStore fileRolesStore,
+        ThreadPool threadPool
+    ) {
+        this.clusterService = clusterService;
+        this.featureService = featureService;
+        this.rolesProvider = rolesProviderFactory.createProvider(reservedRolesStore, fileRolesStore);
+        this.nativeRolesStore = nativeRolesStore;
+        this.executor = threadPool.generic();
+        this.markRolesAsSyncedTaskQueue = clusterService.createTaskQueue(
+            "mark-built-in-roles-as-synced-task-queue",
+            Priority.LOW,
+            MARK_ROLES_AS_SYNCED_TASK_EXECUTOR
+        );
+        this.rolesProvider.addListener(this::builtInRolesChanged);
+        this.clusterService.addLifecycleListener(new LifecycleListener() {
+            @Override
+            public void beforeStop() {
+                clusterService.removeListener(QueryableBuiltInRolesSynchronizer.this);
+            }
+
+            @Override
+            public void beforeStart() {
+                clusterService.addListener(QueryableBuiltInRolesSynchronizer.this);
+            }
+        });
+    }
+
+    private void builtInRolesChanged(QueryableBuiltInRoles roles) {
+        logger.debug("Built-in roles changed, attempting to sync to .security index");
+        final ClusterState state = clusterService.state();
+        if (shouldSyncBuiltInRoles(state)) {
+            syncBuiltInRoles(roles);
+        }
+    }
+
+    @Override
+    public void clusterChanged(ClusterChangedEvent event) {
+        final ClusterState state = event.state();
+        if (isSecurityIndexDeleted(event)) {
+            this.securityIndexDeleted = true;
+            logger.trace("Received security index deletion event, skipping built-in roles synchronization");
+            return;
+        } else if (isSecurityIndexCreatedOrRecovered(event)) {
+            this.securityIndexDeleted = false;
+            logger.trace("Security index has been created/recovered, attempting to sync built-in roles");
+        }
+        if (shouldSyncBuiltInRoles(state)) {
+            final QueryableBuiltInRoles roles = rolesProvider.getRoles();
+            syncBuiltInRoles(roles);
+        }
+    }
+
+    private void syncBuiltInRoles(final QueryableBuiltInRoles roles) {
+        if (synchronizationInProgress.compareAndSet(false, true)) {
+            final Map<String, String> indexedRolesDigests = readIndexedBuiltInRolesDigests(clusterService.state());
+            if (roles.rolesDigest().equals(indexedRolesDigests)) {
+                logger.debug("Security index already contains the latest built-in roles indexed, skipping synchronization");
+                return;
+            }
+            executor.execute(() -> doSyncBuiltinRoles(indexedRolesDigests, roles, ActionListener.wrap(v -> {
+                logger.info("Successfully synced [" + roles.roleDescriptors().size() + "] built-in roles to .security index");
+                synchronizationInProgress.set(false);
+            }, e -> {
+                handleException(e);
+                synchronizationInProgress.set(false);
+            })));
+        }
+    }
+
+    private static void handleException(Exception e) {
+        if (e instanceof BulkRolesResponseException bulkException) {
+            final boolean isBulkDeleteFailure = bulkException instanceof BulkDeleteRolesResponseException;
+            for (final Map.Entry<String, Exception> bulkFailure : bulkException.getFailures().entrySet()) {
+                final String logMessage = Strings.format(
+                    "Failed to [%s] built-in role [%s]",
+                    isBulkDeleteFailure ? "delete" : "create/update",
+                    bulkFailure.getKey()
+                );
+                if (isExpectedFailure(bulkFailure.getValue())) {
+                    logger.info(logMessage, bulkFailure.getValue());
+                } else {
+                    logger.warn(logMessage, bulkFailure.getValue());
+                }
+            }
+        } else if (isExpectedFailure(e)) {
+            logger.info("Failed to sync built-in roles to .security index", e);
+        } else {
+            logger.warn("Failed to sync built-in roles to .security index due to unexpected exception", e);
+        }
+    }
+
+    /**
+     * Some failures are expected and should not be logged as errors.
+     * These exceptions are either:
+     * - transient (e.g. connection errors),
+     * - recoverable (e.g. no longer master, index reallocating or caused by concurrent operations)
+     * - not recoverable but expected (e.g. index closed).
+     *
+     * @param e to check
+     * @return {@code true} if the exception is expected and should not be logged as an error
+     */
+    private static boolean isExpectedFailure(final Exception e) {
+        final Throwable cause = ExceptionsHelper.unwrapCause(e);
+        return ExceptionsHelper.isNodeOrShardUnavailableTypeException(cause)
+            || TransportActions.isShardNotAvailableException(cause)
+            || cause instanceof IndexClosedException
+            || cause instanceof IndexPrimaryShardNotAllocatedException
+            || cause instanceof NotMasterException
+            || cause instanceof ResourceAlreadyExistsException
+            || cause instanceof VersionConflictEngineException
+            || cause instanceof DocumentMissingException
+            || cause instanceof FailedToMarkBuiltInRolesAsSyncedException;
+    }
+
+    private boolean shouldSyncBuiltInRoles(final ClusterState state) {
+        if (false == state.nodes().isLocalNodeElectedMaster()) {
+            logger.trace("Local node is not the master, skipping built-in roles synchronization");
+            return false;
+        }
+        if (false == state.clusterRecovered()) {
+            logger.trace("Cluster state has not recovered yet, skipping built-in roles synchronization");
+            return false;
+        }
+        if (nativeRolesStore.isEnabled() == false) {
+            logger.trace("Native roles store is not enabled, skipping built-in roles synchronization");
+            return false;
+        }
+        if (state.nodes().getDataNodes().isEmpty()) {
+            logger.trace("No data nodes in the cluster, skipping built-in roles synchronization");
+            return false;
+        }
+        if (state.nodes().isMixedVersionCluster()) {
+            // To keep things simple and avoid potential overwrites with an older version of built-in roles,
+            // we only sync built-in roles if all nodes are on the same version.
+            logger.trace("Not all nodes are on the same version, skipping built-in roles synchronization");
+            return false;
+        }
+        if (false == featureService.clusterHasFeature(state, QUERYABLE_BUILT_IN_ROLES_FEATURE)) {
+            logger.trace("Not all nodes support queryable built-in roles feature, skipping built-in roles synchronization");
+            return false;
+        }
+        if (securityIndexDeleted) {
+            logger.trace("Security index is deleted, skipping built-in roles synchronization");
+            return false;
+        }
+        if (isSecurityIndexClosed(state)) {
+            logger.trace("Security index is closed, skipping built-in roles synchronization");
+            return false;
+        }
+        return true;
+    }
+
+    private void doSyncBuiltinRoles(
+        final Map<String, String> indexedRolesDigests,
+        final QueryableBuiltInRoles roles,
+        final ActionListener<Void> listener
+    ) {
+        final Set<RoleDescriptor> rolesToUpsert = determineRolesToUpsert(roles, indexedRolesDigests);
+        final Set<String> rolesToDelete = determineRolesToDelete(roles, indexedRolesDigests);
+
+        assert Sets.intersection(rolesToUpsert.stream().map(RoleDescriptor::getName).collect(toSet()), rolesToDelete).isEmpty()
+            : "The roles to upsert and delete should not have any common roles";
+
+        if (rolesToUpsert.isEmpty() && rolesToDelete.isEmpty()) {
+            logger.debug("No changes to built-in roles to sync to .security index");
+            listener.onResponse(null);
+            return;
+        }
+
+        indexRoles(rolesToUpsert, listener.delegateFailureAndWrap((l1, indexResponse) -> {
+            deleteRoles(rolesToDelete, l1.delegateFailureAndWrap((l2, deleteResponse) -> {
+                markRolesAsSynced(indexedRolesDigests, roles.rolesDigest(), l2);
+            }));
+        }));
+    }
+
+    private void deleteRoles(final Set<String> rolesToDelete, final ActionListener<Void> listener) {
+        if (rolesToDelete.isEmpty()) {
+            listener.onResponse(null);
+            return;
+        }
+        nativeRolesStore.deleteRoles(rolesToDelete, WriteRequest.RefreshPolicy.IMMEDIATE, false, ActionListener.wrap(deleteResponse -> {
+            final Map<String, Exception> deleteFailure = deleteResponse.getItems()
+                .stream()
+                .filter(BulkRolesResponse.Item::isFailed)
+                .collect(toMap(BulkRolesResponse.Item::getRoleName, BulkRolesResponse.Item::getCause));
+            if (deleteFailure.isEmpty()) {
+                listener.onResponse(null);
+            } else {
+                listener.onFailure(new BulkDeleteRolesResponseException(deleteFailure));
+            }
+        }, listener::onFailure));
+    }
+
+    private void indexRoles(final Collection<RoleDescriptor> rolesToUpsert, final ActionListener<Void> listener) {
+        if (rolesToUpsert.isEmpty()) {
+            listener.onResponse(null);
+            return;
+        }
+        nativeRolesStore.putRoles(WriteRequest.RefreshPolicy.IMMEDIATE, rolesToUpsert, false, ActionListener.wrap(response -> {
+            final Map<String, Exception> indexFailures = response.getItems()
+                .stream()
+                .filter(BulkRolesResponse.Item::isFailed)
+                .collect(toMap(BulkRolesResponse.Item::getRoleName, BulkRolesResponse.Item::getCause));
+            if (indexFailures.isEmpty()) {
+                listener.onResponse(null);
+            } else {
+                listener.onFailure(new BulkIndexRolesResponseException(indexFailures));
+            }
+        }, listener::onFailure));
+    }
+
+    private boolean isSecurityIndexDeleted(final ClusterChangedEvent event) {
+        final IndexMetadata previousSecurityIndexMetadata = resolveSecurityIndexMetadata(event.previousState().metadata());
+        final IndexMetadata currentSecurityIndexMetadata = resolveSecurityIndexMetadata(event.state().metadata());
+        return previousSecurityIndexMetadata != null && currentSecurityIndexMetadata == null;
+    }
+
+    private boolean isSecurityIndexCreatedOrRecovered(final ClusterChangedEvent event) {
+        final IndexMetadata previousSecurityIndexMetadata = resolveSecurityIndexMetadata(event.previousState().metadata());
+        final IndexMetadata currentSecurityIndexMetadata = resolveSecurityIndexMetadata(event.state().metadata());
+        return previousSecurityIndexMetadata == null && currentSecurityIndexMetadata != null;
+    }
+
+    private boolean isSecurityIndexClosed(final ClusterState state) {
+        final IndexMetadata indexMetadata = resolveSecurityIndexMetadata(state.metadata());
+        return indexMetadata != null && indexMetadata.getState() == IndexMetadata.State.CLOSE;
+    }
+
+    /**
+     * This method marks the built-in roles as synced in the .security index
+     * by setting the new roles digests in the metadata of the .security index.
+     * <p>
+     * The marking is done as a compare and swap operation to ensure that the roles
+     * are marked as synced only when new roles are indexed. The operation is idempotent
+     * and will succeed if the expected roles digests are equal to the digests in the
+     * .security index or if they are equal to the new roles digests.
+     */
+    private void markRolesAsSynced(
+        final Map<String, String> expectedRolesDigests,
+        final Map<String, String> newRolesDigests,
+        final ActionListener<Void> listener
+    ) {
+        final IndexMetadata securityIndexMetadata = resolveSecurityIndexMetadata(clusterService.state().metadata());
+        if (securityIndexMetadata == null) {
+            listener.onFailure(new IndexNotFoundException(SECURITY_MAIN_ALIAS));
+            return;
+        }
+        final Index concreteSecurityIndex = securityIndexMetadata.getIndex();
+        markRolesAsSyncedTaskQueue.submitTask(
+            "mark built-in roles as synced task",
+            new MarkRolesAsSyncedTask(listener.delegateFailureAndWrap((l, response) -> {
+                if (newRolesDigests.equals(response) == false) {
+                    logger.debug(
+                        () -> Strings.format(
+                            "Another master node most probably indexed a newer versions of built-in roles in the meantime. "
+                                + "Expected: [%s], Actual: [%s]",
+                            newRolesDigests,
+                            response
+                        )
+                    );
+                    l.onFailure(
+                        new FailedToMarkBuiltInRolesAsSyncedException(
+                            "Failed to mark built-in roles as synced. The expected role digests have changed."
+                        )
+                    );
+                } else {
+                    l.onResponse(null);
+                }
+            }), concreteSecurityIndex.getName(), expectedRolesDigests, newRolesDigests),
+            null
+        );
+    }
+
+    private Map<String, String> readIndexedBuiltInRolesDigests(final ClusterState state) {
+        final IndexMetadata indexMetadata = resolveSecurityIndexMetadata(state.metadata());
+        if (indexMetadata == null) {
+            return null;
+        }
+        return indexMetadata.getCustomData(METADATA_QUERYABLE_BUILT_IN_ROLES_DIGEST_KEY);
+    }
+
+    private static IndexMetadata resolveSecurityIndexMetadata(final Metadata metadata) {
+        return SecurityIndexManager.resolveConcreteIndex(SECURITY_MAIN_ALIAS, metadata);
+    }
+
+    static class MarkRolesAsSyncedTask implements ClusterStateTaskListener {
+
+        private final ActionListener<Map<String, String>> listener;
+        private final String concreteSecurityIndexName;
+        private final Map<String, String> expectedRoleDigests;
+        private final Map<String, String> newRoleDigests;
+
+        MarkRolesAsSyncedTask(
+            ActionListener<Map<String, String>> listener,
+            String concreteSecurityIndexName,
+            @Nullable Map<String, String> expectedRoleDigests,
+            @Nullable Map<String, String> newRoleDigests
+        ) {
+            this.listener = listener;
+            this.concreteSecurityIndexName = concreteSecurityIndexName;
+            this.expectedRoleDigests = expectedRoleDigests;
+            this.newRoleDigests = newRoleDigests;
+        }
+
+        Tuple<ClusterState, Map<String, String>> execute(ClusterState state) {
+            IndexMetadata indexMetadata = state.metadata().index(concreteSecurityIndexName);
+            if (indexMetadata == null) {
+                throw new IndexNotFoundException(concreteSecurityIndexName);
+            }
+            Map<String, String> existingRoleDigests = indexMetadata.getCustomData(METADATA_QUERYABLE_BUILT_IN_ROLES_DIGEST_KEY);
+            if (Objects.equals(expectedRoleDigests, existingRoleDigests)) {
+                IndexMetadata.Builder indexMetadataBuilder = IndexMetadata.builder(indexMetadata);
+                if (newRoleDigests != null) {
+                    indexMetadataBuilder.putCustom(METADATA_QUERYABLE_BUILT_IN_ROLES_DIGEST_KEY, newRoleDigests);
+                } else {
+                    indexMetadataBuilder.removeCustom(METADATA_QUERYABLE_BUILT_IN_ROLES_DIGEST_KEY);
+                }
+                indexMetadataBuilder.version(indexMetadataBuilder.version() + 1);
+                ImmutableOpenMap.Builder<String, IndexMetadata> builder = ImmutableOpenMap.builder(state.metadata().indices());
+                builder.put(concreteSecurityIndexName, indexMetadataBuilder.build());
+                return new Tuple<>(
+                    ClusterState.builder(state).metadata(Metadata.builder(state.metadata()).indices(builder.build()).build()).build(),
+                    newRoleDigests
+                );
+            } else {
+                // returns existing value when expectation is not met
+                return new Tuple<>(state, existingRoleDigests);
+            }
+        }
+
+        void success(Map<String, String> value) {
+            listener.onResponse(value);
+        }
+
+        @Override
+        public void onFailure(Exception e) {
+            listener.onFailure(e);
+        }
+    }
+
+    private static class BulkDeleteRolesResponseException extends BulkRolesResponseException {
+
+        BulkDeleteRolesResponseException(Map<String, Exception> failures) {
+            super("Failed to bulk delete built-in roles", failures);
+        }
+
+    }
+
+    private static class BulkIndexRolesResponseException extends BulkRolesResponseException {
+
+        BulkIndexRolesResponseException(Map<String, Exception> failures) {
+            super("Failed to bulk create/update built-in roles", failures);
+        }
+
+    }
+
+    private abstract static class BulkRolesResponseException extends RuntimeException {
+
+        private final Map<String, Exception> failures;
+
+        BulkRolesResponseException(String message, Map<String, Exception> failures) {
+            super(message);
+            assert failures != null && failures.isEmpty() == false;
+            this.failures = failures;
+            failures.values().forEach(this::addSuppressed);
+        }
+
+        Map<String, Exception> getFailures() {
+            return failures;
+        }
+
+    }
+
+    private static class FailedToMarkBuiltInRolesAsSyncedException extends RuntimeException {
+
+        FailedToMarkBuiltInRolesAsSyncedException(String message) {
+            super(message);
+        }
+
+    }
+
+}
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtils.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtils.java
new file mode 100644
index 0000000000000..2d2eb345594ed
--- /dev/null
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtils.java
@@ -0,0 +1,101 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.hash.MessageDigests;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.util.Maps;
+import org.elasticsearch.common.util.set.Sets;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
+
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.security.MessageDigest;
+import java.util.Base64;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+
+import static org.elasticsearch.xcontent.ToXContent.EMPTY_PARAMS;
+
+/**
+ * Utility class which provides helper method for calculating the hash of a role descriptor,
+ * determining the roles to upsert and the roles to delete.
+ */
+public final class QueryableBuiltInRolesUtils {
+
+    /**
+     * Calculates the hash of the given role descriptor by serializing it by calling {@link RoleDescriptor#writeTo(StreamOutput)} method
+     * and then SHA256 hashing the bytes.
+     *
+     * @param roleDescriptor the role descriptor to hash
+     * @return the base64 encoded SHA256 hash of the role descriptor
+     */
+    public static String calculateHash(final RoleDescriptor roleDescriptor) {
+        final MessageDigest hash = MessageDigests.sha256();
+        try (XContentBuilder jsonBuilder = XContentFactory.jsonBuilder()) {
+            roleDescriptor.toXContent(jsonBuilder, EMPTY_PARAMS);
+            final Map<String, Object> flattenMap = Maps.flatten(
+                XContentHelper.convertToMap(BytesReference.bytes(jsonBuilder), true, XContentType.JSON).v2(),
+                false,
+                true
+            );
+            hash.update(flattenMap.toString().getBytes(StandardCharsets.UTF_8));
+        } catch (IOException e) {
+            throw new IllegalStateException("failed to compute digest for [" + roleDescriptor.getName() + "] role", e);
+        }
+        // HEX vs Base64 encoding is a trade-off between readability and space efficiency
+        // opting for Base64 here to reduce the size of the cluster state
+        return Base64.getEncoder().encodeToString(hash.digest());
+    }
+
+    /**
+     * Determines the roles to delete by comparing the indexed roles with the roles in the built-in roles.
+     * @return the set of roles to delete
+     */
+    public static Set<String> determineRolesToDelete(final QueryableBuiltInRoles roles, final Map<String, String> indexedRolesDigests) {
+        assert roles != null;
+        if (indexedRolesDigests == null) {
+            // nothing indexed, nothing to delete
+            return Set.of();
+        }
+        final Set<String> rolesToDelete = Sets.difference(indexedRolesDigests.keySet(), roles.rolesDigest().keySet());
+        return Collections.unmodifiableSet(rolesToDelete);
+    }
+
+    /**
+     * Determines the roles to upsert by comparing the indexed roles and their digests with the current built-in roles.
+     * @return the set of roles to upsert (create or update)
+     */
+    public static Set<RoleDescriptor> determineRolesToUpsert(
+        final QueryableBuiltInRoles roles,
+        final Map<String, String> indexedRolesDigests
+    ) {
+        assert roles != null;
+        final Set<RoleDescriptor> rolesToUpsert = new HashSet<>();
+        for (RoleDescriptor role : roles.roleDescriptors()) {
+            final String roleDigest = roles.rolesDigest().get(role.getName());
+            if (indexedRolesDigests == null || indexedRolesDigests.containsKey(role.getName()) == false) {
+                rolesToUpsert.add(role);  // a new role to create
+            } else if (indexedRolesDigests.get(role.getName()).equals(roleDigest) == false) {
+                rolesToUpsert.add(role);  // an existing role that needs to be updated
+            }
+        }
+        return Collections.unmodifiableSet(rolesToUpsert);
+    }
+
+    private QueryableBuiltInRolesUtils() {
+        throw new IllegalAccessError("not allowed");
+    }
+}
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProvider.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProvider.java
new file mode 100644
index 0000000000000..710e94b7ac879
--- /dev/null
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProvider.java
@@ -0,0 +1,56 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.common.util.CachedSupplier;
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.function.Supplier;
+import java.util.stream.Collectors;
+
+/**
+ * A provider of the built-in reserved roles.
+ * <p>
+ * This provider fetches all reserved roles from the {@link ReservedRolesStore} and calculates their hashes lazily.
+ * The reserved roles are static and do not change during runtime, hence this provider will never notify any listeners.
+ * </p>
+ */
+public final class QueryableReservedRolesProvider implements QueryableBuiltInRoles.Provider {
+
+    private final Supplier<QueryableBuiltInRoles> reservedRolesSupplier;
+
+    /**
+     * Constructs a new reserved roles provider.
+     *
+     * @param reservedRolesStore the store to fetch the reserved roles from.
+     *                           Having a store reference here is necessary to ensure that static fields are initialized.
+     */
+    public QueryableReservedRolesProvider(ReservedRolesStore reservedRolesStore) {
+        this.reservedRolesSupplier = CachedSupplier.wrap(() -> {
+            final Collection<RoleDescriptor> roleDescriptors = Collections.unmodifiableCollection(ReservedRolesStore.roleDescriptors());
+            return new QueryableBuiltInRoles(
+                roleDescriptors.stream()
+                    .collect(Collectors.toUnmodifiableMap(RoleDescriptor::getName, QueryableBuiltInRolesUtils::calculateHash)),
+                roleDescriptors
+            );
+        });
+    }
+
+    @Override
+    public QueryableBuiltInRoles getRoles() {
+        return reservedRolesSupplier.get();
+    }
+
+    @Override
+    public void addListener(QueryableBuiltInRoles.Listener listener) {
+        // no-op: reserved roles are static and do not change
+    }
+}
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
index f3222a74b530c..78f7209c06e3a 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/support/SecurityIndexManager.java
@@ -586,7 +586,7 @@ private static int readMappingVersion(String indexName, MappingMetadata mappingM
      * Resolves a concrete index name or alias to a {@link IndexMetadata} instance.  Requires
      * that if supplied with an alias, the alias resolves to at most one concrete index.
      */
-    private static IndexMetadata resolveConcreteIndex(final String indexOrAliasName, final Metadata metadata) {
+    public static IndexMetadata resolveConcreteIndex(final String indexOrAliasName, final Metadata metadata) {
         final IndexAbstraction indexAbstraction = metadata.getIndicesLookup().get(indexOrAliasName);
         if (indexAbstraction != null) {
             final List<Index> indices = indexAbstraction.getIndices();
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtilsTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtilsTests.java
new file mode 100644
index 0000000000000..5b4787f25ae7f
--- /dev/null
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableBuiltInRolesUtilsTests.java
@@ -0,0 +1,296 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptorTestHelper;
+import org.elasticsearch.xpack.core.security.authz.permission.RemoteClusterPermissionGroup;
+import org.elasticsearch.xpack.core.security.authz.permission.RemoteClusterPermissions;
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+import org.junit.BeforeClass;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Set;
+
+import static org.elasticsearch.xpack.core.security.support.MetadataUtils.RESERVED_METADATA_KEY;
+import static org.elasticsearch.xpack.security.support.QueryableBuiltInRolesUtils.determineRolesToDelete;
+import static org.elasticsearch.xpack.security.support.QueryableBuiltInRolesUtils.determineRolesToUpsert;
+import static org.hamcrest.Matchers.containsInAnyOrder;
+import static org.hamcrest.Matchers.empty;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
+
+public class QueryableBuiltInRolesUtilsTests extends ESTestCase {
+
+    @BeforeClass
+    public static void setupReservedRolesStore() {
+        new ReservedRolesStore(); // initialize the store
+    }
+
+    public void testCalculateHash() {
+        assertThat(
+            QueryableBuiltInRolesUtils.calculateHash(ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR),
+            equalTo("bWEFdFo4WX229wdhdecfiz5QHMYEssh3ex8hizRgg+Q=")
+        );
+    }
+
+    public void testEmptyOrNullRolesToUpsertOrDelete() {
+        // test empty roles and index digests
+        final QueryableBuiltInRoles emptyRoles = new QueryableBuiltInRoles(Map.of(), Set.of());
+        assertThat(determineRolesToDelete(emptyRoles, Map.of()), is(empty()));
+        assertThat(determineRolesToUpsert(emptyRoles, Map.of()), is(empty()));
+
+        // test empty roles and null indexed digests
+        assertThat(determineRolesToDelete(emptyRoles, null), is(empty()));
+        assertThat(determineRolesToUpsert(emptyRoles, null), is(empty()));
+    }
+
+    public void testNoRolesToUpsertOrDelete() {
+        {
+            QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(
+                Set.of(
+                    ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                    ReservedRolesStore.roleDescriptor("viewer"),
+                    ReservedRolesStore.roleDescriptor("editor")
+                )
+            );
+
+            // no roles to delete or upsert since the built-in roles are the same as the indexed roles
+            assertThat(determineRolesToDelete(currentBuiltInRoles, currentBuiltInRoles.rolesDigest()), is(empty()));
+            assertThat(determineRolesToUpsert(currentBuiltInRoles, currentBuiltInRoles.rolesDigest()), is(empty()));
+        }
+        {
+            QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(
+                Set.of(
+                    ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                    ReservedRolesStore.roleDescriptor("viewer"),
+                    ReservedRolesStore.roleDescriptor("editor"),
+                    supermanRole("monitor", "read")
+                )
+            );
+
+            Map<String, String> digests = buildDigests(
+                Set.of(
+                    ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                    ReservedRolesStore.roleDescriptor("viewer"),
+                    ReservedRolesStore.roleDescriptor("editor"),
+                    supermanRole("monitor", "read")
+                )
+            );
+
+            // no roles to delete or upsert since the built-in roles are the same as the indexed roles
+            assertThat(determineRolesToDelete(currentBuiltInRoles, digests), is(empty()));
+            assertThat(determineRolesToUpsert(currentBuiltInRoles, digests), is(empty()));
+        }
+        {
+            final RoleDescriptor randomRole = RoleDescriptorTestHelper.randomRoleDescriptor();
+            final QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(Set.of(randomRole));
+            final Map<String, String> digests = buildDigests(
+                Set.of(
+                    new RoleDescriptor(
+                        randomRole.getName(),
+                        randomRole.getClusterPrivileges(),
+                        randomRole.getIndicesPrivileges(),
+                        randomRole.getApplicationPrivileges(),
+                        randomRole.getConditionalClusterPrivileges(),
+                        randomRole.getRunAs(),
+                        randomRole.getMetadata(),
+                        randomRole.getTransientMetadata(),
+                        randomRole.getRemoteIndicesPrivileges(),
+                        randomRole.getRemoteClusterPermissions(),
+                        randomRole.getRestriction(),
+                        randomRole.getDescription()
+                    )
+                )
+            );
+
+            assertThat(determineRolesToDelete(currentBuiltInRoles, digests), is(empty()));
+            assertThat(determineRolesToUpsert(currentBuiltInRoles, digests), is(empty()));
+        }
+    }
+
+    public void testRolesToDeleteOnly() {
+        Map<String, String> indexedDigests = buildDigests(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor"),
+                supermanRole("monitor", "read", "view_index_metadata", "read_cross_cluster")
+            )
+        );
+
+        QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor")
+            )
+        );
+
+        // superman is the only role that needs to be deleted since it is not in a current built-in role
+        assertThat(determineRolesToDelete(currentBuiltInRoles, indexedDigests), containsInAnyOrder("superman"));
+        assertThat(determineRolesToUpsert(currentBuiltInRoles, indexedDigests), is(empty()));
+
+        // passing empty built-in roles should result in all indexed roles needing to be deleted
+        QueryableBuiltInRoles emptyBuiltInRoles = new QueryableBuiltInRoles(Map.of(), Set.of());
+        assertThat(
+            determineRolesToDelete(emptyBuiltInRoles, indexedDigests),
+            containsInAnyOrder("superman", "viewer", "editor", "superuser")
+        );
+        assertThat(determineRolesToUpsert(emptyBuiltInRoles, indexedDigests), is(empty()));
+    }
+
+    public void testRolesToUpdateOnly() {
+        Map<String, String> indexedDigests = buildDigests(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor"),
+                supermanRole("monitor", "read", "write")
+            )
+        );
+
+        RoleDescriptor updatedSupermanRole = supermanRole("monitor", "read", "view_index_metadata", "read_cross_cluster");
+        QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor"),
+                updatedSupermanRole
+            )
+        );
+
+        // superman is the only role that needs to be updated since its definition has changed
+        assertThat(determineRolesToDelete(currentBuiltInRoles, indexedDigests), is(empty()));
+        assertThat(determineRolesToUpsert(currentBuiltInRoles, indexedDigests), containsInAnyOrder(updatedSupermanRole));
+        assertThat(currentBuiltInRoles.rolesDigest().get("superman"), is(not(equalTo(indexedDigests.get("superman")))));
+    }
+
+    public void testRolesToCreateOnly() {
+        Map<String, String> indexedDigests = buildDigests(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor")
+            )
+        );
+
+        RoleDescriptor newSupermanRole = supermanRole("monitor", "read", "view_index_metadata", "read_cross_cluster");
+        QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor"),
+                newSupermanRole
+            )
+        );
+
+        // superman is the only role that needs to be created since it is not in the indexed roles
+        assertThat(determineRolesToDelete(currentBuiltInRoles, indexedDigests), is(empty()));
+        assertThat(determineRolesToUpsert(currentBuiltInRoles, indexedDigests), containsInAnyOrder(newSupermanRole));
+
+        // passing empty indexed roles should result in all roles needing to be created
+        assertThat(determineRolesToDelete(currentBuiltInRoles, Map.of()), is(empty()));
+        assertThat(
+            determineRolesToUpsert(currentBuiltInRoles, Map.of()),
+            containsInAnyOrder(currentBuiltInRoles.roleDescriptors().toArray(new RoleDescriptor[0]))
+        );
+    }
+
+    public void testRolesToUpsertAndDelete() {
+        Map<String, String> indexedDigests = buildDigests(
+            Set.of(
+                ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR,
+                ReservedRolesStore.roleDescriptor("viewer"),
+                ReservedRolesStore.roleDescriptor("editor")
+            )
+        );
+
+        RoleDescriptor newSupermanRole = supermanRole("monitor");
+        QueryableBuiltInRoles currentBuiltInRoles = buildQueryableBuiltInRoles(
+            Set.of(ReservedRolesStore.SUPERUSER_ROLE_DESCRIPTOR, newSupermanRole)
+        );
+
+        // superman is the only role that needs to be updated since its definition has changed
+        assertThat(determineRolesToDelete(currentBuiltInRoles, indexedDigests), containsInAnyOrder("viewer", "editor"));
+        assertThat(determineRolesToUpsert(currentBuiltInRoles, indexedDigests), containsInAnyOrder(newSupermanRole));
+    }
+
+    private static RoleDescriptor supermanRole(String... indicesPrivileges) {
+        return new RoleDescriptor(
+            "superman",
+            new String[] { "all" },
+            new RoleDescriptor.IndicesPrivileges[] {
+                RoleDescriptor.IndicesPrivileges.builder().indices("*").privileges("all").allowRestrictedIndices(false).build(),
+                RoleDescriptor.IndicesPrivileges.builder()
+                    .indices("*")
+                    .privileges(indicesPrivileges)
+                    .allowRestrictedIndices(true)
+                    .build() },
+            new RoleDescriptor.ApplicationResourcePrivileges[] {
+                RoleDescriptor.ApplicationResourcePrivileges.builder().application("*").privileges("*").resources("*").build() },
+            null,
+            new String[] { "*" },
+            randomlyOrderedSupermanMetadata(),
+            Collections.emptyMap(),
+            new RoleDescriptor.RemoteIndicesPrivileges[] {
+                new RoleDescriptor.RemoteIndicesPrivileges(
+                    RoleDescriptor.IndicesPrivileges.builder().indices("*").privileges("all").allowRestrictedIndices(false).build(),
+                    "*"
+                ),
+                new RoleDescriptor.RemoteIndicesPrivileges(
+                    RoleDescriptor.IndicesPrivileges.builder()
+                        .indices("*")
+                        .privileges(indicesPrivileges)
+                        .allowRestrictedIndices(true)
+                        .build(),
+                    "*"
+                ) },
+            new RemoteClusterPermissions().addGroup(
+                new RemoteClusterPermissionGroup(
+                    RemoteClusterPermissions.getSupportedRemoteClusterPermissions().toArray(new String[0]),
+                    new String[] { "*" }
+                )
+            ),
+            null,
+            "Grants full access to cluster management and data indices."
+        );
+    }
+
+    private static Map<String, Object> randomlyOrderedSupermanMetadata() {
+        final LinkedHashMap<String, Object> metadata = new LinkedHashMap<>();
+        if (randomBoolean()) {
+            metadata.put("foo", "bar");
+            metadata.put("baz", "qux");
+            metadata.put(RESERVED_METADATA_KEY, true);
+        } else {
+            metadata.put(RESERVED_METADATA_KEY, true);
+            metadata.put("foo", "bar");
+            metadata.put("baz", "qux");
+        }
+        return metadata;
+    }
+
+    private static QueryableBuiltInRoles buildQueryableBuiltInRoles(Set<RoleDescriptor> roles) {
+        final Map<String, String> digests = buildDigests(roles);
+        return new QueryableBuiltInRoles(digests, roles);
+    }
+
+    private static Map<String, String> buildDigests(Set<RoleDescriptor> roles) {
+        final Map<String, String> digests = new HashMap<>();
+        for (RoleDescriptor role : roles) {
+            digests.put(role.getName(), QueryableBuiltInRolesUtils.calculateHash(role));
+        }
+        return digests;
+    }
+}
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProviderTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProviderTests.java
new file mode 100644
index 0000000000000..7beb078795b29
--- /dev/null
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/support/QueryableReservedRolesProviderTests.java
@@ -0,0 +1,31 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.security.support;
+
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.core.security.authz.RoleDescriptor;
+import org.elasticsearch.xpack.core.security.authz.store.ReservedRolesStore;
+
+import java.util.stream.Collectors;
+
+import static org.hamcrest.Matchers.equalTo;
+
+public class QueryableReservedRolesProviderTests extends ESTestCase {
+
+    public void testReservedRoleProvider() {
+        QueryableReservedRolesProvider provider = new QueryableReservedRolesProvider(new ReservedRolesStore());
+        assertNotNull(provider.getRoles());
+        assertThat(provider.getRoles(), equalTo(provider.getRoles()));
+        assertThat(provider.getRoles().rolesDigest().size(), equalTo(ReservedRolesStore.roleDescriptors().size()));
+        assertThat(
+            provider.getRoles().rolesDigest().keySet(),
+            equalTo(ReservedRolesStore.roleDescriptors().stream().map(RoleDescriptor::getName).collect(Collectors.toSet()))
+        );
+    }
+
+}

From cf1f2cbc34e97b8d280ee74e824ac1106c24cef0 Mon Sep 17 00:00:00 2001
From: Kathleen DeRusso <kathleen.derusso@elastic.co>
Date: Mon, 16 Dec 2024 14:08:11 -0500
Subject: [PATCH 016/119] Unmute ml/sparse_vector_search/Test sparse_vector
 search with query vector and pruning config (#118788)

* Unmute ml/sparse_vector_search/Test sparse_vector search with query vector and pruning config

* Revert "Unmute ml/sparse_vector_search/Test sparse_vector search with query vector and pruning config"

This reverts commit 48e76936e622072da7c214842613d22b9830dc45.

* Unmute test, this time without formatting the entire file
---
 muted-tests.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 2689f02cc92cd..be3805d887bbe 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -40,9 +40,6 @@ tests:
 - class: org.elasticsearch.packaging.test.WindowsServiceTests
   method: test33JavaChanged
   issue: https://github.com/elastic/elasticsearch/issues/113177
-- class: org.elasticsearch.smoketest.MlWithSecurityIT
-  method: test {yaml=ml/sparse_vector_search/Test sparse_vector search with query vector and pruning config}
-  issue: https://github.com/elastic/elasticsearch/issues/108997
 - class: org.elasticsearch.packaging.test.WindowsServiceTests
   method: test80JavaOptsInEnvVar
   issue: https://github.com/elastic/elasticsearch/issues/113219

From 8e988689438f9579dc23427efc85d320e8289ce3 Mon Sep 17 00:00:00 2001
From: Craig Taverner <craig@amanzi.com>
Date: Mon, 16 Dec 2024 21:26:45 +0100
Subject: [PATCH 017/119] Support multi-index LOOKUP JOIN and various bug fixes
 (#118429)

While working on supporting multi-index LOOKUP JOIN; various bugs were
fixed:

* Previously we just used '*' for lookup-join indices, because the fieldnames were sometimes not being correctly determined. The problem was with KEEP referencing fields from the right that had previously been defined on the left as aliases, including using the ROW command. We normally don't want to ask for aliases, but if they could be shadowed by a lookup join, we need to keep them.
* With both single and multi-index LOOKUP JOIN we need to mark each index as potentially wildcard fields, if the KEEP commands occur before the LOOKUP JOIN.
---
 .../esql/qa/mixed/MixedClusterEsqlSpecIT.java |   4 +-
 .../xpack/esql/ccq/MultiClusterSpecIT.java    |   8 +-
 .../rest/RequestIndexFilteringTestCase.java   |  11 +
 .../src/main/resources/lookup-join.csv-spec   | 566 +++++++++++++++---
 .../src/main/resources/message_types.csv      |   2 +
 .../xpack/esql/action/EsqlCapabilities.java   |   2 +-
 .../xpack/esql/analysis/Analyzer.java         |  12 +-
 .../xpack/esql/analysis/AnalyzerContext.java  |  12 +-
 .../xpack/esql/session/EsqlSession.java       | 269 ++++-----
 .../elasticsearch/xpack/esql/CsvTests.java    |   2 +-
 .../esql/analysis/AnalyzerTestUtils.java      |   4 +-
 .../xpack/esql/analysis/AnalyzerTests.java    |   6 +-
 .../xpack/esql/analysis/VerifierTests.java    |   2 +-
 .../optimizer/LogicalPlanOptimizerTests.java  |  37 +-
 .../optimizer/PhysicalPlanOptimizerTests.java |   4 +-
 .../session/IndexResolverFieldNamesTests.java | 226 ++++++-
 16 files changed, 902 insertions(+), 265 deletions(-)

diff --git a/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java b/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
index 1120a69cc5166..5efe7ffc800a2 100644
--- a/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
+++ b/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
@@ -21,7 +21,7 @@
 import java.util.List;
 
 import static org.elasticsearch.xpack.esql.CsvTestUtils.isEnabled;
-import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V5;
+import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V6;
 import static org.elasticsearch.xpack.esql.qa.rest.EsqlSpecTestCase.Mode.ASYNC;
 
 public class MixedClusterEsqlSpecIT extends EsqlSpecTestCase {
@@ -96,7 +96,7 @@ protected boolean supportsInferenceTestService() {
 
     @Override
     protected boolean supportsIndexModeLookup() throws IOException {
-        return hasCapabilities(List.of(JOIN_LOOKUP_V5.capabilityName()));
+        return hasCapabilities(List.of(JOIN_LOOKUP_V6.capabilityName()));
     }
 
     @Override
diff --git a/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java b/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
index 5c7f981c93a97..dd75776973c3d 100644
--- a/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
+++ b/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
@@ -48,7 +48,7 @@
 import static org.elasticsearch.xpack.esql.EsqlTestUtils.classpathResources;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.INLINESTATS;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.INLINESTATS_V2;
-import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V5;
+import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V6;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_PLANNING_V1;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.METADATA_FIELDS_REMOTE_TEST;
 import static org.elasticsearch.xpack.esql.qa.rest.EsqlSpecTestCase.Mode.SYNC;
@@ -124,7 +124,7 @@ protected void shouldSkipTest(String testName) throws IOException {
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(INLINESTATS.capabilityName()));
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(INLINESTATS_V2.capabilityName()));
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_PLANNING_V1.capabilityName()));
-        assumeFalse("LOOKUP JOIN not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_LOOKUP_V5.capabilityName()));
+        assumeFalse("LOOKUP JOIN not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_LOOKUP_V6.capabilityName()));
     }
 
     private TestFeatureService remoteFeaturesService() throws IOException {
@@ -283,8 +283,8 @@ protected boolean supportsInferenceTestService() {
 
     @Override
     protected boolean supportsIndexModeLookup() throws IOException {
-        // CCS does not yet support JOIN_LOOKUP_V5 and clusters falsely report they have this capability
-        // return hasCapabilities(List.of(JOIN_LOOKUP_V5.capabilityName()));
+        // CCS does not yet support JOIN_LOOKUP_V6 and clusters falsely report they have this capability
+        // return hasCapabilities(List.of(JOIN_LOOKUP_V6.capabilityName()));
         return false;
     }
 }
diff --git a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
index 406997b66dbf0..2aae4c94c33fe 100644
--- a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
+++ b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.test.rest.ESRestTestCase;
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.esql.AssertWarnings;
+import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
 import org.junit.After;
 import org.junit.Assert;
 
@@ -219,6 +220,16 @@ public void testIndicesDontExist() throws IOException {
         assertEquals(404, e.getResponse().getStatusLine().getStatusCode());
         assertThat(e.getMessage(), containsString("index_not_found_exception"));
         assertThat(e.getMessage(), containsString("no such index [foo]"));
+
+        if (EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled()) {
+            e = expectThrows(
+                ResponseException.class,
+                () -> runEsql(timestampFilter("gte", "2020-01-01").query("FROM test1 | LOOKUP JOIN foo ON id1"))
+            );
+            assertEquals(400, e.getResponse().getStatusLine().getStatusCode());
+            assertThat(e.getMessage(), containsString("verification_exception"));
+            assertThat(e.getMessage(), containsString("Unknown index [foo]"));
+        }
     }
 
     private static RestEsqlTestCase.RequestObjectBuilder timestampFilter(String op, String date) throws IOException {
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index 7fed4f377096f..8b8d24b1bb156 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -3,8 +3,12 @@
 // Reuses the sample dataset and commands from enrich.csv-spec
 //
 
+###############################################
+# Tests with languages_lookup index
+###############################################
+
 basicOnTheDataNode
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | EVAL language_code = languages
@@ -21,7 +25,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 basicRow
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW language_code = 1
 | LOOKUP JOIN languages_lookup ON language_code
@@ -32,7 +36,7 @@ language_code:integer  | language_name:keyword
 ;
 
 basicOnTheCoordinator
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | SORT emp_no
@@ -49,7 +53,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 subsequentEvalOnTheDataNode
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | EVAL language_code = languages
@@ -67,7 +71,7 @@ emp_no:integer | language_code:integer | language_name:keyword | language_code_x
 ;
 
 subsequentEvalOnTheCoordinator
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | SORT emp_no
@@ -85,7 +89,7 @@ emp_no:integer | language_code:integer | language_name:keyword | language_code_x
 ;
 
 sortEvalBeforeLookup
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | SORT emp_no
@@ -102,7 +106,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 nonUniqueLeftKeyOnTheDataNode
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | WHERE emp_no <= 10030
@@ -126,7 +130,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 nonUniqueRightKeyOnTheDataNode
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | EVAL language_code = emp_no % 10
@@ -146,7 +150,7 @@ emp_no:integer | language_code:integer | language_name:keyword       | country:k
 ;
 
 nonUniqueRightKeyOnTheCoordinator
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | SORT emp_no
@@ -166,7 +170,7 @@ emp_no:integer | language_code:integer | language_name:keyword       | country:k
 ;
 
 nonUniqueRightKeyFromRow
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW language_code = 2
 | LOOKUP JOIN languages_lookup_non_unique_key ON language_code
@@ -178,8 +182,73 @@ language_code:integer | language_name:keyword       | country:keyword
 2                     | [German, German, German]    | [Austria, Germany, Switzerland]
 ;
 
+###############################################
+# Filtering tests with languages_lookup index
+###############################################
+
+lookupWithFilterOnLeftSideField
+required_capability: join_lookup_v6
+
+FROM employees
+| EVAL language_code = languages
+| LOOKUP JOIN languages_lookup ON language_code
+| SORT emp_no
+| KEEP emp_no, language_code, language_name
+| WHERE emp_no >= 10091 AND emp_no < 10094
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10091          | 3                     | Spanish
+10092          | 1                     | English
+10093          | 3                     | Spanish
+;
+
+lookupMessageWithFilterOnRightSideField-Ignore
+required_capability: join_lookup_v6
+
+FROM sample_data
+| LOOKUP JOIN message_types_lookup ON message
+| WHERE type == "Error"
+| KEEP @timestamp, client_ip, event_duration, message, type
+| SORT @timestamp DESC
+;
+
+@timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
+2023-10-23T13:53:55.832Z | 172.21.3.15  | 5033755             | Connection error      | Error
+2023-10-23T13:52:55.015Z | 172.21.3.15  | 8268153             | Connection error      | Error
+2023-10-23T13:51:54.732Z | 172.21.3.15  | 725448              | Connection error      | Error
+;
+
+lookupWithFieldAndRightSideAfterStats
+required_capability: join_lookup_v6
+
+FROM sample_data
+| LOOKUP JOIN message_types_lookup ON message
+| STATS count = count(message) BY type
+| WHERE type == "Error"
+;
+
+count:long | type:keyword
+3          | Error
+;
+
+lookupWithFieldOnJoinKey-Ignore
+required_capability: join_lookup_v6
+
+FROM employees
+| EVAL language_code = languages
+| LOOKUP JOIN languages_lookup ON language_code
+| WHERE language_code > 1 AND language_name IS NOT NULL
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10001          | 2                     | French
+10003          | 4                     | German
+;
+
 nullJoinKeyOnTheDataNode
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | WHERE emp_no < 10004
@@ -197,7 +266,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 
 
 mvJoinKeyOnTheDataNode
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM employees
 | WHERE 10003 < emp_no AND emp_no < 10008
@@ -215,7 +284,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 mvJoinKeyFromRow
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW language_code = [4, 5, 6, 7]
 | LOOKUP JOIN languages_lookup_non_unique_key ON language_code
@@ -228,7 +297,7 @@ language_code:integer | language_name:keyword       | country:keyword
 ;
 
 mvJoinKeyFromRowExpanded
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW language_code = [4, 5, 6, 7, 8]
 | MV_EXPAND language_code
@@ -245,10 +314,26 @@ language_code:integer | language_name:keyword       | country:keyword
 8                     | Mv-Lang2                    | Mv-Land2
 ;
 
+###############################################
+# Tests with clientips_lookup index
+###############################################
+
 lookupIPFromRow
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", right = "right"
+| LOOKUP JOIN clientips_lookup ON client_ip
+;
+
+left:keyword | client_ip:keyword | right:keyword | env:keyword
+left         | 172.21.0.5        | right         | Development
+;
+
+lookupIPFromKeepRow
+required_capability: join_lookup_v6
 
 ROW left = "left", client_ip = "172.21.0.5", right = "right"
+| KEEP left, client_ip, right
 | LOOKUP JOIN clientips_lookup ON client_ip
 ;
 
@@ -257,7 +342,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowing
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -268,7 +353,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowingKeep
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -281,7 +366,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowingKeepReordered
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -294,7 +379,7 @@ right         | Development | 172.21.0.5
 ;
 
 lookupIPFromIndex
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -313,7 +398,7 @@ ignoreOrder:true
 ;
 
 lookupIPFromIndexKeep
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -332,8 +417,30 @@ ignoreOrder:true
 2023-10-23T12:15:03.360Z | 172.21.2.162      | 3450233             | Connected to 10.1.0.3 | QA
 ;
 
+lookupIPFromIndexKeepKeep
+required_capability: join_lookup_v6
+
+FROM sample_data
+| KEEP client_ip, event_duration, @timestamp, message
+| RENAME @timestamp AS timestamp, message AS msg
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| KEEP timestamp, client_ip, event_duration, msg, env
+;
+ignoreOrder:true
+
+timestamp:date           | client_ip:keyword | event_duration:long | msg:keyword           | env:keyword
+2023-10-23T13:55:01.543Z | 172.21.3.15       | 1756467             | Connected to 10.1.0.1 | Production
+2023-10-23T13:53:55.832Z | 172.21.3.15       | 5033755             | Connection error      | Production
+2023-10-23T13:52:55.015Z | 172.21.3.15       | 8268153             | Connection error      | Production
+2023-10-23T13:51:54.732Z | 172.21.3.15       | 725448              | Connection error      | Production
+2023-10-23T13:33:34.937Z | 172.21.0.5        | 1232382             | Disconnected          | Development
+2023-10-23T12:27:28.948Z | 172.21.2.113      | 2764889             | Connected to 10.1.0.2 | QA
+2023-10-23T12:15:03.360Z | 172.21.2.162      | 3450233             | Connected to 10.1.0.3 | QA
+;
+
 lookupIPFromIndexStats
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -349,7 +456,7 @@ count:long | env:keyword
 ;
 
 lookupIPFromIndexStatsKeep
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -365,10 +472,43 @@ count:long | env:keyword
 1          | Development
 ;
 
+statsAndLookupIPFromIndex
+required_capability: join_lookup_v6
+
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| STATS count = count(client_ip) BY client_ip
+| LOOKUP JOIN clientips_lookup ON client_ip
+| SORT count DESC, client_ip ASC, env ASC
+;
+
+count:long | client_ip:keyword | env:keyword
+4          | 172.21.3.15       | Production
+1          | 172.21.0.5        | Development
+1          | 172.21.2.113      | QA
+1          | 172.21.2.162      | QA
+;
+
+###############################################
+# Tests with message_types_lookup index
+###############################################
+
 lookupMessageFromRow
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
+
+ROW left = "left", message = "Connected to 10.1.0.1", right = "right"
+| LOOKUP JOIN message_types_lookup ON message
+;
+
+left:keyword | message:keyword       | right:keyword | type:keyword
+left         | Connected to 10.1.0.1 | right         | Success
+;
+
+lookupMessageFromKeepRow
+required_capability: join_lookup_v6
 
 ROW left = "left", message = "Connected to 10.1.0.1", right = "right"
+| KEEP left, message, right
 | LOOKUP JOIN message_types_lookup ON message
 ;
 
@@ -377,7 +517,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromRowWithShadowing
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW left = "left", message = "Connected to 10.1.0.1", type = "unknown", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -388,7 +528,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromRowWithShadowingKeep
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 ROW left = "left", message = "Connected to 10.1.0.1", type = "unknown", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -400,7 +540,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromIndex
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -418,7 +558,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeep
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -436,8 +576,28 @@ ignoreOrder:true
 2023-10-23T12:15:03.360Z | 172.21.2.162 | 3450233             | Connected to 10.1.0.3 | Success
 ;
 
+lookupMessageFromIndexKeepKeep
+required_capability: join_lookup_v6
+
+FROM sample_data
+| KEEP client_ip, event_duration, @timestamp, message
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP @timestamp, client_ip, event_duration, message, type
+;
+ignoreOrder:true
+
+@timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
+2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success
+2023-10-23T13:53:55.832Z | 172.21.3.15  | 5033755             | Connection error      | Error
+2023-10-23T13:52:55.015Z | 172.21.3.15  | 8268153             | Connection error      | Error
+2023-10-23T13:51:54.732Z | 172.21.3.15  | 725448              | Connection error      | Error
+2023-10-23T13:33:34.937Z | 172.21.0.5   | 1232382             | Disconnected          | Disconnected
+2023-10-23T12:27:28.948Z | 172.21.2.113 | 2764889             | Connected to 10.1.0.2 | Success
+2023-10-23T12:15:03.360Z | 172.21.2.162 | 3450233             | Connected to 10.1.0.3 | Success
+;
+
 lookupMessageFromIndexKeepReordered
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -456,7 +616,7 @@ Success      | 172.21.2.162 | 3450233             | Connected to 10.1.0.3
 ;
 
 lookupMessageFromIndexStats
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -471,7 +631,7 @@ count:long | type:keyword
 ;
 
 lookupMessageFromIndexStatsKeep
-required_capability: join_lookup_v5
+required_capability: join_lookup_v6
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -486,67 +646,333 @@ count:long | type:keyword
 1          | Disconnected
 ;
 
-// 
-// Filtering tests
-// 
+statsAndLookupMessageFromIndex
+required_capability: join_lookup_v6
 
-lookupWithFilterOnLeftSideField
-required_capability: join_lookup_v5
+FROM sample_data
+| STATS count = count(message) BY message
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP count, type, message
+| SORT count DESC, message ASC
+;
 
-FROM employees
-| EVAL language_code = languages
-| LOOKUP JOIN languages_lookup ON language_code
-| SORT emp_no
-| KEEP emp_no, language_code, language_name
-| WHERE emp_no >= 10091 AND emp_no < 10094
+count:long | type:keyword | message:keyword
+3          | Error        | Connection error
+1          | Success      | Connected to 10.1.0.1
+1          | Success      | Connected to 10.1.0.2
+1          | Success      | Connected to 10.1.0.3
+1          | Disconnected | Disconnected
 ;
 
-emp_no:integer | language_code:integer | language_name:keyword
-10091          | 3                     | Spanish
-10092          | 1                     | English
-10093          | 3                     | Spanish
+lookupMessageFromIndexTwice
+required_capability: join_lookup_v6
+
+FROM sample_data
+| LOOKUP JOIN message_types_lookup ON message
+| RENAME message AS message1, type AS type1
+| EVAL message = client_ip::keyword
+| LOOKUP JOIN message_types_lookup ON message
+| RENAME message AS message2, type AS type2
 ;
+ignoreOrder:true
 
-lookupMessageWithFilterOnRightSideField-Ignore
-required_capability: join_lookup_v5
+@timestamp:date          | client_ip:ip | event_duration:long | message1:keyword      | type1:keyword | message2:keyword | type2:keyword 
+2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success       | 172.21.3.15      | null
+2023-10-23T13:53:55.832Z | 172.21.3.15  | 5033755             | Connection error      | Error         | 172.21.3.15      | null
+2023-10-23T13:52:55.015Z | 172.21.3.15  | 8268153             | Connection error      | Error         | 172.21.3.15      | null
+2023-10-23T13:51:54.732Z | 172.21.3.15  | 725448              | Connection error      | Error         | 172.21.3.15      | null
+2023-10-23T13:33:34.937Z | 172.21.0.5   | 1232382             | Disconnected          | Disconnected  | 172.21.0.5       | null
+2023-10-23T12:27:28.948Z | 172.21.2.113 | 2764889             | Connected to 10.1.0.2 | Success       | 172.21.2.113     | null
+2023-10-23T12:15:03.360Z | 172.21.2.162 | 3450233             | Connected to 10.1.0.3 | Success       | 172.21.2.162     | null
+;
+
+lookupMessageFromIndexTwiceKeep
+required_capability: join_lookup_v6
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
-| WHERE type == "Error"
-| KEEP @timestamp, client_ip, event_duration, message, type
-| SORT @timestamp DESC
+| RENAME message AS message1, type AS type1
+| EVAL message = client_ip::keyword
+| LOOKUP JOIN message_types_lookup ON message
+| RENAME message AS message2, type AS type2
+| KEEP @timestamp, client_ip, event_duration, message1, type1, message2, type2
 ;
+ignoreOrder:true
 
-@timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
-2023-10-23T13:53:55.832Z | 172.21.3.15  | 5033755             | Connection error      | Error
-2023-10-23T13:52:55.015Z | 172.21.3.15  | 8268153             | Connection error      | Error
-2023-10-23T13:51:54.732Z | 172.21.3.15  | 725448              | Connection error      | Error
+@timestamp:date          | client_ip:ip | event_duration:long | message1:keyword      | type1:keyword | message2:keyword | type2:keyword 
+2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success       | 172.21.3.15      | null
+2023-10-23T13:53:55.832Z | 172.21.3.15  | 5033755             | Connection error      | Error         | 172.21.3.15      | null
+2023-10-23T13:52:55.015Z | 172.21.3.15  | 8268153             | Connection error      | Error         | 172.21.3.15      | null
+2023-10-23T13:51:54.732Z | 172.21.3.15  | 725448              | Connection error      | Error         | 172.21.3.15      | null
+2023-10-23T13:33:34.937Z | 172.21.0.5   | 1232382             | Disconnected          | Disconnected  | 172.21.0.5       | null
+2023-10-23T12:27:28.948Z | 172.21.2.113 | 2764889             | Connected to 10.1.0.2 | Success       | 172.21.2.113     | null
+2023-10-23T12:15:03.360Z | 172.21.2.162 | 3450233             | Connected to 10.1.0.3 | Success       | 172.21.2.162     | null
 ;
 
-lookupWithFieldAndRightSideAfterStats
-required_capability: join_lookup_v5
+###############################################
+# Tests with clientips_lookup and message_types_lookup indexes
+###############################################
+
+lookupIPAndMessageFromRow
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowKeepBefore
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
+| KEEP left, client_ip, message, right
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowKeepBetween
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
+| LOOKUP JOIN clientips_lookup ON client_ip
+| KEEP left, client_ip, message, right, env
+| LOOKUP JOIN message_types_lookup ON message
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowKeepAfter
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP left, client_ip, message, right, env, type
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowWithShadowing
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", type = "type", right = "right"
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowWithShadowingKeep
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP left, client_ip, message, right, env, type
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowWithShadowingKeepKeep
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| KEEP left, client_ip, message, right, env
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP left, client_ip, message, right, env, type
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowWithShadowingKeepKeepKeep
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
+| EVAL client_ip = client_ip::keyword
+| KEEP left, client_ip, message, right, env
+| LOOKUP JOIN clientips_lookup ON client_ip
+| KEEP left, client_ip, message, right, env
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP left, client_ip, message, right, env, type
+;
+
+left:keyword | client_ip:keyword | message:keyword       | right:keyword | env:keyword | type:keyword
+left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Development | Success
+;
+
+lookupIPAndMessageFromRowWithShadowingKeepReordered
+required_capability: join_lookup_v6
+
+ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP right, env, type, client_ip
+;
+
+right:keyword | env:keyword  | type:keyword | client_ip:keyword
+right         | Development  | Success      | 172.21.0.5
+;
+
+lookupIPAndMessageFromIndex
+required_capability: join_lookup_v6
 
 FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
 | LOOKUP JOIN message_types_lookup ON message
-| STATS count = count(message) BY type
-| WHERE type == "Error"
 ;
+ignoreOrder:true
 
-count:long | type:keyword
-3          | Error
+@timestamp:date          | event_duration:long | message:keyword       | client_ip:keyword | env:keyword | type:keyword
+2023-10-23T13:55:01.543Z | 1756467             | Connected to 10.1.0.1 | 172.21.3.15       | Production  | Success
+2023-10-23T13:53:55.832Z | 5033755             | Connection error      | 172.21.3.15       | Production  | Error
+2023-10-23T13:52:55.015Z | 8268153             | Connection error      | 172.21.3.15       | Production  | Error
+2023-10-23T13:51:54.732Z | 725448              | Connection error      | 172.21.3.15       | Production  | Error
+2023-10-23T13:33:34.937Z | 1232382             | Disconnected          | 172.21.0.5        | Development | Disconnected
+2023-10-23T12:27:28.948Z | 2764889             | Connected to 10.1.0.2 | 172.21.2.113      | QA          | Success
+2023-10-23T12:15:03.360Z | 3450233             | Connected to 10.1.0.3 | 172.21.2.162      | QA          | Success
 ;
 
-lookupWithFieldOnJoinKey-Ignore
-required_capability: join_lookup_v5
+lookupIPAndMessageFromIndexKeep
+required_capability: join_lookup_v6
 
-FROM employees
-| EVAL language_code = languages
-| LOOKUP JOIN languages_lookup ON language_code
-| WHERE language_code > 1 AND language_name IS NOT NULL
-| KEEP emp_no, language_code, language_name
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP @timestamp, client_ip, event_duration, message, env, type
 ;
+ignoreOrder:true
 
-emp_no:integer | language_code:integer | language_name:keyword
-10001          | 2                     | French
-10003          | 4                     | German
+@timestamp:date          | client_ip:keyword | event_duration:long | message:keyword       | env:keyword | type:keyword
+2023-10-23T13:55:01.543Z | 172.21.3.15       | 1756467             | Connected to 10.1.0.1 | Production  | Success
+2023-10-23T13:53:55.832Z | 172.21.3.15       | 5033755             | Connection error      | Production  | Error
+2023-10-23T13:52:55.015Z | 172.21.3.15       | 8268153             | Connection error      | Production  | Error
+2023-10-23T13:51:54.732Z | 172.21.3.15       | 725448              | Connection error      | Production  | Error
+2023-10-23T13:33:34.937Z | 172.21.0.5        | 1232382             | Disconnected          | Development | Disconnected
+2023-10-23T12:27:28.948Z | 172.21.2.113      | 2764889             | Connected to 10.1.0.2 | QA          | Success
+2023-10-23T12:15:03.360Z | 172.21.2.162      | 3450233             | Connected to 10.1.0.3 | QA          | Success
+;
+
+lookupIPAndMessageFromIndexStats
+required_capability: join_lookup_v6
+
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| STATS count = count(*) BY env, type
+| SORT count DESC, env ASC, type ASC
+;
+
+count:long | env:keyword | type:keyword
+3          | Production  | Error
+2          | QA          | Success
+1          | Development | Disconnected
+1          | Production  | Success
+;
+
+lookupIPAndMessageFromIndexStatsKeep
+required_capability: join_lookup_v6
+
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP client_ip, env, type
+| STATS count = count(*) BY env, type
+| SORT count DESC, env ASC, type ASC
+;
+
+count:long | env:keyword | type:keyword
+3          | Production  | Error
+2          | QA          | Success
+1          | Development | Disconnected
+1          | Production  | Success
+;
+
+statsAndLookupIPAndMessageFromIndex
+required_capability: join_lookup_v6
+
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| STATS count = count(*) BY client_ip, message
+| LOOKUP JOIN clientips_lookup ON client_ip
+| LOOKUP JOIN message_types_lookup ON message
+| SORT count DESC, client_ip ASC, message ASC
+;
+
+count:long | client_ip:keyword | message:keyword       | env:keyword | type:keyword
+3          | 172.21.3.15       | Connection error      | Production  | Error
+1          | 172.21.0.5        | Disconnected          | Development | Disconnected
+1          | 172.21.2.113      | Connected to 10.1.0.2 | QA          | Success
+1          | 172.21.2.162      | Connected to 10.1.0.3 | QA          | Success
+1          | 172.21.3.15       | Connected to 10.1.0.1 | Production  | Success
+;
+
+lookupIPAndMessageFromIndexChainedEvalKeep
+required_capability: join_lookup_v6
+
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| EVAL message = CONCAT(env, " environment")
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP @timestamp, client_ip, event_duration, message, type
+;
+ignoreOrder:true
+
+@timestamp:date          | client_ip:keyword | event_duration:long | message:keyword         | type:keyword
+2023-10-23T13:55:01.543Z | 172.21.3.15       | 1756467             | Production environment  | Production
+2023-10-23T13:53:55.832Z | 172.21.3.15       | 5033755             | Production environment  | Production
+2023-10-23T13:52:55.015Z | 172.21.3.15       | 8268153             | Production environment  | Production
+2023-10-23T13:51:54.732Z | 172.21.3.15       | 725448              | Production environment  | Production
+2023-10-23T13:33:34.937Z | 172.21.0.5        | 1232382             | Development environment | Development
+2023-10-23T12:27:28.948Z | 172.21.2.113      | 2764889             | QA environment          | null
+2023-10-23T12:15:03.360Z | 172.21.2.162      | 3450233             | QA environment          | null
+;
+
+lookupIPAndMessageFromIndexChainedRenameKeep
+required_capability: join_lookup_v6
+
+FROM sample_data
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| RENAME env AS message
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP @timestamp, client_ip, event_duration, message, type
 ;
+ignoreOrder:true
+
+@timestamp:date          | client_ip:keyword | event_duration:long | message:keyword | type:keyword
+2023-10-23T13:55:01.543Z | 172.21.3.15       | 1756467             | Production      | null
+2023-10-23T13:53:55.832Z | 172.21.3.15       | 5033755             | Production      | null
+2023-10-23T13:52:55.015Z | 172.21.3.15       | 8268153             | Production      | null
+2023-10-23T13:51:54.732Z | 172.21.3.15       | 725448              | Production      | null
+2023-10-23T13:33:34.937Z | 172.21.0.5        | 1232382             | Development     | null
+2023-10-23T12:27:28.948Z | 172.21.2.113      | 2764889             | QA              | null
+2023-10-23T12:15:03.360Z | 172.21.2.162      | 3450233             | QA              | null
+;
+
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/message_types.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/message_types.csv
index 8e00485771445..bb4b58046b843 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/message_types.csv
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/message_types.csv
@@ -4,3 +4,5 @@ Disconnected,Disconnected
 Connected to 10.1.0.1,Success
 Connected to 10.1.0.2,Success
 Connected to 10.1.0.3,Success
+Production environment,Production
+Development environment,Development
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index e9a0f89e4f448..235d0dcbe4164 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -547,7 +547,7 @@ public enum Cap {
         /**
          * LOOKUP JOIN
          */
-        JOIN_LOOKUP_V5(Build.current().isSnapshot()),
+        JOIN_LOOKUP_V6(Build.current().isSnapshot()),
 
         /**
          * Fix for https://github.com/elastic/elasticsearch/issues/117054
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
index cf91c7df9a034..d59745f03f608 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
@@ -198,12 +198,16 @@ private static class ResolveTable extends ParameterizedAnalyzerRule<UnresolvedRe
 
         @Override
         protected LogicalPlan rule(UnresolvedRelation plan, AnalyzerContext context) {
-            return resolveIndex(plan, plan.indexMode().equals(IndexMode.LOOKUP) ? context.lookupResolution() : context.indexResolution());
+            return resolveIndex(
+                plan,
+                plan.indexMode().equals(IndexMode.LOOKUP) ? context.lookupResolution().get(plan.table().index()) : context.indexResolution()
+            );
         }
 
         private LogicalPlan resolveIndex(UnresolvedRelation plan, IndexResolution indexResolution) {
-            if (indexResolution.isValid() == false) {
-                return plan.unresolvedMessage().equals(indexResolution.toString())
+            if (indexResolution == null || indexResolution.isValid() == false) {
+                String indexResolutionMessage = indexResolution == null ? "[none specified]" : indexResolution.toString();
+                return plan.unresolvedMessage().equals(indexResolutionMessage)
                     ? plan
                     : new UnresolvedRelation(
                         plan.source(),
@@ -211,7 +215,7 @@ private LogicalPlan resolveIndex(UnresolvedRelation plan, IndexResolution indexR
                         plan.frozen(),
                         plan.metadataFields(),
                         plan.indexMode(),
-                        indexResolution.toString(),
+                        indexResolutionMessage,
                         plan.commandName()
                     );
             }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java
index ea6e5ed425711..2aad172bd9946 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java
@@ -11,11 +11,13 @@
 import org.elasticsearch.xpack.esql.index.IndexResolution;
 import org.elasticsearch.xpack.esql.session.Configuration;
 
+import java.util.Map;
+
 public record AnalyzerContext(
     Configuration configuration,
     EsqlFunctionRegistry functionRegistry,
     IndexResolution indexResolution,
-    IndexResolution lookupResolution,
+    Map<String, IndexResolution> lookupResolution,
     EnrichResolution enrichResolution
 ) {
     // Currently for tests only, since most do not test lookups
@@ -26,12 +28,6 @@ public AnalyzerContext(
         IndexResolution indexResolution,
         EnrichResolution enrichResolution
     ) {
-        this(
-            configuration,
-            functionRegistry,
-            indexResolution,
-            IndexResolution.invalid("AnalyzerContext constructed without any lookup join resolution"),
-            enrichResolution
-        );
+        this(configuration, functionRegistry, indexResolution, Map.of(), enrichResolution);
     }
 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
index 83480f6651abf..c0290fa2b1d73 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.action.support.SubscribableListener;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.TriFunction;
 import org.elasticsearch.common.collect.Iterators;
 import org.elasticsearch.common.regex.Regex;
 import org.elasticsearch.compute.data.Block;
@@ -77,10 +76,12 @@
 
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.HashMap;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.function.Function;
 import java.util.stream.Collectors;
 
 import static org.elasticsearch.index.query.QueryBuilders.boolQuery;
@@ -282,10 +283,10 @@ public void analyzedPlan(
             return;
         }
 
-        TriFunction<IndexResolution, IndexResolution, EnrichResolution, LogicalPlan> analyzeAction = (indices, lookupIndices, policies) -> {
+        Function<PreAnalysisResult, LogicalPlan> analyzeAction = (l) -> {
             planningMetrics.gatherPreAnalysisMetrics(parsed);
             Analyzer analyzer = new Analyzer(
-                new AnalyzerContext(configuration, functionRegistry, indices, lookupIndices, policies),
+                new AnalyzerContext(configuration, functionRegistry, l.indices, l.lookupIndices, l.enrichResolution),
                 verifier
             );
             LogicalPlan plan = analyzer.analyze(parsed);
@@ -301,110 +302,77 @@ public void analyzedPlan(
 
         EsqlSessionCCSUtils.checkForCcsLicense(indices, indicesExpressionGrouper, verifier.licenseState());
 
-        // TODO: make a separate call for lookup indices
         final Set<String> targetClusters = enrichPolicyResolver.groupIndicesPerCluster(
             indices.stream().flatMap(t -> Arrays.stream(Strings.commaDelimitedListToStringArray(t.id().index()))).toArray(String[]::new)
         ).keySet();
 
-        SubscribableListener.<EnrichResolution>newForked(l -> enrichPolicyResolver.resolvePolicies(targetClusters, unresolvedPolicies, l))
-            .<ListenerResult>andThen((l, enrichResolution) -> {
-                // we need the match_fields names from enrich policies and THEN, with an updated list of fields, we call field_caps API
-                var enrichMatchFields = enrichResolution.resolvedEnrichPolicies()
-                    .stream()
-                    .map(ResolvedEnrichPolicy::matchField)
-                    .collect(Collectors.toSet());
-                // get the field names from the parsed plan combined with the ENRICH match fields from the ENRICH policy
-                var fieldNames = fieldNames(parsed, enrichMatchFields);
-                ListenerResult listenerResult = new ListenerResult(null, null, enrichResolution, fieldNames);
-
-                // first resolve the lookup indices, then the main indices
-                preAnalyzeLookupIndices(preAnalysis.lookupIndices, listenerResult, l);
-            })
-            .<ListenerResult>andThen((l, listenerResult) -> {
-                // resolve the main indices
-                preAnalyzeIndices(preAnalysis.indices, executionInfo, listenerResult, requestFilter, l);
-            })
-            .<ListenerResult>andThen((l, listenerResult) -> {
-                // TODO in follow-PR (for skip_unavailable handling of missing concrete indexes) add some tests for
-                // invalid index resolution to updateExecutionInfo
-                if (listenerResult.indices.isValid()) {
-                    // CCS indices and skip_unavailable cluster values can stop the analysis right here
-                    if (analyzeCCSIndices(executionInfo, targetClusters, unresolvedPolicies, listenerResult, logicalPlanListener, l))
-                        return;
-                }
-                // whatever tuple we have here (from CCS-special handling or from the original pre-analysis), pass it on to the next step
-                l.onResponse(listenerResult);
-            })
-            .<ListenerResult>andThen((l, listenerResult) -> {
-                // first attempt (maybe the only one) at analyzing the plan
-                analyzeAndMaybeRetry(analyzeAction, requestFilter, listenerResult, logicalPlanListener, l);
-            })
-            .<ListenerResult>andThen((l, listenerResult) -> {
-                assert requestFilter != null : "The second pre-analysis shouldn't take place when there is no index filter in the request";
-
-                // "reset" execution information for all ccs or non-ccs (local) clusters, since we are performing the indices
-                // resolving one more time (the first attempt failed and the query had a filter)
-                for (String clusterAlias : executionInfo.clusterAliases()) {
-                    executionInfo.swapCluster(clusterAlias, (k, v) -> null);
-                }
-
-                // here the requestFilter is set to null, performing the pre-analysis after the first step failed
-                preAnalyzeIndices(preAnalysis.indices, executionInfo, listenerResult, null, l);
-            })
-            .<LogicalPlan>andThen((l, listenerResult) -> {
-                assert requestFilter != null : "The second analysis shouldn't take place when there is no index filter in the request";
-                LOGGER.debug("Analyzing the plan (second attempt, without filter)");
-                LogicalPlan plan;
-                try {
-                    plan = analyzeAction.apply(listenerResult.indices, listenerResult.lookupIndices, listenerResult.enrichResolution);
-                } catch (Exception e) {
-                    l.onFailure(e);
-                    return;
-                }
-                LOGGER.debug("Analyzed plan (second attempt, without filter):\n{}", plan);
-                l.onResponse(plan);
-            })
-            .addListener(logicalPlanListener);
-    }
+        var listener = SubscribableListener.<EnrichResolution>newForked(
+            l -> enrichPolicyResolver.resolvePolicies(targetClusters, unresolvedPolicies, l)
+        ).<PreAnalysisResult>andThen((l, enrichResolution) -> resolveFieldNames(parsed, enrichResolution, l));
+        // first resolve the lookup indices, then the main indices
+        for (TableInfo lookupIndex : preAnalysis.lookupIndices) {
+            listener = listener.andThen((l, preAnalysisResult) -> { preAnalyzeLookupIndex(lookupIndex, preAnalysisResult, l); });
+        }
+        listener.<PreAnalysisResult>andThen((l, result) -> {
+            // resolve the main indices
+            preAnalyzeIndices(preAnalysis.indices, executionInfo, result, requestFilter, l);
+        }).<PreAnalysisResult>andThen((l, result) -> {
+            // TODO in follow-PR (for skip_unavailable handling of missing concrete indexes) add some tests for
+            // invalid index resolution to updateExecutionInfo
+            if (result.indices.isValid()) {
+                // CCS indices and skip_unavailable cluster values can stop the analysis right here
+                if (analyzeCCSIndices(executionInfo, targetClusters, unresolvedPolicies, result, logicalPlanListener, l)) return;
+            }
+            // whatever tuple we have here (from CCS-special handling or from the original pre-analysis), pass it on to the next step
+            l.onResponse(result);
+        }).<PreAnalysisResult>andThen((l, result) -> {
+            // first attempt (maybe the only one) at analyzing the plan
+            analyzeAndMaybeRetry(analyzeAction, requestFilter, result, logicalPlanListener, l);
+        }).<PreAnalysisResult>andThen((l, result) -> {
+            assert requestFilter != null : "The second pre-analysis shouldn't take place when there is no index filter in the request";
+
+            // "reset" execution information for all ccs or non-ccs (local) clusters, since we are performing the indices
+            // resolving one more time (the first attempt failed and the query had a filter)
+            for (String clusterAlias : executionInfo.clusterAliases()) {
+                executionInfo.swapCluster(clusterAlias, (k, v) -> null);
+            }
 
-    private void preAnalyzeLookupIndices(List<TableInfo> indices, ListenerResult listenerResult, ActionListener<ListenerResult> listener) {
-        if (indices.size() > 1) {
-            // Note: JOINs on more than one index are not yet supported
-            listener.onFailure(new MappingException("More than one LOOKUP JOIN is not supported"));
-        } else if (indices.size() == 1) {
-            TableInfo tableInfo = indices.get(0);
-            TableIdentifier table = tableInfo.id();
-            // call the EsqlResolveFieldsAction (field-caps) to resolve indices and get field types
-            indexResolver.resolveAsMergedMapping(
-                table.index(),
-                Set.of("*"), // TODO: for LOOKUP JOIN, this currently declares all lookup index fields relevant and might fetch too many.
-                null,
-                listener.map(indexResolution -> listenerResult.withLookupIndexResolution(indexResolution))
-            );
-            // TODO: Verify that the resolved index actually has indexMode: "lookup"
-        } else {
+            // here the requestFilter is set to null, performing the pre-analysis after the first step failed
+            preAnalyzeIndices(preAnalysis.indices, executionInfo, result, null, l);
+        }).<LogicalPlan>andThen((l, result) -> {
+            assert requestFilter != null : "The second analysis shouldn't take place when there is no index filter in the request";
+            LOGGER.debug("Analyzing the plan (second attempt, without filter)");
+            LogicalPlan plan;
             try {
-                // No lookup indices specified
-                listener.onResponse(
-                    new ListenerResult(
-                        listenerResult.indices,
-                        IndexResolution.invalid("[none specified]"),
-                        listenerResult.enrichResolution,
-                        listenerResult.fieldNames
-                    )
-                );
-            } catch (Exception ex) {
-                listener.onFailure(ex);
+                plan = analyzeAction.apply(result);
+            } catch (Exception e) {
+                l.onFailure(e);
+                return;
             }
-        }
+            LOGGER.debug("Analyzed plan (second attempt, without filter):\n{}", plan);
+            l.onResponse(plan);
+        }).addListener(logicalPlanListener);
+    }
+
+    private void preAnalyzeLookupIndex(TableInfo tableInfo, PreAnalysisResult result, ActionListener<PreAnalysisResult> listener) {
+        TableIdentifier table = tableInfo.id();
+        Set<String> fieldNames = result.wildcardJoinIndices().contains(table.index()) ? IndexResolver.ALL_FIELDS : result.fieldNames;
+        // call the EsqlResolveFieldsAction (field-caps) to resolve indices and get field types
+        indexResolver.resolveAsMergedMapping(
+            table.index(),
+            fieldNames,
+            null,
+            listener.map(indexResolution -> result.addLookupIndexResolution(table.index(), indexResolution))
+        );
+        // TODO: Verify that the resolved index actually has indexMode: "lookup"
     }
 
     private void preAnalyzeIndices(
         List<TableInfo> indices,
         EsqlExecutionInfo executionInfo,
-        ListenerResult listenerResult,
+        PreAnalysisResult result,
         QueryBuilder requestFilter,
-        ActionListener<ListenerResult> listener
+        ActionListener<PreAnalysisResult> listener
     ) {
         // TODO we plan to support joins in the future when possible, but for now we'll just fail early if we see one
         if (indices.size() > 1) {
@@ -412,7 +380,7 @@ private void preAnalyzeIndices(
             listener.onFailure(new MappingException("Queries with multiple indices are not supported"));
         } else if (indices.size() == 1) {
             // known to be unavailable from the enrich policy API call
-            Map<String, Exception> unavailableClusters = listenerResult.enrichResolution.getUnavailableClusters();
+            Map<String, Exception> unavailableClusters = result.enrichResolution.getUnavailableClusters();
             TableInfo tableInfo = indices.get(0);
             TableIdentifier table = tableInfo.id();
 
@@ -445,34 +413,20 @@ private void preAnalyzeIndices(
             String indexExpressionToResolve = EsqlSessionCCSUtils.createIndexExpressionFromAvailableClusters(executionInfo);
             if (indexExpressionToResolve.isEmpty()) {
                 // if this was a pure remote CCS request (no local indices) and all remotes are offline, return an empty IndexResolution
-                listener.onResponse(
-                    new ListenerResult(
-                        IndexResolution.valid(new EsIndex(table.index(), Map.of(), Map.of())),
-                        listenerResult.lookupIndices,
-                        listenerResult.enrichResolution,
-                        listenerResult.fieldNames
-                    )
-                );
+                listener.onResponse(result.withIndexResolution(IndexResolution.valid(new EsIndex(table.index(), Map.of(), Map.of()))));
             } else {
                 // call the EsqlResolveFieldsAction (field-caps) to resolve indices and get field types
                 indexResolver.resolveAsMergedMapping(
                     indexExpressionToResolve,
-                    listenerResult.fieldNames,
+                    result.fieldNames,
                     requestFilter,
-                    listener.map(indexResolution -> listenerResult.withIndexResolution(indexResolution))
+                    listener.map(indexResolution -> result.withIndexResolution(indexResolution))
                 );
             }
         } else {
             try {
                 // occurs when dealing with local relations (row a = 1)
-                listener.onResponse(
-                    new ListenerResult(
-                        IndexResolution.invalid("[none specified]"),
-                        listenerResult.lookupIndices,
-                        listenerResult.enrichResolution,
-                        listenerResult.fieldNames
-                    )
-                );
+                listener.onResponse(result.withIndexResolution(IndexResolution.invalid("[none specified]")));
             } catch (Exception ex) {
                 listener.onFailure(ex);
             }
@@ -483,11 +437,11 @@ private boolean analyzeCCSIndices(
         EsqlExecutionInfo executionInfo,
         Set<String> targetClusters,
         Set<EnrichPolicyResolver.UnresolvedPolicy> unresolvedPolicies,
-        ListenerResult listenerResult,
+        PreAnalysisResult result,
         ActionListener<LogicalPlan> logicalPlanListener,
-        ActionListener<ListenerResult> l
+        ActionListener<PreAnalysisResult> l
     ) {
-        IndexResolution indexResolution = listenerResult.indices;
+        IndexResolution indexResolution = result.indices;
         EsqlSessionCCSUtils.updateExecutionInfoWithClustersWithNoMatchingIndices(executionInfo, indexResolution);
         EsqlSessionCCSUtils.updateExecutionInfoWithUnavailableClusters(executionInfo, indexResolution.unavailableClusters());
         if (executionInfo.isCrossClusterSearch() && executionInfo.getClusterStateCount(EsqlExecutionInfo.Cluster.Status.RUNNING) == 0) {
@@ -509,7 +463,7 @@ private boolean analyzeCCSIndices(
             enrichPolicyResolver.resolvePolicies(
                 newClusters,
                 unresolvedPolicies,
-                l.map(enrichResolution -> listenerResult.withEnrichResolution(enrichResolution))
+                l.map(enrichResolution -> result.withEnrichResolution(enrichResolution))
             );
             return true;
         }
@@ -517,11 +471,11 @@ private boolean analyzeCCSIndices(
     }
 
     private static void analyzeAndMaybeRetry(
-        TriFunction<IndexResolution, IndexResolution, EnrichResolution, LogicalPlan> analyzeAction,
+        Function<PreAnalysisResult, LogicalPlan> analyzeAction,
         QueryBuilder requestFilter,
-        ListenerResult listenerResult,
+        PreAnalysisResult result,
         ActionListener<LogicalPlan> logicalPlanListener,
-        ActionListener<ListenerResult> l
+        ActionListener<PreAnalysisResult> l
     ) {
         LogicalPlan plan = null;
         var filterPresentMessage = requestFilter == null ? "without" : "with";
@@ -529,7 +483,7 @@ private static void analyzeAndMaybeRetry(
         LOGGER.debug("Analyzing the plan ({} attempt, {} filter)", attemptMessage, filterPresentMessage);
 
         try {
-            plan = analyzeAction.apply(listenerResult.indices, listenerResult.lookupIndices, listenerResult.enrichResolution);
+            plan = analyzeAction.apply(result);
         } catch (Exception e) {
             if (e instanceof VerificationException ve) {
                 LOGGER.debug(
@@ -544,7 +498,7 @@ private static void analyzeAndMaybeRetry(
                 } else {
                     // interested only in a VerificationException, but this time we are taking out the index filter
                     // to try and make the index resolution work without any index filtering. In the next step... to be continued
-                    l.onResponse(listenerResult);
+                    l.onResponse(result);
                 }
             } else {
                 // if the query failed with any other type of exception, then just pass the exception back to the user
@@ -557,10 +511,24 @@ private static void analyzeAndMaybeRetry(
         logicalPlanListener.onResponse(plan);
     }
 
-    static Set<String> fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchFields) {
+    private static void resolveFieldNames(LogicalPlan parsed, EnrichResolution enrichResolution, ActionListener<PreAnalysisResult> l) {
+        try {
+            // we need the match_fields names from enrich policies and THEN, with an updated list of fields, we call field_caps API
+            var enrichMatchFields = enrichResolution.resolvedEnrichPolicies()
+                .stream()
+                .map(ResolvedEnrichPolicy::matchField)
+                .collect(Collectors.toSet());
+            // get the field names from the parsed plan combined with the ENRICH match fields from the ENRICH policy
+            l.onResponse(fieldNames(parsed, enrichMatchFields, new PreAnalysisResult(enrichResolution)));
+        } catch (Exception ex) {
+            l.onFailure(ex);
+        }
+    }
+
+    static PreAnalysisResult fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchFields, PreAnalysisResult result) {
         if (false == parsed.anyMatch(plan -> plan instanceof Aggregate || plan instanceof Project)) {
             // no explicit columns selection, for example "from employees"
-            return IndexResolver.ALL_FIELDS;
+            return result.withFieldNames(IndexResolver.ALL_FIELDS);
         }
 
         Holder<Boolean> projectAll = new Holder<>(false);
@@ -571,7 +539,7 @@ static Set<String> fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchF
             projectAll.set(true);
         });
         if (projectAll.get()) {
-            return IndexResolver.ALL_FIELDS;
+            return result.withFieldNames(IndexResolver.ALL_FIELDS);
         }
 
         AttributeSet references = new AttributeSet();
@@ -579,6 +547,7 @@ static Set<String> fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchF
         // ie "from test | eval lang = languages + 1 | keep *l" should consider both "languages" and "*l" as valid fields to ask for
         AttributeSet keepCommandReferences = new AttributeSet();
         AttributeSet keepJoinReferences = new AttributeSet();
+        Set<String> wildcardJoinIndices = new java.util.HashSet<>();
 
         parsed.forEachDown(p -> {// go over each plan top-down
             if (p instanceof RegexExtract re) { // for Grok and Dissect
@@ -596,10 +565,16 @@ static Set<String> fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchF
                 enrichRefs.removeIf(attr -> attr instanceof EmptyAttribute);
                 references.addAll(enrichRefs);
             } else if (p instanceof LookupJoin join) {
-                keepJoinReferences.addAll(join.config().matchFields());  // TODO: why is this empty
                 if (join.config().type() instanceof JoinTypes.UsingJoinType usingJoinType) {
                     keepJoinReferences.addAll(usingJoinType.columns());
                 }
+                if (keepCommandReferences.isEmpty()) {
+                    // No KEEP commands after the JOIN, so we need to mark this index for "*" field resolution
+                    wildcardJoinIndices.add(((UnresolvedRelation) join.right()).table().index());
+                } else {
+                    // Keep commands can reference the join columns with names that shadow aliases, so we block their removal
+                    keepJoinReferences.addAll(keepCommandReferences);
+                }
             } else {
                 references.addAll(p.references());
                 if (p instanceof UnresolvedRelation ur && ur.indexMode() == IndexMode.TIME_SERIES) {
@@ -634,6 +609,10 @@ static Set<String> fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchF
         });
         // Add JOIN ON column references afterward to avoid Alias removal
         references.addAll(keepJoinReferences);
+        // If any JOIN commands need wildcard field-caps calls, persist the index names
+        if (wildcardJoinIndices.isEmpty() == false) {
+            result = result.withWildcardJoinIndices(wildcardJoinIndices);
+        }
 
         // remove valid metadata attributes because they will be filtered out by the IndexResolver anyway
         // otherwise, in some edge cases, we will fail to ask for "*" (all fields) instead
@@ -642,12 +621,12 @@ static Set<String> fieldNames(LogicalPlan parsed, Set<String> enrichPolicyMatchF
 
         if (fieldNames.isEmpty() && enrichPolicyMatchFields.isEmpty()) {
             // there cannot be an empty list of fields, we'll ask the simplest and lightest one instead: _index
-            return IndexResolver.INDEX_METADATA_FIELD;
+            return result.withFieldNames(IndexResolver.INDEX_METADATA_FIELD);
         } else {
             fieldNames.addAll(subfields(fieldNames));
             fieldNames.addAll(enrichPolicyMatchFields);
             fieldNames.addAll(subfields(enrichPolicyMatchFields));
-            return fieldNames;
+            return result.withFieldNames(fieldNames);
         }
     }
 
@@ -706,22 +685,36 @@ public PhysicalPlan optimizedPhysicalPlan(LogicalPlan optimizedPlan) {
         return plan;
     }
 
-    private record ListenerResult(
+    record PreAnalysisResult(
         IndexResolution indices,
-        IndexResolution lookupIndices,
+        Map<String, IndexResolution> lookupIndices,
         EnrichResolution enrichResolution,
-        Set<String> fieldNames
+        Set<String> fieldNames,
+        Set<String> wildcardJoinIndices
     ) {
-        ListenerResult withEnrichResolution(EnrichResolution newEnrichResolution) {
-            return new ListenerResult(indices(), lookupIndices(), newEnrichResolution, fieldNames());
+        PreAnalysisResult(EnrichResolution newEnrichResolution) {
+            this(null, new HashMap<>(), newEnrichResolution, Set.of(), Set.of());
         }
 
-        ListenerResult withIndexResolution(IndexResolution newIndexResolution) {
-            return new ListenerResult(newIndexResolution, lookupIndices(), enrichResolution(), fieldNames());
+        PreAnalysisResult withEnrichResolution(EnrichResolution newEnrichResolution) {
+            return new PreAnalysisResult(indices(), lookupIndices(), newEnrichResolution, fieldNames(), wildcardJoinIndices());
         }
 
-        ListenerResult withLookupIndexResolution(IndexResolution newIndexResolution) {
-            return new ListenerResult(indices(), newIndexResolution, enrichResolution(), fieldNames());
+        PreAnalysisResult withIndexResolution(IndexResolution newIndexResolution) {
+            return new PreAnalysisResult(newIndexResolution, lookupIndices(), enrichResolution(), fieldNames(), wildcardJoinIndices());
         }
-    };
+
+        PreAnalysisResult addLookupIndexResolution(String index, IndexResolution newIndexResolution) {
+            lookupIndices.put(index, newIndexResolution);
+            return this;
+        }
+
+        PreAnalysisResult withFieldNames(Set<String> newFields) {
+            return new PreAnalysisResult(indices(), lookupIndices(), enrichResolution(), newFields, wildcardJoinIndices());
+        }
+
+        public PreAnalysisResult withWildcardJoinIndices(Set<String> wildcardJoinIndices) {
+            return new PreAnalysisResult(indices(), lookupIndices(), enrichResolution(), fieldNames(), wildcardJoinIndices);
+        }
+    }
 }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index c11ef8615eb72..f553c15ef69fa 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -263,7 +263,7 @@ public final void test() throws Throwable {
             );
             assumeFalse(
                 "lookup join disabled for csv tests",
-                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V5.capabilityName())
+                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V6.capabilityName())
             );
             assumeFalse(
                 "can't use TERM function in csv tests",
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
index 5e79e40b7e938..85dd36ba0aaa5 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
@@ -123,8 +123,8 @@ public static IndexResolution expandedDefaultIndexResolution() {
         return loadMapping("mapping-default.json", "test");
     }
 
-    public static IndexResolution defaultLookupResolution() {
-        return loadMapping("mapping-languages.json", "languages_lookup", IndexMode.LOOKUP);
+    public static Map<String, IndexResolution> defaultLookupResolution() {
+        return Map.of("languages_lookup", loadMapping("mapping-languages.json", "languages_lookup", IndexMode.LOOKUP));
     }
 
     public static EnrichResolution defaultEnrichResolution() {
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
index cfff245b19244..4e02119b31744 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
@@ -2139,7 +2139,7 @@ public void testLookupMatchTypeWrong() {
     }
 
     public void testLookupJoinUnknownIndex() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String errorMessage = "Unknown index [foobar]";
         IndexResolution missingLookupIndex = IndexResolution.invalid(errorMessage);
@@ -2149,7 +2149,7 @@ public void testLookupJoinUnknownIndex() {
                 EsqlTestUtils.TEST_CFG,
                 new EsqlFunctionRegistry(),
                 analyzerDefaultMapping(),
-                missingLookupIndex,
+                Map.of("foobar", missingLookupIndex),
                 defaultEnrichResolution()
             ),
             TEST_VERIFIER
@@ -2168,7 +2168,7 @@ public void testLookupJoinUnknownIndex() {
     }
 
     public void testLookupJoinUnknownField() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String query = "FROM test | LOOKUP JOIN languages_lookup ON last_name";
         String errorMessage = "1:45: Unknown column [last_name] in right side of join";
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
index 4b916106165fb..58180aafedc0b 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
@@ -1964,7 +1964,7 @@ public void testSortByAggregate() {
     }
 
     public void testLookupJoinDataTypeMismatch() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         query("FROM test | EVAL language_code = languages | LOOKUP JOIN languages_lookup ON language_code");
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
index 1d10ebab267ce..c4d7b30115c2d 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
@@ -219,11 +219,6 @@ public static void init() {
         enrichResolution = new EnrichResolution();
         AnalyzerTestUtils.loadEnrichPolicyResolution(enrichResolution, "languages_idx", "id", "languages_idx", "mapping-languages.json");
 
-        var lookupMapping = loadMapping("mapping-languages.json");
-        IndexResolution lookupResolution = IndexResolution.valid(
-            new EsIndex("language_code", lookupMapping, Map.of("language_code", IndexMode.LOOKUP))
-        );
-
         // Most tests used data from the test index, so we load it here, and use it in the plan() function.
         mapping = loadMapping("mapping-basic.json");
         EsIndex test = new EsIndex("test", mapping, Map.of("test", IndexMode.STANDARD));
@@ -4911,7 +4906,7 @@ public void testPlanSanityCheck() throws Exception {
     }
 
     public void testPlanSanityCheckWithBinaryPlans() throws Exception {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         var plan = optimizedPlan("""
               FROM test
@@ -5913,15 +5908,15 @@ public void testLookupStats() {
      *     | \_Limit[1000[INTEGER]]
      *     |  \_Filter[languages{f}#10 > 1[INTEGER]]
      *     |    \_EsRelation[test][_meta_field{f}#13, emp_no{f}#7, first_name{f}#8, ge..]
-     *     \_EsRelation[language_code][LOOKUP][language_code{f}#18, language_name{f}#19]
+     *     \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownFilterOnJoinKeyWithRename() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String query = """
               FROM test
             | RENAME languages AS language_code
-            | LOOKUP JOIN language_code ON language_code
+            | LOOKUP JOIN languages_lookup ON language_code
             | WHERE language_code > 1
             """;
         var plan = optimizedPlan(query);
@@ -5956,15 +5951,15 @@ public void testLookupJoinPushDownFilterOnJoinKeyWithRename() {
      *     | \_Limit[1000[INTEGER]]
      *     |  \_Filter[emp_no{f}#7 > 1[INTEGER]]
      *     |    \_EsRelation[test][_meta_field{f}#13, emp_no{f}#7, first_name{f}#8, ge..]
-     *     \_EsRelation[language_code][LOOKUP][language_code{f}#18, language_name{f}#19]
+     *     \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownFilterOnLeftSideField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String query = """
               FROM test
             | RENAME languages AS language_code
-            | LOOKUP JOIN language_code ON language_code
+            | LOOKUP JOIN languages_lookup ON language_code
             | WHERE emp_no > 1
             """;
 
@@ -6000,15 +5995,15 @@ public void testLookupJoinPushDownFilterOnLeftSideField() {
      *       |_EsqlProject[[_meta_field{f}#13, emp_no{f}#7, first_name{f}#8, gender{f}#9, hire_date{f}#14, job{f}#15, job.raw{f}#16, lang
      * uages{f}#10 AS language_code, last_name{f}#11, long_noidx{f}#17, salary{f}#12]]
      *       | \_EsRelation[test][_meta_field{f}#13, emp_no{f}#7, first_name{f}#8, ge..]
-     *       \_EsRelation[language_code][LOOKUP][language_code{f}#18, language_name{f}#19]
+     *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownDisabledForLookupField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String query = """
               FROM test
             | RENAME languages AS language_code
-            | LOOKUP JOIN language_code ON language_code
+            | LOOKUP JOIN languages_lookup ON language_code
             | WHERE language_name == "English"
             """;
 
@@ -6045,15 +6040,15 @@ public void testLookupJoinPushDownDisabledForLookupField() {
      * guages{f}#11 AS language_code, last_name{f}#12, long_noidx{f}#18, salary{f}#13]]
      *       | \_Filter[emp_no{f}#8 > 1[INTEGER]]
      *       |   \_EsRelation[test][_meta_field{f}#14, emp_no{f}#8, first_name{f}#9, ge..]
-     *       \_EsRelation[language_code][LOOKUP][language_code{f}#19, language_name{f}#20]
+     *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#19, language_name{f}#20]
      */
     public void testLookupJoinPushDownSeparatedForConjunctionBetweenLeftAndRightField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String query = """
               FROM test
             | RENAME languages AS language_code
-            | LOOKUP JOIN language_code ON language_code
+            | LOOKUP JOIN languages_lookup ON language_code
             | WHERE language_name == "English" AND emp_no > 1
             """;
 
@@ -6098,15 +6093,15 @@ public void testLookupJoinPushDownSeparatedForConjunctionBetweenLeftAndRightFiel
      *       |_EsqlProject[[_meta_field{f}#14, emp_no{f}#8, first_name{f}#9, gender{f}#10, hire_date{f}#15, job{f}#16, job.raw{f}#17, lan
      * guages{f}#11 AS language_code, last_name{f}#12, long_noidx{f}#18, salary{f}#13]]
      *       | \_EsRelation[test][_meta_field{f}#14, emp_no{f}#8, first_name{f}#9, ge..]
-     *       \_EsRelation[language_code][LOOKUP][language_code{f}#19, language_name{f}#20]
+     *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#19, language_name{f}#20]
      */
     public void testLookupJoinPushDownDisabledForDisjunctionBetweenLeftAndRightField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         String query = """
               FROM test
             | RENAME languages AS language_code
-            | LOOKUP JOIN language_code ON language_code
+            | LOOKUP JOIN languages_lookup ON language_code
             | WHERE language_name == "English" OR emp_no > 1
             """;
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
index d0c7a1cd61010..9f6ef89008a24 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
@@ -285,7 +285,7 @@ TestDataSource makeTestDataSource(
         String indexName,
         String mappingFileName,
         EsqlFunctionRegistry functionRegistry,
-        IndexResolution lookupResolution,
+        Map<String, IndexResolution> lookupResolution,
         EnrichResolution enrichResolution,
         SearchStats stats
     ) {
@@ -2331,7 +2331,7 @@ public void testVerifierOnMissingReferences() {
     }
 
     public void testVerifierOnMissingReferencesWithBinaryPlans() throws Exception {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V5.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
 
         // Do not assert serialization:
         // This will have a LookupJoinExec, which is not serializable because it doesn't leave the coordinator.
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
index 0fe89b24dfc6a..e4271a0a6ddd5 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
@@ -1316,25 +1316,25 @@ public void testCountStar() {
     }
 
     public void testEnrichOnDefaultFieldWithKeep() {
-        Set<String> fieldNames = EsqlSession.fieldNames(parser.createStatement("""
+        Set<String> fieldNames = fieldNames("""
             from employees
             | enrich languages_policy
-            | keep emp_no"""), Set.of("language_name"));
+            | keep emp_no""", Set.of("language_name"));
         assertThat(fieldNames, equalTo(Set.of("emp_no", "emp_no.*", "language_name", "language_name.*")));
     }
 
     public void testDissectOverwriteName() {
-        Set<String> fieldNames = EsqlSession.fieldNames(parser.createStatement("""
+        Set<String> fieldNames = fieldNames("""
             from employees
             | dissect first_name "%{first_name} %{more}"
-            | keep emp_no, first_name, more"""), Set.of());
+            | keep emp_no, first_name, more""", Set.of());
         assertThat(fieldNames, equalTo(Set.of("emp_no", "emp_no.*", "first_name", "first_name.*")));
     }
 
     public void testEnrichOnDefaultField() {
-        Set<String> fieldNames = EsqlSession.fieldNames(parser.createStatement("""
+        Set<String> fieldNames = fieldNames("""
             from employees
-            | enrich languages_policy"""), Set.of("language_name"));
+            | enrich languages_policy""", Set.of("language_name"));
         assertThat(fieldNames, equalTo(ALL_FIELDS));
     }
 
@@ -1345,7 +1345,7 @@ public void testMetrics() {
             assertThat(e.getMessage(), containsString("line 1:1: mismatched input 'METRICS' expecting {"));
             return;
         }
-        Set<String> fieldNames = EsqlSession.fieldNames(parser.createStatement(query), Set.of());
+        Set<String> fieldNames = fieldNames(query, Set.of());
         assertThat(
             fieldNames,
             equalTo(
@@ -1363,8 +1363,218 @@ public void testMetrics() {
         );
     }
 
+    public void testLookupJoin() {
+        assertFieldNames(
+            "FROM employees | KEEP languages | RENAME languages AS language_code | LOOKUP JOIN languages_lookup ON language_code",
+            Set.of("languages", "languages.*", "language_code", "language_code.*"),
+            Set.of("languages_lookup") // Since we have KEEP before the LOOKUP JOIN we need to wildcard the lookup index
+        );
+    }
+
+    public void testLookupJoinKeep() {
+        assertFieldNames(
+            """
+                FROM employees
+                | KEEP languages
+                | RENAME languages AS language_code
+                | LOOKUP JOIN languages_lookup ON language_code
+                | KEEP languages, language_code, language_name""",
+            Set.of("languages", "languages.*", "language_code", "language_code.*", "language_name", "language_name.*"),
+            Set.of()  // Since we have KEEP after the LOOKUP, we can use the global field names instead of wildcarding the lookup index
+        );
+    }
+
+    public void testLookupJoinKeepWildcard() {
+        assertFieldNames(
+            """
+                FROM employees
+                | KEEP languages
+                | RENAME languages AS language_code
+                | LOOKUP JOIN languages_lookup ON language_code
+                | KEEP language*""",
+            Set.of("language*", "languages", "languages.*", "language_code", "language_code.*"),
+            Set.of()  // Since we have KEEP after the LOOKUP, we can use the global field names instead of wildcarding the lookup index
+        );
+    }
+
+    public void testMultiLookupJoin() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | LOOKUP JOIN message_types_lookup ON message""",
+            Set.of("*"), // With no KEEP we should keep all fields
+            Set.of() // since global field names are wildcarded, we don't need to wildcard any indices
+        );
+    }
+
+    public void testMultiLookupJoinKeepBefore() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | KEEP @timestamp, client_ip, event_duration, message
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | LOOKUP JOIN message_types_lookup ON message""",
+            Set.of("@timestamp", "@timestamp.*", "client_ip", "client_ip.*", "event_duration", "event_duration.*", "message", "message.*"),
+            Set.of("clientips_lookup", "message_types_lookup") // Since the KEEP is before both JOINS we need to wildcard both indices
+        );
+    }
+
+    public void testMultiLookupJoinKeepBetween() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | KEEP @timestamp, client_ip, event_duration, message, env
+                | LOOKUP JOIN message_types_lookup ON message""",
+            Set.of(
+                "@timestamp",
+                "@timestamp.*",
+                "client_ip",
+                "client_ip.*",
+                "event_duration",
+                "event_duration.*",
+                "message",
+                "message.*",
+                "env",
+                "env.*"
+            ),
+            Set.of("message_types_lookup")  // Since the KEEP is before the second JOIN, we need to wildcard the second index
+        );
+    }
+
+    public void testMultiLookupJoinKeepAfter() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | LOOKUP JOIN message_types_lookup ON message
+                | KEEP @timestamp, client_ip, event_duration, message, env, type""",
+            Set.of(
+                "@timestamp",
+                "@timestamp.*",
+                "client_ip",
+                "client_ip.*",
+                "event_duration",
+                "event_duration.*",
+                "message",
+                "message.*",
+                "env",
+                "env.*",
+                "type",
+                "type.*"
+            ),
+            Set.of()  // Since the KEEP is after both JOINs, we can use the global field names
+        );
+    }
+
+    public void testMultiLookupJoinKeepAfterWildcard() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | LOOKUP JOIN message_types_lookup ON message
+                | KEEP *env*, *type*""",
+            Set.of("*env*", "*type*", "client_ip", "client_ip.*", "message", "message.*"),
+            Set.of()  // Since the KEEP is after both JOINs, we can use the global field names
+        );
+    }
+
+    public void testMultiLookupJoinSameIndex() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | EVAL client_ip = message
+                | LOOKUP JOIN clientips_lookup ON client_ip""",
+            Set.of("*"), // With no KEEP we should keep all fields
+            Set.of() // since global field names are wildcarded, we don't need to wildcard any indices
+        );
+    }
+
+    public void testMultiLookupJoinSameIndexKeepBefore() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | KEEP @timestamp, client_ip, event_duration, message
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | EVAL client_ip = message
+                | LOOKUP JOIN clientips_lookup ON client_ip""",
+            Set.of("@timestamp", "@timestamp.*", "client_ip", "client_ip.*", "event_duration", "event_duration.*", "message", "message.*"),
+            Set.of("clientips_lookup") // Since there is no KEEP after the last JOIN, we need to wildcard the index
+        );
+    }
+
+    public void testMultiLookupJoinSameIndexKeepBetween() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | KEEP @timestamp, client_ip, event_duration, message, env
+                | EVAL client_ip = message
+                | LOOKUP JOIN clientips_lookup ON client_ip""",
+            Set.of(
+                "@timestamp",
+                "@timestamp.*",
+                "client_ip",
+                "client_ip.*",
+                "event_duration",
+                "event_duration.*",
+                "message",
+                "message.*",
+                "env",
+                "env.*"
+            ),
+            Set.of("clientips_lookup") // Since there is no KEEP after the last JOIN, we need to wildcard the index
+        );
+    }
+
+    public void testMultiLookupJoinSameIndexKeepAfter() {
+        assertFieldNames(
+            """
+                FROM sample_data
+                | EVAL client_ip = client_ip::keyword
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | EVAL client_ip = message
+                | LOOKUP JOIN clientips_lookup ON client_ip
+                | KEEP @timestamp, client_ip, event_duration, message, env""",
+            Set.of(
+                "@timestamp",
+                "@timestamp.*",
+                "client_ip",
+                "client_ip.*",
+                "event_duration",
+                "event_duration.*",
+                "message",
+                "message.*",
+                "env",
+                "env.*"
+            ),
+            Set.of()  // Since the KEEP is after both JOINs, we can use the global field names
+        );
+    }
+
+    private Set<String> fieldNames(String query, Set<String> enrichPolicyMatchFields) {
+        var preAnalysisResult = new EsqlSession.PreAnalysisResult(null);
+        return EsqlSession.fieldNames(parser.createStatement(query), enrichPolicyMatchFields, preAnalysisResult).fieldNames();
+    }
+
     private void assertFieldNames(String query, Set<String> expected) {
-        Set<String> fieldNames = EsqlSession.fieldNames(parser.createStatement(query), Collections.emptySet());
+        Set<String> fieldNames = fieldNames(query, Collections.emptySet());
         assertThat(fieldNames, equalTo(expected));
     }
+
+    private void assertFieldNames(String query, Set<String> expected, Set<String> wildCardIndices) {
+        var preAnalysisResult = EsqlSession.fieldNames(parser.createStatement(query), Set.of(), new EsqlSession.PreAnalysisResult(null));
+        assertThat("Query-wide field names", preAnalysisResult.fieldNames(), equalTo(expected));
+        assertThat("Lookup Indices that expect wildcard lookups", preAnalysisResult.wildcardJoinIndices(), equalTo(wildCardIndices));
+    }
 }

From 8deb32fb1beb686eb8a0e853b22aadb2d382f1c1 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Tue, 17 Dec 2024 08:25:44 +1100
Subject: [PATCH 018/119] Mute
 org.elasticsearch.xpack.ccr.rest.ShardChangesRestIT
 testShardChangesNoOperation #118800

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index be3805d887bbe..0aea4100a2606 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -299,6 +299,9 @@ tests:
 - class: org.elasticsearch.reservedstate.service.FileSettingsServiceTests
   method: testInvalidJSON
   issue: https://github.com/elastic/elasticsearch/issues/116521
+- class: org.elasticsearch.xpack.ccr.rest.ShardChangesRestIT
+  method: testShardChangesNoOperation
+  issue: https://github.com/elastic/elasticsearch/issues/118800
 
 # Examples:
 #

From 5c55c39f9f320aa4defb9f4458ef87d9ac994779 Mon Sep 17 00:00:00 2001
From: Kathleen DeRusso <kathleen.derusso@elastic.co>
Date: Mon, 16 Dec 2024 17:20:33 -0500
Subject: [PATCH 019/119] Fix semantic text match failure (#118790)

* Fix semantic text match failure

* Remove shard settings; only check for counts and not specific doc IDs
---
 .../rest-api-spec/test/inference/45_semantic_text_match.yml  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/45_semantic_text_match.yml b/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/45_semantic_text_match.yml
index cdbf73d31a272..28093ba49e6cc 100644
--- a/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/45_semantic_text_match.yml
+++ b/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/45_semantic_text_match.yml
@@ -210,8 +210,6 @@ setup:
                 query: "inference test"
 
   - match: { hits.total.value: 2 }
-  - match: { hits.hits.0._id: "doc_1" }
-  - match: { hits.hits.1._id: "doc_2" }
 
   # Test querying multiple indices that either use the same inference ID or combine semantic_text with lexical search
   - do:
@@ -246,9 +244,6 @@ setup:
                 query: "inference test"
 
   - match: { hits.total.value: 3 }
-  - match: { hits.hits.0._id: "doc_1" }
-  - match: { hits.hits.1._id: "doc_3" }
-  - match: { hits.hits.2._id: "doc_2" }
 
 ---
 "Query a field that has no indexed inference results":

From e1d06a8881577c90f57cf0e0a379df78ba22b22e Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:14:38 +1100
Subject: [PATCH 020/119] Mute
 org.elasticsearch.xpack.security.QueryableReservedRolesIT
 testDeletingAndCreatingSecurityIndexTriggersSynchronization #118806

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 0aea4100a2606..b43045d24be81 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -302,6 +302,9 @@ tests:
 - class: org.elasticsearch.xpack.ccr.rest.ShardChangesRestIT
   method: testShardChangesNoOperation
   issue: https://github.com/elastic/elasticsearch/issues/118800
+- class: org.elasticsearch.xpack.security.QueryableReservedRolesIT
+  method: testDeletingAndCreatingSecurityIndexTriggersSynchronization
+  issue: https://github.com/elastic/elasticsearch/issues/118806
 
 # Examples:
 #

From b44469736c92cfb3dcb21d3aaa177765fd643d5d Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Tue, 17 Dec 2024 08:07:56 +0200
Subject: [PATCH 021/119] Remove esql-core ParsingException (#118789)

* Remove esql-core ParsingException
Move fulltext related classes: querydsl, predicate and tests
---
 .../xpack/esql/core/ParsingException.java     | 56 -------------------
 .../core/planner/ExpressionTranslators.java   | 14 -----
 .../function/EsqlFunctionRegistry.java        |  2 +-
 .../function/fulltext/FullTextWritables.java  |  4 +-
 .../predicate/fulltext/FullTextPredicate.java |  2 +-
 .../predicate/fulltext/FullTextUtils.java     |  8 +--
 .../fulltext/MatchQueryPredicate.java         |  2 +-
 .../fulltext/MultiMatchQueryPredicate.java    |  2 +-
 .../xpack/esql/parser/EsqlParser.java         |  6 +-
 .../xpack/esql/parser/ParserUtils.java        |  1 -
 .../xpack/esql/parser/ParsingException.java   |  2 +-
 .../planner/EsqlExpressionTranslators.java    | 18 +++++-
 .../esql}/querydsl/query/MatchQuery.java      |  3 +-
 .../esql}/querydsl/query/MultiMatchQuery.java |  5 +-
 .../xpack/esql/analysis/ParsingTests.java     | 22 ++++----
 .../function/EsqlFunctionRegistryTests.java   |  2 +-
 .../AbstractFulltextSerializationTests.java   |  3 +-
 .../fulltext/FullTextUtilsTests.java          | 12 ++--
 .../MatchQuerySerializationTests.java         |  3 +-
 .../MultiMatchQuerySerializationTests.java    |  4 +-
 .../esql}/querydsl/query/BoolQueryTests.java  |  6 +-
 .../esql}/querydsl/query/MatchQueryTests.java |  4 +-
 .../querydsl/query/MultiMatchQueryTests.java  |  4 +-
 .../querydsl/query/QueryStringQueryTests.java |  3 +-
 .../esql/tree/EsqlNodeSubclassTests.java      |  2 +-
 25 files changed, 66 insertions(+), 124 deletions(-)
 delete mode 100644 x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/ParsingException.java
 rename x-pack/plugin/{esql-core/src/main/java/org/elasticsearch/xpack/esql/core => esql/src/main/java/org/elasticsearch/xpack/esql}/expression/predicate/fulltext/FullTextPredicate.java (97%)
 rename x-pack/plugin/{esql-core/src/main/java/org/elasticsearch/xpack/esql/core => esql/src/main/java/org/elasticsearch/xpack/esql}/expression/predicate/fulltext/FullTextUtils.java (90%)
 rename x-pack/plugin/{esql-core/src/main/java/org/elasticsearch/xpack/esql/core => esql/src/main/java/org/elasticsearch/xpack/esql}/expression/predicate/fulltext/MatchQueryPredicate.java (96%)
 rename x-pack/plugin/{esql-core/src/main/java/org/elasticsearch/xpack/esql/core => esql/src/main/java/org/elasticsearch/xpack/esql}/expression/predicate/fulltext/MultiMatchQueryPredicate.java (97%)
 rename x-pack/plugin/{esql-core/src/main/java/org/elasticsearch/xpack/esql/core => esql/src/main/java/org/elasticsearch/xpack/esql}/querydsl/query/MatchQuery.java (97%)
 rename x-pack/plugin/{esql-core/src/main/java/org/elasticsearch/xpack/esql/core => esql/src/main/java/org/elasticsearch/xpack/esql}/querydsl/query/MultiMatchQuery.java (95%)
 rename x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/{operator => }/fulltext/AbstractFulltextSerializationTests.java (88%)
 rename x-pack/plugin/{esql-core/src/test/java/org/elasticsearch/xpack/esql/core => esql/src/test/java/org/elasticsearch/xpack/esql}/expression/predicate/fulltext/FullTextUtilsTests.java (79%)
 rename x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/{operator => }/fulltext/MatchQuerySerializationTests.java (89%)
 rename x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/{operator => }/fulltext/MultiMatchQuerySerializationTests.java (92%)
 rename x-pack/plugin/{esql-core/src/test/java/org/elasticsearch/xpack/esql/core => esql/src/test/java/org/elasticsearch/xpack/esql}/querydsl/query/BoolQueryTests.java (92%)
 rename x-pack/plugin/{esql-core/src/test/java/org/elasticsearch/xpack/esql/core => esql/src/test/java/org/elasticsearch/xpack/esql}/querydsl/query/MatchQueryTests.java (96%)
 rename x-pack/plugin/{esql-core/src/test/java/org/elasticsearch/xpack/esql/core => esql/src/test/java/org/elasticsearch/xpack/esql}/querydsl/query/MultiMatchQueryTests.java (94%)
 rename x-pack/plugin/{esql-core/src/test/java/org/elasticsearch/xpack/esql/core => esql/src/test/java/org/elasticsearch/xpack/esql}/querydsl/query/QueryStringQueryTests.java (94%)

diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/ParsingException.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/ParsingException.java
deleted file mode 100644
index bce3f848c9387..0000000000000
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/ParsingException.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.esql.core;
-
-import org.elasticsearch.xpack.esql.core.tree.Source;
-
-import static org.elasticsearch.common.logging.LoggerMessageFormat.format;
-
-public class ParsingException extends QlClientException {
-    private final int line;
-    private final int charPositionInLine;
-
-    public ParsingException(String message, Exception cause, int line, int charPositionInLine) {
-        super(message, cause);
-        this.line = line;
-        this.charPositionInLine = charPositionInLine;
-    }
-
-    public ParsingException(String message, Object... args) {
-        this(Source.EMPTY, message, args);
-    }
-
-    public ParsingException(Source source, String message, Object... args) {
-        super(message, args);
-        this.line = source.source().getLineNumber();
-        this.charPositionInLine = source.source().getColumnNumber();
-    }
-
-    public ParsingException(Exception cause, Source source, String message, Object... args) {
-        super(cause, message, args);
-        this.line = source.source().getLineNumber();
-        this.charPositionInLine = source.source().getColumnNumber();
-    }
-
-    public int getLineNumber() {
-        return line;
-    }
-
-    public int getColumnNumber() {
-        return charPositionInLine + 1;
-    }
-
-    public String getErrorMessage() {
-        return super.getMessage();
-    }
-
-    @Override
-    public String getMessage() {
-        return format("line {}:{}: {}", getLineNumber(), getColumnNumber(), getErrorMessage());
-    }
-}
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java
index 468d076c1b7ef..e0f4f6b032662 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java
@@ -11,7 +11,6 @@
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
 import org.elasticsearch.xpack.esql.core.expression.MetadataAttribute;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MultiMatchQueryPredicate;
 import org.elasticsearch.xpack.esql.core.expression.predicate.logical.And;
 import org.elasticsearch.xpack.esql.core.expression.predicate.logical.Not;
 import org.elasticsearch.xpack.esql.core.expression.predicate.logical.Or;
@@ -22,7 +21,6 @@
 import org.elasticsearch.xpack.esql.core.expression.predicate.regex.WildcardLike;
 import org.elasticsearch.xpack.esql.core.querydsl.query.BoolQuery;
 import org.elasticsearch.xpack.esql.core.querydsl.query.ExistsQuery;
-import org.elasticsearch.xpack.esql.core.querydsl.query.MultiMatchQuery;
 import org.elasticsearch.xpack.esql.core.querydsl.query.NotQuery;
 import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
 import org.elasticsearch.xpack.esql.core.querydsl.query.RegexQuery;
@@ -71,18 +69,6 @@ private static Query translateField(RegexMatch e, String targetFieldName) {
         }
     }
 
-    public static class MultiMatches extends ExpressionTranslator<MultiMatchQueryPredicate> {
-
-        @Override
-        protected Query asQuery(MultiMatchQueryPredicate q, TranslatorHandler handler) {
-            return doTranslate(q, handler);
-        }
-
-        public static Query doTranslate(MultiMatchQueryPredicate q, TranslatorHandler handler) {
-            return new MultiMatchQuery(q.source(), q.query(), q.fields(), q);
-        }
-    }
-
     public static class BinaryLogic extends ExpressionTranslator<
         org.elasticsearch.xpack.esql.core.expression.predicate.logical.BinaryLogic> {
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
index 1ccc22eb3a6a4..a59ef5bb1575d 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
@@ -11,7 +11,6 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.util.CollectionUtils;
 import org.elasticsearch.common.util.FeatureFlag;
-import org.elasticsearch.xpack.esql.core.ParsingException;
 import org.elasticsearch.xpack.esql.core.QlIllegalArgumentException;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.function.Function;
@@ -147,6 +146,7 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.ToUpper;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Trim;
 import org.elasticsearch.xpack.esql.expression.function.scalar.util.Delay;
+import org.elasticsearch.xpack.esql.parser.ParsingException;
 import org.elasticsearch.xpack.esql.session.Configuration;
 
 import java.lang.reflect.Constructor;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
index d6b79d16b74f6..245aca5b7328e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
@@ -9,8 +9,8 @@
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MatchQueryPredicate;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.MatchQueryPredicate;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.MultiMatchQueryPredicate;
 
 import java.util.ArrayList;
 import java.util.Collections;
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextPredicate.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextPredicate.java
similarity index 97%
rename from x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextPredicate.java
rename to x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextPredicate.java
index b23593804f8fe..1dd6f650828c3 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextPredicate.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextPredicate.java
@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.expression.predicate.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextUtils.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextUtils.java
similarity index 90%
rename from x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextUtils.java
rename to x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextUtils.java
index 6ba2650314d04..32c8e70a0fde6 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextUtils.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextUtils.java
@@ -4,13 +4,13 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.expression.predicate.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.util.Maps;
-import org.elasticsearch.xpack.esql.core.ParsingException;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.FullTextPredicate.Operator;
 import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.FullTextPredicate.Operator;
+import org.elasticsearch.xpack.esql.parser.ParsingException;
 
 import java.util.LinkedHashMap;
 import java.util.Locale;
@@ -86,7 +86,7 @@ private static String[] splitInTwo(String string, String delimiter) {
         return split;
     }
 
-    static FullTextPredicate.Operator operator(Map<String, String> options, String key) {
+    static Operator operator(Map<String, String> options, String key) {
         String value = options.get(key);
         return value != null ? Operator.valueOf(value.toUpperCase(Locale.ROOT)) : null;
     }
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/MatchQueryPredicate.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MatchQueryPredicate.java
similarity index 96%
rename from x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/MatchQueryPredicate.java
rename to x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MatchQueryPredicate.java
index f2e6088167ba5..66c6d8995b24e 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/MatchQueryPredicate.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MatchQueryPredicate.java
@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.expression.predicate.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.StreamInput;
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/MultiMatchQueryPredicate.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
similarity index 97%
rename from x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/MultiMatchQueryPredicate.java
rename to x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
index 2d66023a1407d..5d165d9ea01f7 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/MultiMatchQueryPredicate.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MultiMatchQueryPredicate.java
@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.expression.predicate.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.StreamInput;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java
index 2e55b4df1e223..9538e3ba495db 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java
@@ -70,11 +70,7 @@ private <T> T invokeParser(
         BiFunction<AstBuilder, ParserRuleContext, T> result
     ) {
         if (query.length() > MAX_LENGTH) {
-            throw new org.elasticsearch.xpack.esql.core.ParsingException(
-                "ESQL statement is too large [{} characters > {}]",
-                query.length(),
-                MAX_LENGTH
-            );
+            throw new ParsingException("ESQL statement is too large [{} characters > {}]", query.length(), MAX_LENGTH);
         }
         try {
             EsqlBaseLexer lexer = new EsqlBaseLexer(CharStreams.fromString(query));
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParserUtils.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParserUtils.java
index 89b1ae4e37a68..398c6c5aafbb2 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParserUtils.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParserUtils.java
@@ -14,7 +14,6 @@
 import org.antlr.v4.runtime.tree.ParseTreeVisitor;
 import org.antlr.v4.runtime.tree.TerminalNode;
 import org.elasticsearch.common.util.Maps;
-import org.elasticsearch.xpack.esql.core.ParsingException;
 import org.elasticsearch.xpack.esql.core.tree.Location;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.util.Check;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParsingException.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParsingException.java
index 484a655fc2988..c25ab92437bfc 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParsingException.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/ParsingException.java
@@ -21,7 +21,7 @@ public ParsingException(String message, Exception cause, int line, int charPosit
         this.charPositionInLine = charPositionInLine + 1;
     }
 
-    ParsingException(String message, Object... args) {
+    public ParsingException(String message, Object... args) {
         this(Source.EMPTY, message, args);
     }
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java
index 43bbf9a5f4ff1..a1765977ee9c2 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.xpack.esql.core.planner.ExpressionTranslators;
 import org.elasticsearch.xpack.esql.core.planner.TranslatorHandler;
 import org.elasticsearch.xpack.esql.core.querydsl.query.MatchAll;
-import org.elasticsearch.xpack.esql.core.querydsl.query.MatchQuery;
 import org.elasticsearch.xpack.esql.core.querydsl.query.NotQuery;
 import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
 import org.elasticsearch.xpack.esql.core.querydsl.query.QueryStringQuery;
@@ -44,6 +43,7 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.ip.CIDRMatch;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialRelatesFunction;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialRelatesUtils;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.MultiMatchQueryPredicate;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.Equals;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.GreaterThan;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.GreaterThanOrEqual;
@@ -53,6 +53,8 @@
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.LessThanOrEqual;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.NotEquals;
 import org.elasticsearch.xpack.esql.querydsl.query.KqlQuery;
+import org.elasticsearch.xpack.esql.querydsl.query.MatchQuery;
+import org.elasticsearch.xpack.esql.querydsl.query.MultiMatchQuery;
 import org.elasticsearch.xpack.esql.querydsl.query.SpatialRelatesQuery;
 import org.elasticsearch.xpack.versionfield.Version;
 
@@ -92,7 +94,7 @@ public final class EsqlExpressionTranslators {
         new ExpressionTranslators.IsNotNulls(),
         new ExpressionTranslators.Nots(),
         new ExpressionTranslators.Likes(),
-        new ExpressionTranslators.MultiMatches(),
+        new MultiMatches(),
         new MatchFunctionTranslator(),
         new QueryStringFunctionTranslator(),
         new KqlFunctionTranslator(),
@@ -537,6 +539,18 @@ private static RangeQuery translate(Range r, TranslatorHandler handler) {
         }
     }
 
+    public static class MultiMatches extends ExpressionTranslator<MultiMatchQueryPredicate> {
+
+        @Override
+        protected Query asQuery(MultiMatchQueryPredicate q, TranslatorHandler handler) {
+            return doTranslate(q, handler);
+        }
+
+        public static Query doTranslate(MultiMatchQueryPredicate q, TranslatorHandler handler) {
+            return new MultiMatchQuery(q.source(), q.query(), q.fields(), q);
+        }
+    }
+
     public static class MatchFunctionTranslator extends ExpressionTranslator<Match> {
         @Override
         protected Query asQuery(Match match, TranslatorHandler handler) {
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/querydsl/query/MatchQuery.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/MatchQuery.java
similarity index 97%
rename from x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/querydsl/query/MatchQuery.java
rename to x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/MatchQuery.java
index e6b6dc20c951a..1614b4f455456 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/querydsl/query/MatchQuery.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/MatchQuery.java
@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.querydsl.query;
+package org.elasticsearch.xpack.esql.querydsl.query;
 
 import org.elasticsearch.common.unit.Fuzziness;
 import org.elasticsearch.core.Booleans;
@@ -12,6 +12,7 @@
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 
 import java.util.Collections;
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/querydsl/query/MultiMatchQuery.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/MultiMatchQuery.java
similarity index 95%
rename from x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/querydsl/query/MultiMatchQuery.java
rename to x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/MultiMatchQuery.java
index 71e3cb9fd494a..84524bad29e08 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/querydsl/query/MultiMatchQuery.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/MultiMatchQuery.java
@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.querydsl.query;
+package org.elasticsearch.xpack.esql.querydsl.query;
 
 import org.elasticsearch.common.unit.Fuzziness;
 import org.elasticsearch.core.Booleans;
@@ -12,8 +12,9 @@
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MultiMatchQueryPredicate;
+import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
 import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.MultiMatchQueryPredicate;
 
 import java.util.Map;
 import java.util.Objects;
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
index 68529e99c6b1b..205c8943d4e3c 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.json.JsonXContent;
 import org.elasticsearch.xpack.esql.LoadMapping;
-import org.elasticsearch.xpack.esql.core.ParsingException;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.type.DataType;
 import org.elasticsearch.xpack.esql.expression.function.EsqlFunctionRegistry;
@@ -20,6 +19,7 @@
 import org.elasticsearch.xpack.esql.index.EsIndex;
 import org.elasticsearch.xpack.esql.index.IndexResolution;
 import org.elasticsearch.xpack.esql.parser.EsqlParser;
+import org.elasticsearch.xpack.esql.parser.ParsingException;
 import org.elasticsearch.xpack.esql.plan.logical.LogicalPlan;
 import org.elasticsearch.xpack.esql.plan.logical.Row;
 import org.elasticsearch.xpack.esql.type.EsqlDataTypeConverter;
@@ -49,27 +49,27 @@ public class ParsingTests extends ESTestCase {
     );
 
     public void testCaseFunctionInvalidInputs() {
-        assertEquals("1:23: error building [case]: expects at least two arguments", error("row a = 1 | eval x = case()"));
-        assertEquals("1:23: error building [case]: expects at least two arguments", error("row a = 1 | eval x = case(a)"));
-        assertEquals("1:23: error building [case]: expects at least two arguments", error("row a = 1 | eval x = case(1)"));
+        assertEquals("1:22: error building [case]: expects at least two arguments", error("row a = 1 | eval x = case()"));
+        assertEquals("1:22: error building [case]: expects at least two arguments", error("row a = 1 | eval x = case(a)"));
+        assertEquals("1:22: error building [case]: expects at least two arguments", error("row a = 1 | eval x = case(1)"));
     }
 
     public void testConcatFunctionInvalidInputs() {
-        assertEquals("1:23: error building [concat]: expects at least two arguments", error("row a = 1 | eval x = concat()"));
-        assertEquals("1:23: error building [concat]: expects at least two arguments", error("row a = 1 | eval x = concat(a)"));
-        assertEquals("1:23: error building [concat]: expects at least two arguments", error("row a = 1 | eval x = concat(1)"));
+        assertEquals("1:22: error building [concat]: expects at least two arguments", error("row a = 1 | eval x = concat()"));
+        assertEquals("1:22: error building [concat]: expects at least two arguments", error("row a = 1 | eval x = concat(a)"));
+        assertEquals("1:22: error building [concat]: expects at least two arguments", error("row a = 1 | eval x = concat(1)"));
     }
 
     public void testCoalesceFunctionInvalidInputs() {
-        assertEquals("1:23: error building [coalesce]: expects at least one argument", error("row a = 1 | eval x = coalesce()"));
+        assertEquals("1:22: error building [coalesce]: expects at least one argument", error("row a = 1 | eval x = coalesce()"));
     }
 
     public void testGreatestFunctionInvalidInputs() {
-        assertEquals("1:23: error building [greatest]: expects at least one argument", error("row a = 1 | eval x = greatest()"));
+        assertEquals("1:22: error building [greatest]: expects at least one argument", error("row a = 1 | eval x = greatest()"));
     }
 
     public void testLeastFunctionInvalidInputs() {
-        assertEquals("1:23: error building [least]: expects at least one argument", error("row a = 1 | eval x = least()"));
+        assertEquals("1:22: error building [least]: expects at least one argument", error("row a = 1 | eval x = least()"));
     }
 
     /**
@@ -108,7 +108,7 @@ public void testTooBigQuery() {
         while (query.length() < EsqlParser.MAX_LENGTH) {
             query.append(", a = CONCAT(a, a)");
         }
-        assertEquals("-1:0: ESQL statement is too large [1000011 characters > 1000000]", error(query.toString()));
+        assertEquals("-1:-1: ESQL statement is too large [1000011 characters > 1000000]", error(query.toString()));
     }
 
     private String functionName(EsqlFunctionRegistry registry, Expression functionCall) {
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistryTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistryTests.java
index 801bd8700d014..50cbbdf4a9338 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistryTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistryTests.java
@@ -10,7 +10,6 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.compute.operator.EvalOperator;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.esql.core.ParsingException;
 import org.elasticsearch.xpack.esql.core.QlIllegalArgumentException;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.function.scalar.ScalarFunction;
@@ -19,6 +18,7 @@
 import org.elasticsearch.xpack.esql.core.tree.SourceTests;
 import org.elasticsearch.xpack.esql.core.type.DataType;
 import org.elasticsearch.xpack.esql.expression.function.scalar.EsqlConfigurationFunction;
+import org.elasticsearch.xpack.esql.parser.ParsingException;
 import org.elasticsearch.xpack.esql.session.Configuration;
 
 import java.io.IOException;
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/AbstractFulltextSerializationTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/AbstractFulltextSerializationTests.java
similarity index 88%
rename from x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/AbstractFulltextSerializationTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/AbstractFulltextSerializationTests.java
index 370cfaf67fe0f..abd46f4b2b1aa 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/AbstractFulltextSerializationTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/AbstractFulltextSerializationTests.java
@@ -5,9 +5,8 @@
  * 2.0.
  */
 
-package org.elasticsearch.xpack.esql.expression.predicate.operator.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.FullTextPredicate;
 import org.elasticsearch.xpack.esql.expression.AbstractExpressionSerializationTests;
 
 import java.util.HashMap;
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextUtilsTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextUtilsTests.java
similarity index 79%
rename from x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextUtilsTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextUtilsTests.java
index c6358b4682a79..46bafe5ebae9c 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/predicate/fulltext/FullTextUtilsTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/FullTextUtilsTests.java
@@ -4,11 +4,11 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.expression.predicate.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.esql.core.ParsingException;
 import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.parser.ParsingException;
 
 import java.util.Map;
 
@@ -28,15 +28,15 @@ public void testColonDelimited() {
 
     public void testColonDelimitedErrorString() {
         ParsingException e = expectThrows(ParsingException.class, () -> FullTextUtils.parseSettings("k1=v1;k2v2", source));
-        assertThat(e.getMessage(), is("line 1:3: Cannot parse entry k2v2 in options k1=v1;k2v2"));
+        assertThat(e.getMessage(), is("line 1:2: Cannot parse entry k2v2 in options k1=v1;k2v2"));
         assertThat(e.getLineNumber(), is(1));
-        assertThat(e.getColumnNumber(), is(3));
+        assertThat(e.getColumnNumber(), is(2));
     }
 
     public void testColonDelimitedErrorDuplicate() {
         ParsingException e = expectThrows(ParsingException.class, () -> FullTextUtils.parseSettings("k1=v1;k1=v2", source));
-        assertThat(e.getMessage(), is("line 1:3: Duplicate option k1=v2 detected in options k1=v1;k1=v2"));
+        assertThat(e.getMessage(), is("line 1:2: Duplicate option k1=v2 detected in options k1=v1;k1=v2"));
         assertThat(e.getLineNumber(), is(1));
-        assertThat(e.getColumnNumber(), is(3));
+        assertThat(e.getColumnNumber(), is(2));
     }
 }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/MatchQuerySerializationTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MatchQuerySerializationTests.java
similarity index 89%
rename from x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/MatchQuerySerializationTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MatchQuerySerializationTests.java
index 80a538cf84baa..7781c804a6dfc 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/MatchQuerySerializationTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MatchQuerySerializationTests.java
@@ -5,9 +5,8 @@
  * 2.0.
  */
 
-package org.elasticsearch.xpack.esql.expression.predicate.operator.fulltext;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MatchQueryPredicate;
 import org.elasticsearch.xpack.esql.expression.AbstractExpressionSerializationTests;
 
 import java.io.IOException;
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/MultiMatchQuerySerializationTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MultiMatchQuerySerializationTests.java
similarity index 92%
rename from x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/MultiMatchQuerySerializationTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MultiMatchQuerySerializationTests.java
index d4d0f2edc11b1..17843e24a8663 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/fulltext/MultiMatchQuerySerializationTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/fulltext/MultiMatchQuerySerializationTests.java
@@ -5,9 +5,7 @@
  * 2.0.
  */
 
-package org.elasticsearch.xpack.esql.expression.predicate.operator.fulltext;
-
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MultiMatchQueryPredicate;
+package org.elasticsearch.xpack.esql.expression.predicate.fulltext;
 
 import java.io.IOException;
 import java.util.HashMap;
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/BoolQueryTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/BoolQueryTests.java
similarity index 92%
rename from x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/BoolQueryTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/BoolQueryTests.java
index 1c9d6bc54aebf..1aa5d47ed07ea 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/BoolQueryTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/BoolQueryTests.java
@@ -4,9 +4,13 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.querydsl.query;
+package org.elasticsearch.xpack.esql.querydsl.query;
 
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.esql.core.querydsl.query.BoolQuery;
+import org.elasticsearch.xpack.esql.core.querydsl.query.ExistsQuery;
+import org.elasticsearch.xpack.esql.core.querydsl.query.NotQuery;
+import org.elasticsearch.xpack.esql.core.querydsl.query.Query;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.tree.SourceTests;
 import org.elasticsearch.xpack.esql.core.util.StringUtils;
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/MatchQueryTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/MatchQueryTests.java
similarity index 96%
rename from x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/MatchQueryTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/MatchQueryTests.java
index 4316bd21ffe94..49d1a9ad19d09 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/MatchQueryTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/MatchQueryTests.java
@@ -4,17 +4,17 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.querydsl.query;
+package org.elasticsearch.xpack.esql.querydsl.query;
 
 import org.elasticsearch.index.query.MatchQueryBuilder;
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MatchQueryPredicate;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.tree.SourceTests;
 import org.elasticsearch.xpack.esql.core.type.EsField;
 import org.elasticsearch.xpack.esql.core.util.StringUtils;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.MatchQueryPredicate;
 
 import java.util.Arrays;
 import java.util.List;
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/MultiMatchQueryTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/MultiMatchQueryTests.java
similarity index 94%
rename from x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/MultiMatchQueryTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/MultiMatchQueryTests.java
index 9ca9765ed0542..93c285f5e3ab0 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/MultiMatchQueryTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/MultiMatchQueryTests.java
@@ -4,14 +4,14 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.querydsl.query;
+package org.elasticsearch.xpack.esql.querydsl.query;
 
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.index.query.MultiMatchQueryBuilder;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.MultiMatchQueryPredicate;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.util.StringUtils;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.MultiMatchQueryPredicate;
 
 import java.util.HashMap;
 import java.util.Map;
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/QueryStringQueryTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/QueryStringQueryTests.java
similarity index 94%
rename from x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/QueryStringQueryTests.java
rename to x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/QueryStringQueryTests.java
index 22e7b93e84ce1..3114b852aac70 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/querydsl/query/QueryStringQueryTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/querydsl/query/QueryStringQueryTests.java
@@ -4,12 +4,13 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-package org.elasticsearch.xpack.esql.core.querydsl.query;
+package org.elasticsearch.xpack.esql.querydsl.query;
 
 import org.elasticsearch.ElasticsearchParseException;
 import org.elasticsearch.index.query.Operator;
 import org.elasticsearch.index.query.QueryStringQueryBuilder;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.esql.core.querydsl.query.QueryStringQuery;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.util.StringUtils;
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/tree/EsqlNodeSubclassTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/tree/EsqlNodeSubclassTests.java
index c1d94933537f0..f01a125bc3c23 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/tree/EsqlNodeSubclassTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/tree/EsqlNodeSubclassTests.java
@@ -25,7 +25,6 @@
 import org.elasticsearch.xpack.esql.core.expression.UnresolvedAttributeTests;
 import org.elasticsearch.xpack.esql.core.expression.UnresolvedNamedExpression;
 import org.elasticsearch.xpack.esql.core.expression.function.Function;
-import org.elasticsearch.xpack.esql.core.expression.predicate.fulltext.FullTextPredicate;
 import org.elasticsearch.xpack.esql.core.tree.AbstractNodeTestCase;
 import org.elasticsearch.xpack.esql.core.tree.Node;
 import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
@@ -40,6 +39,7 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.ip.CIDRMatch;
 import org.elasticsearch.xpack.esql.expression.function.scalar.math.Pow;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Concat;
+import org.elasticsearch.xpack.esql.expression.predicate.fulltext.FullTextPredicate;
 import org.elasticsearch.xpack.esql.plan.logical.Dissect;
 import org.elasticsearch.xpack.esql.plan.logical.Grok;
 import org.elasticsearch.xpack.esql.plan.logical.LogicalPlan;

From ce7a0c86fb975f76dfbea5eff1cf51602dbed184 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Tue, 17 Dec 2024 17:34:22 +1100
Subject: [PATCH 022/119] Mute
 org.elasticsearch.xpack.esql.session.IndexResolverFieldNamesTests
 org.elasticsearch.xpack.esql.session.IndexResolverFieldNamesTests #118814

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index b43045d24be81..da52d585267a5 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -305,6 +305,8 @@ tests:
 - class: org.elasticsearch.xpack.security.QueryableReservedRolesIT
   method: testDeletingAndCreatingSecurityIndexTriggersSynchronization
   issue: https://github.com/elastic/elasticsearch/issues/118806
+- class: org.elasticsearch.xpack.esql.session.IndexResolverFieldNamesTests
+  issue: https://github.com/elastic/elasticsearch/issues/118814
 
 # Examples:
 #

From d09d57db802ecba45195abfd1b38c12818bbe537 Mon Sep 17 00:00:00 2001
From: Carlos Delgado <6339205+carlosdelest@users.noreply.github.com>
Date: Tue, 17 Dec 2024 09:14:50 +0100
Subject: [PATCH 023/119] Fix BwC  synonyms tests (#118691)

---
 muted-tests.yml                               |  3 --
 rest-api-spec/build.gradle                    |  1 +
 .../90_synonyms_reloading_for_synset.yml      | 33 +++++++++++++++----
 3 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index da52d585267a5..fe6c77bdf9f93 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -156,9 +156,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/117473
 - class: org.elasticsearch.repositories.s3.RepositoryS3EcsClientYamlTestSuiteIT
   issue: https://github.com/elastic/elasticsearch/issues/117525
-- class: org.elasticsearch.backwards.MixedClusterClientYamlTestSuiteIT
-  method: test {p0=synonyms/90_synonyms_reloading_for_synset/Reload analyzers for specific synonym set}
-  issue: https://github.com/elastic/elasticsearch/issues/116777
 - class: "org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT"
   method: "test {scoring.*}"
   issue: https://github.com/elastic/elasticsearch/issues/117641
diff --git a/rest-api-spec/build.gradle b/rest-api-spec/build.gradle
index 7347d9c1312dd..bdee32e596c4c 100644
--- a/rest-api-spec/build.gradle
+++ b/rest-api-spec/build.gradle
@@ -69,4 +69,5 @@ tasks.named("yamlRestCompatTestTransform").configure ({ task ->
   task.skipTest("search/520_fetch_fields/fetch _seq_no via fields", "error code is changed from 5xx to 400 in 9.0")
   task.skipTest("search.vectors/41_knn_search_bbq_hnsw/Test knn search", "Scoring has changed in latest versions")
   task.skipTest("search.vectors/42_knn_search_bbq_flat/Test knn search", "Scoring has changed in latest versions")
+  task.skipTest("synonyms/90_synonyms_reloading_for_synset/Reload analyzers for specific synonym set", "Can't work until auto-expand replicas is 0-1 for synonyms index")
 })
diff --git a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/synonyms/90_synonyms_reloading_for_synset.yml b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/synonyms/90_synonyms_reloading_for_synset.yml
index d6c98673253fb..4e6bd83f07955 100644
--- a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/synonyms/90_synonyms_reloading_for_synset.yml
+++ b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/synonyms/90_synonyms_reloading_for_synset.yml
@@ -1,8 +1,8 @@
----
-"Reload analyzers for specific synonym set":
+setup:
   - requires:
       cluster_features: ["gte_v8.10.0"]
       reason: Reloading analyzers for specific synonym set is introduced in 8.10.0
+
   # Create synonyms_set1
   - do:
       synonyms.put_synonym:
@@ -100,7 +100,12 @@
           - '{"index": {"_index": "my_index2", "_id": "2"}}'
           - '{"my_field": "goodbye"}'
 
-  # An update of synonyms_set1 must trigger auto-reloading of analyzers only for synonyms_set1
+---
+"Reload analyzers for specific synonym set":
+# These specific tests can't succeed in BwC, as synonyms auto-expand replicas are 0-all. Replicas can't be associated to
+#  upgraded nodes, and thus we are not able to guarantee that the shards are not failed.
+# This test is skipped for BwC until synonyms index has auto-exapnd replicas set to 0-1.
+
   - do:
       synonyms.put_synonym:
         id: synonyms_set1
@@ -108,13 +113,12 @@
           synonyms_set:
             - synonyms: "hello, salute"
             - synonyms: "ciao => goodbye"
+
   - match: { result: "updated" }
   - gt: { reload_analyzers_details._shards.total: 0 }
   - gt: { reload_analyzers_details._shards.successful: 0 }
   - match: { reload_analyzers_details._shards.failed: 0 }
-  - length: { reload_analyzers_details.reload_details: 1 } # reload details contain only a single index
-  - match: { reload_analyzers_details.reload_details.0.index: "my_index1" }
-  - match: { reload_analyzers_details.reload_details.0.reloaded_analyzers.0: "my_analyzer1" }
+
 
   # Confirm that the index analyzers are reloaded for my_index1
   - do:
@@ -127,6 +131,23 @@
                 query: salute
   - match: { hits.total.value: 1 }
 
+---
+"Check analyzer reloaded and non failed shards for bwc tests":
+
+  - do:
+      synonyms.put_synonym:
+        id: synonyms_set1
+        body:
+          synonyms_set:
+            - synonyms: "hello, salute"
+            - synonyms: "ciao => goodbye"
+  - match: { result: "updated" }
+  - gt: { reload_analyzers_details._shards.total: 0 }
+  - gt: { reload_analyzers_details._shards.successful: 0 }
+  - length: { reload_analyzers_details.reload_details: 1 } # reload details contain only a single index
+  - match: { reload_analyzers_details.reload_details.0.index: "my_index1" }
+  - match: { reload_analyzers_details.reload_details.0.reloaded_analyzers.0: "my_analyzer1" }
+
   # Confirm that the index analyzers are still the same for my_index2
   - do:
       search:

From 87c9d13ed52668fb22e2c5da07744516aa84bf09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Slobodan=20Adamovi=C4=87?=
 <slobodanadamovic@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:49:25 +0100
Subject: [PATCH 024/119] Mark Query Role API as public in seerverless
 (#118798)

This commit makes Query Role API available in Serverless.
---
 .../xpack/security/rest/action/role/RestQueryRoleAction.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java
index 3637159479463..862ff2552b4e3 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/rest/action/role/RestQueryRoleAction.java
@@ -34,7 +34,7 @@
 import static org.elasticsearch.rest.RestRequest.Method.POST;
 import static org.elasticsearch.xcontent.ConstructingObjectParser.optionalConstructorArg;
 
-@ServerlessScope(Scope.INTERNAL)
+@ServerlessScope(Scope.PUBLIC)
 public final class RestQueryRoleAction extends NativeRoleBaseRestHandler {
 
     @SuppressWarnings("unchecked")

From 8793248d6d5dd1135327d938ae7a69e91c0eed00 Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Tue, 17 Dec 2024 11:22:20 +0100
Subject: [PATCH 025/119] Remove unused code from PercolateQueryBuilder
 (#118791)

---
 .../percolator/PercolateQueryBuilder.java          | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/modules/percolator/src/main/java/org/elasticsearch/percolator/PercolateQueryBuilder.java b/modules/percolator/src/main/java/org/elasticsearch/percolator/PercolateQueryBuilder.java
index 85af5b120f6fd..c150f01153d35 100644
--- a/modules/percolator/src/main/java/org/elasticsearch/percolator/PercolateQueryBuilder.java
+++ b/modules/percolator/src/main/java/org/elasticsearch/percolator/PercolateQueryBuilder.java
@@ -43,7 +43,6 @@
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.index.IndexVersion;
@@ -80,7 +79,6 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Objects;
-import java.util.function.BiConsumer;
 import java.util.function.Supplier;
 
 import static org.elasticsearch.search.SearchService.ALLOW_EXPENSIVE_QUERIES;
@@ -88,20 +86,12 @@
 import static org.elasticsearch.xcontent.ConstructingObjectParser.optionalConstructorArg;
 
 public class PercolateQueryBuilder extends AbstractQueryBuilder<PercolateQueryBuilder> {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(ParseField.class);
-    static final String DOCUMENT_TYPE_DEPRECATION_MESSAGE = "[types removal] Types are deprecated in [percolate] queries. "
-        + "The [document_type] should no longer be specified.";
-    static final String TYPE_DEPRECATION_MESSAGE = "[types removal] Types are deprecated in [percolate] queries. "
-        + "The [type] of the indexed document should no longer be specified.";
-
     public static final String NAME = "percolate";
 
     static final ParseField DOCUMENT_FIELD = new ParseField("document");
     static final ParseField DOCUMENTS_FIELD = new ParseField("documents");
     private static final ParseField NAME_FIELD = new ParseField("name");
     private static final ParseField QUERY_FIELD = new ParseField("field");
-    private static final ParseField DOCUMENT_TYPE_FIELD = new ParseField("document_type");
-    private static final ParseField INDEXED_DOCUMENT_FIELD_TYPE = new ParseField("type");
     private static final ParseField INDEXED_DOCUMENT_FIELD_INDEX = new ParseField("index");
     private static final ParseField INDEXED_DOCUMENT_FIELD_ID = new ParseField("id");
     private static final ParseField INDEXED_DOCUMENT_FIELD_ROUTING = new ParseField("routing");
@@ -368,10 +358,6 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
         );
     }
 
-    private static BiConsumer<PercolateQueryBuilder, String> deprecateAndIgnoreType(String key, String message) {
-        return (target, type) -> deprecationLogger.compatibleCritical(key, message);
-    }
-
     private static BytesReference parseDocument(XContentParser parser) throws IOException {
         try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
             builder.copyCurrentStructure(parser);

From 8134c79ce8a11b26ee26d88ad7975c91a127af98 Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Tue, 17 Dec 2024 13:05:20 +0100
Subject: [PATCH 026/119] ESQL: Skip lookup fields when eliminating missing
 fields (#118658)

We do not have SearchStats for fields from lookup indices. And unfortunately, these are hard to obtain.

For now, just do not apply ReplaceMissingFieldWithNull to fields coming from an index used in LOOKUP JOIN. These are identified via their indexmode.
---
 .../esql/qa/mixed/MixedClusterEsqlSpecIT.java |   4 +-
 .../xpack/esql/ccq/MultiClusterSpecIT.java    |   8 +-
 .../rest/RequestIndexFilteringTestCase.java   |   2 +-
 .../src/main/resources/lookup-join.csv-spec   | 212 ++++++++++++------
 .../xpack/esql/action/EsqlCapabilities.java   |   2 +-
 .../local/ReplaceMissingFieldWithNull.java    |  15 +-
 .../elasticsearch/xpack/esql/CsvTests.java    |   2 +-
 .../xpack/esql/analysis/AnalyzerTests.java    |   4 +-
 .../xpack/esql/analysis/VerifierTests.java    |   2 +-
 .../optimizer/LogicalPlanOptimizerTests.java  |  12 +-
 .../optimizer/PhysicalPlanOptimizerTests.java |   2 +-
 11 files changed, 180 insertions(+), 85 deletions(-)

diff --git a/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java b/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
index 5efe7ffc800a2..004beaafb4009 100644
--- a/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
+++ b/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
@@ -21,7 +21,7 @@
 import java.util.List;
 
 import static org.elasticsearch.xpack.esql.CsvTestUtils.isEnabled;
-import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V6;
+import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V7;
 import static org.elasticsearch.xpack.esql.qa.rest.EsqlSpecTestCase.Mode.ASYNC;
 
 public class MixedClusterEsqlSpecIT extends EsqlSpecTestCase {
@@ -96,7 +96,7 @@ protected boolean supportsInferenceTestService() {
 
     @Override
     protected boolean supportsIndexModeLookup() throws IOException {
-        return hasCapabilities(List.of(JOIN_LOOKUP_V6.capabilityName()));
+        return hasCapabilities(List.of(JOIN_LOOKUP_V7.capabilityName()));
     }
 
     @Override
diff --git a/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java b/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
index dd75776973c3d..c75a920e16973 100644
--- a/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
+++ b/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
@@ -48,7 +48,7 @@
 import static org.elasticsearch.xpack.esql.EsqlTestUtils.classpathResources;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.INLINESTATS;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.INLINESTATS_V2;
-import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V6;
+import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V7;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_PLANNING_V1;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.METADATA_FIELDS_REMOTE_TEST;
 import static org.elasticsearch.xpack.esql.qa.rest.EsqlSpecTestCase.Mode.SYNC;
@@ -124,7 +124,7 @@ protected void shouldSkipTest(String testName) throws IOException {
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(INLINESTATS.capabilityName()));
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(INLINESTATS_V2.capabilityName()));
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_PLANNING_V1.capabilityName()));
-        assumeFalse("LOOKUP JOIN not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_LOOKUP_V6.capabilityName()));
+        assumeFalse("LOOKUP JOIN not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_LOOKUP_V7.capabilityName()));
     }
 
     private TestFeatureService remoteFeaturesService() throws IOException {
@@ -283,8 +283,8 @@ protected boolean supportsInferenceTestService() {
 
     @Override
     protected boolean supportsIndexModeLookup() throws IOException {
-        // CCS does not yet support JOIN_LOOKUP_V6 and clusters falsely report they have this capability
-        // return hasCapabilities(List.of(JOIN_LOOKUP_V6.capabilityName()));
+        // CCS does not yet support JOIN_LOOKUP_V7 and clusters falsely report they have this capability
+        // return hasCapabilities(List.of(JOIN_LOOKUP_V7.capabilityName()));
         return false;
     }
 }
diff --git a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
index 2aae4c94c33fe..40027249670f6 100644
--- a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
+++ b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
@@ -221,7 +221,7 @@ public void testIndicesDontExist() throws IOException {
         assertThat(e.getMessage(), containsString("index_not_found_exception"));
         assertThat(e.getMessage(), containsString("no such index [foo]"));
 
-        if (EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled()) {
+        if (EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled()) {
             e = expectThrows(
                 ResponseException.class,
                 () -> runEsql(timestampFilter("gte", "2020-01-01").query("FROM test1 | LOOKUP JOIN foo ON id1"))
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index 8b8d24b1bb156..8bcc2c2ff3502 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -8,7 +8,7 @@
 ###############################################
 
 basicOnTheDataNode
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | EVAL language_code = languages
@@ -25,7 +25,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 basicRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW language_code = 1
 | LOOKUP JOIN languages_lookup ON language_code
@@ -36,7 +36,7 @@ language_code:integer  | language_name:keyword
 ;
 
 basicOnTheCoordinator
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | SORT emp_no
@@ -53,7 +53,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 subsequentEvalOnTheDataNode
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | EVAL language_code = languages
@@ -71,7 +71,7 @@ emp_no:integer | language_code:integer | language_name:keyword | language_code_x
 ;
 
 subsequentEvalOnTheCoordinator
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | SORT emp_no
@@ -89,7 +89,7 @@ emp_no:integer | language_code:integer | language_name:keyword | language_code_x
 ;
 
 sortEvalBeforeLookup
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | SORT emp_no
@@ -106,7 +106,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 nonUniqueLeftKeyOnTheDataNode
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | WHERE emp_no <= 10030
@@ -130,7 +130,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 nonUniqueRightKeyOnTheDataNode
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | EVAL language_code = emp_no % 10
@@ -150,7 +150,7 @@ emp_no:integer | language_code:integer | language_name:keyword       | country:k
 ;
 
 nonUniqueRightKeyOnTheCoordinator
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | SORT emp_no
@@ -170,7 +170,7 @@ emp_no:integer | language_code:integer | language_name:keyword       | country:k
 ;
 
 nonUniqueRightKeyFromRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW language_code = 2
 | LOOKUP JOIN languages_lookup_non_unique_key ON language_code
@@ -186,8 +186,8 @@ language_code:integer | language_name:keyword       | country:keyword
 # Filtering tests with languages_lookup index
 ###############################################
 
-lookupWithFilterOnLeftSideField
-required_capability: join_lookup_v6
+filterOnLeftSide
+required_capability: join_lookup_v7
 
 FROM employees
 | EVAL language_code = languages
@@ -203,8 +203,8 @@ emp_no:integer | language_code:integer | language_name:keyword
 10093          | 3                     | Spanish
 ;
 
-lookupMessageWithFilterOnRightSideField-Ignore
-required_capability: join_lookup_v6
+filterOnRightSide
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -219,8 +219,8 @@ FROM sample_data
 2023-10-23T13:51:54.732Z | 172.21.3.15  | 725448              | Connection error      | Error
 ;
 
-lookupWithFieldAndRightSideAfterStats
-required_capability: join_lookup_v6
+filterOnRightSideAfterStats
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -232,23 +232,110 @@ count:long | type:keyword
 3          | Error
 ;
 
-lookupWithFieldOnJoinKey-Ignore
-required_capability: join_lookup_v6
+filterOnJoinKey
+required_capability: join_lookup_v7
 
 FROM employees
 | EVAL language_code = languages
+| WHERE emp_no >= 10091 AND emp_no < 10094
+| LOOKUP JOIN languages_lookup ON language_code
+| WHERE language_code == 1
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10092          | 1                     | English
+;
+
+filterOnJoinKeyAndRightSide
+required_capability: join_lookup_v7
+
+FROM employees
+| WHERE emp_no < 10006
+| EVAL language_code = languages
 | LOOKUP JOIN languages_lookup ON language_code
 | WHERE language_code > 1 AND language_name IS NOT NULL
 | KEEP emp_no, language_code, language_name
 ;
+ignoreOrder:true
 
 emp_no:integer | language_code:integer | language_name:keyword
 10001          | 2                     | French
 10003          | 4                     | German
 ;
 
+filterOnRightSideOnTheCoordinator
+required_capability: join_lookup_v7
+
+FROM employees
+| SORT emp_no
+| LIMIT 5
+| EVAL language_code = languages
+| LOOKUP JOIN languages_lookup ON language_code
+| WHERE language_name == "English"
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10005          | 1                     | English
+;
+
+filterOnJoinKeyOnTheCoordinator
+required_capability: join_lookup_v7
+
+FROM employees
+| SORT emp_no
+| LIMIT 5
+| EVAL language_code = languages
+| LOOKUP JOIN languages_lookup ON language_code
+| WHERE language_code == 1
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10005          | 1                     | English
+;
+
+filterOnJoinKeyAndRightSideOnTheCoordinator
+required_capability: join_lookup_v7
+
+FROM employees
+| SORT emp_no
+| LIMIT 5
+| EVAL language_code = languages
+| LOOKUP JOIN languages_lookup ON language_code
+| WHERE language_code > 1 AND language_name IS NOT NULL
+| KEEP emp_no, language_code, language_name
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10001          | 2                     | French
+10003          | 4                     | German
+;
+
+filterOnTheDataNodeThenFilterOnTheCoordinator
+required_capability: join_lookup_v7
+
+FROM employees
+| EVAL language_code = languages
+| WHERE emp_no >= 10091 AND emp_no < 10094
+| LOOKUP JOIN languages_lookup ON language_code
+| WHERE language_name == "English"
+| KEEP emp_no, language_code, language_name
+| SORT emp_no
+| WHERE language_code == 1
+;
+
+emp_no:integer | language_code:integer | language_name:keyword
+10092          | 1                     | English
+;
+
+###########################################################################
+# null and multi-value behavior with languages_lookup_non_unique_key index
+###########################################################################
+
 nullJoinKeyOnTheDataNode
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | WHERE emp_no < 10004
@@ -264,9 +351,8 @@ emp_no:integer | language_code:integer | language_name:keyword
 10003          | null                  | null
 ;
 
-
 mvJoinKeyOnTheDataNode
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM employees
 | WHERE 10003 < emp_no AND emp_no < 10008
@@ -284,7 +370,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 mvJoinKeyFromRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW language_code = [4, 5, 6, 7]
 | LOOKUP JOIN languages_lookup_non_unique_key ON language_code
@@ -297,7 +383,7 @@ language_code:integer | language_name:keyword       | country:keyword
 ;
 
 mvJoinKeyFromRowExpanded
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW language_code = [4, 5, 6, 7, 8]
 | MV_EXPAND language_code
@@ -319,7 +405,7 @@ language_code:integer | language_name:keyword       | country:keyword
 ###############################################
 
 lookupIPFromRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -330,7 +416,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromKeepRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", right = "right"
 | KEEP left, client_ip, right
@@ -342,7 +428,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowing
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -353,7 +439,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowingKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -366,7 +452,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowingKeepReordered
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -379,7 +465,7 @@ right         | Development | 172.21.0.5
 ;
 
 lookupIPFromIndex
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -398,7 +484,7 @@ ignoreOrder:true
 ;
 
 lookupIPFromIndexKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -418,7 +504,7 @@ ignoreOrder:true
 ;
 
 lookupIPFromIndexKeepKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | KEEP client_ip, event_duration, @timestamp, message
@@ -440,7 +526,7 @@ timestamp:date           | client_ip:keyword | event_duration:long | msg:keyword
 ;
 
 lookupIPFromIndexStats
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -456,7 +542,7 @@ count:long | env:keyword
 ;
 
 lookupIPFromIndexStatsKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -473,7 +559,7 @@ count:long | env:keyword
 ;
 
 statsAndLookupIPFromIndex
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -494,7 +580,7 @@ count:long | client_ip:keyword | env:keyword
 ###############################################
 
 lookupMessageFromRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -505,7 +591,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromKeepRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", message = "Connected to 10.1.0.1", right = "right"
 | KEEP left, message, right
@@ -517,7 +603,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromRowWithShadowing
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", message = "Connected to 10.1.0.1", type = "unknown", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -528,7 +614,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromRowWithShadowingKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", message = "Connected to 10.1.0.1", type = "unknown", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -540,7 +626,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromIndex
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -558,7 +644,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -577,7 +663,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeepKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | KEEP client_ip, event_duration, @timestamp, message
@@ -597,7 +683,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeepReordered
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -616,7 +702,7 @@ Success      | 172.21.2.162 | 3450233             | Connected to 10.1.0.3
 ;
 
 lookupMessageFromIndexStats
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -631,7 +717,7 @@ count:long | type:keyword
 ;
 
 lookupMessageFromIndexStatsKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -647,7 +733,7 @@ count:long | type:keyword
 ;
 
 statsAndLookupMessageFromIndex
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | STATS count = count(message) BY message
@@ -665,7 +751,7 @@ count:long | type:keyword | message:keyword
 ;
 
 lookupMessageFromIndexTwice
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -687,7 +773,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexTwiceKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -714,7 +800,7 @@ ignoreOrder:true
 ###############################################
 
 lookupIPAndMessageFromRow
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -726,7 +812,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowKeepBefore
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | KEEP left, client_ip, message, right
@@ -739,7 +825,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowKeepBetween
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -752,7 +838,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowKeepAfter
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -765,7 +851,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowing
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", type = "type", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -777,7 +863,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -791,7 +877,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeepKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -806,7 +892,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeepKeepKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -822,7 +908,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeepReordered
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -836,7 +922,7 @@ right         | Development  | Success      | 172.21.0.5
 ;
 
 lookupIPAndMessageFromIndex
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -856,7 +942,7 @@ ignoreOrder:true
 ;
 
 lookupIPAndMessageFromIndexKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -877,7 +963,7 @@ ignoreOrder:true
 ;
 
 lookupIPAndMessageFromIndexStats
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -895,7 +981,7 @@ count:long | env:keyword | type:keyword
 ;
 
 lookupIPAndMessageFromIndexStatsKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -914,7 +1000,7 @@ count:long | env:keyword | type:keyword
 ;
 
 statsAndLookupIPAndMessageFromIndex
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -933,7 +1019,7 @@ count:long | client_ip:keyword | message:keyword       | env:keyword | type:keyw
 ;
 
 lookupIPAndMessageFromIndexChainedEvalKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -955,7 +1041,7 @@ ignoreOrder:true
 ;
 
 lookupIPAndMessageFromIndexChainedRenameKeep
-required_capability: join_lookup_v6
+required_capability: join_lookup_v7
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index 235d0dcbe4164..4fcabb02b2d4f 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -547,7 +547,7 @@ public enum Cap {
         /**
          * LOOKUP JOIN
          */
-        JOIN_LOOKUP_V6(Build.current().isSnapshot()),
+        JOIN_LOOKUP_V7(Build.current().isSnapshot()),
 
         /**
          * Fix for https://github.com/elastic/elasticsearch/issues/117054
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/local/ReplaceMissingFieldWithNull.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/local/ReplaceMissingFieldWithNull.java
index 096f72f7694e1..f9d86ecf0f61a 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/local/ReplaceMissingFieldWithNull.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/local/ReplaceMissingFieldWithNull.java
@@ -8,6 +8,7 @@
 package org.elasticsearch.xpack.esql.optimizer.rules.logical.local;
 
 import org.elasticsearch.common.util.Maps;
+import org.elasticsearch.index.IndexMode;
 import org.elasticsearch.xpack.esql.core.expression.Alias;
 import org.elasticsearch.xpack.esql.core.expression.AttributeSet;
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
@@ -41,10 +42,17 @@ public class ReplaceMissingFieldWithNull extends ParameterizedRule<LogicalPlan,
 
     @Override
     public LogicalPlan apply(LogicalPlan plan, LocalLogicalOptimizerContext localLogicalOptimizerContext) {
-        return plan.transformUp(p -> missingToNull(p, localLogicalOptimizerContext.searchStats()));
+        AttributeSet lookupFields = new AttributeSet();
+        plan.forEachUp(EsRelation.class, esRelation -> {
+            if (esRelation.indexMode() == IndexMode.LOOKUP) {
+                lookupFields.addAll(esRelation.output());
+            }
+        });
+
+        return plan.transformUp(p -> missingToNull(p, localLogicalOptimizerContext.searchStats(), lookupFields));
     }
 
-    private LogicalPlan missingToNull(LogicalPlan plan, SearchStats stats) {
+    private LogicalPlan missingToNull(LogicalPlan plan, SearchStats stats, AttributeSet lookupFields) {
         if (plan instanceof EsRelation || plan instanceof LocalRelation) {
             return plan;
         }
@@ -95,7 +103,8 @@ else if (plan instanceof Project project) {
                 plan = plan.transformExpressionsOnlyUp(
                     FieldAttribute.class,
                     // Do not use the attribute name, this can deviate from the field name for union types.
-                    f -> stats.exists(f.fieldName()) ? f : Literal.of(f, null)
+                    // Also skip fields from lookup indices because we do not have stats for these.
+                    f -> stats.exists(f.fieldName()) || lookupFields.contains(f) ? f : Literal.of(f, null)
                 );
             }
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index f553c15ef69fa..717ac7b5a62a7 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -263,7 +263,7 @@ public final void test() throws Throwable {
             );
             assumeFalse(
                 "lookup join disabled for csv tests",
-                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V6.capabilityName())
+                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V7.capabilityName())
             );
             assumeFalse(
                 "can't use TERM function in csv tests",
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
index 4e02119b31744..9c71f20dcde0e 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
@@ -2139,7 +2139,7 @@ public void testLookupMatchTypeWrong() {
     }
 
     public void testLookupJoinUnknownIndex() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String errorMessage = "Unknown index [foobar]";
         IndexResolution missingLookupIndex = IndexResolution.invalid(errorMessage);
@@ -2168,7 +2168,7 @@ public void testLookupJoinUnknownIndex() {
     }
 
     public void testLookupJoinUnknownField() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String query = "FROM test | LOOKUP JOIN languages_lookup ON last_name";
         String errorMessage = "1:45: Unknown column [last_name] in right side of join";
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
index 58180aafedc0b..182e87d1ab9dd 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
@@ -1964,7 +1964,7 @@ public void testSortByAggregate() {
     }
 
     public void testLookupJoinDataTypeMismatch() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         query("FROM test | EVAL language_code = languages | LOOKUP JOIN languages_lookup ON language_code");
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
index c4d7b30115c2d..cfb993a7dd73d 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
@@ -4906,7 +4906,7 @@ public void testPlanSanityCheck() throws Exception {
     }
 
     public void testPlanSanityCheckWithBinaryPlans() throws Exception {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         var plan = optimizedPlan("""
               FROM test
@@ -5911,7 +5911,7 @@ public void testLookupStats() {
      *     \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownFilterOnJoinKeyWithRename() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String query = """
               FROM test
@@ -5954,7 +5954,7 @@ public void testLookupJoinPushDownFilterOnJoinKeyWithRename() {
      *     \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownFilterOnLeftSideField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String query = """
               FROM test
@@ -5998,7 +5998,7 @@ public void testLookupJoinPushDownFilterOnLeftSideField() {
      *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownDisabledForLookupField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String query = """
               FROM test
@@ -6043,7 +6043,7 @@ public void testLookupJoinPushDownDisabledForLookupField() {
      *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#19, language_name{f}#20]
      */
     public void testLookupJoinPushDownSeparatedForConjunctionBetweenLeftAndRightField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String query = """
               FROM test
@@ -6096,7 +6096,7 @@ public void testLookupJoinPushDownSeparatedForConjunctionBetweenLeftAndRightFiel
      *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#19, language_name{f}#20]
      */
     public void testLookupJoinPushDownDisabledForDisjunctionBetweenLeftAndRightField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         String query = """
               FROM test
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
index 9f6ef89008a24..964dd4642d7c2 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
@@ -2331,7 +2331,7 @@ public void testVerifierOnMissingReferences() {
     }
 
     public void testVerifierOnMissingReferencesWithBinaryPlans() throws Exception {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V6.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
 
         // Do not assert serialization:
         // This will have a LookupJoinExec, which is not serializable because it doesn't leave the coordinator.

From 6516a535ab487eabf02b7d65b7cbe928820a181b Mon Sep 17 00:00:00 2001
From: Rene Groeschke <rene@elastic.co>
Date: Tue, 17 Dec 2024 13:45:27 +0100
Subject: [PATCH 027/119] Add wolfi documentation from 8.16 branch (#118835)

port from https://github.com/elastic/elasticsearch/pull/118684
---
 docs/Versions.asciidoc                       | 1 +
 docs/reference/setup/install/docker.asciidoc | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/docs/Versions.asciidoc b/docs/Versions.asciidoc
index bdb0704fcd880..f2e61861bd3a6 100644
--- a/docs/Versions.asciidoc
+++ b/docs/Versions.asciidoc
@@ -9,6 +9,7 @@ include::{docs-root}/shared/versions/stack/{source_branch}.asciidoc[]
 
 :docker-repo:       docker.elastic.co/elasticsearch/elasticsearch
 :docker-image:      {docker-repo}:{version}
+:docker-wolfi-image: {docker-repo}-wolfi:{version}
 :kib-docker-repo:   docker.elastic.co/kibana/kibana
 :kib-docker-image:  {kib-docker-repo}:{version}
 :plugin_url:      https://artifacts.elastic.co/downloads/elasticsearch-plugins
diff --git a/docs/reference/setup/install/docker.asciidoc b/docs/reference/setup/install/docker.asciidoc
index 8694d7f5b46c6..86a0e567f6eec 100644
--- a/docs/reference/setup/install/docker.asciidoc
+++ b/docs/reference/setup/install/docker.asciidoc
@@ -55,6 +55,12 @@ docker pull {docker-image}
 // REVIEWED[DEC.10.24]
 --
 
+Alternatevely, you can use the Wolfi based image. Using Wolfi based images requires Docker version 20.10.10 or superior.
+[source,sh,subs="attributes"]
+----
+docker pull {docker-wolfi-image}
+----
+
 . Optional: Install
 https://docs.sigstore.dev/cosign/system_config/installation/[Cosign] for your
 environment. Then use Cosign to verify the {es} image's signature.

From f5712e4875122d9f5c451ac73225725179795929 Mon Sep 17 00:00:00 2001
From: Simon Cooper <simon.cooper@elastic.co>
Date: Tue, 17 Dec 2024 13:18:42 +0000
Subject: [PATCH 028/119] Infrastructure for assuming cluster features in the
 next major version (#118143)

Allow features to be marked as 'assumed', allowing them to be removed in the next major version.
---
 .../forbidden/es-server-signatures.txt        |   4 +-
 docs/changelog/118143.yaml                    |   5 +
 .../cluster/ClusterFeatures.java              |  56 ++++-
 .../coordination/NodeJoinExecutor.java        |  81 +++++-
 .../org/elasticsearch/env/BuildVersion.java   |   6 +
 .../env/DefaultBuildVersion.java              |  11 +
 .../features/FeatureService.java              |  23 +-
 .../elasticsearch/features/NodeFeature.java   |   9 +-
 .../readiness/ReadinessService.java           |   4 +-
 .../DataStreamAutoShardingServiceTests.java   |  29 ++-
 .../coordination/NodeJoinExecutorTests.java   | 232 +++++++++++++++++-
 .../features/FeatureServiceTests.java         |  41 ++++
 .../HealthNodeTaskExecutorTests.java          |   2 +-
 .../slm/SnapshotLifecycleServiceTests.java    |   3 +
 14 files changed, 464 insertions(+), 42 deletions(-)
 create mode 100644 docs/changelog/118143.yaml

diff --git a/build-tools-internal/src/main/resources/forbidden/es-server-signatures.txt b/build-tools-internal/src/main/resources/forbidden/es-server-signatures.txt
index a9da7995c2b36..53480a4a27b0b 100644
--- a/build-tools-internal/src/main/resources/forbidden/es-server-signatures.txt
+++ b/build-tools-internal/src/main/resources/forbidden/es-server-signatures.txt
@@ -155,10 +155,8 @@ org.elasticsearch.cluster.ClusterState#compatibilityVersions()
 
 @defaultMessage ClusterFeatures#nodeFeatures is for internal use only. Use FeatureService#clusterHasFeature to determine if a feature is present on the cluster.
 org.elasticsearch.cluster.ClusterFeatures#nodeFeatures()
-@defaultMessage ClusterFeatures#allNodeFeatures is for internal use only. Use FeatureService#clusterHasFeature to determine if a feature is present on the cluster.
-org.elasticsearch.cluster.ClusterFeatures#allNodeFeatures()
 @defaultMessage ClusterFeatures#clusterHasFeature is for internal use only. Use FeatureService#clusterHasFeature to determine if a feature is present on the cluster.
-org.elasticsearch.cluster.ClusterFeatures#clusterHasFeature(org.elasticsearch.features.NodeFeature)
+org.elasticsearch.cluster.ClusterFeatures#clusterHasFeature(org.elasticsearch.cluster.node.DiscoveryNodes, org.elasticsearch.features.NodeFeature)
 
 @defaultMessage Do not construct this records outside the source files they are declared in
 org.elasticsearch.cluster.SnapshotsInProgress$ShardSnapshotStatus#<init>(java.lang.String, org.elasticsearch.cluster.SnapshotsInProgress$ShardState, org.elasticsearch.repositories.ShardGeneration, java.lang.String, org.elasticsearch.repositories.ShardSnapshotResult)
diff --git a/docs/changelog/118143.yaml b/docs/changelog/118143.yaml
new file mode 100644
index 0000000000000..4dcbf4b4b6c2c
--- /dev/null
+++ b/docs/changelog/118143.yaml
@@ -0,0 +1,5 @@
+pr: 118143
+summary: Infrastructure for assuming cluster features in the next major version
+area: "Infra/Core"
+type: feature
+issues: []
diff --git a/server/src/main/java/org/elasticsearch/cluster/ClusterFeatures.java b/server/src/main/java/org/elasticsearch/cluster/ClusterFeatures.java
index ad285cbd391cd..5b5a6577082d7 100644
--- a/server/src/main/java/org/elasticsearch/cluster/ClusterFeatures.java
+++ b/server/src/main/java/org/elasticsearch/cluster/ClusterFeatures.java
@@ -9,11 +9,12 @@
 
 package org.elasticsearch.cluster;
 
+import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.xcontent.ChunkedToXContent;
 import org.elasticsearch.common.xcontent.ChunkedToXContentObject;
-import org.elasticsearch.core.SuppressForbidden;
 import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.xcontent.ToXContent;
 
@@ -79,28 +80,61 @@ public Map<String, Set<String>> nodeFeatures() {
         return nodeFeatures;
     }
 
-    /**
-     * The features in all nodes in the cluster.
-     * <p>
-     * NOTE: This should not be used directly.
-     * Please use {@link org.elasticsearch.features.FeatureService#clusterHasFeature} instead.
-     */
-    public Set<String> allNodeFeatures() {
+    private Set<String> allNodeFeatures() {
         if (allNodeFeatures == null) {
             allNodeFeatures = Set.copyOf(calculateAllNodeFeatures(nodeFeatures.values()));
         }
         return allNodeFeatures;
     }
 
+    /**
+     * Returns {@code true} if {@code node} can have assumed features.
+     * @see org.elasticsearch.env.BuildVersion#canRemoveAssumedFeatures
+     */
+    public static boolean featuresCanBeAssumedForNode(DiscoveryNode node) {
+        return node.getBuildVersion().canRemoveAssumedFeatures();
+    }
+
+    /**
+     * Returns {@code true} if one or more nodes in {@code nodes} can have assumed features.
+     * @see org.elasticsearch.env.BuildVersion#canRemoveAssumedFeatures
+     */
+    public static boolean featuresCanBeAssumedForNodes(DiscoveryNodes nodes) {
+        return nodes.getAllNodes().stream().anyMatch(n -> n.getBuildVersion().canRemoveAssumedFeatures());
+    }
+
     /**
      * {@code true} if {@code feature} is present on all nodes in the cluster.
      * <p>
      * NOTE: This should not be used directly.
      * Please use {@link org.elasticsearch.features.FeatureService#clusterHasFeature} instead.
      */
-    @SuppressForbidden(reason = "directly reading cluster features")
-    public boolean clusterHasFeature(NodeFeature feature) {
-        return allNodeFeatures().contains(feature.id());
+    public boolean clusterHasFeature(DiscoveryNodes nodes, NodeFeature feature) {
+        assert nodes.getNodes().keySet().equals(nodeFeatures.keySet())
+            : "Cluster features nodes " + nodeFeatures.keySet() + " is different to discovery nodes " + nodes.getNodes().keySet();
+
+        // basic case
+        boolean allNodesHaveFeature = allNodeFeatures().contains(feature.id());
+        if (allNodesHaveFeature) {
+            return true;
+        }
+
+        // if the feature is assumed, check the versions more closely
+        // it's actually ok if the feature is assumed, and all nodes missing the feature can assume it
+        // TODO: do we need some kind of transient cache of this calculation?
+        if (feature.assumedAfterNextCompatibilityBoundary()) {
+            for (var nf : nodeFeatures.entrySet()) {
+                if (nf.getValue().contains(feature.id()) == false
+                    && featuresCanBeAssumedForNode(nodes.getNodes().get(nf.getKey())) == false) {
+                    return false;
+                }
+            }
+
+            // all nodes missing the feature can assume it - so that's alright then
+            return true;
+        }
+
+        return false;
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/cluster/coordination/NodeJoinExecutor.java b/server/src/main/java/org/elasticsearch/cluster/coordination/NodeJoinExecutor.java
index 5235293a54d95..74a8dc7851c89 100644
--- a/server/src/main/java/org/elasticsearch/cluster/coordination/NodeJoinExecutor.java
+++ b/server/src/main/java/org/elasticsearch/cluster/coordination/NodeJoinExecutor.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.common.Priority;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.features.FeatureService;
+import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.index.IndexVersion;
 import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.persistent.PersistentTasksCustomMetadata;
@@ -39,6 +40,7 @@
 import java.util.Comparator;
 import java.util.HashMap;
 import java.util.HashSet;
+import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
@@ -137,8 +139,8 @@ public ClusterState execute(BatchExecutionContext<JoinTask> batchExecutionContex
 
         DiscoveryNodes.Builder nodesBuilder = DiscoveryNodes.builder(newState.nodes());
         Map<String, CompatibilityVersions> compatibilityVersionsMap = new HashMap<>(newState.compatibilityVersions());
-        Map<String, Set<String>> nodeFeatures = new HashMap<>(newState.nodeFeatures());
-        Set<String> allNodesFeatures = ClusterFeatures.calculateAllNodeFeatures(nodeFeatures.values());
+        Map<String, Set<String>> nodeFeatures = new HashMap<>(newState.nodeFeatures()); // as present in cluster state
+        Set<String> effectiveClusterFeatures = calculateEffectiveClusterFeatures(newState.nodes(), nodeFeatures);
 
         assert nodesBuilder.isLocalNodeElectedMaster();
 
@@ -174,14 +176,17 @@ public ClusterState execute(BatchExecutionContext<JoinTask> batchExecutionContex
                         }
                         blockForbiddenVersions(compatibilityVersions.transportVersion());
                         ensureNodesCompatibility(node.getVersion(), minClusterNodeVersion, maxClusterNodeVersion);
-                        enforceNodeFeatureBarrier(node.getId(), allNodesFeatures, features);
+                        Set<String> newNodeEffectiveFeatures = enforceNodeFeatureBarrier(node, effectiveClusterFeatures, features);
                         // we do this validation quite late to prevent race conditions between nodes joining and importing dangling indices
                         // we have to reject nodes that don't support all indices we have in this cluster
                         ensureIndexCompatibility(node.getMinIndexVersion(), node.getMaxIndexVersion(), initialState.getMetadata());
+
                         nodesBuilder.add(node);
                         compatibilityVersionsMap.put(node.getId(), compatibilityVersions);
+                        // store the actual node features here, not including assumed features, as this is persisted in cluster state
                         nodeFeatures.put(node.getId(), features);
-                        allNodesFeatures.retainAll(features);
+                        effectiveClusterFeatures.retainAll(newNodeEffectiveFeatures);
+
                         nodesChanged = true;
                         minClusterNodeVersion = Version.min(minClusterNodeVersion, node.getVersion());
                         maxClusterNodeVersion = Version.max(maxClusterNodeVersion, node.getVersion());
@@ -355,6 +360,35 @@ private static void blockForbiddenVersions(TransportVersion joiningTransportVers
         }
     }
 
+    /**
+     * Calculate the cluster's effective features. This includes all features that are assumed on any nodes in the cluster,
+     * that are also present across the whole cluster as a result.
+     */
+    private Set<String> calculateEffectiveClusterFeatures(DiscoveryNodes nodes, Map<String, Set<String>> nodeFeatures) {
+        if (featureService.featuresCanBeAssumedForNodes(nodes)) {
+            Set<String> assumedFeatures = featureService.getNodeFeatures()
+                .values()
+                .stream()
+                .filter(NodeFeature::assumedAfterNextCompatibilityBoundary)
+                .map(NodeFeature::id)
+                .collect(Collectors.toSet());
+
+            // add all assumed features to the featureset of all nodes of the next major version
+            nodeFeatures = new HashMap<>(nodeFeatures);
+            for (var node : nodes.getNodes().entrySet()) {
+                if (featureService.featuresCanBeAssumedForNode(node.getValue())) {
+                    assert nodeFeatures.containsKey(node.getKey()) : "Node " + node.getKey() + " does not have any features";
+                    nodeFeatures.computeIfPresent(node.getKey(), (k, v) -> {
+                        var newFeatures = new HashSet<>(v);
+                        return newFeatures.addAll(assumedFeatures) ? newFeatures : v;
+                    });
+                }
+            }
+        }
+
+        return ClusterFeatures.calculateAllNodeFeatures(nodeFeatures.values());
+    }
+
     /**
      * Ensures that all indices are compatible with the given index version. This will ensure that all indices in the given metadata
      * will not be created with a newer version of elasticsearch as well as that all indices are newer or equal to the minimum index
@@ -461,13 +495,44 @@ public static void ensureVersionBarrier(Version joiningNodeVersion, Version minC
         }
     }
 
-    private void enforceNodeFeatureBarrier(String nodeId, Set<String> existingNodesFeatures, Set<String> newNodeFeatures) {
+    /**
+     * Enforces the feature join barrier - a joining node should have all features already present in all existing nodes in the cluster
+     *
+     * @return The set of features that this node has (including assumed features)
+     */
+    private Set<String> enforceNodeFeatureBarrier(DiscoveryNode node, Set<String> effectiveClusterFeatures, Set<String> newNodeFeatures) {
         // prevent join if it does not have one or more features that all other nodes have
-        Set<String> missingFeatures = new HashSet<>(existingNodesFeatures);
+        Set<String> missingFeatures = new HashSet<>(effectiveClusterFeatures);
         missingFeatures.removeAll(newNodeFeatures);
 
-        if (missingFeatures.isEmpty() == false) {
-            throw new IllegalStateException("Node " + nodeId + " is missing required features " + missingFeatures);
+        if (missingFeatures.isEmpty()) {
+            // nothing missing - all ok
+            return newNodeFeatures;
+        }
+
+        if (featureService.featuresCanBeAssumedForNode(node)) {
+            // it might still be ok for this node to join if this node can have assumed features,
+            // and all the missing features are assumed
+            // we can get the NodeFeature object direct from this node's registered features
+            // as all existing nodes in the cluster have the features present in existingNodesFeatures, including this one
+            newNodeFeatures = new HashSet<>(newNodeFeatures);
+            for (Iterator<String> it = missingFeatures.iterator(); it.hasNext();) {
+                String feature = it.next();
+                NodeFeature nf = featureService.getNodeFeatures().get(feature);
+                if (nf.assumedAfterNextCompatibilityBoundary()) {
+                    // its ok for this feature to be missing from this node
+                    it.remove();
+                    // and it should be assumed to still be in the cluster
+                    newNodeFeatures.add(feature);
+                }
+                // even if we don't remove it, still continue, so the exception message below is accurate
+            }
+        }
+
+        if (missingFeatures.isEmpty()) {
+            return newNodeFeatures;
+        } else {
+            throw new IllegalStateException("Node " + node.getId() + " is missing required features " + missingFeatures);
         }
     }
 
diff --git a/server/src/main/java/org/elasticsearch/env/BuildVersion.java b/server/src/main/java/org/elasticsearch/env/BuildVersion.java
index 7a6b27eab2330..5c3602283fef3 100644
--- a/server/src/main/java/org/elasticsearch/env/BuildVersion.java
+++ b/server/src/main/java/org/elasticsearch/env/BuildVersion.java
@@ -37,6 +37,12 @@
  */
 public abstract class BuildVersion implements ToXContentFragment, Writeable {
 
+    /**
+     * Checks if this version can operate properly in a cluster without features
+     * that are assumed in the currently running Elasticsearch.
+     */
+    public abstract boolean canRemoveAssumedFeatures();
+
     /**
      * Check whether this version is on or after a minimum threshold.
      *
diff --git a/server/src/main/java/org/elasticsearch/env/DefaultBuildVersion.java b/server/src/main/java/org/elasticsearch/env/DefaultBuildVersion.java
index a7e1a4fee341d..70aa3f6639a4d 100644
--- a/server/src/main/java/org/elasticsearch/env/DefaultBuildVersion.java
+++ b/server/src/main/java/org/elasticsearch/env/DefaultBuildVersion.java
@@ -47,6 +47,17 @@ final class DefaultBuildVersion extends BuildVersion {
         this(in.readVInt());
     }
 
+    @Override
+    public boolean canRemoveAssumedFeatures() {
+        /*
+         * We can remove assumed features if the node version is the next major version.
+         * This is because the next major version can only form a cluster with the
+         * latest minor version of the previous major, so any features introduced before that point
+         * (that are marked as assumed in the running code version) are automatically met by that version.
+         */
+        return version.major == Version.CURRENT.major + 1;
+    }
+
     @Override
     public boolean onOrAfterMinimumCompatible() {
         return Version.CURRENT.minimumCompatibilityVersion().onOrBefore(version);
diff --git a/server/src/main/java/org/elasticsearch/features/FeatureService.java b/server/src/main/java/org/elasticsearch/features/FeatureService.java
index 9a0ac7cafc183..c04fbae05ee2c 100644
--- a/server/src/main/java/org/elasticsearch/features/FeatureService.java
+++ b/server/src/main/java/org/elasticsearch/features/FeatureService.java
@@ -9,7 +9,10 @@
 
 package org.elasticsearch.features;
 
+import org.elasticsearch.cluster.ClusterFeatures;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.core.SuppressForbidden;
 import org.elasticsearch.logging.LogManager;
 import org.elasticsearch.logging.Logger;
@@ -38,9 +41,7 @@ public class FeatureService {
      * as the local node's supported feature set
      */
     public FeatureService(List<? extends FeatureSpecification> specs) {
-
-        var featureData = FeatureData.createFromSpecifications(specs);
-        nodeFeatures = featureData.getNodeFeatures();
+        this.nodeFeatures = FeatureData.createFromSpecifications(specs).getNodeFeatures();
 
         logger.info("Registered local node features {}", nodeFeatures.keySet().stream().sorted().toList());
     }
@@ -53,11 +54,25 @@ public Map<String, NodeFeature> getNodeFeatures() {
         return nodeFeatures;
     }
 
+    /**
+     * Returns {@code true} if {@code node} can have assumed features.
+     */
+    public boolean featuresCanBeAssumedForNode(DiscoveryNode node) {
+        return ClusterFeatures.featuresCanBeAssumedForNode(node);
+    }
+
+    /**
+    * Returns {@code true} if one or more nodes in {@code nodes} can have assumed features.
+    */
+    public boolean featuresCanBeAssumedForNodes(DiscoveryNodes nodes) {
+        return ClusterFeatures.featuresCanBeAssumedForNodes(nodes);
+    }
+
     /**
      * Returns {@code true} if all nodes in {@code state} support feature {@code feature}.
      */
     @SuppressForbidden(reason = "We need basic feature information from cluster state")
     public boolean clusterHasFeature(ClusterState state, NodeFeature feature) {
-        return state.clusterFeatures().clusterHasFeature(feature);
+        return state.clusterFeatures().clusterHasFeature(state.nodes(), feature);
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/features/NodeFeature.java b/server/src/main/java/org/elasticsearch/features/NodeFeature.java
index 957308e805562..961b386d62802 100644
--- a/server/src/main/java/org/elasticsearch/features/NodeFeature.java
+++ b/server/src/main/java/org/elasticsearch/features/NodeFeature.java
@@ -15,10 +15,17 @@
  * A feature published by a node.
  *
  * @param id        The feature id. Must be unique in the node.
+ * @param assumedAfterNextCompatibilityBoundary
+ *              {@code true} if this feature is removed at the next compatibility boundary (ie next major version),
+ *              and so should be assumed to be true for all nodes after that boundary.
  */
-public record NodeFeature(String id) {
+public record NodeFeature(String id, boolean assumedAfterNextCompatibilityBoundary) {
 
     public NodeFeature {
         Objects.requireNonNull(id);
     }
+
+    public NodeFeature(String id) {
+        this(id, false);
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/readiness/ReadinessService.java b/server/src/main/java/org/elasticsearch/readiness/ReadinessService.java
index 15b9eacfa2118..de56ead9b5aba 100644
--- a/server/src/main/java/org/elasticsearch/readiness/ReadinessService.java
+++ b/server/src/main/java/org/elasticsearch/readiness/ReadinessService.java
@@ -294,8 +294,8 @@ protected boolean areFileSettingsApplied(ClusterState clusterState) {
     }
 
     @SuppressForbidden(reason = "need to check file settings support on exact cluster state")
-    private static boolean supportsFileSettings(ClusterState clusterState) {
-        return clusterState.clusterFeatures().clusterHasFeature(FileSettingsFeatures.FILE_SETTINGS_SUPPORTED);
+    private boolean supportsFileSettings(ClusterState clusterState) {
+        return clusterState.clusterFeatures().clusterHasFeature(clusterState.nodes(), FileSettingsFeatures.FILE_SETTINGS_SUPPORTED);
     }
 
     private void setReady(boolean ready) {
diff --git a/server/src/test/java/org/elasticsearch/action/datastreams/autosharding/DataStreamAutoShardingServiceTests.java b/server/src/test/java/org/elasticsearch/action/datastreams/autosharding/DataStreamAutoShardingServiceTests.java
index 2c6e273bb6e23..ba0f04d174f43 100644
--- a/server/src/test/java/org/elasticsearch/action/datastreams/autosharding/DataStreamAutoShardingServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/action/datastreams/autosharding/DataStreamAutoShardingServiceTests.java
@@ -19,6 +19,8 @@
 import org.elasticsearch.cluster.metadata.IndexMetadataStats;
 import org.elasticsearch.cluster.metadata.IndexWriteLoad;
 import org.elasticsearch.cluster.metadata.Metadata;
+import org.elasticsearch.cluster.node.DiscoveryNodeUtils;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.settings.ClusterSettings;
 import org.elasticsearch.common.settings.Setting;
@@ -110,6 +112,7 @@ public void testCalculateValidations() {
         );
         builder.put(dataStream);
         ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
             .nodeFeatures(
                 Map.of(
                     "n1",
@@ -143,8 +146,9 @@ public Set<NodeFeature> getFeatures() {
             // cluster doesn't have feature
             ClusterState stateNoFeature = ClusterState.builder(ClusterName.DEFAULT).metadata(Metadata.builder()).build();
 
+            Settings settings = Settings.builder().put(DataStreamAutoShardingService.DATA_STREAMS_AUTO_SHARDING_ENABLED, true).build();
             DataStreamAutoShardingService noFeatureService = new DataStreamAutoShardingService(
-                Settings.builder().put(DataStreamAutoShardingService.DATA_STREAMS_AUTO_SHARDING_ENABLED, true).build(),
+                settings,
                 clusterService,
                 new FeatureService(List.of()),
                 () -> now
@@ -155,15 +159,16 @@ public Set<NodeFeature> getFeatures() {
         }
 
         {
+            Settings settings = Settings.builder()
+                .put(DataStreamAutoShardingService.DATA_STREAMS_AUTO_SHARDING_ENABLED, true)
+                .putList(
+                    DataStreamAutoShardingService.DATA_STREAMS_AUTO_SHARDING_EXCLUDES_SETTING.getKey(),
+                    List.of("foo", dataStreamName + "*")
+                )
+                .build();
             // patterns are configured to exclude the current data stream
             DataStreamAutoShardingService noFeatureService = new DataStreamAutoShardingService(
-                Settings.builder()
-                    .put(DataStreamAutoShardingService.DATA_STREAMS_AUTO_SHARDING_ENABLED, true)
-                    .putList(
-                        DataStreamAutoShardingService.DATA_STREAMS_AUTO_SHARDING_EXCLUDES_SETTING.getKey(),
-                        List.of("foo", dataStreamName + "*")
-                    )
-                    .build(),
+                settings,
                 clusterService,
                 new FeatureService(List.of()),
                 () -> now
@@ -199,6 +204,7 @@ public void testCalculateIncreaseShardingRecommendations() {
             DataStream dataStream = dataStreamSupplier.apply(null);
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -237,6 +243,7 @@ public void testCalculateIncreaseShardingRecommendations() {
             );
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -275,6 +282,7 @@ public void testCalculateIncreaseShardingRecommendations() {
             );
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -313,6 +321,7 @@ public void testCalculateDecreaseShardingRecommendations() {
             DataStream dataStream = dataStreamSupplier.apply(null);
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -353,6 +362,7 @@ public void testCalculateDecreaseShardingRecommendations() {
             DataStream dataStream = dataStreamSupplier.apply(null);
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -401,6 +411,7 @@ public void testCalculateDecreaseShardingRecommendations() {
             );
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -447,6 +458,7 @@ public void testCalculateDecreaseShardingRecommendations() {
             );
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
@@ -487,6 +499,7 @@ public void testCalculateDecreaseShardingRecommendations() {
             DataStream dataStream = dataStreamSupplier.apply(null);
             builder.put(dataStream);
             ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("n1")).add(DiscoveryNodeUtils.create("n2")))
                 .nodeFeatures(
                     Map.of(
                         "n1",
diff --git a/server/src/test/java/org/elasticsearch/cluster/coordination/NodeJoinExecutorTests.java b/server/src/test/java/org/elasticsearch/cluster/coordination/NodeJoinExecutorTests.java
index 27775270a83eb..492a142492e18 100644
--- a/server/src/test/java/org/elasticsearch/cluster/coordination/NodeJoinExecutorTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/coordination/NodeJoinExecutorTests.java
@@ -33,6 +33,7 @@
 import org.elasticsearch.common.ReferenceDocs;
 import org.elasticsearch.common.UUIDs;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.core.SuppressForbidden;
 import org.elasticsearch.features.FeatureService;
 import org.elasticsearch.features.FeatureSpecification;
 import org.elasticsearch.features.NodeFeature;
@@ -46,11 +47,13 @@
 import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.TimeUnit;
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.stream.Stream;
 
 import static org.elasticsearch.cluster.metadata.DesiredNodesTestCase.assertDesiredNodesStatusIsCorrect;
@@ -227,6 +230,227 @@ public Set<NodeFeature> getFeatures() {
         );
     }
 
+    @SuppressForbidden(reason = "we need to actually check what is in cluster state")
+    private static Map<String, Set<String>> getRecordedNodeFeatures(ClusterState state) {
+        return state.clusterFeatures().nodeFeatures();
+    }
+
+    private static Version nextMajor() {
+        return Version.fromId((Version.CURRENT.major + 1) * 1_000_000 + 99);
+    }
+
+    public void testCanJoinClusterWithAssumedFeatures() throws Exception {
+        AllocationService allocationService = createAllocationService();
+        RerouteService rerouteService = (reason, priority, listener) -> listener.onResponse(null);
+        FeatureService featureService = new FeatureService(List.of(new FeatureSpecification() {
+            @Override
+            public Set<NodeFeature> getFeatures() {
+                return Set.of(new NodeFeature("f1"), new NodeFeature("af1", true), new NodeFeature("af2", true));
+            }
+        }));
+
+        NodeJoinExecutor executor = new NodeJoinExecutor(allocationService, rerouteService, featureService);
+
+        DiscoveryNode masterNode = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        DiscoveryNode otherNode = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        Map<String, Set<String>> features = new HashMap<>();
+        features.put(masterNode.getId(), Set.of("f1", "af1", "af2"));
+        features.put(otherNode.getId(), Set.of("f1", "af1", "af2"));
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(DiscoveryNodes.builder().add(masterNode).localNodeId(masterNode.getId()).masterNodeId(masterNode.getId()).add(otherNode))
+            .nodeFeatures(features)
+            .build();
+
+        // it is valid for major+1 versions to join clusters assumed features still present
+        // this can happen in the process of marking, then removing, assumed features
+        // they should still be recorded appropriately
+        DiscoveryNode newNode = DiscoveryNodeUtils.builder(UUIDs.base64UUID())
+            .version(nextMajor(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+            .build();
+        clusterState = ClusterStateTaskExecutorUtils.executeAndAssertSuccessful(
+            clusterState,
+            executor,
+            List.of(
+                JoinTask.singleNode(
+                    newNode,
+                    CompatibilityVersionsUtils.staticCurrent(),
+                    Set.of("f1", "af2"),
+                    TEST_REASON,
+                    NO_FAILURE_LISTENER,
+                    0L
+                )
+            )
+        );
+        features.put(newNode.getId(), Set.of("f1", "af2"));
+
+        // extra final check that the recorded cluster features are as they should be
+        assertThat(getRecordedNodeFeatures(clusterState), equalTo(features));
+    }
+
+    public void testJoinClusterWithAssumedFeaturesDoesntAllowNonAssumed() throws Exception {
+        AllocationService allocationService = createAllocationService();
+        RerouteService rerouteService = (reason, priority, listener) -> listener.onResponse(null);
+        FeatureService featureService = new FeatureService(List.of(new FeatureSpecification() {
+            @Override
+            public Set<NodeFeature> getFeatures() {
+                return Set.of(new NodeFeature("f1"), new NodeFeature("af1", true));
+            }
+        }));
+
+        NodeJoinExecutor executor = new NodeJoinExecutor(allocationService, rerouteService, featureService);
+
+        DiscoveryNode masterNode = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        DiscoveryNode otherNode = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        Map<String, Set<String>> features = new HashMap<>();
+        features.put(masterNode.getId(), Set.of("f1", "af1"));
+        features.put(otherNode.getId(), Set.of("f1", "af1"));
+
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(DiscoveryNodes.builder().add(masterNode).localNodeId(masterNode.getId()).masterNodeId(masterNode.getId()).add(otherNode))
+            .nodeFeatures(features)
+            .build();
+
+        DiscoveryNode newNodeNextMajor = DiscoveryNodeUtils.builder(UUIDs.base64UUID())
+            .version(nextMajor(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+            .build();
+        clusterState = ClusterStateTaskExecutorUtils.executeAndAssertSuccessful(
+            clusterState,
+            executor,
+            List.of(
+                JoinTask.singleNode(
+                    newNodeNextMajor,
+                    CompatibilityVersionsUtils.staticCurrent(),
+                    Set.of("f1"),
+                    TEST_REASON,
+                    NO_FAILURE_LISTENER,
+                    0L
+                )
+            )
+        );
+        features.put(newNodeNextMajor.getId(), Set.of("f1"));
+
+        // even though a next major has joined without af1, this doesnt allow the current major to join with af1 missing features
+        DiscoveryNode newNodeCurMajor = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        AtomicReference<Exception> ex = new AtomicReference<>();
+        clusterState = ClusterStateTaskExecutorUtils.executeAndAssertSuccessful(
+            clusterState,
+            executor,
+            List.of(
+                JoinTask.singleNode(
+                    newNodeCurMajor,
+                    CompatibilityVersionsUtils.staticCurrent(),
+                    Set.of("f1"),
+                    TEST_REASON,
+                    ActionTestUtils.assertNoSuccessListener(ex::set),
+                    0L
+                )
+            )
+        );
+        assertThat(ex.get().getMessage(), containsString("missing required features [af1]"));
+
+        // a next major can't join missing non-assumed features
+        DiscoveryNode newNodeNextMajorMissing = DiscoveryNodeUtils.builder(UUIDs.base64UUID())
+            .version(nextMajor(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+            .build();
+        ex.set(null);
+        clusterState = ClusterStateTaskExecutorUtils.executeAndAssertSuccessful(
+            clusterState,
+            executor,
+            List.of(
+                JoinTask.singleNode(
+                    newNodeNextMajorMissing,
+                    CompatibilityVersionsUtils.staticCurrent(),
+                    Set.of(),
+                    TEST_REASON,
+                    ActionTestUtils.assertNoSuccessListener(ex::set),
+                    0L
+                )
+            )
+        );
+        assertThat(ex.get().getMessage(), containsString("missing required features [f1]"));
+
+        // extra final check that the recorded cluster features are as they should be, and newNodeNextMajor hasn't gained af1
+        assertThat(getRecordedNodeFeatures(clusterState), equalTo(features));
+    }
+
+    /*
+     * Same as above but the current major missing features is processed in the same execution
+     */
+    public void testJoinClusterWithAssumedFeaturesDoesntAllowNonAssumedSameExecute() throws Exception {
+        AllocationService allocationService = createAllocationService();
+        RerouteService rerouteService = (reason, priority, listener) -> listener.onResponse(null);
+        FeatureService featureService = new FeatureService(List.of(new FeatureSpecification() {
+            @Override
+            public Set<NodeFeature> getFeatures() {
+                return Set.of(new NodeFeature("f1"), new NodeFeature("af1", true));
+            }
+        }));
+
+        NodeJoinExecutor executor = new NodeJoinExecutor(allocationService, rerouteService, featureService);
+
+        DiscoveryNode masterNode = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        DiscoveryNode otherNode = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        Map<String, Set<String>> features = new HashMap<>();
+        features.put(masterNode.getId(), Set.of("f1", "af1"));
+        features.put(otherNode.getId(), Set.of("f1", "af1"));
+
+        ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(DiscoveryNodes.builder().add(masterNode).localNodeId(masterNode.getId()).masterNodeId(masterNode.getId()).add(otherNode))
+            .nodeFeatures(features)
+            .build();
+
+        DiscoveryNode newNodeNextMajor = DiscoveryNodeUtils.builder(UUIDs.base64UUID())
+            .version(nextMajor(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+            .build();
+        DiscoveryNode newNodeCurMajor = DiscoveryNodeUtils.create(UUIDs.base64UUID());
+        DiscoveryNode newNodeNextMajorMissing = DiscoveryNodeUtils.builder(UUIDs.base64UUID())
+            .version(nextMajor(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+            .build();
+        // even though a next major could join, this doesnt allow the current major to join with missing features
+        // nor a next major missing non-assumed features
+        AtomicReference<Exception> thisMajorEx = new AtomicReference<>();
+        AtomicReference<Exception> nextMajorEx = new AtomicReference<>();
+        List<JoinTask> tasks = List.of(
+            JoinTask.singleNode(
+                newNodeNextMajor,
+                CompatibilityVersionsUtils.staticCurrent(),
+                Set.of("f1"),
+                TEST_REASON,
+                NO_FAILURE_LISTENER,
+                0L
+            ),
+            JoinTask.singleNode(
+                newNodeCurMajor,
+                CompatibilityVersionsUtils.staticCurrent(),
+                Set.of("f1"),
+                TEST_REASON,
+                ActionTestUtils.assertNoSuccessListener(thisMajorEx::set),
+                0L
+            ),
+            JoinTask.singleNode(
+                newNodeNextMajorMissing,
+                CompatibilityVersionsUtils.staticCurrent(),
+                Set.of(),
+                TEST_REASON,
+                ActionTestUtils.assertNoSuccessListener(nextMajorEx::set),
+                0L
+            )
+        );
+        if (randomBoolean()) {
+            // sometimes combine them together into a single task for completeness
+            tasks = List.of(new JoinTask(tasks.stream().flatMap(t -> t.nodeJoinTasks().stream()).toList(), false, 0L, null));
+        }
+
+        clusterState = ClusterStateTaskExecutorUtils.executeAndAssertSuccessful(clusterState, executor, tasks);
+        features.put(newNodeNextMajor.getId(), Set.of("f1"));
+
+        assertThat(thisMajorEx.get().getMessage(), containsString("missing required features [af1]"));
+        assertThat(nextMajorEx.get().getMessage(), containsString("missing required features [f1]"));
+
+        // extra check that the recorded cluster features are as they should be, and newNodeNextMajor hasn't gained af1
+        assertThat(getRecordedNodeFeatures(clusterState), equalTo(features));
+    }
+
     public void testSuccess() {
         Settings.builder().build();
         Metadata.Builder metaBuilder = Metadata.builder();
@@ -921,8 +1145,8 @@ public void testSetsNodeFeaturesWhenRejoining() throws Exception {
             .nodeFeatures(Map.of(masterNode.getId(), Set.of("f1", "f2"), rejoinNode.getId(), Set.of()))
             .build();
 
-        assertThat(clusterState.clusterFeatures().clusterHasFeature(new NodeFeature("f1")), is(false));
-        assertThat(clusterState.clusterFeatures().clusterHasFeature(new NodeFeature("f2")), is(false));
+        assertThat(clusterState.clusterFeatures().clusterHasFeature(clusterState.nodes(), new NodeFeature("f1")), is(false));
+        assertThat(clusterState.clusterFeatures().clusterHasFeature(clusterState.nodes(), new NodeFeature("f2")), is(false));
 
         final var resultingState = ClusterStateTaskExecutorUtils.executeAndAssertSuccessful(
             clusterState,
@@ -939,8 +1163,8 @@ public void testSetsNodeFeaturesWhenRejoining() throws Exception {
             )
         );
 
-        assertThat(resultingState.clusterFeatures().clusterHasFeature(new NodeFeature("f1")), is(true));
-        assertThat(resultingState.clusterFeatures().clusterHasFeature(new NodeFeature("f2")), is(true));
+        assertThat(resultingState.clusterFeatures().clusterHasFeature(resultingState.nodes(), new NodeFeature("f1")), is(true));
+        assertThat(resultingState.clusterFeatures().clusterHasFeature(resultingState.nodes(), new NodeFeature("f2")), is(true));
     }
 
     private DesiredNodeWithStatus createActualizedDesiredNode() {
diff --git a/server/src/test/java/org/elasticsearch/features/FeatureServiceTests.java b/server/src/test/java/org/elasticsearch/features/FeatureServiceTests.java
index 874a6a96313e4..a64303f376b20 100644
--- a/server/src/test/java/org/elasticsearch/features/FeatureServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/features/FeatureServiceTests.java
@@ -9,8 +9,14 @@
 
 package org.elasticsearch.features;
 
+import org.elasticsearch.Version;
 import org.elasticsearch.cluster.ClusterName;
 import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.node.DiscoveryNodeUtils;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
+import org.elasticsearch.cluster.node.VersionInformation;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.test.ESTestCase;
 
 import java.util.List;
@@ -69,6 +75,12 @@ public void testStateHasFeatures() {
         );
 
         ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(
+                DiscoveryNodes.builder()
+                    .add(DiscoveryNodeUtils.create("node1"))
+                    .add(DiscoveryNodeUtils.create("node2"))
+                    .add(DiscoveryNodeUtils.create("node3"))
+            )
             .nodeFeatures(
                 Map.of("node1", Set.of("f1", "f2", "nf1"), "node2", Set.of("f1", "f2", "nf2"), "node3", Set.of("f1", "f2", "nf1"))
             )
@@ -81,4 +93,33 @@ public void testStateHasFeatures() {
         assertFalse(service.clusterHasFeature(state, new NodeFeature("nf2")));
         assertFalse(service.clusterHasFeature(state, new NodeFeature("nf3")));
     }
+
+    private static Version nextMajor() {
+        return Version.fromId((Version.CURRENT.major + 1) * 1_000_000 + 99);
+    }
+
+    public void testStateHasAssumedFeatures() {
+        List<FeatureSpecification> specs = List.of(
+            new TestFeatureSpecification(Set.of(new NodeFeature("f1"), new NodeFeature("f2"), new NodeFeature("af1", true)))
+        );
+
+        ClusterState state = ClusterState.builder(ClusterName.DEFAULT)
+            .nodes(
+                DiscoveryNodes.builder()
+                    .add(DiscoveryNodeUtils.create("node1"))
+                    .add(DiscoveryNodeUtils.create("node2"))
+                    .add(
+                        DiscoveryNodeUtils.builder("node3")
+                            .version(new VersionInformation(nextMajor(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current()))
+                            .build()
+                    )
+            )
+            .nodeFeatures(Map.of("node1", Set.of("f1", "af1"), "node2", Set.of("f1", "f2", "af1"), "node3", Set.of("f1", "f2")))
+            .build();
+
+        FeatureService service = new FeatureService(specs);
+        assertTrue(service.clusterHasFeature(state, new NodeFeature("f1")));
+        assertFalse(service.clusterHasFeature(state, new NodeFeature("f2")));
+        assertTrue(service.clusterHasFeature(state, new NodeFeature("af1", true)));
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/health/node/selection/HealthNodeTaskExecutorTests.java b/server/src/test/java/org/elasticsearch/health/node/selection/HealthNodeTaskExecutorTests.java
index 97f44f7480a72..92bfabf6f1972 100644
--- a/server/src/test/java/org/elasticsearch/health/node/selection/HealthNodeTaskExecutorTests.java
+++ b/server/src/test/java/org/elasticsearch/health/node/selection/HealthNodeTaskExecutorTests.java
@@ -77,8 +77,8 @@ public void setUp() throws Exception {
         clusterService = createClusterService(threadPool);
         localNodeId = clusterService.localNode().getId();
         persistentTasksService = mock(PersistentTasksService.class);
-        featureService = new FeatureService(List.of(new HealthFeatures()));
         settings = Settings.builder().build();
+        featureService = new FeatureService(List.of(new HealthFeatures()));
         clusterSettings = new ClusterSettings(settings, ClusterSettings.BUILT_IN_CLUSTER_SETTINGS);
     }
 
diff --git a/x-pack/plugin/slm/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleServiceTests.java b/x-pack/plugin/slm/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleServiceTests.java
index 36887681f5575..9955fe4cf0f95 100644
--- a/x-pack/plugin/slm/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleServiceTests.java
+++ b/x-pack/plugin/slm/src/test/java/org/elasticsearch/xpack/slm/SnapshotLifecycleServiceTests.java
@@ -529,6 +529,7 @@ public void testValidateIntervalScheduleSupport() {
         var featureService = new FeatureService(List.of(new SnapshotLifecycleFeatures()));
         {
             ClusterState state = ClusterState.builder(new ClusterName("cluster"))
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("a")).add(DiscoveryNodeUtils.create("b")))
                 .nodeFeatures(Map.of("a", Set.of(), "b", Set.of(SnapshotLifecycleService.INTERVAL_SCHEDULE.id())))
                 .build();
 
@@ -540,6 +541,7 @@ public void testValidateIntervalScheduleSupport() {
         }
         {
             ClusterState state = ClusterState.builder(new ClusterName("cluster"))
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("a")))
                 .nodeFeatures(Map.of("a", Set.of(SnapshotLifecycleService.INTERVAL_SCHEDULE.id())))
                 .build();
             try {
@@ -550,6 +552,7 @@ public void testValidateIntervalScheduleSupport() {
         }
         {
             ClusterState state = ClusterState.builder(new ClusterName("cluster"))
+                .nodes(DiscoveryNodes.builder().add(DiscoveryNodeUtils.create("a")).add(DiscoveryNodeUtils.create("b")))
                 .nodeFeatures(Map.of("a", Set.of(), "b", Set.of(SnapshotLifecycleService.INTERVAL_SCHEDULE.id())))
                 .build();
             try {

From 312c21a3240339477c70fb512b5643b23952d572 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 18 Dec 2024 00:58:11 +1100
Subject: [PATCH 029/119] Mute
 org.elasticsearch.index.engine.RecoverySourcePruneMergePolicyTests
 testPruneSome #118728

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index fe6c77bdf9f93..cdf3007ee0027 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -304,6 +304,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118806
 - class: org.elasticsearch.xpack.esql.session.IndexResolverFieldNamesTests
   issue: https://github.com/elastic/elasticsearch/issues/118814
+- class: org.elasticsearch.index.engine.RecoverySourcePruneMergePolicyTests
+  method: testPruneSome
+  issue: https://github.com/elastic/elasticsearch/issues/118728
 
 # Examples:
 #

From e0763c25ae9600611fe93b8d4133b5106ff280fd Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Tue, 17 Dec 2024 17:16:40 +0200
Subject: [PATCH 030/119] Mark the lookup join tests in
 IndexResolverFieldNamesTests as snapshot-only (#118815)

---
 muted-tests.yml                                     |  2 --
 .../esql/session/IndexResolverFieldNamesTests.java  | 13 +++++++++++++
 .../qa/server/src/main/resources/docs/docs.csv-spec |  2 +-
 3 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index cdf3007ee0027..42845fda82180 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -302,8 +302,6 @@ tests:
 - class: org.elasticsearch.xpack.security.QueryableReservedRolesIT
   method: testDeletingAndCreatingSecurityIndexTriggersSynchronization
   issue: https://github.com/elastic/elasticsearch/issues/118806
-- class: org.elasticsearch.xpack.esql.session.IndexResolverFieldNamesTests
-  issue: https://github.com/elastic/elasticsearch/issues/118814
 - class: org.elasticsearch.index.engine.RecoverySourcePruneMergePolicyTests
   method: testPruneSome
   issue: https://github.com/elastic/elasticsearch/issues/118728
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
index e4271a0a6ddd5..31ec4663738f7 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
@@ -9,6 +9,7 @@
 
 import org.elasticsearch.Build;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
 import org.elasticsearch.xpack.esql.parser.EsqlParser;
 import org.elasticsearch.xpack.esql.parser.ParsingException;
 
@@ -1364,6 +1365,7 @@ public void testMetrics() {
     }
 
     public void testLookupJoin() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             "FROM employees | KEEP languages | RENAME languages AS language_code | LOOKUP JOIN languages_lookup ON language_code",
             Set.of("languages", "languages.*", "language_code", "language_code.*"),
@@ -1372,6 +1374,7 @@ public void testLookupJoin() {
     }
 
     public void testLookupJoinKeep() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM employees
@@ -1385,6 +1388,7 @@ public void testLookupJoinKeep() {
     }
 
     public void testLookupJoinKeepWildcard() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM employees
@@ -1398,6 +1402,7 @@ public void testLookupJoinKeepWildcard() {
     }
 
     public void testMultiLookupJoin() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1410,6 +1415,7 @@ public void testMultiLookupJoin() {
     }
 
     public void testMultiLookupJoinKeepBefore() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1423,6 +1429,7 @@ public void testMultiLookupJoinKeepBefore() {
     }
 
     public void testMultiLookupJoinKeepBetween() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1447,6 +1454,7 @@ public void testMultiLookupJoinKeepBetween() {
     }
 
     public void testMultiLookupJoinKeepAfter() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1473,6 +1481,7 @@ public void testMultiLookupJoinKeepAfter() {
     }
 
     public void testMultiLookupJoinKeepAfterWildcard() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1486,6 +1495,7 @@ public void testMultiLookupJoinKeepAfterWildcard() {
     }
 
     public void testMultiLookupJoinSameIndex() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1499,6 +1509,7 @@ public void testMultiLookupJoinSameIndex() {
     }
 
     public void testMultiLookupJoinSameIndexKeepBefore() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1513,6 +1524,7 @@ public void testMultiLookupJoinSameIndexKeepBefore() {
     }
 
     public void testMultiLookupJoinSameIndexKeepBetween() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1538,6 +1550,7 @@ public void testMultiLookupJoinSameIndexKeepBetween() {
     }
 
     public void testMultiLookupJoinSameIndexKeepAfter() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
diff --git a/x-pack/plugin/sql/qa/server/src/main/resources/docs/docs.csv-spec b/x-pack/plugin/sql/qa/server/src/main/resources/docs/docs.csv-spec
index 60e81be43cc96..2fa82c05cc1aa 100644
--- a/x-pack/plugin/sql/qa/server/src/main/resources/docs/docs.csv-spec
+++ b/x-pack/plugin/sql/qa/server/src/main/resources/docs/docs.csv-spec
@@ -3353,7 +3353,7 @@ Alejandro
 Amabile
 Anoosh
 Basil
-Bojan
+Brendon
 // end::filterToday
 ;
 

From 6d943e9e53576700b8417164d0e4c899c5f84e52 Mon Sep 17 00:00:00 2001
From: Valeriy Khakhutskyy <1292899+valeriy42@users.noreply.github.com>
Date: Tue, 17 Dec 2024 16:33:27 +0100
Subject: [PATCH 031/119] [ML] Ignore failures from renormalizing buckets in
 read-only index (#118674)

In anomaly detection, score renormalization will update the anomaly score in the result indices. However, if the index in the old format was marked as read-only, the score update will fail. Since this failure is expected, this PR suppresses the error logging in this specific case.
---
 docs/changelog/118674.yaml                    |  5 ++++
 .../JobRenormalizedResultsPersister.java      | 26 ++++++++++++++++++-
 2 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 docs/changelog/118674.yaml

diff --git a/docs/changelog/118674.yaml b/docs/changelog/118674.yaml
new file mode 100644
index 0000000000000..eeb90a3b38f66
--- /dev/null
+++ b/docs/changelog/118674.yaml
@@ -0,0 +1,5 @@
+pr: 118674
+summary: Ignore failures from renormalizing buckets in read-only index
+area: Machine Learning
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobRenormalizedResultsPersister.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobRenormalizedResultsPersister.java
index 3c0d2aca4deda..3c82841f1b99e 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobRenormalizedResultsPersister.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/job/persistence/JobRenormalizedResultsPersister.java
@@ -8,10 +8,12 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.bulk.BulkItemResponse;
 import org.elasticsearch.action.bulk.BulkRequest;
 import org.elasticsearch.action.bulk.BulkResponse;
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.xcontent.ToXContent;
 import org.elasticsearch.xcontent.XContentBuilder;
@@ -102,7 +104,29 @@ public void executeRequest() {
         try (ThreadContext.StoredContext ignore = client.threadPool().getThreadContext().stashWithOrigin(ML_ORIGIN)) {
             BulkResponse addRecordsResponse = client.bulk(bulkRequest).actionGet();
             if (addRecordsResponse.hasFailures()) {
-                logger.error("[{}] Bulk index of results has errors: {}", jobId, addRecordsResponse.buildFailureMessage());
+                // Implementation note: Ignore the failures from writing to the read-only index, as it comes
+                // from changing the index format version.
+                boolean hasNonReadOnlyFailures = false;
+                for (BulkItemResponse response : addRecordsResponse.getItems()) {
+                    if (response.isFailed() == false) {
+                        continue;
+                    }
+                    if (response.getFailureMessage().contains(IndexMetadata.INDEX_READ_ONLY_BLOCK.description())) {
+                        // We expect this to happen when the old index is made read-only and being reindexed
+                        logger.debug(
+                            "[{}] Ignoring failure to write renormalized results to a read-only index [{}]: {}",
+                            jobId,
+                            response.getFailure().getIndex(),
+                            response.getFailureMessage()
+                        );
+                    } else {
+                        hasNonReadOnlyFailures = true;
+                        break;
+                    }
+                }
+                if (hasNonReadOnlyFailures) {
+                    logger.error("[{}] Bulk index of results has errors: {}", jobId, addRecordsResponse.buildFailureMessage());
+                }
             }
         }
 

From f64c05ac32ee23930cf913c7939c9eeac12f00ce Mon Sep 17 00:00:00 2001
From: Adam Szaraniec <szaraniec.adam@gmail.com>
Date: Tue, 17 Dec 2024 20:09:22 +0400
Subject: [PATCH 032/119] Update alias.asciidoc (#118553)

Add section about removing index
---
 docs/reference/alias.asciidoc | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/reference/alias.asciidoc b/docs/reference/alias.asciidoc
index 9d784f530d63c..f676644c4ec48 100644
--- a/docs/reference/alias.asciidoc
+++ b/docs/reference/alias.asciidoc
@@ -407,3 +407,24 @@ POST _aliases
 }
 ----
 // TEST[s/^/PUT my-index-2099.05.06-000001\n/]
+
+[discrete]
+[[remove-index]]
+=== Remove an index
+
+To remove an index, use the aliases API's `remove_index` action.
+
+[source,console]
+----
+POST _aliases
+{
+  "actions": [
+    {
+      "remove_index": {
+        "index": "my-index-2099.05.06-000001"
+      }
+    }
+  ]
+}
+----
+// TEST[s/^/PUT my-index-2099.05.06-000001\n/]

From 1d2840ece1b8a5fcc1e6836d70bb1187160f2cd2 Mon Sep 17 00:00:00 2001
From: Luigi Dell'Aquila <luigi.dellaquila@gmail.com>
Date: Tue, 17 Dec 2024 17:13:52 +0100
Subject: [PATCH 033/119] EQL: add support for partial search results (#116388)

Allow queries to succeed if some shards are failing
---
 docs/changelog/116388.yaml                    |   5 +
 docs/reference/eql/eql-search-api.asciidoc    |  47 ++
 .../rest-api-spec/api/eql.search.json         |  10 +
 .../org/elasticsearch/TransportVersions.java  |   1 +
 .../test/eql/BaseEqlSpecTestCase.java         |  84 +-
 .../elasticsearch/test/eql/DataLoader.java    |   6 +
 .../test/eql/EqlDateNanosSpecTestCase.java    |  36 +-
 .../test/eql/EqlExtraSpecTestCase.java        |  36 +-
 .../eql/EqlMissingEventsSpecTestCase.java     |  36 +-
 .../eql/EqlSampleMultipleEntriesTestCase.java |  36 +-
 .../test/eql/EqlSampleTestCase.java           |  43 +-
 .../org/elasticsearch/test/eql/EqlSpec.java   |  51 +-
 .../eql/EqlSpecFailingShardsTestCase.java     |  83 ++
 .../elasticsearch/test/eql/EqlSpecLoader.java |   7 +
 .../test/eql/EqlSpecTestCase.java             |  43 +-
 .../data/endgame-shard-failures.data          |  14 +
 .../data/endgame-shard-failures.mapping       | 105 +++
 .../main/resources/test_failing_shards.toml   | 173 ++++
 .../xpack/eql/qa/mixed_node/EqlSearchIT.java  |  11 +-
 .../xpack/eql/EqlDateNanosIT.java             |  25 +-
 .../elasticsearch/xpack/eql/EqlExtraIT.java   |  25 +-
 .../elasticsearch/xpack/eql/EqlSampleIT.java  |  25 +-
 .../xpack/eql/EqlSampleMultipleEntriesIT.java |  18 +-
 .../elasticsearch/xpack/eql/EqlSpecIT.java    |  25 +-
 .../xpack/eql/EqlDateNanosIT.java             |  24 +-
 .../elasticsearch/xpack/eql/EqlExtraIT.java   |  24 +-
 .../xpack/eql/EqlMissingEventsIT.java         |  24 +-
 .../elasticsearch/xpack/eql/EqlSampleIT.java  |  24 +-
 .../xpack/eql/EqlSampleMultipleEntriesIT.java |  17 +-
 .../xpack/eql/EqlSpecFailingShardsIT.java     |  53 ++
 .../elasticsearch/xpack/eql/EqlSpecIT.java    |  24 +-
 .../rest-api-spec/test/eql/10_basic.yml       | 143 ++++
 .../xpack/eql/action/CCSPartialResultsIT.java | 613 ++++++++++++++
 .../eql/action/PartialSearchResultsIT.java    | 780 ++++++++++++++++++
 .../xpack/eql/action/EqlSearchRequest.java    |  47 +-
 .../xpack/eql/action/EqlSearchResponse.java   |  42 +-
 .../xpack/eql/action/EqlSearchTask.java       |   4 +-
 .../execution/assembler/ExecutionManager.java |   7 +-
 .../execution/payload/AbstractPayload.java    |  10 +-
 .../eql/execution/payload/EventPayload.java   |   2 +-
 .../eql/execution/sample/SampleIterator.java  |  29 +-
 .../eql/execution/sample/SamplePayload.java   |  11 +-
 .../execution/search/BasicQueryClient.java    |  18 +-
 .../execution/search/PITAwareQueryClient.java |  25 +-
 .../eql/execution/search/RuntimeUtils.java    |  31 +-
 .../execution/sequence/SequencePayload.java   |  11 +-
 .../execution/sequence/TumblingWindow.java    |  43 +-
 .../xpack/eql/plugin/EqlPlugin.java           |  16 +-
 .../xpack/eql/plugin/RestEqlSearchAction.java |   6 +
 .../eql/plugin/TransportEqlSearchAction.java  |  36 +-
 .../xpack/eql/session/EmptyPayload.java       |  13 +-
 .../xpack/eql/session/EqlConfiguration.java   |  14 +
 .../xpack/eql/session/Payload.java            |   3 +
 .../xpack/eql/session/Results.java            |  19 +-
 .../xpack/eql/util/SearchHitUtils.java        |  12 +
 .../elasticsearch/xpack/eql/EqlTestUtils.java |   4 +
 .../eql/action/EqlSearchRequestTests.java     |   8 +
 .../eql/action/EqlSearchResponseTests.java    |  14 +-
 .../eql/action/LocalStateEQLXPackPlugin.java  |  21 +-
 .../assembler/ImplicitTiebreakerTests.java    |  10 +-
 .../assembler/SequenceSpecTests.java          |  10 +-
 .../execution/sample/CircuitBreakerTests.java |   5 +-
 .../search/PITAwareQueryClientTests.java      |  12 +-
 .../sequence/CircuitBreakerTests.java         |  32 +-
 .../execution/sequence/PITFailureTests.java   |  12 +-
 65 files changed, 3068 insertions(+), 130 deletions(-)
 create mode 100644 docs/changelog/116388.yaml
 create mode 100644 x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecFailingShardsTestCase.java
 create mode 100644 x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.data
 create mode 100644 x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.mapping
 create mode 100644 x-pack/plugin/eql/qa/common/src/main/resources/test_failing_shards.toml
 create mode 100644 x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecFailingShardsIT.java
 create mode 100644 x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/CCSPartialResultsIT.java
 create mode 100644 x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/PartialSearchResultsIT.java

diff --git a/docs/changelog/116388.yaml b/docs/changelog/116388.yaml
new file mode 100644
index 0000000000000..59cdafc9ec337
--- /dev/null
+++ b/docs/changelog/116388.yaml
@@ -0,0 +1,5 @@
+pr: 116388
+summary: Add support for partial shard results
+area: EQL
+type: enhancement
+issues: []
diff --git a/docs/reference/eql/eql-search-api.asciidoc b/docs/reference/eql/eql-search-api.asciidoc
index d7f10f4627f6c..0fd490609277f 100644
--- a/docs/reference/eql/eql-search-api.asciidoc
+++ b/docs/reference/eql/eql-search-api.asciidoc
@@ -88,6 +88,53 @@ request that targets only `bar*` still returns an error.
 +
 Defaults to `true`.
 
+`allow_partial_search_results`::
+(Optional, Boolean)
+
+If `false`, the request returns an error if one or more shards involved in the query are unavailable.
++
+If `true`, the query is executed only on the available shards, ignoring shard request timeouts and
+<<shard-failures,shard failures>>.
++
+Defaults to `false`.
++
+To override the default for this field, set the
+`xpack.eql.default_allow_partial_results` cluster setting to `true`.
+
+
+[IMPORTANT]
+====
+You can also specify this value using the `allow_partial_search_results` request body parameter.
+If both parameters are specified, only the query parameter is used.
+====
+
+
+`allow_partial_sequence_results`::
+(Optional, Boolean)
+
+
+Used together with `allow_partial_search_results=true`, controls the behavior of sequence queries specifically
+(if `allow_partial_search_results=false`, this setting has no effect).
+If `true` and if some shards are unavailable, the sequences are calculated on available shards only.
++
+If `false` and if some shards are unavailable, the query only returns information about the shard failures,
+but no further results.
++
+Defaults to `false`.
++
+Consider that sequences calculated with `allow_partial_search_results=true` can return incorrect results
+(eg. if a <<eql-missing-events, missing event>> clause matches records in unavailable shards)
++
+To override the default for this field, set the
+`xpack.eql.default_allow_partial_sequence_results` cluster setting to `true`.
+
+
+[IMPORTANT]
+====
+You can also specify this value using the `allow_partial_sequence_results` request body parameter.
+If both parameters are specified, only the query parameter is used.
+====
+
 `ccs_minimize_roundtrips`::
 (Optional, Boolean) If `true`, network round-trips between the local and the
 remote cluster are minimized when running cross-cluster search (CCS) requests.
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/eql.search.json b/rest-api-spec/src/main/resources/rest-api-spec/api/eql.search.json
index c854c44d9d761..0f9af508f4c16 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/eql.search.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/eql.search.json
@@ -41,6 +41,16 @@
         "type": "time",
         "description": "Update the time interval in which the results (partial or final) for this search will be available",
         "default": "5d"
+      },
+      "allow_partial_search_results": {
+        "type":"boolean",
+        "description":"Control whether the query should keep running in case of shard failures, and return partial results",
+        "default":false
+      },
+      "allow_partial_sequence_results": {
+        "type":"boolean",
+        "description":"Control whether a sequence query should return partial results or no results at all in case of shard failures. This option has effect only if [allow_partial_search_results] is true.",
+        "default":false
       }
     },
     "body":{
diff --git a/server/src/main/java/org/elasticsearch/TransportVersions.java b/server/src/main/java/org/elasticsearch/TransportVersions.java
index f5e581a81a37c..371af961720cc 100644
--- a/server/src/main/java/org/elasticsearch/TransportVersions.java
+++ b/server/src/main/java/org/elasticsearch/TransportVersions.java
@@ -138,6 +138,7 @@ static TransportVersion def(int id) {
     public static final TransportVersion KNN_QUERY_RESCORE_OVERSAMPLE = def(8_806_00_0);
     public static final TransportVersion SEMANTIC_QUERY_LENIENT = def(8_807_00_0);
     public static final TransportVersion ESQL_QUERY_BUILDER_IN_SEARCH_FUNCTIONS = def(8_808_00_0);
+    public static final TransportVersion EQL_ALLOW_PARTIAL_SEARCH_RESULTS = def(8_809_00_0);
 
     /*
      * STOP! READ THIS FIRST! No, really,
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/BaseEqlSpecTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/BaseEqlSpecTestCase.java
index 90244d9b2c019..3557114e2f4c7 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/BaseEqlSpecTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/BaseEqlSpecTestCase.java
@@ -33,6 +33,9 @@
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
+import static org.hamcrest.Matchers.greaterThan;
+import static org.hamcrest.Matchers.is;
+
 public abstract class BaseEqlSpecTestCase extends RemoteClusterAwareEqlRestTestCase {
 
     protected static final String PARAM_FORMATTING = "%2$s";
@@ -52,6 +55,9 @@ public abstract class BaseEqlSpecTestCase extends RemoteClusterAwareEqlRestTestC
      */
     private final int size;
     private final int maxSamplesPerKey;
+    private final Boolean allowPartialSearchResults;
+    private final Boolean allowPartialSequenceResults;
+    private final Boolean expectShardFailures;
 
     @Before
     public void setup() throws Exception {
@@ -104,7 +110,16 @@ protected static List<Object[]> asArray(List<EqlSpec> specs) {
             }
 
             results.add(
-                new Object[] { spec.query(), name, spec.expectedEventIds(), spec.joinKeys(), spec.size(), spec.maxSamplesPerKey() }
+                new Object[] {
+                    spec.query(),
+                    name,
+                    spec.expectedEventIds(),
+                    spec.joinKeys(),
+                    spec.size(),
+                    spec.maxSamplesPerKey(),
+                    spec.allowPartialSearchResults(),
+                    spec.allowPartialSequenceResults(),
+                    spec.expectShardFailures() }
             );
         }
 
@@ -118,7 +133,10 @@ protected static List<Object[]> asArray(List<EqlSpec> specs) {
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
         this.index = index;
 
@@ -128,6 +146,9 @@ protected static List<Object[]> asArray(List<EqlSpec> specs) {
         this.joinKeys = joinKeys;
         this.size = size == null ? -1 : size;
         this.maxSamplesPerKey = maxSamplesPerKey == null ? -1 : maxSamplesPerKey;
+        this.allowPartialSearchResults = allowPartialSearchResults;
+        this.allowPartialSequenceResults = allowPartialSequenceResults;
+        this.expectShardFailures = expectShardFailures;
     }
 
     public void test() throws Exception {
@@ -137,6 +158,7 @@ public void test() throws Exception {
     private void assertResponse(ObjectPath response) throws Exception {
         List<Map<String, Object>> events = response.evaluate("hits.events");
         List<Map<String, Object>> sequences = response.evaluate("hits.sequences");
+        Object shardFailures = response.evaluate("shard_failures");
 
         if (events != null) {
             assertEvents(events);
@@ -145,6 +167,7 @@ private void assertResponse(ObjectPath response) throws Exception {
         } else {
             fail("No events or sequences found");
         }
+        assertShardFailures(shardFailures);
     }
 
     protected ObjectPath runQuery(String index, String query) throws Exception {
@@ -163,6 +186,32 @@ protected ObjectPath runQuery(String index, String query) throws Exception {
         if (maxSamplesPerKey > 0) {
             builder.field("max_samples_per_key", maxSamplesPerKey);
         }
+        boolean allowPartialResultsInBody = randomBoolean();
+        if (allowPartialSearchResults != null) {
+            if (allowPartialResultsInBody) {
+                builder.field("allow_partial_search_results", String.valueOf(allowPartialSearchResults));
+                if (allowPartialSequenceResults != null) {
+                    builder.field("allow_partial_sequence_results", String.valueOf(allowPartialSequenceResults));
+                }
+            } else {
+                // these will be overwritten by the path params, that have higher priority than the query (JSON body) params
+                if (allowPartialSearchResults != null) {
+                    builder.field("allow_partial_search_results", randomBoolean());
+                }
+                if (allowPartialSequenceResults != null) {
+                    builder.field("allow_partial_sequence_results", randomBoolean());
+                }
+            }
+        } else {
+            // Tests that don't specify a setting for these parameters should always pass.
+            // These params should be irrelevant.
+            if (randomBoolean()) {
+                builder.field("allow_partial_search_results", randomBoolean());
+            }
+            if (randomBoolean()) {
+                builder.field("allow_partial_sequence_results", randomBoolean());
+            }
+        }
         builder.endObject();
 
         Request request = new Request("POST", "/" + index + "/_eql/search");
@@ -170,6 +219,23 @@ protected ObjectPath runQuery(String index, String query) throws Exception {
         if (ccsMinimizeRoundtrips != null) {
             request.addParameter("ccs_minimize_roundtrips", ccsMinimizeRoundtrips.toString());
         }
+        if (allowPartialSearchResults != null) {
+            if (allowPartialResultsInBody == false) {
+                request.addParameter("allow_partial_search_results", String.valueOf(allowPartialSearchResults));
+                if (allowPartialSequenceResults != null) {
+                    request.addParameter("allow_partial_sequence_results", String.valueOf(allowPartialSequenceResults));
+                }
+            }
+        } else {
+            // Tests that don't specify a setting for these parameters should always pass.
+            // These params should be irrelevant.
+            if (randomBoolean()) {
+                request.addParameter("allow_partial_search_results", String.valueOf(randomBoolean()));
+            }
+            if (randomBoolean()) {
+                request.addParameter("allow_partial_sequence_results", String.valueOf(randomBoolean()));
+            }
+        }
         int timeout = Math.toIntExact(timeout().millis());
         RequestConfig config = RequestConfig.copy(RequestConfig.DEFAULT)
             .setConnectionRequestTimeout(timeout)
@@ -182,6 +248,20 @@ protected ObjectPath runQuery(String index, String query) throws Exception {
         return ObjectPath.createFromResponse(client().performRequest(request));
     }
 
+    private void assertShardFailures(Object shardFailures) {
+        if (expectShardFailures != null) {
+            if (expectShardFailures) {
+                assertNotNull(shardFailures);
+                List<?> list = (List<?>) shardFailures;
+                assertThat(list.size(), is(greaterThan(0)));
+            } else {
+                assertNull(shardFailures);
+            }
+        } else {
+            assertNull(shardFailures);
+        }
+    }
+
     private void assertEvents(List<Map<String, Object>> events) {
         assertNotNull(events);
         logger.debug("Events {}", new Object() {
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/DataLoader.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/DataLoader.java
index 1d51af574c810..4618bd8f4ff3d 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/DataLoader.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/DataLoader.java
@@ -52,6 +52,7 @@
  */
 public class DataLoader {
     public static final String TEST_INDEX = "endgame-140";
+    public static final String TEST_SHARD_FAILURES_INDEX = "endgame-shard-failures";
     public static final String TEST_EXTRA_INDEX = "extra";
     public static final String TEST_NANOS_INDEX = "endgame-140-nanos";
     public static final String TEST_SAMPLE = "sample1,sample2,sample3";
@@ -103,6 +104,11 @@ public static void loadDatasetIntoEs(RestClient client, CheckedBiFunction<XConte
         //
         load(client, TEST_MISSING_EVENTS_INDEX, null, null, p);
         load(client, TEST_SAMPLE_MULTI, null, null, p);
+        //
+        // index with a runtime field ("broken", type long) that causes shard failures.
+        // the rest of the mapping is the same as TEST_INDEX
+        //
+        load(client, TEST_SHARD_FAILURES_INDEX, null, DataLoader::timestampToUnixMillis, p);
     }
 
     private static void load(
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlDateNanosSpecTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlDateNanosSpecTestCase.java
index a368ea0d22aa9..583a3eda69953 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlDateNanosSpecTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlDateNanosSpecTestCase.java
@@ -27,9 +27,23 @@ public EqlDateNanosSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        this(TEST_NANOS_INDEX, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        this(
+            TEST_NANOS_INDEX,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     // constructor for multi-cluster tests
@@ -40,9 +54,23 @@ public EqlDateNanosSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(index, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     @Override
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlExtraSpecTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlExtraSpecTestCase.java
index 292fe6c895cee..cc858ded25f37 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlExtraSpecTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlExtraSpecTestCase.java
@@ -27,9 +27,23 @@ public EqlExtraSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        this(TEST_EXTRA_INDEX, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        this(
+            TEST_EXTRA_INDEX,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     // constructor for multi-cluster tests
@@ -40,9 +54,23 @@ public EqlExtraSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(index, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     @Override
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlMissingEventsSpecTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlMissingEventsSpecTestCase.java
index cdda9e9e068f5..f62c2b29101db 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlMissingEventsSpecTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlMissingEventsSpecTestCase.java
@@ -27,9 +27,23 @@ public EqlMissingEventsSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        this(TEST_MISSING_EVENTS_INDEX, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        this(
+            TEST_MISSING_EVENTS_INDEX,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     // constructor for multi-cluster tests
@@ -40,9 +54,23 @@ public EqlMissingEventsSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(index, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     @Override
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleMultipleEntriesTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleMultipleEntriesTestCase.java
index 6471e264a92fa..a38ccacb42f5f 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleMultipleEntriesTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleMultipleEntriesTestCase.java
@@ -21,9 +21,23 @@ public EqlSampleMultipleEntriesTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        this(TEST_SAMPLE_MULTI, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        this(
+            TEST_SAMPLE_MULTI,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     public EqlSampleMultipleEntriesTestCase(
@@ -33,9 +47,23 @@ public EqlSampleMultipleEntriesTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(index, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     @ParametersFactory(shuffle = false, argumentFormatting = PARAM_FORMATTING)
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleTestCase.java
index dfae73b3602a7..4748bd0e3307b 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSampleTestCase.java
@@ -15,8 +15,29 @@
 
 public abstract class EqlSampleTestCase extends BaseEqlSpecTestCase {
 
-    public EqlSampleTestCase(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        this(TEST_SAMPLE, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlSampleTestCase(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        this(
+            TEST_SAMPLE,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     public EqlSampleTestCase(
@@ -26,9 +47,23 @@ public EqlSampleTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(index, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     @ParametersFactory(shuffle = false, argumentFormatting = PARAM_FORMATTING)
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpec.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpec.java
index db7ee05ff2239..4dd617bac0abd 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpec.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpec.java
@@ -30,6 +30,9 @@ public class EqlSpec {
 
     private Integer size;
     private Integer maxSamplesPerKey;
+    private Boolean allowPartialSearchResults;
+    private Boolean allowPartialSequenceResults;
+    private Boolean expectShardFailures;
 
     public String name() {
         return name;
@@ -103,6 +106,30 @@ public void maxSamplesPerKey(Integer maxSamplesPerKey) {
         this.maxSamplesPerKey = maxSamplesPerKey;
     }
 
+    public Boolean allowPartialSearchResults() {
+        return allowPartialSearchResults;
+    }
+
+    public void allowPartialSearchResults(Boolean allowPartialSearchResults) {
+        this.allowPartialSearchResults = allowPartialSearchResults;
+    }
+
+    public Boolean allowPartialSequenceResults() {
+        return allowPartialSequenceResults;
+    }
+
+    public void allowPartialSequenceResults(Boolean allowPartialSequenceResults) {
+        this.allowPartialSequenceResults = allowPartialSequenceResults;
+    }
+
+    public Boolean expectShardFailures() {
+        return expectShardFailures;
+    }
+
+    public void expectShardFailures(Boolean expectShardFailures) {
+        this.expectShardFailures = expectShardFailures;
+    }
+
     @Override
     public String toString() {
         String str = "";
@@ -132,7 +159,15 @@ public String toString() {
         if (maxSamplesPerKey != null) {
             str = appendWithComma(str, "max_samples_per_key", "" + maxSamplesPerKey);
         }
-
+        if (allowPartialSearchResults != null) {
+            str = appendWithComma(str, "allow_partial_search_results", String.valueOf(allowPartialSearchResults));
+        }
+        if (allowPartialSequenceResults != null) {
+            str = appendWithComma(str, "allow_partial_sequence_results", String.valueOf(allowPartialSequenceResults));
+        }
+        if (expectShardFailures != null) {
+            str = appendWithComma(str, "expect_shard_failures", String.valueOf(expectShardFailures));
+        }
         return str;
     }
 
@@ -150,12 +185,22 @@ public boolean equals(Object other) {
 
         return Objects.equals(this.query(), that.query())
             && Objects.equals(size, that.size)
-            && Objects.equals(maxSamplesPerKey, that.maxSamplesPerKey);
+            && Objects.equals(maxSamplesPerKey, that.maxSamplesPerKey)
+            && Objects.equals(allowPartialSearchResults, that.allowPartialSearchResults)
+            && Objects.equals(allowPartialSequenceResults, that.allowPartialSequenceResults)
+            && Objects.equals(expectShardFailures, that.expectShardFailures);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(this.query, size, maxSamplesPerKey);
+        return Objects.hash(
+            this.query,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     private static String appendWithComma(String str, String name, String append) {
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecFailingShardsTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecFailingShardsTestCase.java
new file mode 100644
index 0000000000000..c490a2f703dcc
--- /dev/null
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecFailingShardsTestCase.java
@@ -0,0 +1,83 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.test.eql;
+
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import java.util.List;
+
+import static org.elasticsearch.test.eql.DataLoader.TEST_INDEX;
+import static org.elasticsearch.test.eql.DataLoader.TEST_SHARD_FAILURES_INDEX;
+
+public abstract class EqlSpecFailingShardsTestCase extends BaseEqlSpecTestCase {
+
+    @ParametersFactory(shuffle = false, argumentFormatting = PARAM_FORMATTING)
+    public static List<Object[]> readTestSpecs() throws Exception {
+
+        // Load EQL validation specs
+        return asArray(EqlSpecLoader.load("/test_failing_shards.toml"));
+    }
+
+    @Override
+    protected String tiebreaker() {
+        return "serial_event_id";
+    }
+
+    // constructor for "local" rest tests
+    public EqlSpecFailingShardsTestCase(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        this(
+            TEST_INDEX + "," + TEST_SHARD_FAILURES_INDEX,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
+    }
+
+    // constructor for multi-cluster tests
+    public EqlSpecFailingShardsTestCase(
+        String index,
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearch,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearch,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
+    }
+}
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecLoader.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecLoader.java
index a1f555563e29c..f86107cf3bac5 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecLoader.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecLoader.java
@@ -76,6 +76,10 @@ private static Integer getInteger(TomlTable table, String key) {
         return null;
     }
 
+    private static Boolean getBoolean(TomlTable table, String key) {
+        return table.getBoolean(key);
+    }
+
     private static List<EqlSpec> readFromStream(InputStream is, Set<String> uniqueTestNames) throws Exception {
         List<EqlSpec> testSpecs = new ArrayList<>();
 
@@ -90,6 +94,9 @@ private static List<EqlSpec> readFromStream(InputStream is, Set<String> uniqueTe
             spec.note(getTrimmedString(table, "note"));
             spec.description(getTrimmedString(table, "description"));
             spec.size(getInteger(table, "size"));
+            spec.allowPartialSearchResults(getBoolean(table, "allow_partial_search_results"));
+            spec.allowPartialSequenceResults(getBoolean(table, "allow_partial_sequence_results"));
+            spec.expectShardFailures(getBoolean(table, "expect_shard_failures"));
 
             List<?> arr = table.getList("tags");
             if (arr != null) {
diff --git a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecTestCase.java b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecTestCase.java
index 7113924f79029..62a3ea72fe51f 100644
--- a/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecTestCase.java
+++ b/x-pack/plugin/eql/qa/common/src/main/java/org/elasticsearch/test/eql/EqlSpecTestCase.java
@@ -28,8 +28,29 @@ protected String tiebreaker() {
     }
 
     // constructor for "local" rest tests
-    public EqlSpecTestCase(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        this(TEST_INDEX, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlSpecTestCase(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearch,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        this(
+            TEST_INDEX,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearch,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
     // constructor for multi-cluster tests
@@ -40,8 +61,22 @@ public EqlSpecTestCase(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearch,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(index, query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            index,
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearch,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.data b/x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.data
new file mode 100644
index 0000000000000..18a1d05656d09
--- /dev/null
+++ b/x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.data
@@ -0,0 +1,14 @@
+[
+  {
+    "event_subtype_full": "already_running",
+    "event_type": "process",
+    "event_type_full": "process_event",
+    "opcode": 3,
+    "pid": 0,
+    "process_name": "System Idle Process",
+    "serial_event_id": 10000,
+    "subtype": "create",
+    "timestamp": 117444736000000000,
+    "unique_pid": 1
+  }
+]
diff --git a/x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.mapping b/x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.mapping
new file mode 100644
index 0000000000000..3b5039f4098af
--- /dev/null
+++ b/x-pack/plugin/eql/qa/common/src/main/resources/data/endgame-shard-failures.mapping
@@ -0,0 +1,105 @@
+# Text patterns like "[runtime_random_keyword_type]" will get replaced at runtime with a random string type.
+# See DataLoader class for pattern replacements.
+{
+    "runtime":{
+          "broken":{
+            "type": "long",
+            "script": {
+              "lang": "painless",
+              "source": "emit(doc['non_existing'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))"
+            }
+        }
+    },
+    "properties" : {
+        "command_line" : {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "event_type" : {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "event" : {
+            "properties" : {
+                "category" : {
+                    "type" : "alias",
+                    "path" : "event_type"
+                },
+                "sequence" : {
+                    "type" : "alias",
+                    "path" : "serial_event_id"
+                }
+            }
+        },
+        "md5" : {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "parent_process_name": {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "parent_process_path": {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "pid" : {
+            "type" : "long"
+        },
+        "ppid" : {
+            "type" : "long"
+        },
+        "process_name": {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "process_path": {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "subtype" : {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "timestamp" : {
+            "type" : "date"
+        },
+        "@timestamp" : {
+            "type" : "date"
+        },
+        "user" : {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "user_name" : {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "user_domain": {
+            "type" : "[runtime_random_keyword_type]"
+        },
+        "hostname" : {
+            "type" : "text",
+            "fields" : {
+                "[runtime_random_keyword_type]" : {
+                    "type" : "[runtime_random_keyword_type]",
+                    "ignore_above" : 256
+                }
+            }
+        },
+        "opcode" : {
+            "type" : "long"
+        },
+        "file_name" : {
+            "type" : "text",
+            "fields" : {
+                "[runtime_random_keyword_type]" : {
+                    "type" : "[runtime_random_keyword_type]",
+                    "ignore_above" : 256
+                }
+            }
+        },
+        "file_path" : {
+          "type" : "[runtime_random_keyword_type]"
+        },
+        "serial_event_id" : {
+            "type" : "long"
+        },
+        "source_address" : {
+            "type" : "ip"
+        },
+        "exit_code" : {
+            "type" : "long"
+        }
+    }
+}
diff --git a/x-pack/plugin/eql/qa/common/src/main/resources/test_failing_shards.toml b/x-pack/plugin/eql/qa/common/src/main/resources/test_failing_shards.toml
new file mode 100644
index 0000000000000..a551c66fd48bd
--- /dev/null
+++ b/x-pack/plugin/eql/qa/common/src/main/resources/test_failing_shards.toml
@@ -0,0 +1,173 @@
+# this query doesn't touch the "broken" field, so it should not fail
+[[queries]]
+name = "eventQueryNoShardFailures"
+query = 'process where serial_event_id == 1'
+allow_partial_search_results = true
+expected_event_ids  = [1]
+expect_shard_failures = false
+
+
+[[queries]]
+name = "eventQueryShardFailures"
+query = 'process where serial_event_id == 1 or broken == 1'
+allow_partial_search_results = true
+expected_event_ids  = [1]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "eventQueryShardFailuresOptionalField"
+query = 'process where serial_event_id == 1 and ?optional_field_default_null == null or broken == 1'
+allow_partial_search_results = true
+expected_event_ids  = [1]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "eventQueryShardFailuresOptionalFieldMatching"
+query = 'process where serial_event_id == 2 and ?subtype == "create" or broken == 1'
+allow_partial_search_results = true
+expected_event_ids  = [2]
+expect_shard_failures = true
+
+
+# this query doesn't touch the "broken" field, so it should not fail
+[[queries]]
+name = "sequenceQueryNoShardFailures"
+query = '''
+sequence
+  [process where serial_event_id == 1]
+  [process where serial_event_id == 2]
+'''
+expected_event_ids  = [1, 2]
+expect_shard_failures = false
+
+
+# this query doesn't touch the "broken" field, so it should not fail
+[[queries]]
+name = "sequenceQueryNoShardFailuresAllowFalse"
+query = '''
+sequence
+  [process where serial_event_id == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = false
+expected_event_ids  = [1, 2]
+expect_shard_failures = false
+
+
+# this query doesn't touch the "broken" field, so it should not fail
+[[queries]]
+name = "sequenceQueryNoShardFailuresAllowTrue"
+query = '''
+sequence
+  [process where serial_event_id == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+expected_event_ids  = [1, 2]
+expect_shard_failures = false
+
+
+[[queries]]
+name = "sequenceQueryMissingShards"
+query = '''
+sequence
+  [process where serial_event_id == 1 or broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+expected_event_ids  = []
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sequenceQueryMissingShardsPartialResults"
+query = '''
+sequence
+  [process where serial_event_id == 1 or broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+allow_partial_sequence_results = true
+expected_event_ids  = [1, 2]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sequenceQueryMissingShardsPartialResultsOptional"
+query = '''
+sequence
+  [process where ?serial_event_id == 1 or broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+allow_partial_sequence_results = true
+expected_event_ids  = [1, 2]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sequenceQueryMissingShardsPartialResultsOptional2"
+query = '''
+sequence with maxspan=100000d
+  [process where serial_event_id == 1 and ?subtype == "create" or broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+allow_partial_sequence_results = true
+expected_event_ids  = [1, 2]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sequenceQueryMissingShardsPartialResultsOptionalMissing"
+query = '''
+sequence with maxspan=100000d
+  [process where serial_event_id == 1 and ?subtype == "create"]
+ ![process where broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+allow_partial_sequence_results = true
+expected_event_ids  = [1, -1, 2]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sequenceQueryMissingShardsPartialResultsOptionalMissing2"
+query = '''
+sequence with maxspan=100000d
+  [process where serial_event_id == 1 and ?subtype == "create" or broken == 1]
+ ![process where broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+allow_partial_sequence_results = true
+expected_event_ids  = [1, -1, 2]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sampleQueryMissingShardsPartialResults"
+query = '''
+sample by event_subtype_full
+  [process where serial_event_id == 1 or broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+expected_event_ids  = [1, 2]
+expect_shard_failures = true
+
+
+[[queries]]
+name = "sampleQueryMissingShardsPartialResultsOptional"
+query = '''
+sample by event_subtype_full
+  [process where serial_event_id == 1 and ?subtype == "create" or broken == 1]
+  [process where serial_event_id == 2]
+'''
+allow_partial_search_results = true
+expected_event_ids  = [1, 2]
+expect_shard_failures = true
+
diff --git a/x-pack/plugin/eql/qa/mixed-node/src/javaRestTest/java/org/elasticsearch/xpack/eql/qa/mixed_node/EqlSearchIT.java b/x-pack/plugin/eql/qa/mixed-node/src/javaRestTest/java/org/elasticsearch/xpack/eql/qa/mixed_node/EqlSearchIT.java
index 2a29572374fa8..60c7fb1c7ad25 100644
--- a/x-pack/plugin/eql/qa/mixed-node/src/javaRestTest/java/org/elasticsearch/xpack/eql/qa/mixed_node/EqlSearchIT.java
+++ b/x-pack/plugin/eql/qa/mixed-node/src/javaRestTest/java/org/elasticsearch/xpack/eql/qa/mixed_node/EqlSearchIT.java
@@ -407,7 +407,16 @@ private void assertMultiValueFunctionQuery(
         for (int id : ids) {
             eventIds.add(String.valueOf(id));
         }
-        request.setJsonEntity("{\"query\":\"" + query + "\"}");
+
+        StringBuilder payload = new StringBuilder("{\"query\":\"" + query + "\"");
+        if (randomBoolean()) {
+            payload.append(", \"allow_partial_search_results\": true");
+        }
+        if (randomBoolean()) {
+            payload.append(", \"allow_partial_sequence_results\": true");
+        }
+        payload.append("}");
+        request.setJsonEntity(payload.toString());
         assertResponse(query, eventIds, runEql(client, request));
         testedFunctions.add(functionName);
     }
diff --git a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java
index c20968871472f..5d6824232d80f 100644
--- a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java
+++ b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java
@@ -37,7 +37,28 @@ protected String getRemoteCluster() {
         return REMOTE_CLUSTER.getHttpAddresses();
     }
 
-    public EqlDateNanosIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(remoteClusterIndex(TEST_NANOS_INDEX), query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlDateNanosIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            remoteClusterIndex(TEST_NANOS_INDEX),
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java
index 774c19d02adf0..79b095434814b 100644
--- a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java
+++ b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java
@@ -37,7 +37,28 @@ protected String getRemoteCluster() {
         return REMOTE_CLUSTER.getHttpAddresses();
     }
 
-    public EqlExtraIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(remoteClusterIndex(TEST_EXTRA_INDEX), query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlExtraIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            remoteClusterIndex(TEST_EXTRA_INDEX),
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java
index 1502c250bd058..7673eec32ec55 100644
--- a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java
+++ b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java
@@ -37,7 +37,28 @@ protected String getRemoteCluster() {
         return REMOTE_CLUSTER.getHttpAddresses();
     }
 
-    public EqlSampleIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(remoteClusterPattern(TEST_SAMPLE), query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlSampleIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            remoteClusterPattern(TEST_SAMPLE),
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java
index 795fe4e103a31..ac6f7fe508c99 100644
--- a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java
+++ b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java
@@ -43,8 +43,22 @@ public EqlSampleMultipleEntriesIT(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(remoteClusterPattern(TEST_SAMPLE_MULTI), query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            remoteClusterPattern(TEST_SAMPLE_MULTI),
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java
index 2cddecb644a1a..db0c03e8fdb6f 100644
--- a/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java
+++ b/x-pack/plugin/eql/qa/multi-cluster-with-security/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java
@@ -37,7 +37,28 @@ protected String getRemoteCluster() {
         return REMOTE_CLUSTER.getHttpAddresses();
     }
 
-    public EqlSpecIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(remoteClusterIndex(TEST_INDEX), query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlSpecIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            remoteClusterIndex(TEST_INDEX),
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java
index 1df10fde7fde5..5e1fa224de58d 100644
--- a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlDateNanosIT.java
@@ -27,7 +27,27 @@ protected String getTestRestCluster() {
         return cluster.getHttpAddresses();
     }
 
-    public EqlDateNanosIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlDateNanosIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java
index 8af8fcac087b5..cb92eddeb0410 100644
--- a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlExtraIT.java
@@ -27,7 +27,27 @@ protected String getTestRestCluster() {
         return cluster.getHttpAddresses();
     }
 
-    public EqlExtraIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlExtraIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlMissingEventsIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlMissingEventsIT.java
index 05557fb4883b3..4f1faf3322e7f 100644
--- a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlMissingEventsIT.java
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlMissingEventsIT.java
@@ -27,8 +27,28 @@ protected String getTestRestCluster() {
         return cluster.getHttpAddresses();
     }
 
-    public EqlMissingEventsIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlMissingEventsIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java
index dc2c653fad89e..c0bce3ffc9e4f 100644
--- a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleIT.java
@@ -27,8 +27,28 @@ protected String getTestRestCluster() {
         return cluster.getHttpAddresses();
     }
 
-    public EqlSampleIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlSampleIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java
index af1ade9120bbd..f50ee36095ae0 100644
--- a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSampleMultipleEntriesIT.java
@@ -33,9 +33,22 @@ public EqlSampleMultipleEntriesIT(
         List<long[]> eventIds,
         String[] joinKeys,
         Integer size,
-        Integer maxSamplesPerKey
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
     ) {
-        super(query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecFailingShardsIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecFailingShardsIT.java
new file mode 100644
index 0000000000000..cf05811a77857
--- /dev/null
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecFailingShardsIT.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.eql;
+
+import com.carrotsearch.randomizedtesting.annotations.ThreadLeakFilters;
+
+import org.elasticsearch.test.TestClustersThreadFilter;
+import org.elasticsearch.test.cluster.ElasticsearchCluster;
+import org.elasticsearch.test.eql.EqlSpecFailingShardsTestCase;
+import org.junit.ClassRule;
+
+import java.util.List;
+
+@ThreadLeakFilters(filters = TestClustersThreadFilter.class)
+public class EqlSpecFailingShardsIT extends EqlSpecFailingShardsTestCase {
+
+    @ClassRule
+    public static final ElasticsearchCluster cluster = EqlTestCluster.CLUSTER;
+
+    @Override
+    protected String getTestRestCluster() {
+        return cluster.getHttpAddresses();
+    }
+
+    public EqlSpecFailingShardsIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
+    }
+}
diff --git a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java
index 7aac0ae336c8a..0aad5cc1b73da 100644
--- a/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java
+++ b/x-pack/plugin/eql/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/eql/EqlSpecIT.java
@@ -27,7 +27,27 @@ protected String getTestRestCluster() {
         return cluster.getHttpAddresses();
     }
 
-    public EqlSpecIT(String query, String name, List<long[]> eventIds, String[] joinKeys, Integer size, Integer maxSamplesPerKey) {
-        super(query, name, eventIds, joinKeys, size, maxSamplesPerKey);
+    public EqlSpecIT(
+        String query,
+        String name,
+        List<long[]> eventIds,
+        String[] joinKeys,
+        Integer size,
+        Integer maxSamplesPerKey,
+        Boolean allowPartialSearchResults,
+        Boolean allowPartialSequenceResults,
+        Boolean expectShardFailures
+    ) {
+        super(
+            query,
+            name,
+            eventIds,
+            joinKeys,
+            size,
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults,
+            expectShardFailures
+        );
     }
 }
diff --git a/x-pack/plugin/eql/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/eql/10_basic.yml b/x-pack/plugin/eql/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/eql/10_basic.yml
index e49264d76d5e9..c7974f3b584b4 100644
--- a/x-pack/plugin/eql/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/eql/10_basic.yml
+++ b/x-pack/plugin/eql/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/eql/10_basic.yml
@@ -83,6 +83,34 @@ setup:
             id: 123
             valid: true
 
+  - do:
+      indices.create:
+        index:  eql_test_rebel
+        body:
+          mappings:
+            properties:
+              some_keyword:
+                type: keyword
+            runtime:
+              day_of_week:
+                type: keyword
+                script:
+                  source: "throw new IllegalArgumentException(\"rebel shards\")"
+  - do:
+      bulk:
+        refresh: true
+        body:
+          - index:
+              _index: eql_test_rebel
+              _id:    "1"
+          - event:
+              - category: process
+            "@timestamp": 2020-02-03T12:34:56Z
+            user: SYSTEM
+            id: 123
+            valid: false
+            some_keyword: longer than normal
+
 ---
 # Testing round-trip and the basic shape of the response
 "Execute some EQL.":
@@ -478,3 +506,118 @@ setup:
           query: 'sequence with maxspan=10d [network where user == "ADMIN"] ![network where used == "SYSTEM"]'
   - match: { error.root_cause.0.type: "verification_exception" }
   - match: { error.root_cause.0.reason: "Found 1 problem\nline 1:75: Unknown column [used], did you mean [user]?" }
+
+
+---
+"Execute query shard failures and with allow_partial_search_results":
+  - do:
+      eql.search:
+        index: eql_test*
+        body:
+          query: 'process where user == "SYSTEM" and day_of_week == "Monday"'
+          fields: [{"field":"@timestamp","format":"epoch_millis"},"id","valid","day_of_week"]
+          allow_partial_search_results: true
+
+  - match: {timed_out: false}
+  - match: {hits.total.value: 1}
+  - match: {hits.total.relation: "eq"}
+  - match: {hits.events.0._source.user: "SYSTEM"}
+  - match: {hits.events.0._id: "1"}
+  - match: {hits.events.0.fields.@timestamp: ["1580733296000"]}
+  - match: {hits.events.0.fields.id: [123]}
+  - match: {hits.events.0.fields.valid: [false]}
+  - match: {hits.events.0.fields.day_of_week: ["Monday"]}
+  - match: {shard_failures.0.index: "eql_test_rebel"}
+
+
+---
+"Execute query shard failures and with allow_partial_search_results as request param":
+  - do:
+      eql.search:
+        index: eql_test*
+        allow_partial_search_results: true
+        body:
+          query: 'process where user == "SYSTEM" and day_of_week == "Monday"'
+          fields: [{"field":"@timestamp","format":"epoch_millis"},"id","valid","day_of_week"]
+
+  - match: {timed_out: false}
+  - match: {hits.total.value: 1}
+  - match: {hits.total.relation: "eq"}
+  - match: {hits.events.0._source.user: "SYSTEM"}
+  - match: {hits.events.0._id: "1"}
+  - match: {hits.events.0.fields.@timestamp: ["1580733296000"]}
+  - match: {hits.events.0.fields.id: [123]}
+  - match: {hits.events.0.fields.valid: [false]}
+  - match: {hits.events.0.fields.day_of_week: ["Monday"]}
+  - match: {shard_failures.0.index: "eql_test_rebel"}
+
+
+---
+"Execute sequence with shard failures and allow_partial_search_results=true":
+  - do:
+      eql.search:
+        index: eql_test*
+        body:
+          query: 'sequence [process where user == "SYSTEM" and day_of_week == "Monday"] [process where user == "SYSTEM" and day_of_week == "Tuesday"]'
+          fields: [{"field":"@timestamp","format":"epoch_millis"},"id","valid","day_of_week"]
+          allow_partial_search_results: true
+
+  - match: {timed_out: false}
+  - match: {hits.total.value: 0}
+  - match: {shard_failures.0.index: "eql_test_rebel"}
+
+
+---
+"Execute sequence with shard failures, allow_partial_search_results=true and allow_partial_sequence_results=true":
+  - do:
+      eql.search:
+        index: eql_test*
+        body:
+          query: 'sequence [process where user == "SYSTEM" and day_of_week == "Monday"] [process where user == "SYSTEM" and day_of_week == "Tuesday"]'
+          fields: [{"field":"@timestamp","format":"epoch_millis"},"id","valid","day_of_week"]
+          allow_partial_search_results: true
+          allow_partial_sequence_results: true
+
+  - match: {timed_out: false}
+  - match: {hits.total.value: 1}
+  - match: {hits.total.relation: "eq"}
+  - match: {hits.sequences.0.events.0._source.user: "SYSTEM"}
+  - match: {hits.sequences.0.events.0._id: "1"}
+  - match: {hits.sequences.0.events.0.fields.@timestamp: ["1580733296000"]}
+  - match: {hits.sequences.0.events.0.fields.id: [123]}
+  - match: {hits.sequences.0.events.0.fields.valid: [false]}
+  - match: {hits.sequences.0.events.0.fields.day_of_week: ["Monday"]}
+  - match: {hits.sequences.0.events.1._id: "2"}
+  - match: {hits.sequences.0.events.1.fields.@timestamp: ["1580819696000"]}
+  - match: {hits.sequences.0.events.1.fields.id: [123]}
+  - match: {hits.sequences.0.events.1.fields.valid: [true]}
+  - match: {hits.sequences.0.events.1.fields.day_of_week: ["Tuesday"]}
+  - match: {shard_failures.0.index: "eql_test_rebel"}
+
+
+---
+"Execute sequence with shard failures, allow_partial_search_results=true and allow_partial_sequence_results=true as query params":
+  - do:
+      eql.search:
+        index: eql_test*
+        allow_partial_search_results: true
+        allow_partial_sequence_results: true
+        body:
+          query: 'sequence [process where user == "SYSTEM" and day_of_week == "Monday"] [process where user == "SYSTEM" and day_of_week == "Tuesday"]'
+          fields: [{"field":"@timestamp","format":"epoch_millis"},"id","valid","day_of_week"]
+
+  - match: {timed_out: false}
+  - match: {hits.total.value: 1}
+  - match: {hits.total.relation: "eq"}
+  - match: {hits.sequences.0.events.0._source.user: "SYSTEM"}
+  - match: {hits.sequences.0.events.0._id: "1"}
+  - match: {hits.sequences.0.events.0.fields.@timestamp: ["1580733296000"]}
+  - match: {hits.sequences.0.events.0.fields.id: [123]}
+  - match: {hits.sequences.0.events.0.fields.valid: [false]}
+  - match: {hits.sequences.0.events.0.fields.day_of_week: ["Monday"]}
+  - match: {hits.sequences.0.events.1._id: "2"}
+  - match: {hits.sequences.0.events.1.fields.@timestamp: ["1580819696000"]}
+  - match: {hits.sequences.0.events.1.fields.id: [123]}
+  - match: {hits.sequences.0.events.1.fields.valid: [true]}
+  - match: {hits.sequences.0.events.1.fields.day_of_week: ["Tuesday"]}
+  - match: {shard_failures.0.index: "eql_test_rebel"}
diff --git a/x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/CCSPartialResultsIT.java b/x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/CCSPartialResultsIT.java
new file mode 100644
index 0000000000000..da6bb6180428b
--- /dev/null
+++ b/x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/CCSPartialResultsIT.java
@@ -0,0 +1,613 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.eql.action;
+
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsAction;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
+import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.test.AbstractMultiClustersTestCase;
+import org.elasticsearch.xpack.eql.plugin.EqlPlugin;
+
+import java.io.IOException;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.concurrent.ExecutionException;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+
+public class CCSPartialResultsIT extends AbstractMultiClustersTestCase {
+
+    static String REMOTE_CLUSTER = "cluster_a";
+
+    protected Collection<Class<? extends Plugin>> nodePlugins(String cluster) {
+        return Collections.singletonList(LocalStateEQLXPackPlugin.class);
+    }
+
+    protected final Client localClient() {
+        return client(LOCAL_CLUSTER);
+    }
+
+    @Override
+    protected List<String> remoteClusterAlias() {
+        return List.of(REMOTE_CLUSTER);
+    }
+
+    @Override
+    protected boolean reuseClusters() {
+        return false;
+    }
+
+    /**
+     *
+     * @return remote node name
+     */
+    private String createSchema() {
+        final Client remoteClient = client(REMOTE_CLUSTER);
+        final String remoteNode = cluster(REMOTE_CLUSTER).startDataOnlyNode();
+        final String remoteNode2 = cluster(REMOTE_CLUSTER).startDataOnlyNode();
+
+        assertAcked(
+            remoteClient.admin()
+                .indices()
+                .prepareCreate("test-1-remote")
+                .setSettings(
+                    Settings.builder()
+                        .put("index.routing.allocation.require._name", remoteNode)
+                        .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                        .build()
+                )
+                .setMapping("@timestamp", "type=date"),
+            TimeValue.timeValueSeconds(60)
+        );
+
+        assertAcked(
+            remoteClient.admin()
+                .indices()
+                .prepareCreate("test-2-remote")
+                .setSettings(
+                    Settings.builder()
+                        .put("index.routing.allocation.require._name", remoteNode2)
+                        .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                        .build()
+                )
+                .setMapping("@timestamp", "type=date"),
+            TimeValue.timeValueSeconds(60)
+        );
+
+        for (int i = 0; i < 5; i++) {
+            int val = i * 2;
+            remoteClient.prepareIndex("test-1-remote")
+                .setId(Integer.toString(i))
+                .setSource("@timestamp", 100000 + val, "event.category", "process", "key", "same", "value", val)
+                .get();
+        }
+        for (int i = 0; i < 5; i++) {
+            int val = i * 2 + 1;
+            remoteClient.prepareIndex("test-2-remote")
+                .setId(Integer.toString(i))
+                .setSource("@timestamp", 100000 + val, "event.category", "process", "key", "same", "value", val)
+                .get();
+        }
+
+        remoteClient.admin().indices().prepareRefresh().get();
+        return remoteNode;
+    }
+
+    // ------------------------------------------------------------------------
+    // queries with full cluster (no missing shards)
+    // ------------------------------------------------------------------------
+
+    public void testNoFailures() throws ExecutionException, InterruptedException, IOException {
+        createSchema();
+
+        // event query
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("process where true")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        EqlSearchResponse response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(10));
+        for (int i = 0; i < 10; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + i));
+        }
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query on both shards
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 2]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        EqlSearchResponse.Sequence sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 2"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 3]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 3"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 0] [process where value == 2]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 0"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 2"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query with missing event on unavailable shard
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence with maxspan=10s [process where value == 1] ![process where value == 2] [process where value == 3]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sample query on both shards
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        EqlSearchResponse.Sequence sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 2"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 2"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 0"));
+        assertThat(response.shardFailures().length, is(0));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards and allow_partial_search_results=true
+    // and allow_partial_sequence_result=true
+    // ------------------------------------------------------------------------
+
+    public void testAllowPartialSearchAndSequence_event() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        // event query
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("process where true")
+            .allowPartialSearchResults(true);
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+    }
+
+    public void testAllowPartialSearchAndSequence_sequence() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        // sequence query on both shards
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 2]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 3]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 3"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 0] [process where value == 2]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(2).toString(), containsString("\"value\" : 3"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    public void testAllowPartialSearchAndSequence_sample() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        // sample query on both shards
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards and allow_partial_search_results=true
+    // and default allow_partial_sequence_results (ie. false)
+    // ------------------------------------------------------------------------
+
+    public void testAllowPartialSearch_event() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        // event query
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("process where true")
+            .allowPartialSearchResults(true);
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+
+    }
+
+    public void testAllowPartialSearch_sequence() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        // sequence query on both shards
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 2]")
+            .allowPartialSearchResults(true);
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 3]")
+            .allowPartialSearchResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 0] [process where value == 2]")
+            .allowPartialSearchResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]")
+            .allowPartialSearchResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    public void testAllowPartialSearch_sample() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        // sample query on both shards
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]")
+            .allowPartialSearchResults(true);
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]")
+            .allowPartialSearchResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]")
+            .allowPartialSearchResults(true);
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards and with default xpack.eql.default_allow_partial_results=true
+    // ------------------------------------------------------------------------
+
+    public void testClusterSetting_event() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        cluster(REMOTE_CLUSTER).client()
+            .execute(
+                ClusterUpdateSettingsAction.INSTANCE,
+                new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                    Settings.builder().put(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey(), true)
+                )
+            )
+            .get();
+
+        // event query
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*").query("process where true");
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+
+        localClient().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().putNull(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey())
+            )
+        ).get();
+    }
+
+    public void testClusterSetting_sequence() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        cluster(REMOTE_CLUSTER).client()
+            .execute(
+                ClusterUpdateSettingsAction.INSTANCE,
+                new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                    Settings.builder().put(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey(), true)
+                )
+            )
+            .get();
+        // sequence query on both shards
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 2]");
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 1] [process where value == 3]");
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence [process where value == 0] [process where value == 2]");
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]");
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        localClient().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().putNull(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey())
+            )
+        ).get();
+    }
+
+    public void testClusterSetting_sample() throws ExecutionException, InterruptedException, IOException {
+        var remoteNode = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        cluster(REMOTE_CLUSTER).stopNode(remoteNode);
+
+        cluster(REMOTE_CLUSTER).client()
+            .execute(
+                ClusterUpdateSettingsAction.INSTANCE,
+                new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                    Settings.builder().put(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey(), true)
+                )
+            )
+            .get();
+
+        // sample query on both shards
+        var request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]");
+        var response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]");
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices(REMOTE_CLUSTER + ":test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]");
+        response = localClient().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1-remote"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        localClient().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().putNull(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey())
+            )
+        ).get();
+    }
+}
diff --git a/x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/PartialSearchResultsIT.java b/x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/PartialSearchResultsIT.java
new file mode 100644
index 0000000000000..9048d11f4eddf
--- /dev/null
+++ b/x-pack/plugin/eql/src/internalClusterTest/java/org/elasticsearch/xpack/eql/action/PartialSearchResultsIT.java
@@ -0,0 +1,780 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.eql.action;
+
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsAction;
+import org.elasticsearch.action.admin.cluster.settings.ClusterUpdateSettingsRequest;
+import org.elasticsearch.action.search.SearchPhaseExecutionException;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.CollectionUtils;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.search.SearchService;
+import org.elasticsearch.test.transport.MockTransportService;
+import org.elasticsearch.xpack.core.async.GetAsyncResultRequest;
+import org.elasticsearch.xpack.eql.plugin.EqlAsyncGetResultAction;
+import org.elasticsearch.xpack.eql.plugin.EqlPlugin;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.concurrent.ExecutionException;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.is;
+
+public class PartialSearchResultsIT extends AbstractEqlIntegTestCase {
+
+    @Override
+    protected Collection<Class<? extends Plugin>> nodePlugins() {
+        return CollectionUtils.appendToCopy(super.nodePlugins(), MockTransportService.TestPlugin.class);
+    }
+
+    @Override
+    protected Settings nodeSettings(int nodeOrdinal, Settings otherSettings) {
+        return Settings.builder()
+            .put(super.nodeSettings(nodeOrdinal, otherSettings))
+            .put(SearchService.KEEPALIVE_INTERVAL_SETTING.getKey(), TimeValue.timeValueMillis(randomIntBetween(100, 500)))
+            .build();
+    }
+
+    /**
+     *
+     * @return node name where the first index is
+     */
+    private String createSchema() {
+        internalCluster().ensureAtLeastNumDataNodes(2);
+        final List<String> dataNodes = internalCluster().clusterService()
+            .state()
+            .nodes()
+            .getDataNodes()
+            .values()
+            .stream()
+            .map(DiscoveryNode::getName)
+            .toList();
+        final String assignedNodeForIndex1 = randomFrom(dataNodes);
+
+        assertAcked(
+            indicesAdmin().prepareCreate("test-1")
+                .setSettings(
+                    Settings.builder()
+                        .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                        .put("index.routing.allocation.include._name", assignedNodeForIndex1)
+                        .build()
+                )
+                .setMapping("@timestamp", "type=date")
+        );
+        assertAcked(
+            indicesAdmin().prepareCreate("test-2")
+                .setSettings(
+                    Settings.builder()
+                        .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+                        .put("index.routing.allocation.exclude._name", assignedNodeForIndex1)
+                        .build()
+                )
+                .setMapping("@timestamp", "type=date")
+        );
+
+        for (int i = 0; i < 5; i++) {
+            int val = i * 2;
+            prepareIndex("test-1").setId(Integer.toString(i))
+                .setSource("@timestamp", 100000 + val, "event.category", "process", "key", "same", "value", val)
+                .get();
+        }
+        for (int i = 0; i < 5; i++) {
+            int val = i * 2 + 1;
+            prepareIndex("test-2").setId(Integer.toString(i))
+                .setSource("@timestamp", 100000 + val, "event.category", "process", "key", "same", "value", val)
+                .get();
+        }
+        refresh();
+        return assignedNodeForIndex1;
+    }
+
+    public void testNoFailures() throws Exception {
+        createSchema();
+
+        // ------------------------------------------------------------------------
+        // queries with full cluster (no missing shards)
+        // ------------------------------------------------------------------------
+
+        // event query
+        var request = new EqlSearchRequest().indices("test-*")
+            .query("process where true")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        EqlSearchResponse response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(10));
+        for (int i = 0; i < 10; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + i));
+        }
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query on both shards
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 1] [process where value == 2]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        EqlSearchResponse.Sequence sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 2"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 1] [process where value == 3]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 3"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 0] [process where value == 2]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 0"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 2"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sequence query with missing event on unavailable shard
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence with maxspan=10s [process where value == 1] ![process where value == 2] [process where value == 3]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sample query on both shards
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        EqlSearchResponse.Sequence sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 2"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(0));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]")
+            .allowPartialSearchResults(randomBoolean())
+            .allowPartialSequenceResults(randomBoolean());
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 2"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 0"));
+        assertThat(response.shardFailures().length, is(0));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards. Let them fail
+    // allow_partial_sequence_results has no effect if allow_partial_sequence_results is not set to true.
+    // ------------------------------------------------------------------------
+
+    public void testFailures_event() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // event query
+        shouldFail("process where true");
+
+    }
+
+    public void testFailures_sequence() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sequence query on both shards
+        shouldFail("sequence [process where value == 1] [process where value == 2]");
+
+        // sequence query on the available shard only
+        shouldFail("sequence [process where value == 1] [process where value == 3]");
+
+        // sequence query on the unavailable shard only
+        shouldFail("sequence [process where value == 0] [process where value == 2]");
+
+        // sequence query with missing event on unavailable shard.
+        shouldFail("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]");
+    }
+
+    public void testFailures_sample() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sample query on both shards
+        shouldFail("sample by key [process where value == 2] [process where value == 1]");
+
+        // sample query on the available shard only
+        shouldFail("sample by key [process where value == 3] [process where value == 1]");
+
+        // sample query on the unavailable shard only
+        shouldFail("sample by key [process where value == 2] [process where value == 0]");
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards and allow_partial_search_results=true
+    // and allow_partial_sequence_result=true
+    // ------------------------------------------------------------------------
+
+    public void testAllowPartialSearchAndSequenceResults_event() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // event query
+        var request = new EqlSearchRequest().indices("test-*").query("process where true").allowPartialSearchResults(true);
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+
+    }
+
+    public void testAllowPartialSearchAndSequenceResults_sequence() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sequence query on both shards
+        var request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 1] [process where value == 2]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 1] [process where value == 3]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(1).toString(), containsString("\"value\" : 3"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 0] [process where value == 2]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        sequence = response.hits().sequences().get(0);
+        assertThat(sequence.events().get(0).toString(), containsString("\"value\" : 1"));
+        assertThat(sequence.events().get(2).toString(), containsString("\"value\" : 3"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    public void testAllowPartialSearchAndSequenceResults_sample() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sample query on both shards
+        var request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]")
+            .allowPartialSearchResults(true)
+            .allowPartialSequenceResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards and allow_partial_search_results=true
+    // and default allow_partial_sequence_results (ie. false)
+    // ------------------------------------------------------------------------
+
+    public void testAllowPartialSearchResults_event() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // event query
+        var request = new EqlSearchRequest().indices("test-*").query("process where true").allowPartialSearchResults(true);
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+
+    }
+
+    public void testAllowPartialSearchResults_sequence() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sequence query on both shards
+        var request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 1] [process where value == 2]")
+            .allowPartialSearchResults(true);
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 1] [process where value == 3]")
+            .allowPartialSearchResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence [process where value == 0] [process where value == 2]")
+            .allowPartialSearchResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]")
+            .allowPartialSearchResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    public void testAllowPartialSearchResults_sample() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sample query on both shards
+        var request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 2] [process where value == 1]")
+            .allowPartialSearchResults(true);
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 3] [process where value == 1]")
+            .allowPartialSearchResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sample by key [process where value == 2] [process where value == 0]")
+            .allowPartialSearchResults(true);
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, this time async, with missing shards and allow_partial_search_results=true
+    // and default allow_partial_sequence_results (ie. false)
+    // ------------------------------------------------------------------------
+
+    public void testAsyncAllowPartialSearchResults_event() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // event query
+        var response = runAsync("process where true", true);
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+
+    }
+
+    public void testAsyncAllowPartialSearchResults_sequence() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        // sequence query on both shards
+        var response = runAsync("sequence [process where value == 1] [process where value == 2]", true);
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        response = runAsync("sequence [process where value == 1] [process where value == 3]", true);
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        response = runAsync("sequence [process where value == 0] [process where value == 2]", true);
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        response = runAsync(
+            "sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]",
+            true
+        );
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    public void testAsyncAllowPartialSearchResults_sample() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+        // sample query on both shards
+        var response = runAsync("sample by key [process where value == 2] [process where value == 1]", true);
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        response = runAsync("sample by key [process where value == 3] [process where value == 1]", true);
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        response = runAsync("sample by key [process where value == 2] [process where value == 0]", true);
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+    }
+
+    // ------------------------------------------------------------------------
+    // same queries, with missing shards and with default xpack.eql.default_allow_partial_results=true
+    // ------------------------------------------------------------------------
+
+    public void testClusterSetting_event() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        client().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().put(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey(), true)
+            )
+        ).get();
+
+        // event query
+        var request = new EqlSearchRequest().indices("test-*").query("process where true");
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().events().size(), equalTo(5));
+        for (int i = 0; i < 5; i++) {
+            assertThat(response.hits().events().get(i).toString(), containsString("\"value\" : " + (i * 2 + 1)));
+        }
+        assertThat(response.shardFailures().length, is(1));
+
+        client().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().putNull(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey())
+            )
+        ).get();
+    }
+
+    public void testClusterSetting_sequence() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        client().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().put(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey(), true)
+            )
+        ).get();
+        // sequence query on both shards
+        var request = new EqlSearchRequest().indices("test-*").query("sequence [process where value == 1] [process where value == 2]");
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the available shard only
+        request = new EqlSearchRequest().indices("test-*").query("sequence [process where value == 1] [process where value == 3]");
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*").query("sequence [process where value == 0] [process where value == 2]");
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sequence query with missing event on unavailable shard. THIS IS A FALSE POSITIVE
+        request = new EqlSearchRequest().indices("test-*")
+            .query("sequence with maxspan=10s  [process where value == 1] ![process where value == 2] [process where value == 3]");
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        client().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().putNull(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey())
+            )
+        ).get();
+    }
+
+    public void testClusterSetting_sample() throws Exception {
+        final String assignedNodeForIndex1 = createSchema();
+        // ------------------------------------------------------------------------
+        // stop one of the nodes, make one of the shards unavailable
+        // ------------------------------------------------------------------------
+
+        internalCluster().stopNode(assignedNodeForIndex1);
+
+        client().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().put(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey(), true)
+            )
+        ).get();
+
+        // sample query on both shards
+        var request = new EqlSearchRequest().indices("test-*").query("sample by key [process where value == 2] [process where value == 1]");
+        var response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the available shard only
+        request = new EqlSearchRequest().indices("test-*").query("sample by key [process where value == 3] [process where value == 1]");
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(1));
+        var sample = response.hits().sequences().get(0);
+        assertThat(sample.events().get(0).toString(), containsString("\"value\" : 3"));
+        assertThat(sample.events().get(1).toString(), containsString("\"value\" : 1"));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        // sample query on the unavailable shard only
+        request = new EqlSearchRequest().indices("test-*").query("sample by key [process where value == 2] [process where value == 0]");
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        assertThat(response.hits().sequences().size(), equalTo(0));
+        assertThat(response.shardFailures().length, is(1));
+        assertThat(response.shardFailures()[0].index(), is("test-1"));
+        assertThat(response.shardFailures()[0].reason(), containsString("NoShardAvailableActionException"));
+
+        client().execute(
+            ClusterUpdateSettingsAction.INSTANCE,
+            new ClusterUpdateSettingsRequest(TimeValue.THIRTY_SECONDS, TimeValue.THIRTY_SECONDS).persistentSettings(
+                Settings.builder().putNull(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getKey())
+            )
+        ).get();
+    }
+
+    private static EqlSearchResponse runAsync(String query, Boolean allowPartialSearchResults) throws InterruptedException,
+        ExecutionException {
+        EqlSearchRequest request;
+        EqlSearchResponse response;
+        request = new EqlSearchRequest().indices("test-*").query(query).waitForCompletionTimeout(TimeValue.ZERO);
+        if (allowPartialSearchResults != null) {
+            request = request.allowPartialSearchResults(allowPartialSearchResults);
+        }
+        response = client().execute(EqlSearchAction.INSTANCE, request).get();
+        while (response.isRunning()) {
+            GetAsyncResultRequest getResultsRequest = new GetAsyncResultRequest(response.id()).setKeepAlive(TimeValue.timeValueMinutes(10))
+                .setWaitForCompletionTimeout(TimeValue.timeValueMillis(10));
+            response = client().execute(EqlAsyncGetResultAction.INSTANCE, getResultsRequest).get();
+        }
+        return response;
+    }
+
+    private static void shouldFail(String query) throws InterruptedException {
+        EqlSearchRequest request = new EqlSearchRequest().indices("test-*").query(query);
+        if (randomBoolean()) {
+            request = request.allowPartialSearchResults(false);
+        }
+        if (randomBoolean()) {
+            request = request.allowPartialSequenceResults(randomBoolean());
+        }
+        try {
+            client().execute(EqlSearchAction.INSTANCE, request).get();
+            fail();
+        } catch (ExecutionException e) {
+            assertThat(e.getCause(), instanceOf(SearchPhaseExecutionException.class));
+        }
+    }
+}
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchRequest.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchRequest.java
index 0aeddd525e317..5804e11b72ff5 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchRequest.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchRequest.java
@@ -63,6 +63,8 @@ public class EqlSearchRequest extends ActionRequest implements IndicesRequest.Re
     private List<FieldAndFormat> fetchFields;
     private Map<String, Object> runtimeMappings = emptyMap();
     private int maxSamplesPerKey = RequestDefaults.MAX_SAMPLES_PER_KEY;
+    private Boolean allowPartialSearchResults;
+    private Boolean allowPartialSequenceResults;
 
     // Async settings
     private TimeValue waitForCompletionTimeout = null;
@@ -83,6 +85,8 @@ public class EqlSearchRequest extends ActionRequest implements IndicesRequest.Re
     static final String KEY_FETCH_FIELDS = "fields";
     static final String KEY_RUNTIME_MAPPINGS = "runtime_mappings";
     static final String KEY_MAX_SAMPLES_PER_KEY = "max_samples_per_key";
+    static final String KEY_ALLOW_PARTIAL_SEARCH_RESULTS = "allow_partial_search_results";
+    static final String KEY_ALLOW_PARTIAL_SEQUENCE_RESULTS = "allow_partial_sequence_results";
 
     static final ParseField FILTER = new ParseField(KEY_FILTER);
     static final ParseField TIMESTAMP_FIELD = new ParseField(KEY_TIMESTAMP_FIELD);
@@ -97,6 +101,8 @@ public class EqlSearchRequest extends ActionRequest implements IndicesRequest.Re
     static final ParseField RESULT_POSITION = new ParseField(KEY_RESULT_POSITION);
     static final ParseField FETCH_FIELDS_FIELD = SearchSourceBuilder.FETCH_FIELDS_FIELD;
     static final ParseField MAX_SAMPLES_PER_KEY = new ParseField(KEY_MAX_SAMPLES_PER_KEY);
+    static final ParseField ALLOW_PARTIAL_SEARCH_RESULTS = new ParseField(KEY_ALLOW_PARTIAL_SEARCH_RESULTS);
+    static final ParseField ALLOW_PARTIAL_SEQUENCE_RESULTS = new ParseField(KEY_ALLOW_PARTIAL_SEQUENCE_RESULTS);
 
     private static final ObjectParser<EqlSearchRequest, Void> PARSER = objectParser(EqlSearchRequest::new);
 
@@ -135,6 +141,13 @@ public EqlSearchRequest(StreamInput in) throws IOException {
         if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_7_0)) {
             maxSamplesPerKey = in.readInt();
         }
+        if (in.getTransportVersion().onOrAfter(TransportVersions.EQL_ALLOW_PARTIAL_SEARCH_RESULTS)) {
+            allowPartialSearchResults = in.readOptionalBoolean();
+            allowPartialSequenceResults = in.readOptionalBoolean();
+        } else {
+            allowPartialSearchResults = false;
+            allowPartialSequenceResults = false;
+        }
     }
 
     @Override
@@ -245,6 +258,8 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
             builder.field(KEY_RUNTIME_MAPPINGS, runtimeMappings);
         }
         builder.field(KEY_MAX_SAMPLES_PER_KEY, maxSamplesPerKey);
+        builder.field(KEY_ALLOW_PARTIAL_SEARCH_RESULTS, allowPartialSearchResults);
+        builder.field(KEY_ALLOW_PARTIAL_SEQUENCE_RESULTS, allowPartialSequenceResults);
 
         return builder;
     }
@@ -279,6 +294,8 @@ protected static <R extends EqlSearchRequest> ObjectParser<R, Void> objectParser
         parser.declareField(EqlSearchRequest::fetchFields, EqlSearchRequest::parseFetchFields, FETCH_FIELDS_FIELD, ValueType.VALUE_ARRAY);
         parser.declareObject(EqlSearchRequest::runtimeMappings, (p, c) -> p.map(), SearchSourceBuilder.RUNTIME_MAPPINGS_FIELD);
         parser.declareInt(EqlSearchRequest::maxSamplesPerKey, MAX_SAMPLES_PER_KEY);
+        parser.declareBoolean(EqlSearchRequest::allowPartialSearchResults, ALLOW_PARTIAL_SEARCH_RESULTS);
+        parser.declareBoolean(EqlSearchRequest::allowPartialSequenceResults, ALLOW_PARTIAL_SEQUENCE_RESULTS);
         return parser;
     }
 
@@ -427,6 +444,24 @@ public EqlSearchRequest maxSamplesPerKey(int maxSamplesPerKey) {
         return this;
     }
 
+    public Boolean allowPartialSearchResults() {
+        return allowPartialSearchResults;
+    }
+
+    public EqlSearchRequest allowPartialSearchResults(Boolean val) {
+        this.allowPartialSearchResults = val;
+        return this;
+    }
+
+    public Boolean allowPartialSequenceResults() {
+        return allowPartialSequenceResults;
+    }
+
+    public EqlSearchRequest allowPartialSequenceResults(Boolean val) {
+        this.allowPartialSequenceResults = val;
+        return this;
+    }
+
     private static List<FieldAndFormat> parseFetchFields(XContentParser parser) throws IOException {
         List<FieldAndFormat> result = new ArrayList<>();
         Token token = parser.currentToken();
@@ -470,6 +505,10 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_7_0)) {
             out.writeInt(maxSamplesPerKey);
         }
+        if (out.getTransportVersion().onOrAfter(TransportVersions.EQL_ALLOW_PARTIAL_SEARCH_RESULTS)) {
+            out.writeOptionalBoolean(allowPartialSearchResults);
+            out.writeOptionalBoolean(allowPartialSequenceResults);
+        }
     }
 
     @Override
@@ -496,7 +535,9 @@ public boolean equals(Object o) {
             && Objects.equals(resultPosition, that.resultPosition)
             && Objects.equals(fetchFields, that.fetchFields)
             && Objects.equals(runtimeMappings, that.runtimeMappings)
-            && Objects.equals(maxSamplesPerKey, that.maxSamplesPerKey);
+            && Objects.equals(maxSamplesPerKey, that.maxSamplesPerKey)
+            && Objects.equals(allowPartialSearchResults, that.allowPartialSearchResults)
+            && Objects.equals(allowPartialSequenceResults, that.allowPartialSequenceResults);
     }
 
     @Override
@@ -517,7 +558,9 @@ public int hashCode() {
             resultPosition,
             fetchFields,
             runtimeMappings,
-            maxSamplesPerKey
+            maxSamplesPerKey,
+            allowPartialSearchResults,
+            allowPartialSequenceResults
         );
     }
 
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchResponse.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchResponse.java
index 2b7b8b074fa71..a4d93b7659970 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchResponse.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchResponse.java
@@ -7,8 +7,11 @@
 package org.elasticsearch.xpack.eql.action;
 
 import org.apache.lucene.search.TotalHits;
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.TransportVersions;
 import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.ShardOperationFailedException;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
@@ -17,6 +20,7 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.lucene.Lucene;
+import org.elasticsearch.common.util.CollectionUtils;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.common.xcontent.XContentParserUtils;
 import org.elasticsearch.core.Nullable;
@@ -36,6 +40,7 @@
 
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
@@ -54,6 +59,7 @@ public class EqlSearchResponse extends ActionResponse implements ToXContentObjec
     private final String asyncExecutionId;
     private final boolean isRunning;
     private final boolean isPartial;
+    private final ShardSearchFailure[] shardFailures;
 
     private static final class Fields {
         static final String TOOK = "took";
@@ -62,6 +68,7 @@ private static final class Fields {
         static final String ID = "id";
         static final String IS_RUNNING = "is_running";
         static final String IS_PARTIAL = "is_partial";
+        static final String SHARD_FAILURES = "shard_failures";
     }
 
     private static final ParseField TOOK = new ParseField(Fields.TOOK);
@@ -70,8 +77,10 @@ private static final class Fields {
     private static final ParseField ID = new ParseField(Fields.ID);
     private static final ParseField IS_RUNNING = new ParseField(Fields.IS_RUNNING);
     private static final ParseField IS_PARTIAL = new ParseField(Fields.IS_PARTIAL);
+    private static final ParseField SHARD_FAILURES = new ParseField(Fields.SHARD_FAILURES);
 
     private static final InstantiatingObjectParser<EqlSearchResponse, Void> PARSER;
+
     static {
         InstantiatingObjectParser.Builder<EqlSearchResponse, Void> parser = InstantiatingObjectParser.builder(
             "eql/search_response",
@@ -84,11 +93,12 @@ private static final class Fields {
         parser.declareString(optionalConstructorArg(), ID);
         parser.declareBoolean(constructorArg(), IS_RUNNING);
         parser.declareBoolean(constructorArg(), IS_PARTIAL);
+        parser.declareObjectArray(optionalConstructorArg(), (p, c) -> ShardSearchFailure.EMPTY_ARRAY, SHARD_FAILURES);
         PARSER = parser.build();
     }
 
-    public EqlSearchResponse(Hits hits, long tookInMillis, boolean isTimeout) {
-        this(hits, tookInMillis, isTimeout, null, false, false);
+    public EqlSearchResponse(Hits hits, long tookInMillis, boolean isTimeout, ShardSearchFailure[] shardFailures) {
+        this(hits, tookInMillis, isTimeout, null, false, false, shardFailures);
     }
 
     public EqlSearchResponse(
@@ -97,7 +107,8 @@ public EqlSearchResponse(
         boolean isTimeout,
         String asyncExecutionId,
         boolean isRunning,
-        boolean isPartial
+        boolean isPartial,
+        ShardSearchFailure[] shardFailures
     ) {
         super();
         this.hits = hits == null ? Hits.EMPTY : hits;
@@ -106,6 +117,7 @@ public EqlSearchResponse(
         this.asyncExecutionId = asyncExecutionId;
         this.isRunning = isRunning;
         this.isPartial = isPartial;
+        this.shardFailures = shardFailures;
     }
 
     public EqlSearchResponse(StreamInput in) throws IOException {
@@ -116,6 +128,11 @@ public EqlSearchResponse(StreamInput in) throws IOException {
         asyncExecutionId = in.readOptionalString();
         isPartial = in.readBoolean();
         isRunning = in.readBoolean();
+        if (in.getTransportVersion().onOrAfter(TransportVersions.EQL_ALLOW_PARTIAL_SEARCH_RESULTS)) {
+            shardFailures = in.readArray(ShardSearchFailure::readShardSearchFailure, ShardSearchFailure[]::new);
+        } else {
+            shardFailures = ShardSearchFailure.EMPTY_ARRAY;
+        }
     }
 
     public static EqlSearchResponse fromXContent(XContentParser parser) {
@@ -130,6 +147,9 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeOptionalString(asyncExecutionId);
         out.writeBoolean(isPartial);
         out.writeBoolean(isRunning);
+        if (out.getTransportVersion().onOrAfter(TransportVersions.EQL_ALLOW_PARTIAL_SEARCH_RESULTS)) {
+            out.writeArray(shardFailures);
+        }
     }
 
     @Override
@@ -147,6 +167,13 @@ private XContentBuilder innerToXContent(XContentBuilder builder, Params params)
         builder.field(IS_RUNNING.getPreferredName(), isRunning);
         builder.field(TOOK.getPreferredName(), tookInMillis);
         builder.field(TIMED_OUT.getPreferredName(), isTimeout);
+        if (CollectionUtils.isEmpty(shardFailures) == false) {
+            builder.startArray(SHARD_FAILURES.getPreferredName());
+            for (ShardOperationFailedException shardFailure : ExceptionsHelper.groupBy(shardFailures)) {
+                shardFailure.toXContent(builder, params);
+            }
+            builder.endArray();
+        }
         hits.toXContent(builder, params);
         return builder;
     }
@@ -178,6 +205,10 @@ public boolean isPartial() {
         return isPartial;
     }
 
+    public ShardSearchFailure[] shardFailures() {
+        return shardFailures;
+    }
+
     @Override
     public boolean equals(Object o) {
         if (this == o) {
@@ -190,12 +221,13 @@ public boolean equals(Object o) {
         return Objects.equals(hits, that.hits)
             && Objects.equals(tookInMillis, that.tookInMillis)
             && Objects.equals(isTimeout, that.isTimeout)
-            && Objects.equals(asyncExecutionId, that.asyncExecutionId);
+            && Objects.equals(asyncExecutionId, that.asyncExecutionId)
+            && Arrays.equals(shardFailures, that.shardFailures);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(hits, tookInMillis, isTimeout, asyncExecutionId);
+        return Objects.hash(hits, tookInMillis, isTimeout, asyncExecutionId, Arrays.hashCode(shardFailures));
     }
 
     @Override
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchTask.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchTask.java
index 2a1bc3b7adb67..0fc8e8c88d7d9 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchTask.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/action/EqlSearchTask.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.xpack.eql.action;
 
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.tasks.TaskId;
 import org.elasticsearch.xpack.core.async.AsyncExecutionId;
@@ -39,7 +40,8 @@ public EqlSearchResponse getCurrentResult() {
             false,
             getExecutionId().getEncoded(),
             true,
-            true
+            true,
+            ShardSearchFailure.EMPTY_ARRAY
         );
     }
 }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/assembler/ExecutionManager.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/assembler/ExecutionManager.java
index b26c815c1a2b5..672d6b87a8dbb 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/assembler/ExecutionManager.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/assembler/ExecutionManager.java
@@ -167,7 +167,9 @@ public Executable assemble(
             criteria.subList(0, completionStage),
             criteria.get(completionStage),
             matcher,
-            listOfKeys
+            listOfKeys,
+            cfg.allowPartialSearchResults(),
+            cfg.allowPartialSequenceResults()
         );
 
         return w;
@@ -235,7 +237,8 @@ public Executable assemble(List<List<Attribute>> listOfKeys, List<PhysicalPlan>
             cfg.fetchSize(),
             limit,
             session.circuitBreaker(),
-            cfg.maxSamplesPerKey()
+            cfg.maxSamplesPerKey(),
+            cfg.allowPartialSearchResults()
         );
     }
 
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/AbstractPayload.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/AbstractPayload.java
index 823cd04d25f45..9fecf958b9714 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/AbstractPayload.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/AbstractPayload.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.xpack.eql.execution.payload;
 
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.xpack.eql.session.Payload;
 
@@ -14,10 +15,12 @@ public abstract class AbstractPayload implements Payload {
 
     private final boolean timedOut;
     private final TimeValue timeTook;
+    private ShardSearchFailure[] shardFailures;
 
-    protected AbstractPayload(boolean timedOut, TimeValue timeTook) {
+    protected AbstractPayload(boolean timedOut, TimeValue timeTook, ShardSearchFailure[] shardFailures) {
         this.timedOut = timedOut;
         this.timeTook = timeTook;
+        this.shardFailures = shardFailures;
     }
 
     @Override
@@ -29,4 +32,9 @@ public boolean timedOut() {
     public TimeValue timeTook() {
         return timeTook;
     }
+
+    @Override
+    public ShardSearchFailure[] shardFailures() {
+        return shardFailures;
+    }
 }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/EventPayload.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/EventPayload.java
index a7845ca62dccc..6471bc0814f70 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/EventPayload.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/payload/EventPayload.java
@@ -20,7 +20,7 @@ public class EventPayload extends AbstractPayload {
     private final List<Event> values;
 
     public EventPayload(SearchResponse response) {
-        super(response.isTimedOut(), response.getTook());
+        super(response.isTimedOut(), response.getTook(), response.getShardFailures());
 
         SearchHits hits = response.getHits();
         values = new ArrayList<>(hits.getHits().length);
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SampleIterator.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SampleIterator.java
index 89f1c4d1eb041..b9b7cfd6b615a 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SampleIterator.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SampleIterator.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.search.MultiSearchResponse;
 import org.elasticsearch.action.search.SearchRequest;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.common.breaker.CircuitBreaker;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.search.SearchHit;
@@ -35,6 +36,7 @@
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collection;
+import java.util.HashMap;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
@@ -44,6 +46,7 @@
 import static org.elasticsearch.common.Strings.EMPTY_ARRAY;
 import static org.elasticsearch.xpack.eql.execution.assembler.SampleQueryRequest.COMPOSITE_AGG_NAME;
 import static org.elasticsearch.xpack.eql.execution.search.RuntimeUtils.prepareRequest;
+import static org.elasticsearch.xpack.eql.util.SearchHitUtils.addShardFailures;
 
 public class SampleIterator implements Executable {
 
@@ -58,6 +61,7 @@ public class SampleIterator implements Executable {
     private final Limit limit;
     private final int maxSamplesPerKey;
     private long startTime;
+    private Map<String, ShardSearchFailure> shardFailures = new HashMap<>();
 
     // ---------- CIRCUIT BREAKER -----------
 
@@ -84,13 +88,16 @@ public class SampleIterator implements Executable {
      */
     private long previousTotalPageSize = 0;
 
+    private boolean allowPartialSearchResults;
+
     public SampleIterator(
         QueryClient client,
         List<SampleCriterion> criteria,
         int fetchSize,
         Limit limit,
         CircuitBreaker circuitBreaker,
-        int maxSamplesPerKey
+        int maxSamplesPerKey,
+        boolean allowPartialSearchResults
     ) {
         this.client = client;
         this.criteria = criteria;
@@ -100,6 +107,7 @@ public SampleIterator(
         this.limit = limit;
         this.circuitBreaker = circuitBreaker;
         this.maxSamplesPerKey = maxSamplesPerKey;
+        this.allowPartialSearchResults = allowPartialSearchResults;
     }
 
     @Override
@@ -147,6 +155,7 @@ private void advance(ActionListener<Payload> listener) {
 
     private void queryForCompositeAggPage(ActionListener<Payload> listener, final SampleQueryRequest request) {
         client.query(request, listener.delegateFailureAndWrap((delegate, r) -> {
+            addShardFailures(shardFailures, r);
             // either the fields values or the fields themselves are missing
             // or the filter applied on the eql query matches no documents
             if (r.hasAggregations() == false) {
@@ -209,13 +218,16 @@ private void finalStep(ActionListener<Payload> listener) {
             for (SampleCriterion criterion : criteria) {
                 SampleQueryRequest r = criterion.finalQuery();
                 r.singleKeyPair(compositeKeyValues, maxCriteria, maxSamplesPerKey);
-                searches.add(prepareRequest(r.searchSource(), false, EMPTY_ARRAY));
+                searches.add(prepareRequest(r.searchSource(), false, allowPartialSearchResults, EMPTY_ARRAY));
             }
             sampleKeys.add(new SequenceKey(compositeKeyValues.toArray()));
         }
 
         int initialSize = samples.size();
         client.multiQuery(searches, listener.delegateFailureAndWrap((delegate, r) -> {
+            for (MultiSearchResponse.Item item : r) {
+                addShardFailures(shardFailures, item.getResponse());
+            }
             List<List<SearchHit>> sample = new ArrayList<>(maxCriteria);
             MultiSearchResponse.Item[] response = r.getResponses();
             int docGroupsCounter = 1;
@@ -280,14 +292,23 @@ private void payload(ActionListener<Payload> listener) {
         log.trace("Sending payload for [{}] samples", samples.size());
 
         if (samples.isEmpty()) {
-            listener.onResponse(new EmptyPayload(Type.SAMPLE, timeTook()));
+            listener.onResponse(new EmptyPayload(Type.SAMPLE, timeTook(), shardFailures.values().toArray(new ShardSearchFailure[0])));
             return;
         }
 
         // get results through search (to keep using PIT)
         client.fetchHits(
             hits(samples),
-            ActionListeners.map(listener, listOfHits -> new SamplePayload(samples, listOfHits, false, timeTook()))
+            ActionListeners.map(
+                listener,
+                listOfHits -> new SamplePayload(
+                    samples,
+                    listOfHits,
+                    false,
+                    timeTook(),
+                    shardFailures.values().toArray(new ShardSearchFailure[0])
+                )
+            )
         );
     }
 
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SamplePayload.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SamplePayload.java
index 121f4c208273b..aee084dd88734 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SamplePayload.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sample/SamplePayload.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.xpack.eql.execution.sample;
 
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.eql.action.EqlSearchResponse.Event;
@@ -19,8 +20,14 @@ class SamplePayload extends AbstractPayload {
 
     private final List<org.elasticsearch.xpack.eql.action.EqlSearchResponse.Sequence> values;
 
-    SamplePayload(List<Sample> samples, List<List<SearchHit>> docs, boolean timedOut, TimeValue timeTook) {
-        super(timedOut, timeTook);
+    SamplePayload(
+        List<Sample> samples,
+        List<List<SearchHit>> docs,
+        boolean timedOut,
+        TimeValue timeTook,
+        ShardSearchFailure[] shardFailures
+    ) {
+        super(timedOut, timeTook, shardFailures);
         values = new ArrayList<>(samples.size());
 
         for (int i = 0; i < samples.size(); i++) {
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/BasicQueryClient.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/BasicQueryClient.java
index 6cbe5298b5950..18623c17dcffb 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/BasicQueryClient.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/BasicQueryClient.java
@@ -46,12 +46,14 @@ public class BasicQueryClient implements QueryClient {
     final Client client;
     final String[] indices;
     final List<FieldAndFormat> fetchFields;
+    private final boolean allowPartialSearchResults;
 
     public BasicQueryClient(EqlSession eqlSession) {
         this.cfg = eqlSession.configuration();
         this.client = eqlSession.client();
         this.indices = cfg.indices();
         this.fetchFields = cfg.fetchFields();
+        this.allowPartialSearchResults = cfg.allowPartialSearchResults();
     }
 
     @Override
@@ -60,11 +62,11 @@ public void query(QueryRequest request, ActionListener<SearchResponse> listener)
         // set query timeout
         searchSource.timeout(cfg.requestTimeout());
 
-        SearchRequest search = prepareRequest(searchSource, false, indices);
-        search(search, searchLogListener(listener, log));
+        SearchRequest search = prepareRequest(searchSource, false, allowPartialSearchResults, indices);
+        search(search, allowPartialSearchResults, searchLogListener(listener, log, allowPartialSearchResults));
     }
 
-    protected void search(SearchRequest search, ActionListener<SearchResponse> listener) {
+    protected void search(SearchRequest search, boolean allowPartialSearchResults, ActionListener<SearchResponse> listener) {
         if (cfg.isCancelled()) {
             listener.onFailure(new TaskCancelledException("cancelled"));
             return;
@@ -77,7 +79,7 @@ protected void search(SearchRequest search, ActionListener<SearchResponse> liste
         client.search(search, listener);
     }
 
-    protected void search(MultiSearchRequest search, ActionListener<MultiSearchResponse> listener) {
+    protected void search(MultiSearchRequest search, boolean allowPartialSearchResults, ActionListener<MultiSearchResponse> listener) {
         if (cfg.isCancelled()) {
             listener.onFailure(new TaskCancelledException("cancelled"));
             return;
@@ -91,7 +93,7 @@ protected void search(MultiSearchRequest search, ActionListener<MultiSearchRespo
             log.trace("About to execute multi-queries {} on {}", sj, indices);
         }
 
-        client.multiSearch(search, multiSearchLogListener(listener, log));
+        client.multiSearch(search, multiSearchLogListener(listener, allowPartialSearchResults, log));
     }
 
     @Override
@@ -147,11 +149,11 @@ public void fetchHits(Iterable<List<HitReference>> refs, ActionListener<List<Lis
                 builder.runtimeMappings(cfg.runtimeMappings());
             }
 
-            SearchRequest search = prepareRequest(builder, false, entry.getKey());
+            SearchRequest search = prepareRequest(builder, false, allowPartialSearchResults, entry.getKey());
             multiSearchBuilder.add(search);
         }
 
-        search(multiSearchBuilder.request(), listener.delegateFailureAndWrap((delegate, r) -> {
+        search(multiSearchBuilder.request(), allowPartialSearchResults, listener.delegateFailureAndWrap((delegate, r) -> {
             for (MultiSearchResponse.Item item : r.getResponses()) {
                 // check for failures
                 if (item.isFailure()) {
@@ -187,6 +189,6 @@ public void multiQuery(List<SearchRequest> searches, ActionListener<MultiSearchR
             request.indices(indices);
             multiSearchBuilder.add(request);
         }
-        search(multiSearchBuilder.request(), listener);
+        search(multiSearchBuilder.request(), allowPartialSearchResults, listener);
     }
 }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClient.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClient.java
index 2cfa4db37ee07..e338550c22458 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClient.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClient.java
@@ -56,38 +56,38 @@ public PITAwareQueryClient(EqlSession eqlSession) {
     }
 
     @Override
-    protected void search(SearchRequest search, ActionListener<SearchResponse> listener) {
+    protected void search(SearchRequest search, boolean allowPartialSearchResults, ActionListener<SearchResponse> listener) {
         // no pitId, ask for one
         if (pitId == null) {
-            openPIT(listener, () -> searchWithPIT(search, listener));
+            openPIT(listener, () -> searchWithPIT(search, listener, allowPartialSearchResults), allowPartialSearchResults);
         } else {
-            searchWithPIT(search, listener);
+            searchWithPIT(search, listener, allowPartialSearchResults);
         }
     }
 
-    private void searchWithPIT(SearchRequest request, ActionListener<SearchResponse> listener) {
+    private void searchWithPIT(SearchRequest request, ActionListener<SearchResponse> listener, boolean allowPartialSearchResults) {
         makeRequestPITCompatible(request);
         // get the pid on each response
-        super.search(request, pitListener(SearchResponse::pointInTimeId, listener));
+        super.search(request, allowPartialSearchResults, pitListener(SearchResponse::pointInTimeId, listener));
     }
 
     @Override
-    protected void search(MultiSearchRequest search, ActionListener<MultiSearchResponse> listener) {
+    protected void search(MultiSearchRequest search, boolean allowPartialSearchResults, ActionListener<MultiSearchResponse> listener) {
         // no pitId, ask for one
         if (pitId == null) {
-            openPIT(listener, () -> searchWithPIT(search, listener));
+            openPIT(listener, () -> searchWithPIT(search, allowPartialSearchResults, listener), allowPartialSearchResults);
         } else {
-            searchWithPIT(search, listener);
+            searchWithPIT(search, allowPartialSearchResults, listener);
         }
     }
 
-    private void searchWithPIT(MultiSearchRequest search, ActionListener<MultiSearchResponse> listener) {
+    private void searchWithPIT(MultiSearchRequest search, boolean allowPartialSearchResults, ActionListener<MultiSearchResponse> listener) {
         for (SearchRequest request : search.requests()) {
             makeRequestPITCompatible(request);
         }
 
         // get the pid on each request
-        super.search(search, pitListener(r -> {
+        super.search(search, allowPartialSearchResults, pitListener(r -> {
             // get pid
             for (MultiSearchResponse.Item item : r.getResponses()) {
                 // pick the first non-failing response
@@ -135,9 +135,10 @@ private <Response> ActionListener<Response> pitListener(
         );
     }
 
-    private <Response> void openPIT(ActionListener<Response> listener, Runnable runnable) {
+    private <Response> void openPIT(ActionListener<Response> listener, Runnable runnable, boolean allowPartialSearchResults) {
         OpenPointInTimeRequest request = new OpenPointInTimeRequest(indices).indicesOptions(IndexResolver.FIELD_CAPS_INDICES_OPTIONS)
-            .keepAlive(keepAlive);
+            .keepAlive(keepAlive)
+            .allowPartialSearchResults(allowPartialSearchResults);
         request.indexFilter(filter);
         client.execute(TransportOpenPointInTimeAction.TYPE, request, listener.delegateFailureAndWrap((l, r) -> {
             pitId = r.getPointInTimeId();
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/RuntimeUtils.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/RuntimeUtils.java
index 40f7f7139efa1..92af8c562f840 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/RuntimeUtils.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/search/RuntimeUtils.java
@@ -56,10 +56,14 @@ public final class RuntimeUtils {
 
     private RuntimeUtils() {}
 
-    public static ActionListener<SearchResponse> searchLogListener(ActionListener<SearchResponse> listener, Logger log) {
+    public static ActionListener<SearchResponse> searchLogListener(
+        ActionListener<SearchResponse> listener,
+        Logger log,
+        boolean allowPartialResults
+    ) {
         return listener.delegateFailureAndWrap((delegate, response) -> {
             ShardSearchFailure[] failures = response.getShardFailures();
-            if (CollectionUtils.isEmpty(failures) == false) {
+            if (CollectionUtils.isEmpty(failures) == false && allowPartialResults == false) {
                 delegate.onFailure(new EqlIllegalArgumentException(failures[0].reason(), failures[0].getCause()));
                 return;
             }
@@ -70,16 +74,22 @@ public static ActionListener<SearchResponse> searchLogListener(ActionListener<Se
         });
     }
 
-    public static ActionListener<MultiSearchResponse> multiSearchLogListener(ActionListener<MultiSearchResponse> listener, Logger log) {
+    public static ActionListener<MultiSearchResponse> multiSearchLogListener(
+        ActionListener<MultiSearchResponse> listener,
+        boolean allowPartialSearchResults,
+        Logger log
+    ) {
         return listener.delegateFailureAndWrap((delegate, items) -> {
             for (MultiSearchResponse.Item item : items) {
                 Exception failure = item.getFailure();
                 SearchResponse response = item.getResponse();
 
                 if (failure == null) {
-                    ShardSearchFailure[] failures = response.getShardFailures();
-                    if (CollectionUtils.isEmpty(failures) == false) {
-                        failure = new EqlIllegalArgumentException(failures[0].reason(), failures[0].getCause());
+                    if (allowPartialSearchResults == false) {
+                        ShardSearchFailure[] failures = response.getShardFailures();
+                        if (CollectionUtils.isEmpty(failures) == false) {
+                            failure = new EqlIllegalArgumentException(failures[0].reason(), failures[0].getCause());
+                        }
                     }
                 }
                 if (failure != null) {
@@ -170,11 +180,16 @@ public static HitExtractor createExtractor(FieldExtraction ref, EqlConfiguration
         throw new EqlIllegalArgumentException("Unexpected value reference {}", ref.getClass());
     }
 
-    public static SearchRequest prepareRequest(SearchSourceBuilder source, boolean includeFrozen, String... indices) {
+    public static SearchRequest prepareRequest(
+        SearchSourceBuilder source,
+        boolean includeFrozen,
+        boolean allowPartialSearchResults,
+        String... indices
+    ) {
         SearchRequest searchRequest = new SearchRequest();
         searchRequest.indices(indices);
         searchRequest.source(source);
-        searchRequest.allowPartialSearchResults(false);
+        searchRequest.allowPartialSearchResults(allowPartialSearchResults);
         searchRequest.indicesOptions(
             includeFrozen ? IndexResolver.FIELD_CAPS_FROZEN_INDICES_OPTIONS : IndexResolver.FIELD_CAPS_INDICES_OPTIONS
         );
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/SequencePayload.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/SequencePayload.java
index 45083babddbb4..b4a8edc79b3ad 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/SequencePayload.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/SequencePayload.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.xpack.eql.execution.sequence;
 
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.search.SearchHit;
 import org.elasticsearch.xpack.eql.action.EqlSearchResponse.Event;
@@ -19,8 +20,14 @@ class SequencePayload extends AbstractPayload {
 
     private final List<org.elasticsearch.xpack.eql.action.EqlSearchResponse.Sequence> values;
 
-    SequencePayload(List<Sequence> sequences, List<List<SearchHit>> docs, boolean timedOut, TimeValue timeTook) {
-        super(timedOut, timeTook);
+    SequencePayload(
+        List<Sequence> sequences,
+        List<List<SearchHit>> docs,
+        boolean timedOut,
+        TimeValue timeTook,
+        ShardSearchFailure[] shardFailures
+    ) {
+        super(timedOut, timeTook, shardFailures);
         values = new ArrayList<>(sequences.size());
 
         for (int i = 0; i < sequences.size(); i++) {
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/TumblingWindow.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/TumblingWindow.java
index eabf6df518ad4..fac8788db0f95 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/TumblingWindow.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/execution/sequence/TumblingWindow.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.action.search.MultiSearchResponse;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.core.Tuple;
@@ -41,6 +42,7 @@
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.Iterator;
 import java.util.LinkedHashMap;
 import java.util.List;
@@ -51,6 +53,7 @@
 import static org.elasticsearch.action.ActionListener.runAfter;
 import static org.elasticsearch.xpack.eql.execution.ExecutionUtils.copySource;
 import static org.elasticsearch.xpack.eql.execution.search.RuntimeUtils.combineFilters;
+import static org.elasticsearch.xpack.eql.util.SearchHitUtils.addShardFailures;
 import static org.elasticsearch.xpack.eql.util.SearchHitUtils.qualifiedIndex;
 
 /**
@@ -103,6 +106,9 @@ protected boolean removeEldestEntry(Map.Entry<String, String> eldest) {
 
     private final boolean hasKeys;
     private final List<List<Attribute>> listOfKeys;
+    private final boolean allowPartialSearchResults;
+    private final boolean allowPartialSequenceResults;
+    private Map<String, ShardSearchFailure> shardFailures = new HashMap<>();
 
     // flag used for DESC sequences to indicate whether
     // the window needs to restart (since the DESC query still has results)
@@ -127,7 +133,10 @@ public TumblingWindow(
         List<SequenceCriterion> criteria,
         SequenceCriterion until,
         SequenceMatcher matcher,
-        List<List<Attribute>> listOfKeys
+        List<List<Attribute>> listOfKeys,
+        boolean allowPartialSearchResults,
+        boolean allowPartialSequenceResults
+
     ) {
         this.client = client;
 
@@ -141,6 +150,8 @@ public TumblingWindow(
         this.hasKeys = baseRequest.keySize() > 0;
         this.restartWindowFromTailQuery = baseRequest.descending();
         this.listOfKeys = listOfKeys;
+        this.allowPartialSearchResults = allowPartialSearchResults;
+        this.allowPartialSequenceResults = allowPartialSequenceResults;
     }
 
     @Override
@@ -158,6 +169,9 @@ public void execute(ActionListener<Payload> listener) {
      * Move the window while preserving the same base.
      */
     private void tumbleWindow(int currentStage, ActionListener<Payload> listener) {
+        if (allowPartialSequenceResults == false && shardFailures.isEmpty() == false) {
+            doPayload(listener);
+        }
         if (currentStage > matcher.firstPositiveStage && matcher.hasCandidates() == false) {
             if (restartWindowFromTailQuery) {
                 currentStage = matcher.firstPositiveStage;
@@ -224,6 +238,9 @@ public void checkMissingEvents(Runnable next, ActionListener<Payload> listener)
 
     private void doCheckMissingEvents(List<Sequence> batchToCheck, MultiSearchResponse p, ActionListener<Payload> listener, Runnable next) {
         MultiSearchResponse.Item[] responses = p.getResponses();
+        for (MultiSearchResponse.Item response : responses) {
+            addShardFailures(shardFailures, response.getResponse());
+        }
         int nextResponse = 0;
         for (Sequence sequence : batchToCheck) {
             boolean leading = true;
@@ -316,7 +333,14 @@ private List<SearchRequest> prepareQueryForMissingEvents(List<Sequence> toCheck)
                     }
                     addKeyFilter(i, sequence, builder);
                     RuntimeUtils.combineFilters(builder, range);
-                    result.add(RuntimeUtils.prepareRequest(builder.size(1).trackTotalHits(false), false, Strings.EMPTY_ARRAY));
+                    result.add(
+                        RuntimeUtils.prepareRequest(
+                            builder.size(1).trackTotalHits(false),
+                            false,
+                            allowPartialSearchResults,
+                            Strings.EMPTY_ARRAY
+                        )
+                    );
                 } else {
                     leading = false;
                 }
@@ -361,6 +385,7 @@ private void advance(int stage, ActionListener<Payload> listener) {
      * Execute the base query.
      */
     private void baseCriterion(int baseStage, SearchResponse r, ActionListener<Payload> listener) {
+        addShardFailures(shardFailures, r);
         SequenceCriterion base = criteria.get(baseStage);
         SearchHits hits = r.getHits();
 
@@ -731,8 +756,10 @@ private void doPayload(ActionListener<Payload> listener) {
 
         log.trace("Sending payload for [{}] sequences", completed.size());
 
-        if (completed.isEmpty()) {
-            listener.onResponse(new EmptyPayload(Type.SEQUENCE, timeTook()));
+        if (completed.isEmpty() || (allowPartialSequenceResults == false && shardFailures.isEmpty() == false)) {
+            listener.onResponse(
+                new EmptyPayload(Type.SEQUENCE, timeTook(), shardFailures.values().toArray(new ShardSearchFailure[shardFailures.size()]))
+            );
             return;
         }
 
@@ -741,7 +768,13 @@ private void doPayload(ActionListener<Payload> listener) {
             if (criteria.get(matcher.firstPositiveStage).descending()) {
                 Collections.reverse(completed);
             }
-            return new SequencePayload(completed, addMissingEventPlaceholders(listOfHits), false, timeTook());
+            return new SequencePayload(
+                completed,
+                addMissingEventPlaceholders(listOfHits),
+                false,
+                timeTook(),
+                shardFailures.values().toArray(new ShardSearchFailure[0])
+            );
         }));
     }
 
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/EqlPlugin.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/EqlPlugin.java
index 084a5e74a47e8..210f88c991539 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/EqlPlugin.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/EqlPlugin.java
@@ -60,6 +60,20 @@ public class EqlPlugin extends Plugin implements ActionPlugin, CircuitBreakerPlu
         Setting.Property.DeprecatedWarning
     );
 
+    public static final Setting<Boolean> DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS = Setting.boolSetting(
+        "xpack.eql.default_allow_partial_results",
+        false,
+        Setting.Property.NodeScope,
+        Setting.Property.Dynamic
+    );
+
+    public static final Setting<Boolean> DEFAULT_ALLOW_PARTIAL_SEQUENCE_RESULTS = Setting.boolSetting(
+        "xpack.eql.default_allow_partial_sequence_results",
+        false,
+        Setting.Property.NodeScope,
+        Setting.Property.Dynamic
+    );
+
     public EqlPlugin() {}
 
     @Override
@@ -86,7 +100,7 @@ private Collection<Object> createComponents(Client client, Settings settings, Cl
      */
     @Override
     public List<Setting<?>> getSettings() {
-        return List.of(EQL_ENABLED_SETTING);
+        return List.of(EQL_ENABLED_SETTING, DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS, DEFAULT_ALLOW_PARTIAL_SEQUENCE_RESULTS);
     }
 
     @Override
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/RestEqlSearchAction.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/RestEqlSearchAction.java
index e24a4749f45cd..65def24563e5e 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/RestEqlSearchAction.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/RestEqlSearchAction.java
@@ -64,6 +64,12 @@ protected RestChannelConsumer prepareRequest(RestRequest request, NodeClient cli
             }
             eqlRequest.keepOnCompletion(request.paramAsBoolean("keep_on_completion", eqlRequest.keepOnCompletion()));
             eqlRequest.ccsMinimizeRoundtrips(request.paramAsBoolean("ccs_minimize_roundtrips", eqlRequest.ccsMinimizeRoundtrips()));
+            eqlRequest.allowPartialSearchResults(
+                request.paramAsBoolean("allow_partial_search_results", eqlRequest.allowPartialSearchResults())
+            );
+            eqlRequest.allowPartialSequenceResults(
+                request.paramAsBoolean("allow_partial_sequence_results", eqlRequest.allowPartialSequenceResults())
+            );
         }
 
         return channel -> {
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/TransportEqlSearchAction.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/TransportEqlSearchAction.java
index c0141da2432ce..582352722fc58 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/TransportEqlSearchAction.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/plugin/TransportEqlSearchAction.java
@@ -10,6 +10,7 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionListenerResponseHandler;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
 import org.elasticsearch.client.internal.Client;
@@ -144,7 +145,8 @@ public EqlSearchResponse initialResponse(EqlSearchTask task) {
             false,
             task.getExecutionId().getEncoded(),
             true,
-            true
+            true,
+            ShardSearchFailure.EMPTY_ARRAY
         );
     }
 
@@ -231,6 +233,12 @@ public static void operation(
                 request.indicesOptions(),
                 request.fetchSize(),
                 request.maxSamplesPerKey(),
+                request.allowPartialSearchResults() == null
+                    ? defaultAllowPartialSearchResults(clusterService)
+                    : request.allowPartialSearchResults(),
+                request.allowPartialSequenceResults() == null
+                    ? defaultAllowPartialSequenceResults(clusterService)
+                    : request.allowPartialSequenceResults(),
                 clientId,
                 new TaskId(nodeId, task.getId()),
                 task
@@ -244,12 +252,34 @@ public static void operation(
         }
     }
 
+    private static boolean defaultAllowPartialSearchResults(ClusterService clusterService) {
+        if (clusterService.getClusterSettings() == null) {
+            return EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS.getDefault(Settings.EMPTY);
+        }
+        return clusterService.getClusterSettings().get(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEARCH_RESULTS);
+    }
+
+    private static boolean defaultAllowPartialSequenceResults(ClusterService clusterService) {
+        if (clusterService.getClusterSettings() == null) {
+            return EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEQUENCE_RESULTS.getDefault(Settings.EMPTY);
+        }
+        return clusterService.getClusterSettings().get(EqlPlugin.DEFAULT_ALLOW_PARTIAL_SEQUENCE_RESULTS);
+    }
+
     static EqlSearchResponse createResponse(Results results, AsyncExecutionId id) {
         EqlSearchResponse.Hits hits = new EqlSearchResponse.Hits(results.events(), results.sequences(), results.totalHits());
         if (id != null) {
-            return new EqlSearchResponse(hits, results.tookTime().getMillis(), results.timedOut(), id.getEncoded(), false, false);
+            return new EqlSearchResponse(
+                hits,
+                results.tookTime().getMillis(),
+                results.timedOut(),
+                id.getEncoded(),
+                false,
+                false,
+                results.shardFailures()
+            );
         } else {
-            return new EqlSearchResponse(hits, results.tookTime().getMillis(), results.timedOut());
+            return new EqlSearchResponse(hits, results.tookTime().getMillis(), results.timedOut(), results.shardFailures());
         }
     }
 
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EmptyPayload.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EmptyPayload.java
index 9822285465087..33ed5799cd073 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EmptyPayload.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EmptyPayload.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.xpack.eql.session;
 
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 
 import java.util.List;
@@ -17,14 +18,16 @@ public class EmptyPayload implements Payload {
 
     private final Type type;
     private final TimeValue timeTook;
+    private final ShardSearchFailure[] shardFailures;
 
     public EmptyPayload(Type type) {
-        this(type, TimeValue.ZERO);
+        this(type, TimeValue.ZERO, ShardSearchFailure.EMPTY_ARRAY);
     }
 
-    public EmptyPayload(Type type, TimeValue timeTook) {
+    public EmptyPayload(Type type, TimeValue timeTook, ShardSearchFailure[] shardFailures) {
         this.type = type;
         this.timeTook = timeTook;
+        this.shardFailures = shardFailures;
     }
 
     @Override
@@ -46,4 +49,10 @@ public TimeValue timeTook() {
     public List<?> values() {
         return emptyList();
     }
+
+    @Override
+    public ShardSearchFailure[] shardFailures() {
+        return shardFailures;
+    }
+
 }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EqlConfiguration.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EqlConfiguration.java
index 8dd8220fb63bc..8242b0b533ad3 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EqlConfiguration.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/EqlConfiguration.java
@@ -30,6 +30,8 @@ public class EqlConfiguration extends org.elasticsearch.xpack.ql.session.Configu
     private final EqlSearchTask task;
     private final int fetchSize;
     private final int maxSamplesPerKey;
+    private final boolean allowPartialSearchResults;
+    private final boolean allowPartialSequenceResults;
 
     @Nullable
     private final QueryBuilder filter;
@@ -50,6 +52,8 @@ public EqlConfiguration(
         IndicesOptions indicesOptions,
         int fetchSize,
         int maxSamplesPerKey,
+        boolean allowPartialSearchResults,
+        boolean allowPartialSequenceResults,
         String clientId,
         TaskId taskId,
         EqlSearchTask task
@@ -67,6 +71,8 @@ public EqlConfiguration(
         this.task = task;
         this.fetchSize = fetchSize;
         this.maxSamplesPerKey = maxSamplesPerKey;
+        this.allowPartialSearchResults = allowPartialSearchResults;
+        this.allowPartialSequenceResults = allowPartialSequenceResults;
     }
 
     public String[] indices() {
@@ -89,6 +95,14 @@ public int maxSamplesPerKey() {
         return maxSamplesPerKey;
     }
 
+    public boolean allowPartialSearchResults() {
+        return allowPartialSearchResults;
+    }
+
+    public boolean allowPartialSequenceResults() {
+        return allowPartialSequenceResults;
+    }
+
     public QueryBuilder filter() {
         return filter;
     }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Payload.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Payload.java
index 1d82478e6db26..05e614714a5aa 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Payload.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Payload.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.xpack.eql.session;
 
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 
 import java.util.List;
@@ -29,4 +30,6 @@ enum Type {
     TimeValue timeTook();
 
     List<?> values();
+
+    ShardSearchFailure[] shardFailures();
 }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Results.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Results.java
index bb76c08c801cb..13886470f21f5 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Results.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/session/Results.java
@@ -9,6 +9,7 @@
 
 import org.apache.lucene.search.TotalHits;
 import org.apache.lucene.search.TotalHits.Relation;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.xpack.eql.action.EqlSearchResponse.Event;
 import org.elasticsearch.xpack.eql.action.EqlSearchResponse.Sequence;
@@ -23,18 +24,28 @@ public class Results {
     private final boolean timedOut;
     private final TimeValue tookTime;
     private final Type type;
+    private ShardSearchFailure[] shardFailures;
 
     public static Results fromPayload(Payload payload) {
         List<?> values = payload.values();
-        return new Results(new TotalHits(values.size(), Relation.EQUAL_TO), payload.timeTook(), false, values, payload.resultType());
+        payload.shardFailures();
+        return new Results(
+            new TotalHits(values.size(), Relation.EQUAL_TO),
+            payload.timeTook(),
+            false,
+            values,
+            payload.resultType(),
+            payload.shardFailures()
+        );
     }
 
-    Results(TotalHits totalHits, TimeValue tookTime, boolean timedOut, List<?> results, Type type) {
+    Results(TotalHits totalHits, TimeValue tookTime, boolean timedOut, List<?> results, Type type, ShardSearchFailure[] shardFailures) {
         this.totalHits = totalHits;
         this.tookTime = tookTime;
         this.timedOut = timedOut;
         this.results = results;
         this.type = type;
+        this.shardFailures = shardFailures;
     }
 
     public TotalHits totalHits() {
@@ -51,6 +62,10 @@ public List<Sequence> sequences() {
         return (type == Type.SEQUENCE || type == Type.SAMPLE) ? (List<Sequence>) results : null;
     }
 
+    public ShardSearchFailure[] shardFailures() {
+        return shardFailures;
+    }
+
     public TimeValue tookTime() {
         return tookTime;
     }
diff --git a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/util/SearchHitUtils.java b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/util/SearchHitUtils.java
index 91795ac15b53e..2b5ec9718cfc4 100644
--- a/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/util/SearchHitUtils.java
+++ b/x-pack/plugin/eql/src/main/java/org/elasticsearch/xpack/eql/util/SearchHitUtils.java
@@ -7,8 +7,12 @@
 
 package org.elasticsearch.xpack.eql.util;
 
+import org.elasticsearch.action.search.SearchResponse;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.search.SearchHit;
 
+import java.util.Map;
+
 import static org.elasticsearch.transport.RemoteClusterAware.buildRemoteIndexName;
 
 public final class SearchHitUtils {
@@ -16,4 +20,12 @@ public final class SearchHitUtils {
     public static String qualifiedIndex(SearchHit hit) {
         return buildRemoteIndexName(hit.getClusterAlias(), hit.getIndex());
     }
+
+    public static void addShardFailures(Map<String, ShardSearchFailure> shardFailures, SearchResponse r) {
+        if (r.getShardFailures() != null) {
+            for (ShardSearchFailure shardFailure : r.getShardFailures()) {
+                shardFailures.put(shardFailure.toString(), shardFailure);
+            }
+        }
+    }
 }
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/EqlTestUtils.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/EqlTestUtils.java
index a1aa8e4bd98d7..75884fab4dbb3 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/EqlTestUtils.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/EqlTestUtils.java
@@ -51,6 +51,8 @@ private EqlTestUtils() {}
         null,
         123,
         1,
+        false,
+        true,
         "",
         new TaskId("test", 123),
         null
@@ -69,6 +71,8 @@ public static EqlConfiguration randomConfiguration() {
             randomIndicesOptions(),
             randomIntBetween(1, 1000),
             randomIntBetween(1, 1000),
+            randomBoolean(),
+            randomBoolean(),
             randomAlphaOfLength(16),
             new TaskId(randomAlphaOfLength(10), randomNonNegativeLong()),
             randomTask()
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchRequestTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchRequestTests.java
index 0ff9fa9131b27..1a06aead910c8 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchRequestTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchRequestTests.java
@@ -80,6 +80,8 @@ protected EqlSearchRequest createTestInstance() {
                 .waitForCompletionTimeout(randomTimeValue())
                 .keepAlive(randomTimeValue())
                 .keepOnCompletion(randomBoolean())
+                .allowPartialSearchResults(randomBoolean())
+                .allowPartialSequenceResults(randomBoolean())
                 .fetchFields(randomFetchFields)
                 .runtimeMappings(randomRuntimeMappings())
                 .resultPosition(randomFrom("tail", "head"))
@@ -136,6 +138,12 @@ protected EqlSearchRequest mutateInstanceForVersion(EqlSearchRequest instance, T
         mutatedInstance.runtimeMappings(version.onOrAfter(TransportVersions.V_7_13_0) ? instance.runtimeMappings() : emptyMap());
         mutatedInstance.resultPosition(version.onOrAfter(TransportVersions.V_7_17_8) ? instance.resultPosition() : "tail");
         mutatedInstance.maxSamplesPerKey(version.onOrAfter(TransportVersions.V_8_7_0) ? instance.maxSamplesPerKey() : 1);
+        mutatedInstance.allowPartialSearchResults(
+            version.onOrAfter(TransportVersions.EQL_ALLOW_PARTIAL_SEARCH_RESULTS) ? instance.allowPartialSearchResults() : false
+        );
+        mutatedInstance.allowPartialSequenceResults(
+            version.onOrAfter(TransportVersions.EQL_ALLOW_PARTIAL_SEARCH_RESULTS) ? instance.allowPartialSequenceResults() : false
+        );
 
         return mutatedInstance;
     }
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchResponseTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchResponseTests.java
index 6cb283d11848e..fa118a5256df1 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchResponseTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/EqlSearchResponseTests.java
@@ -9,6 +9,7 @@
 import org.apache.lucene.search.TotalHits;
 import org.elasticsearch.TransportVersion;
 import org.elasticsearch.TransportVersions;
+import org.elasticsearch.action.search.ShardSearchFailure;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.document.DocumentField;
@@ -190,7 +191,7 @@ public static EqlSearchResponse createRandomEventsResponse(TotalHits totalHits,
             hits = new EqlSearchResponse.Hits(randomEvents(xType), null, totalHits);
         }
         if (randomBoolean()) {
-            return new EqlSearchResponse(hits, randomIntBetween(0, 1001), randomBoolean());
+            return new EqlSearchResponse(hits, randomIntBetween(0, 1001), randomBoolean(), ShardSearchFailure.EMPTY_ARRAY);
         } else {
             return new EqlSearchResponse(
                 hits,
@@ -198,7 +199,8 @@ public static EqlSearchResponse createRandomEventsResponse(TotalHits totalHits,
                 randomBoolean(),
                 randomAlphaOfLength(10),
                 randomBoolean(),
-                randomBoolean()
+                randomBoolean(),
+                ShardSearchFailure.EMPTY_ARRAY
             );
         }
     }
@@ -222,7 +224,7 @@ public static EqlSearchResponse createRandomSequencesResponse(TotalHits totalHit
             hits = new EqlSearchResponse.Hits(null, seq, totalHits);
         }
         if (randomBoolean()) {
-            return new EqlSearchResponse(hits, randomIntBetween(0, 1001), randomBoolean());
+            return new EqlSearchResponse(hits, randomIntBetween(0, 1001), randomBoolean(), ShardSearchFailure.EMPTY_ARRAY);
         } else {
             return new EqlSearchResponse(
                 hits,
@@ -230,7 +232,8 @@ public static EqlSearchResponse createRandomSequencesResponse(TotalHits totalHit
                 randomBoolean(),
                 randomAlphaOfLength(10),
                 randomBoolean(),
-                randomBoolean()
+                randomBoolean(),
+                ShardSearchFailure.EMPTY_ARRAY
             );
         }
     }
@@ -273,7 +276,8 @@ protected EqlSearchResponse mutateInstanceForVersion(EqlSearchResponse instance,
             instance.isTimeout(),
             instance.id(),
             instance.isRunning(),
-            instance.isPartial()
+            instance.isPartial(),
+            ShardSearchFailure.EMPTY_ARRAY
         );
     }
 
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/LocalStateEQLXPackPlugin.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/LocalStateEQLXPackPlugin.java
index 4d5201f544d72..33573b99546fb 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/LocalStateEQLXPackPlugin.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/action/LocalStateEQLXPackPlugin.java
@@ -7,26 +7,41 @@
 
 package org.elasticsearch.xpack.eql.action;
 
+import org.elasticsearch.common.breaker.CircuitBreaker;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.indices.breaker.BreakerSettings;
 import org.elasticsearch.license.XPackLicenseState;
+import org.elasticsearch.plugins.CircuitBreakerPlugin;
 import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
 import org.elasticsearch.xpack.eql.plugin.EqlPlugin;
 import org.elasticsearch.xpack.ql.plugin.QlPlugin;
 
 import java.nio.file.Path;
 
-public class LocalStateEQLXPackPlugin extends LocalStateCompositeXPackPlugin {
+public class LocalStateEQLXPackPlugin extends LocalStateCompositeXPackPlugin implements CircuitBreakerPlugin {
+
+    private final EqlPlugin eqlPlugin;
 
     public LocalStateEQLXPackPlugin(final Settings settings, final Path configPath) {
         super(settings, configPath);
         LocalStateEQLXPackPlugin thisVar = this;
-        plugins.add(new EqlPlugin() {
+        this.eqlPlugin = new EqlPlugin() {
             @Override
             protected XPackLicenseState getLicenseState() {
                 return thisVar.getLicenseState();
             }
-        });
+        };
+        plugins.add(eqlPlugin);
         plugins.add(new QlPlugin());
     }
 
+    @Override
+    public BreakerSettings getCircuitBreaker(Settings settings) {
+        return eqlPlugin.getCircuitBreaker(settings);
+    }
+
+    @Override
+    public void setCircuitBreaker(CircuitBreaker circuitBreaker) {
+        eqlPlugin.setCircuitBreaker(circuitBreaker);
+    }
 }
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/ImplicitTiebreakerTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/ImplicitTiebreakerTests.java
index 7bb6a228f6e48..abd928b04a9c7 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/ImplicitTiebreakerTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/ImplicitTiebreakerTests.java
@@ -141,7 +141,15 @@ public void testImplicitTiebreakerBeingSet() {
             booleanArrayOf(stages, false),
             NOOP_CIRCUIT_BREAKER
         );
-        TumblingWindow window = new TumblingWindow(client, criteria, null, matcher, Collections.emptyList());
+        TumblingWindow window = new TumblingWindow(
+            client,
+            criteria,
+            null,
+            matcher,
+            Collections.emptyList(),
+            randomBoolean(),
+            randomBoolean()
+        );
         window.execute(wrap(p -> {}, ex -> { throw ExceptionsHelper.convertToRuntime(ex); }));
     }
 }
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/SequenceSpecTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/SequenceSpecTests.java
index a8ed842e94c44..f6aa851b2fff0 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/SequenceSpecTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/assembler/SequenceSpecTests.java
@@ -277,7 +277,15 @@ public void test() throws Exception {
         );
 
         QueryClient testClient = new TestQueryClient();
-        TumblingWindow window = new TumblingWindow(testClient, criteria, null, matcher, Collections.emptyList());
+        TumblingWindow window = new TumblingWindow(
+            testClient,
+            criteria,
+            null,
+            matcher,
+            Collections.emptyList(),
+            randomBoolean(),
+            randomBoolean()
+        );
 
         // finally make the assertion at the end of the listener
         window.execute(ActionTestUtils.assertNoFailureListener(this::checkResults));
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sample/CircuitBreakerTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sample/CircuitBreakerTests.java
index dc132659417ff..80b1ff97b725d 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sample/CircuitBreakerTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sample/CircuitBreakerTests.java
@@ -89,7 +89,7 @@ public void query(QueryRequest r, ActionListener<SearchResponse> l) {}
 
             @Override
             public void fetchHits(Iterable<List<HitReference>> refs, ActionListener<List<List<SearchHit>>> listener) {}
-        }, mockCriteria(), randomIntBetween(10, 500), new Limit(1000, 0), CIRCUIT_BREAKER, 1);
+        }, mockCriteria(), randomIntBetween(10, 500), new Limit(1000, 0), CIRCUIT_BREAKER, 1, randomBoolean());
 
         CIRCUIT_BREAKER.startBreaking();
         iterator.pushToStack(new SampleIterator.Page(CB_STACK_SIZE_PRECISION - 1));
@@ -142,7 +142,8 @@ public void fetchHits(Iterable<List<HitReference>> refs, ActionListener<List<Lis
                 randomIntBetween(10, 500),
                 new Limit(1000, 0),
                 eqlCircuitBreaker,
-                1
+                1,
+                randomBoolean()
             );
 
             // unfortunately, mocking an actual result set it extremely complicated
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClientTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClientTests.java
index f1c5d483d4002..9a78dd4573133 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClientTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/search/PITAwareQueryClientTests.java
@@ -102,6 +102,8 @@ public void testQueryFilterUsedInPitAndSearches() {
                 null,
                 123,
                 1,
+                randomBoolean(),
+                randomBoolean(),
                 "",
                 new TaskId("test", 123),
                 new EqlSearchTask(
@@ -168,7 +170,15 @@ public void fetchHits(Iterable<List<HitReference>> refs, ActionListener<List<Lis
             }
 
             SequenceMatcher matcher = new SequenceMatcher(stages, false, TimeValue.MINUS_ONE, null, booleanArrayOf(stages, false), cb);
-            TumblingWindow window = new TumblingWindow(eqlClient, criteria, null, matcher, Collections.emptyList());
+            TumblingWindow window = new TumblingWindow(
+                eqlClient,
+                criteria,
+                null,
+                matcher,
+                Collections.emptyList(),
+                randomBoolean(),
+                randomBoolean()
+            );
             window.execute(wrap(response -> {
                 // do nothing, we don't care about the query results
             }, ex -> { fail("Shouldn't have failed"); }));
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/CircuitBreakerTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/CircuitBreakerTests.java
index fe1fca45364e3..58448d981fcca 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/CircuitBreakerTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/CircuitBreakerTests.java
@@ -146,7 +146,15 @@ public void testCircuitBreakerTumblingWindow() {
             booleanArrayOf(stages, false),
             CIRCUIT_BREAKER
         );
-        TumblingWindow window = new TumblingWindow(client, criteria, null, matcher, Collections.emptyList());
+        TumblingWindow window = new TumblingWindow(
+            client,
+            criteria,
+            null,
+            matcher,
+            Collections.emptyList(),
+            randomBoolean(),
+            randomBoolean()
+        );
         window.execute(ActionTestUtils.assertNoFailureListener(p -> {}));
 
         CIRCUIT_BREAKER.startBreaking();
@@ -228,7 +236,15 @@ private void assertMemoryCleared(
                 booleanArrayOf(sequenceFiltersCount, false),
                 eqlCircuitBreaker
             );
-            TumblingWindow window = new TumblingWindow(eqlClient, criteria, null, matcher, Collections.emptyList());
+            TumblingWindow window = new TumblingWindow(
+                eqlClient,
+                criteria,
+                null,
+                matcher,
+                Collections.emptyList(),
+                randomBoolean(),
+                randomBoolean()
+            );
             window.execute(ActionListener.noop());
 
             assertTrue(esClient.searchRequestsRemainingCount() == 0); // ensure all the search requests have been asked for
@@ -271,7 +287,15 @@ public void testEqlCBCleanedUp_on_ParentCBBreak() {
                 booleanArrayOf(sequenceFiltersCount, false),
                 eqlCircuitBreaker
             );
-            TumblingWindow window = new TumblingWindow(eqlClient, criteria, null, matcher, Collections.emptyList());
+            TumblingWindow window = new TumblingWindow(
+                eqlClient,
+                criteria,
+                null,
+                matcher,
+                Collections.emptyList(),
+                randomBoolean(),
+                randomBoolean()
+            );
             window.execute(wrap(p -> fail(), ex -> assertTrue(ex instanceof CircuitBreakingException)));
         }
         assertCriticalWarnings("[indices.breaker.total.limit] setting of [0%] is below the recommended minimum of 50.0% of the heap");
@@ -329,6 +353,8 @@ private QueryClient buildQueryClient(ESMockClient esClient, CircuitBreaker eqlCi
             null,
             123,
             1,
+            randomBoolean(),
+            randomBoolean(),
             "",
             new TaskId("test", 123),
             new EqlSearchTask(
diff --git a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/PITFailureTests.java b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/PITFailureTests.java
index 1a2f00463b49b..2eee6a262e73c 100644
--- a/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/PITFailureTests.java
+++ b/x-pack/plugin/eql/src/test/java/org/elasticsearch/xpack/eql/execution/sequence/PITFailureTests.java
@@ -83,6 +83,8 @@ public void testHandlingPitFailure() {
                 null,
                 123,
                 1,
+                randomBoolean(),
+                randomBoolean(),
                 "",
                 new TaskId("test", 123),
                 new EqlSearchTask(
@@ -132,7 +134,15 @@ public void testHandlingPitFailure() {
             );
 
             SequenceMatcher matcher = new SequenceMatcher(1, false, TimeValue.MINUS_ONE, null, booleanArrayOf(1, false), cb);
-            TumblingWindow window = new TumblingWindow(eqlClient, criteria, null, matcher, Collections.emptyList());
+            TumblingWindow window = new TumblingWindow(
+                eqlClient,
+                criteria,
+                null,
+                matcher,
+                Collections.emptyList(),
+                randomBoolean(),
+                randomBoolean()
+            );
             window.execute(
                 wrap(
                     p -> { fail("Search succeeded despite PIT failure"); },

From 51eb386a70e20bf17b42f44dda3e6a9bdd37321c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mariusz=20J=C3=B3zala?=
 <377355+jozala@users.noreply.github.com>
Date: Tue, 17 Dec 2024 17:48:57 +0100
Subject: [PATCH 034/119] [ci] Add ubuntu-2404-aarch64 to test matrix in
 platform-support (#118847)

---
 .buildkite/pipelines/periodic-platform-support.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.buildkite/pipelines/periodic-platform-support.yml b/.buildkite/pipelines/periodic-platform-support.yml
index c5846a763f5e8..ea0d7b13b55b4 100644
--- a/.buildkite/pipelines/periodic-platform-support.yml
+++ b/.buildkite/pipelines/periodic-platform-support.yml
@@ -63,6 +63,7 @@ steps:
             image:
               - almalinux-8-aarch64
               - ubuntu-2004-aarch64
+              - ubuntu-2404-aarch64
             GRADLE_TASK:
               - checkPart1
               - checkPart2

From b8f4677254f7a0cd29c8ded0361f3ab201232cd5 Mon Sep 17 00:00:00 2001
From: Ievgen Degtiarenko <ievgen.degtiarenko@elastic.co>
Date: Tue, 17 Dec 2024 18:11:50 +0100
Subject: [PATCH 035/119] Replace build with scope parameter (#118643)

This change replaces the build with scope parameter in order to make
it cleaner when parameter is build and how it is used.
---
 .../org/elasticsearch/compute/ann/Fixed.java  | 26 +++++++++++++------
 .../compute/gen/EvaluatorImplementer.java     | 15 ++++++++---
 .../function/scalar/convert/FromBase64.java   |  3 ++-
 .../function/scalar/convert/ToBase64.java     |  3 ++-
 .../function/scalar/ip/IpPrefix.java          |  3 ++-
 .../multivalue/MvPSeriesWeightedSum.java      |  3 ++-
 .../scalar/multivalue/MvPercentile.java       |  7 ++---
 .../function/scalar/string/Concat.java        |  3 ++-
 .../function/scalar/string/Left.java          |  5 ++--
 .../function/scalar/string/Repeat.java        |  9 +++++--
 .../function/scalar/string/Right.java         |  5 ++--
 .../function/scalar/string/Space.java         |  3 ++-
 .../function/scalar/string/Split.java         |  5 ++--
 13 files changed, 61 insertions(+), 29 deletions(-)

diff --git a/x-pack/plugin/esql/compute/ann/src/main/java/org/elasticsearch/compute/ann/Fixed.java b/x-pack/plugin/esql/compute/ann/src/main/java/org/elasticsearch/compute/ann/Fixed.java
index 62703fa400ff7..1f10abf3b9fb0 100644
--- a/x-pack/plugin/esql/compute/ann/src/main/java/org/elasticsearch/compute/ann/Fixed.java
+++ b/x-pack/plugin/esql/compute/ann/src/main/java/org/elasticsearch/compute/ann/Fixed.java
@@ -11,7 +11,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
-import java.util.function.Function;
 
 /**
  * Used on parameters on methods annotated with {@link Evaluator} to indicate
@@ -27,12 +26,23 @@
     boolean includeInToString() default true;
 
     /**
-     * Should the Evaluator's factory build this per evaluator with a
-     * {@code Function<DriverContext, T>} or just take fixed implementation?
-     * This is typically set to {@code true} to use the {@link Function}
-     * to make "scratch" objects which have to be isolated in a single thread.
-     * This is typically set to {@code false} when the parameter is simply
-     * immutable and can be shared.
+     * Defines the scope of the parameter.
+     * - SINGLETON (default) will build a single instance and share it across all evaluators
+     * - THREAD_LOCAL will build a new instance for each evaluator thread
      */
-    boolean build() default false;
+    Scope scope() default Scope.SINGLETON;
+
+    /**
+     * Defines the parameter scope
+     */
+    enum Scope {
+        /**
+         * Should be used for immutable parameters that can be shared across different threads
+         */
+        SINGLETON,
+        /**
+         * Should be used for mutable or not thread safe parameters
+         */
+        THREAD_LOCAL,
+    }
 }
diff --git a/x-pack/plugin/esql/compute/gen/src/main/java/org/elasticsearch/compute/gen/EvaluatorImplementer.java b/x-pack/plugin/esql/compute/gen/src/main/java/org/elasticsearch/compute/gen/EvaluatorImplementer.java
index 5869eff23a9ab..b4a0cf9127f23 100644
--- a/x-pack/plugin/esql/compute/gen/src/main/java/org/elasticsearch/compute/gen/EvaluatorImplementer.java
+++ b/x-pack/plugin/esql/compute/gen/src/main/java/org/elasticsearch/compute/gen/EvaluatorImplementer.java
@@ -16,6 +16,7 @@
 import com.squareup.javapoet.TypeSpec;
 
 import org.elasticsearch.compute.ann.Fixed;
+import org.elasticsearch.compute.ann.Fixed.Scope;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -725,7 +726,7 @@ public String closeInvocation() {
         }
     }
 
-    private record FixedProcessFunctionArg(TypeName type, String name, boolean includeInToString, boolean build, boolean releasable)
+    private record FixedProcessFunctionArg(TypeName type, String name, boolean includeInToString, Scope scope, boolean releasable)
         implements
             ProcessFunctionArg {
         @Override
@@ -762,12 +763,18 @@ public void implementFactoryCtor(MethodSpec.Builder builder) {
         }
 
         private TypeName factoryFieldType() {
-            return build ? ParameterizedTypeName.get(ClassName.get(Function.class), DRIVER_CONTEXT, type.box()) : type;
+            return switch (scope) {
+                case SINGLETON -> type;
+                case THREAD_LOCAL -> ParameterizedTypeName.get(ClassName.get(Function.class), DRIVER_CONTEXT, type.box());
+            };
         }
 
         @Override
         public String factoryInvocation(MethodSpec.Builder factoryMethodBuilder) {
-            return build ? name + ".apply(context)" : name;
+            return switch (scope) {
+                case SINGLETON -> name;
+                case THREAD_LOCAL -> name + ".apply(context)";
+            };
         }
 
         @Override
@@ -1020,7 +1027,7 @@ private ProcessFunction(
                             type,
                             name,
                             fixed.includeInToString(),
-                            fixed.build(),
+                            fixed.scope(),
                             Types.extendsSuper(types, v.asType(), "org.elasticsearch.core.Releasable")
                         )
                     );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/FromBase64.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/FromBase64.java
index 7f9d0d3f2e647..832c511a2dc50 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/FromBase64.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/FromBase64.java
@@ -30,6 +30,7 @@
 import java.util.Base64;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
 import static org.elasticsearch.xpack.esql.core.type.DataType.KEYWORD;
 
@@ -85,7 +86,7 @@ protected NodeInfo<? extends Expression> info() {
     }
 
     @Evaluator()
-    static BytesRef process(BytesRef field, @Fixed(includeInToString = false, build = true) BytesRefBuilder oScratch) {
+    static BytesRef process(BytesRef field, @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRefBuilder oScratch) {
         byte[] bytes = new byte[field.length];
         System.arraycopy(field.bytes, field.offset, bytes, 0, field.length);
         oScratch.grow(field.length);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/ToBase64.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/ToBase64.java
index c23cef31f32f5..e78968bb209b6 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/ToBase64.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/convert/ToBase64.java
@@ -30,6 +30,7 @@
 import java.util.Base64;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
 import static org.elasticsearch.xpack.esql.core.type.DataType.KEYWORD;
 
@@ -78,7 +79,7 @@ protected NodeInfo<? extends Expression> info() {
     }
 
     @Evaluator(warnExceptions = { ArithmeticException.class })
-    static BytesRef process(BytesRef field, @Fixed(includeInToString = false, build = true) BytesRefBuilder oScratch) {
+    static BytesRef process(BytesRef field, @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRefBuilder oScratch) {
         int outLength = Math.multiplyExact(4, (Math.addExact(field.length, 2) / 3));
         byte[] bytes = new byte[field.length];
         System.arraycopy(field.bytes, field.offset, bytes, 0, field.length);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ip/IpPrefix.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ip/IpPrefix.java
index 26e75e752f681..5fc61c5c07b58 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ip/IpPrefix.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ip/IpPrefix.java
@@ -30,6 +30,7 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.THIRD;
@@ -138,7 +139,7 @@ static BytesRef process(
         BytesRef ip,
         int prefixLengthV4,
         int prefixLengthV6,
-        @Fixed(includeInToString = false, build = true) BytesRef scratch
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRef scratch
     ) {
         if (prefixLengthV4 < 0 || prefixLengthV4 > 32) {
             throw new IllegalArgumentException("Prefix length v4 must be in range [0, 32], found " + prefixLengthV4);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPSeriesWeightedSum.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPSeriesWeightedSum.java
index cf49607893aae..4dd447f938880 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPSeriesWeightedSum.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPSeriesWeightedSum.java
@@ -33,6 +33,7 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isFoldable;
@@ -144,7 +145,7 @@ static void process(
         DoubleBlock.Builder builder,
         int position,
         DoubleBlock block,
-        @Fixed(includeInToString = false, build = true) CompensatedSum sum,
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) CompensatedSum sum,
         @Fixed double p
     ) {
         sum.reset(0, 0);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPercentile.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPercentile.java
index f3a63c835bd34..4e4aee307f1c7 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPercentile.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/multivalue/MvPercentile.java
@@ -35,6 +35,7 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isType;
@@ -167,7 +168,7 @@ static void process(
         int position,
         DoubleBlock values,
         double percentile,
-        @Fixed(includeInToString = false, build = true) DoubleSortingScratch scratch
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) DoubleSortingScratch scratch
     ) {
         int valueCount = values.getValueCount(position);
         int firstValueIndex = values.getFirstValueIndex(position);
@@ -190,7 +191,7 @@ static void process(
         int position,
         IntBlock values,
         double percentile,
-        @Fixed(includeInToString = false, build = true) IntSortingScratch scratch
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) IntSortingScratch scratch
     ) {
         int valueCount = values.getValueCount(position);
         int firstValueIndex = values.getFirstValueIndex(position);
@@ -213,7 +214,7 @@ static void process(
         int position,
         LongBlock values,
         double percentile,
-        @Fixed(includeInToString = false, build = true) LongSortingScratch scratch
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) LongSortingScratch scratch
     ) {
         int valueCount = values.getValueCount(position);
         int firstValueIndex = values.getFirstValueIndex(position);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Concat.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Concat.java
index 46ecc9e026d3d..eb173029876d3 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Concat.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Concat.java
@@ -32,6 +32,7 @@
 import java.util.stream.Stream;
 
 import static org.elasticsearch.common.unit.ByteSizeUnit.MB;
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.DEFAULT;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
 
@@ -111,7 +112,7 @@ public ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
     }
 
     @Evaluator
-    static BytesRef process(@Fixed(includeInToString = false, build = true) BreakingBytesRefBuilder scratch, BytesRef[] values) {
+    static BytesRef process(@Fixed(includeInToString = false, scope = THREAD_LOCAL) BreakingBytesRefBuilder scratch, BytesRef[] values) {
         scratch.grow(checkedTotalLength(values));
         scratch.clear();
         for (int i = 0; i < values.length; i++) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Left.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Left.java
index e7572caafd8f5..0d885e3f3c341 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Left.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Left.java
@@ -30,6 +30,7 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
@@ -77,8 +78,8 @@ public String getWriteableName() {
 
     @Evaluator
     static BytesRef process(
-        @Fixed(includeInToString = false, build = true) BytesRef out,
-        @Fixed(includeInToString = false, build = true) UnicodeUtil.UTF8CodePoint cp,
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRef out,
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) UnicodeUtil.UTF8CodePoint cp,
         BytesRef str,
         int length
     ) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Repeat.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Repeat.java
index 2cc14399df2ae..e91f03de3dd7e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Repeat.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Repeat.java
@@ -31,6 +31,7 @@
 import java.util.List;
 
 import static org.elasticsearch.common.unit.ByteSizeUnit.MB;
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
@@ -101,7 +102,7 @@ public boolean foldable() {
 
     @Evaluator(extraName = "Constant", warnExceptions = { IllegalArgumentException.class })
     static BytesRef processConstantNumber(
-        @Fixed(includeInToString = false, build = true) BreakingBytesRefBuilder scratch,
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BreakingBytesRefBuilder scratch,
         BytesRef str,
         @Fixed int number
     ) {
@@ -109,7 +110,11 @@ static BytesRef processConstantNumber(
     }
 
     @Evaluator(warnExceptions = { IllegalArgumentException.class })
-    static BytesRef process(@Fixed(includeInToString = false, build = true) BreakingBytesRefBuilder scratch, BytesRef str, int number) {
+    static BytesRef process(
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BreakingBytesRefBuilder scratch,
+        BytesRef str,
+        int number
+    ) {
         if (number < 0) {
             throw new IllegalArgumentException("Number parameter cannot be negative, found [" + number + "]");
         }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Right.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Right.java
index b069b984ea81e..e0ebed29cca72 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Right.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Right.java
@@ -30,6 +30,7 @@
 import java.util.Arrays;
 import java.util.List;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
@@ -77,8 +78,8 @@ public String getWriteableName() {
 
     @Evaluator
     static BytesRef process(
-        @Fixed(includeInToString = false, build = true) BytesRef out,
-        @Fixed(includeInToString = false, build = true) UnicodeUtil.UTF8CodePoint cp,
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRef out,
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) UnicodeUtil.UTF8CodePoint cp,
         BytesRef str,
         int length
     ) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Space.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Space.java
index 6481ce5764e1f..3b9a466966911 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Space.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Space.java
@@ -31,6 +31,7 @@
 import java.util.List;
 
 import static org.elasticsearch.common.unit.ByteSizeUnit.MB;
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.DEFAULT;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isType;
 import static org.elasticsearch.xpack.esql.core.type.DataType.KEYWORD;
@@ -82,7 +83,7 @@ protected TypeResolution resolveType() {
     }
 
     @Evaluator(warnExceptions = { IllegalArgumentException.class })
-    static BytesRef process(@Fixed(includeInToString = false, build = true) BreakingBytesRefBuilder scratch, int number) {
+    static BytesRef process(@Fixed(includeInToString = false, scope = THREAD_LOCAL) BreakingBytesRefBuilder scratch, int number) {
         checkNumber(number);
         scratch.grow(number);
         scratch.setLength(number);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Split.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Split.java
index b1f5da56d011b..24762122f755b 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Split.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Split.java
@@ -29,6 +29,7 @@
 
 import java.io.IOException;
 
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
 import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
 import static org.elasticsearch.xpack.esql.expression.EsqlTypeResolutions.isStringAndExact;
@@ -110,7 +111,7 @@ static void process(
         BytesRefBlock.Builder builder,
         BytesRef str,
         @Fixed byte delim,
-        @Fixed(includeInToString = false, build = true) BytesRef scratch
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRef scratch
     ) {
         scratch.bytes = str.bytes;
         scratch.offset = str.offset;
@@ -140,7 +141,7 @@ static void process(
         BytesRefBlock.Builder builder,
         BytesRef str,
         BytesRef delim,
-        @Fixed(includeInToString = false, build = true) BytesRef scratch
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BytesRef scratch
     ) {
         checkDelimiter(delim);
         process(builder, str, delim.bytes[delim.offset], scratch);

From d788761ea985a74aac90c6aee15fe32dea18e2ad Mon Sep 17 00:00:00 2001
From: Artem Prigoda <artem.prigoda@elastic.co>
Date: Tue, 17 Dec 2024 18:18:24 +0100
Subject: [PATCH 036/119] [test] Correctly mute
 MixedClusterClientYamlTestSuiteIT {cat.shards/10_basic/Help} (#116398)

The `sync_id` field was removed from the `cat shards` output for 9.0 in
#114246, this test shouldn't be run along with other 8.x clusters

Resolve #116110
---
 muted-tests.yml               | 3 ---
 qa/mixed-cluster/build.gradle | 3 +++
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 42845fda82180..93d1a6e6374b7 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -87,9 +87,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/115816
 - class: org.elasticsearch.xpack.application.connector.ConnectorIndexServiceTests
   issue: https://github.com/elastic/elasticsearch/issues/116087
-- class: org.elasticsearch.backwards.MixedClusterClientYamlTestSuiteIT
-  method: test {p0=cat.shards/10_basic/Help}
-  issue: https://github.com/elastic/elasticsearch/issues/116110
 - class: org.elasticsearch.xpack.ml.integration.DatafeedJobsRestIT
   method: testLookbackWithIndicesOptions
   issue: https://github.com/elastic/elasticsearch/issues/116127
diff --git a/qa/mixed-cluster/build.gradle b/qa/mixed-cluster/build.gradle
index d8f906b23d523..28bcac9f0242d 100644
--- a/qa/mixed-cluster/build.gradle
+++ b/qa/mixed-cluster/build.gradle
@@ -67,6 +67,9 @@ excludeList.add('indices.resolve_index/20_resolve_system_index/*')
 // Excluded because the error has changed
 excludeList.add('aggregations/percentiles_hdr_metric/Negative values test')
 
+// sync_id is removed in 9.0
+excludeList.add("cat.shards/10_basic/Help")
+
 def clusterPath = getPath()
 
 buildParams.bwcVersions.withWireCompatible { bwcVersion, baseName ->

From 70087e3ded47e905dce9be09a969768345c0fa43 Mon Sep 17 00:00:00 2001
From: "elastic-renovate-prod[bot]"
 <174716857+elastic-renovate-prod[bot]@users.noreply.github.com>
Date: Tue, 17 Dec 2024 17:58:19 +0000
Subject: [PATCH 037/119] Update docker.elastic.co/wolfi/chainguard-base:latest
 Docker digest to bfdeddb (#118868)

Co-authored-by: elastic-renovate-prod[bot] <174716857+elastic-renovate-prod[bot]@users.noreply.github.com>
---
 .../main/java/org/elasticsearch/gradle/internal/DockerBase.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/DockerBase.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/DockerBase.java
index d54eb798ce783..985c98bcd7883 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/DockerBase.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/DockerBase.java
@@ -22,7 +22,7 @@ public enum DockerBase {
     // Chainguard based wolfi image with latest jdk
     // This is usually updated via renovatebot
     // spotless:off
-    WOLFI("docker.elastic.co/wolfi/chainguard-base:latest@sha256:1b51ff6dba78c98d3e02b0cd64a8ce3238c7a40408d21e3af12a329d44db6f23",
+    WOLFI("docker.elastic.co/wolfi/chainguard-base:latest@sha256:bfdeddb33330a281950c2a54adef991dbbe6a42832bc505d13b11beaf50ae73f",
         "-wolfi",
         "apk"
     ),

From f3a16649068799aabfdafa0bc0bacf71c4409687 Mon Sep 17 00:00:00 2001
From: Tanguy Leroux <tlrx.dev@gmail.com>
Date: Tue, 17 Dec 2024 18:59:49 +0100
Subject: [PATCH 038/119] Add min. read-only index version compatible to
 DiscoveryNode (#118744)

#118443 added a new index version for indices that can be opened in read-only mode by Lucene. This change adds this information to the discovery node's VersionInformation and the transport serialization logic.

In a short future we'd like to use this information in methods like IndexMetadataVerifier#checkSupportedVersion and NodeJoineExecutor to allow opening indices in N-2 versions as read-only indices on ES V9.
---
 docs/reference/indices/shard-stores.asciidoc  |  6 +-
 .../org/elasticsearch/TransportVersions.java  |  1 +
 .../cluster/node/DiscoveryNode.java           | 21 ++++++-
 .../cluster/node/DiscoveryNodes.java          | 15 +++++
 .../cluster/node/VersionInformation.java      | 32 ++++++++--
 .../HandshakingTransportAddressConnector.java |  1 +
 .../transport/ProxyConnectionStrategy.java    |  1 +
 .../transport/SniffConnectionStrategy.java    |  1 +
 .../reroute/ClusterRerouteResponseTests.java  |  2 +
 .../cluster/ClusterStateTests.java            |  6 ++
 .../cluster/node/DiscoveryNodeTests.java      | 61 +++++++++++++++++++
 .../cluster/node/DiscoveryNodeUtils.java      | 15 ++++-
 .../ClusterStatsMonitoringDocTests.java       |  2 +
 13 files changed, 152 insertions(+), 12 deletions(-)

diff --git a/docs/reference/indices/shard-stores.asciidoc b/docs/reference/indices/shard-stores.asciidoc
index 1b001a3175b8c..04b086a758f9d 100644
--- a/docs/reference/indices/shard-stores.asciidoc
+++ b/docs/reference/indices/shard-stores.asciidoc
@@ -172,8 +172,9 @@ The API returns the following response:
                             "attributes": {},
                             "roles": [...],
                             "version": "8.10.0",
-                            "min_index_version": 7000099,
-                            "max_index_version": 8100099
+                            "min_index_version": 8000099,
+                            "min_read_only_index_version": 7000099,
+                            "max_index_version": 9004000
                         },
                         "allocation_id": "2iNySv_OQVePRX-yaRH_lQ", <4>
                         "allocation" : "primary|replica|unused" <5>
@@ -193,6 +194,7 @@ The API returns the following response:
 // TESTRESPONSE[s/"roles": \[[^]]*\]/"roles": $body.$_path/]
 // TESTRESPONSE[s/"8.10.0"/\$node_version/]
 // TESTRESPONSE[s/"min_index_version": 7000099/"min_index_version": $body.$_path/]
+// TESTRESPONSE[s/"min_index_version": 7000099/"min_index_version": $body.$_path/]
 // TESTRESPONSE[s/"max_index_version": 8100099/"max_index_version": $body.$_path/]
 
 
diff --git a/server/src/main/java/org/elasticsearch/TransportVersions.java b/server/src/main/java/org/elasticsearch/TransportVersions.java
index 371af961720cc..d3e235f1cd82a 100644
--- a/server/src/main/java/org/elasticsearch/TransportVersions.java
+++ b/server/src/main/java/org/elasticsearch/TransportVersions.java
@@ -139,6 +139,7 @@ static TransportVersion def(int id) {
     public static final TransportVersion SEMANTIC_QUERY_LENIENT = def(8_807_00_0);
     public static final TransportVersion ESQL_QUERY_BUILDER_IN_SEARCH_FUNCTIONS = def(8_808_00_0);
     public static final TransportVersion EQL_ALLOW_PARTIAL_SEARCH_RESULTS = def(8_809_00_0);
+    public static final TransportVersion NODE_VERSION_INFORMATION_WITH_MIN_READ_ONLY_INDEX_VERSION = def(8_810_00_0);
 
     /*
      * STOP! READ THIS FIRST! No, really,
diff --git a/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNode.java b/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNode.java
index 7bf367f99b929..7c757e7657853 100644
--- a/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNode.java
+++ b/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNode.java
@@ -37,6 +37,7 @@
 import java.util.SortedSet;
 import java.util.TreeSet;
 
+import static org.elasticsearch.TransportVersions.NODE_VERSION_INFORMATION_WITH_MIN_READ_ONLY_INDEX_VERSION;
 import static org.elasticsearch.node.NodeRoleSettings.NODE_ROLES_SETTING;
 
 /**
@@ -325,7 +326,17 @@ public DiscoveryNode(StreamInput in) throws IOException {
             }
         }
         this.roles = Collections.unmodifiableSortedSet(roles);
-        versionInfo = new VersionInformation(Version.readVersion(in), IndexVersion.readVersion(in), IndexVersion.readVersion(in));
+        Version version = Version.readVersion(in);
+        IndexVersion minIndexVersion = IndexVersion.readVersion(in);
+        IndexVersion minReadOnlyIndexVersion;
+        if (in.getTransportVersion().onOrAfter(NODE_VERSION_INFORMATION_WITH_MIN_READ_ONLY_INDEX_VERSION)) {
+            minReadOnlyIndexVersion = IndexVersion.readVersion(in);
+        } else {
+            minReadOnlyIndexVersion = minIndexVersion;
+
+        }
+        IndexVersion maxIndexVersion = IndexVersion.readVersion(in);
+        versionInfo = new VersionInformation(version, minIndexVersion, minReadOnlyIndexVersion, maxIndexVersion);
         if (in.getTransportVersion().onOrAfter(EXTERNAL_ID_VERSION)) {
             this.externalId = readStringLiteral.read(in);
         } else {
@@ -360,6 +371,9 @@ public void writeTo(StreamOutput out) throws IOException {
         });
         Version.writeVersion(versionInfo.nodeVersion(), out);
         IndexVersion.writeVersion(versionInfo.minIndexVersion(), out);
+        if (out.getTransportVersion().onOrAfter(NODE_VERSION_INFORMATION_WITH_MIN_READ_ONLY_INDEX_VERSION)) {
+            IndexVersion.writeVersion(versionInfo.minReadOnlyIndexVersion(), out);
+        }
         IndexVersion.writeVersion(versionInfo.maxIndexVersion(), out);
         if (out.getTransportVersion().onOrAfter(EXTERNAL_ID_VERSION)) {
             out.writeString(externalId);
@@ -478,6 +492,10 @@ public IndexVersion getMinIndexVersion() {
         return versionInfo.minIndexVersion();
     }
 
+    public IndexVersion getMinReadOnlyIndexVersion() {
+        return versionInfo.minReadOnlyIndexVersion();
+    }
+
     public IndexVersion getMaxIndexVersion() {
         return versionInfo.maxIndexVersion();
     }
@@ -577,6 +595,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         builder.endArray();
         builder.field("version", versionInfo.buildVersion().toString());
         builder.field("min_index_version", versionInfo.minIndexVersion());
+        builder.field("min_read_only_index_version", versionInfo.minReadOnlyIndexVersion());
         builder.field("max_index_version", versionInfo.maxIndexVersion());
         builder.endObject();
         return builder;
diff --git a/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodes.java b/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodes.java
index 5e6dec7b68062..f733ab223fdd1 100644
--- a/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodes.java
+++ b/server/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodes.java
@@ -69,6 +69,7 @@ public class DiscoveryNodes implements Iterable<DiscoveryNode>, SimpleDiffable<D
     private final Version minNodeVersion;
     private final IndexVersion maxDataNodeCompatibleIndexVersion;
     private final IndexVersion minSupportedIndexVersion;
+    private final IndexVersion minReadOnlySupportedIndexVersion;
 
     private final Map<String, Set<String>> tiersToNodeIds;
 
@@ -84,6 +85,7 @@ private DiscoveryNodes(
         Version minNodeVersion,
         IndexVersion maxDataNodeCompatibleIndexVersion,
         IndexVersion minSupportedIndexVersion,
+        IndexVersion minReadOnlySupportedIndexVersion,
         Map<String, Set<String>> tiersToNodeIds
     ) {
         this.nodeLeftGeneration = nodeLeftGeneration;
@@ -100,6 +102,8 @@ private DiscoveryNodes(
         this.maxNodeVersion = maxNodeVersion;
         this.maxDataNodeCompatibleIndexVersion = maxDataNodeCompatibleIndexVersion;
         this.minSupportedIndexVersion = minSupportedIndexVersion;
+        this.minReadOnlySupportedIndexVersion = minReadOnlySupportedIndexVersion;
+        assert minReadOnlySupportedIndexVersion.onOrBefore(minSupportedIndexVersion);
         assert (localNodeId == null) == (localNode == null);
         this.tiersToNodeIds = tiersToNodeIds;
     }
@@ -118,6 +122,7 @@ public DiscoveryNodes withMasterNodeId(@Nullable String masterNodeId) {
             minNodeVersion,
             maxDataNodeCompatibleIndexVersion,
             minSupportedIndexVersion,
+            minReadOnlySupportedIndexVersion,
             tiersToNodeIds
         );
     }
@@ -374,6 +379,13 @@ public IndexVersion getMinSupportedIndexVersion() {
         return minSupportedIndexVersion;
     }
 
+    /**
+     * Returns the minimum index version for read-only indices supported by all nodes in the cluster
+     */
+    public IndexVersion getMinReadOnlySupportedIndexVersion() {
+        return minReadOnlySupportedIndexVersion;
+    }
+
     /**
      * Return the node-left generation, which is the number of times the cluster membership has been updated by removing one or more nodes.
      * <p>
@@ -840,6 +852,7 @@ public DiscoveryNodes build() {
             Version maxNodeVersion = null;
             IndexVersion maxDataNodeCompatibleIndexVersion = null;
             IndexVersion minSupportedIndexVersion = null;
+            IndexVersion minReadOnlySupportedIndexVersion = null;
             for (Map.Entry<String, DiscoveryNode> nodeEntry : nodes.entrySet()) {
                 DiscoveryNode discoNode = nodeEntry.getValue();
                 Version version = discoNode.getVersion();
@@ -849,6 +862,7 @@ public DiscoveryNodes build() {
                 minNodeVersion = min(minNodeVersion, version);
                 maxNodeVersion = max(maxNodeVersion, version);
                 minSupportedIndexVersion = max(minSupportedIndexVersion, discoNode.getMinIndexVersion());
+                minReadOnlySupportedIndexVersion = max(minReadOnlySupportedIndexVersion, discoNode.getMinReadOnlyIndexVersion());
             }
 
             final long newNodeLeftGeneration;
@@ -881,6 +895,7 @@ public DiscoveryNodes build() {
                 Objects.requireNonNullElse(minNodeVersion, Version.CURRENT.minimumCompatibilityVersion()),
                 Objects.requireNonNullElse(maxDataNodeCompatibleIndexVersion, IndexVersion.current()),
                 Objects.requireNonNullElse(minSupportedIndexVersion, IndexVersions.MINIMUM_COMPATIBLE),
+                Objects.requireNonNullElse(minReadOnlySupportedIndexVersion, IndexVersions.MINIMUM_READONLY_COMPATIBLE),
                 computeTiersToNodesMap(dataNodes)
             );
         }
diff --git a/server/src/main/java/org/elasticsearch/cluster/node/VersionInformation.java b/server/src/main/java/org/elasticsearch/cluster/node/VersionInformation.java
index a4d0ff1eb55e4..852f31db69c92 100644
--- a/server/src/main/java/org/elasticsearch/cluster/node/VersionInformation.java
+++ b/server/src/main/java/org/elasticsearch/cluster/node/VersionInformation.java
@@ -18,20 +18,23 @@
 
 /**
  * Represents the versions of various aspects of an Elasticsearch node.
- * @param buildVersion      The node {@link BuildVersion}
- * @param minIndexVersion   The minimum {@link IndexVersion} supported by this node
- * @param maxIndexVersion   The maximum {@link IndexVersion} supported by this node
+ * @param buildVersion              The node {@link BuildVersion}
+ * @param minIndexVersion           The minimum {@link IndexVersion} supported by this node
+ * @param minReadOnlyIndexVersion   The minimum {@link IndexVersion} for read-only indices supported by this node
+ * @param maxIndexVersion           The maximum {@link IndexVersion} supported by this node
  */
 public record VersionInformation(
     BuildVersion buildVersion,
     Version nodeVersion,
     IndexVersion minIndexVersion,
+    IndexVersion minReadOnlyIndexVersion,
     IndexVersion maxIndexVersion
 ) {
 
     public static final VersionInformation CURRENT = new VersionInformation(
         BuildVersion.current(),
         IndexVersions.MINIMUM_COMPATIBLE,
+        IndexVersions.MINIMUM_READONLY_COMPATIBLE,
         IndexVersion.current()
     );
 
@@ -39,11 +42,18 @@ public record VersionInformation(
         Objects.requireNonNull(buildVersion);
         Objects.requireNonNull(nodeVersion);
         Objects.requireNonNull(minIndexVersion);
+        Objects.requireNonNull(minReadOnlyIndexVersion);
         Objects.requireNonNull(maxIndexVersion);
+        assert minReadOnlyIndexVersion.onOrBefore(minIndexVersion) : minReadOnlyIndexVersion + " > " + minIndexVersion;
     }
 
-    public VersionInformation(BuildVersion version, IndexVersion minIndexVersion, IndexVersion maxIndexVersion) {
-        this(version, Version.CURRENT, minIndexVersion, maxIndexVersion);
+    public VersionInformation(
+        BuildVersion version,
+        IndexVersion minIndexVersion,
+        IndexVersion minReadOnlyIndexVersion,
+        IndexVersion maxIndexVersion
+    ) {
+        this(version, Version.CURRENT, minIndexVersion, minReadOnlyIndexVersion, maxIndexVersion);
         /*
          * Whilst DiscoveryNode.getVersion exists, we need to be able to get a Version from VersionInfo
          * This needs to be consistent - on serverless, BuildVersion has an id of -1, which translates
@@ -57,7 +67,17 @@ public VersionInformation(BuildVersion version, IndexVersion minIndexVersion, In
 
     @Deprecated
     public VersionInformation(Version version, IndexVersion minIndexVersion, IndexVersion maxIndexVersion) {
-        this(BuildVersion.fromVersionId(version.id()), version, minIndexVersion, maxIndexVersion);
+        this(version, minIndexVersion, minIndexVersion, maxIndexVersion);
+    }
+
+    @Deprecated
+    public VersionInformation(
+        Version version,
+        IndexVersion minIndexVersion,
+        IndexVersion minReadOnlyIndexVersion,
+        IndexVersion maxIndexVersion
+    ) {
+        this(BuildVersion.fromVersionId(version.id()), version, minIndexVersion, minReadOnlyIndexVersion, maxIndexVersion);
     }
 
     @Deprecated
diff --git a/server/src/main/java/org/elasticsearch/discovery/HandshakingTransportAddressConnector.java b/server/src/main/java/org/elasticsearch/discovery/HandshakingTransportAddressConnector.java
index ce849c26ab780..98715127351aa 100644
--- a/server/src/main/java/org/elasticsearch/discovery/HandshakingTransportAddressConnector.java
+++ b/server/src/main/java/org/elasticsearch/discovery/HandshakingTransportAddressConnector.java
@@ -110,6 +110,7 @@ private void openProbeConnection(ActionListener<Transport.Connection> listener)
                     new VersionInformation(
                         Version.CURRENT.minimumCompatibilityVersion(),
                         IndexVersions.MINIMUM_COMPATIBLE,
+                        IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                         IndexVersion.current()
                     )
                 ),
diff --git a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
index d5047a61e4606..eb2eab75d3fe3 100644
--- a/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/ProxyConnectionStrategy.java
@@ -303,6 +303,7 @@ public void onFailure(Exception e) {
                     new VersionInformation(
                         Version.CURRENT.minimumCompatibilityVersion(),
                         IndexVersions.MINIMUM_COMPATIBLE,
+                        IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                         IndexVersion.current()
                     )
                 );
diff --git a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
index 2c198caf22354..854072c49e354 100644
--- a/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
+++ b/server/src/main/java/org/elasticsearch/transport/SniffConnectionStrategy.java
@@ -505,6 +505,7 @@ private static DiscoveryNode resolveSeedNode(String clusterAlias, String address
         var seedVersion = new VersionInformation(
             Version.CURRENT.minimumCompatibilityVersion(),
             IndexVersions.MINIMUM_COMPATIBLE,
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
             IndexVersion.current()
         );
         if (proxyAddress == null || proxyAddress.isEmpty()) {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/reroute/ClusterRerouteResponseTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/reroute/ClusterRerouteResponseTests.java
index b59cc13a20ff2..69cff0fc45ac3 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/reroute/ClusterRerouteResponseTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/reroute/ClusterRerouteResponseTests.java
@@ -127,6 +127,7 @@ public void testToXContentWithDeprecatedClusterState() {
                             ],
                             "version": "%s",
                             "min_index_version": %s,
+                            "min_read_only_index_version": %s,
                             "max_index_version": %s
                           }
                         },
@@ -218,6 +219,7 @@ public void testToXContentWithDeprecatedClusterState() {
                 clusterState.getNodes().get("node0").getEphemeralId(),
                 Version.CURRENT,
                 IndexVersions.MINIMUM_COMPATIBLE,
+                IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                 IndexVersion.current(),
                 IndexVersion.current(),
                 IndexVersion.current()
diff --git a/server/src/test/java/org/elasticsearch/cluster/ClusterStateTests.java b/server/src/test/java/org/elasticsearch/cluster/ClusterStateTests.java
index 668aea70c23f2..5f4426b02ce1a 100644
--- a/server/src/test/java/org/elasticsearch/cluster/ClusterStateTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/ClusterStateTests.java
@@ -213,6 +213,7 @@ public void testToXContent() throws IOException {
                               ],
                               "version": "%s",
                               "min_index_version":%s,
+                              "min_read_only_index_version":%s,
                               "max_index_version":%s
                             }
                           },
@@ -389,6 +390,7 @@ public void testToXContent() throws IOException {
                     ephemeralId,
                     Version.CURRENT,
                     IndexVersions.MINIMUM_COMPATIBLE,
+                    IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                     IndexVersion.current(),
                     TransportVersion.current(),
                     IndexVersion.current(),
@@ -488,6 +490,7 @@ public void testToXContent_FlatSettingTrue_ReduceMappingFalse() throws IOExcepti
                           ],
                           "version" : "%s",
                           "min_index_version" : %s,
+                          "min_read_only_index_version" : %s,
                           "max_index_version" : %s
                         }
                       },
@@ -663,6 +666,7 @@ public void testToXContent_FlatSettingTrue_ReduceMappingFalse() throws IOExcepti
                 ephemeralId,
                 Version.CURRENT,
                 IndexVersions.MINIMUM_COMPATIBLE,
+                IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                 IndexVersion.current(),
                 TransportVersion.current(),
                 IndexVersion.current(),
@@ -762,6 +766,7 @@ public void testToXContent_FlatSettingFalse_ReduceMappingTrue() throws IOExcepti
                           ],
                           "version" : "%s",
                           "min_index_version" : %s,
+                          "min_read_only_index_version" : %s,
                           "max_index_version" : %s
                         }
                       },
@@ -943,6 +948,7 @@ public void testToXContent_FlatSettingFalse_ReduceMappingTrue() throws IOExcepti
                 ephemeralId,
                 Version.CURRENT,
                 IndexVersions.MINIMUM_COMPATIBLE,
+                IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                 IndexVersion.current(),
                 TransportVersion.current(),
                 IndexVersion.current(),
diff --git a/server/src/test/java/org/elasticsearch/cluster/node/DiscoveryNodeTests.java b/server/src/test/java/org/elasticsearch/cluster/node/DiscoveryNodeTests.java
index 331b5d92ca94e..fa7633f0eaf75 100644
--- a/server/src/test/java/org/elasticsearch/cluster/node/DiscoveryNodeTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/node/DiscoveryNodeTests.java
@@ -31,6 +31,8 @@
 import static java.util.Collections.emptySet;
 import static org.elasticsearch.test.NodeRoles.nonRemoteClusterClientNode;
 import static org.elasticsearch.test.NodeRoles.remoteClusterClientNode;
+import static org.elasticsearch.test.TransportVersionUtils.getPreviousVersion;
+import static org.elasticsearch.test.TransportVersionUtils.randomVersionBetween;
 import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
@@ -221,6 +223,7 @@ public void testDiscoveryNodeToXContent() {
                             ],
                             "version" : "%s",
                             "min_index_version" : %s,
+                            "min_read_only_index_version" : %s,
                             "max_index_version" : %s
                           }
                         }""",
@@ -228,6 +231,7 @@ public void testDiscoveryNodeToXContent() {
                     withExternalId ? "test-external-id" : "test-name",
                     Version.CURRENT,
                     IndexVersions.MINIMUM_COMPATIBLE,
+                    IndexVersions.MINIMUM_READONLY_COMPATIBLE,
                     IndexVersion.current()
                 )
             )
@@ -250,4 +254,61 @@ public void testDiscoveryNodeToString() {
         assertThat(toString, containsString("{" + node.getBuildVersion() + "}"));
         assertThat(toString, containsString("{test-attr=val}"));// attributes
     }
+
+    public void testDiscoveryNodeMinReadOnlyVersionSerialization() throws Exception {
+        var node = DiscoveryNodeUtils.create("_id", buildNewFakeTransportAddress(), VersionInformation.CURRENT);
+
+        {
+            try (var out = new BytesStreamOutput()) {
+                out.setTransportVersion(TransportVersion.current());
+                node.writeTo(out);
+
+                try (var in = StreamInput.wrap(out.bytes().array())) {
+                    in.setTransportVersion(TransportVersion.current());
+
+                    var deserialized = new DiscoveryNode(in);
+                    assertThat(deserialized.getId(), equalTo(node.getId()));
+                    assertThat(deserialized.getAddress(), equalTo(node.getAddress()));
+                    assertThat(deserialized.getMinIndexVersion(), equalTo(node.getMinIndexVersion()));
+                    assertThat(deserialized.getMaxIndexVersion(), equalTo(node.getMaxIndexVersion()));
+                    assertThat(deserialized.getMinReadOnlyIndexVersion(), equalTo(node.getMinReadOnlyIndexVersion()));
+                    assertThat(deserialized.getVersionInformation(), equalTo(node.getVersionInformation()));
+                }
+            }
+        }
+
+        {
+            var oldVersion = randomVersionBetween(
+                random(),
+                TransportVersions.MINIMUM_COMPATIBLE,
+                getPreviousVersion(TransportVersions.NODE_VERSION_INFORMATION_WITH_MIN_READ_ONLY_INDEX_VERSION)
+            );
+            try (var out = new BytesStreamOutput()) {
+                out.setTransportVersion(oldVersion);
+                node.writeTo(out);
+
+                try (var in = StreamInput.wrap(out.bytes().array())) {
+                    in.setTransportVersion(oldVersion);
+
+                    var deserialized = new DiscoveryNode(in);
+                    assertThat(deserialized.getId(), equalTo(node.getId()));
+                    assertThat(deserialized.getAddress(), equalTo(node.getAddress()));
+                    assertThat(deserialized.getMinIndexVersion(), equalTo(node.getMinIndexVersion()));
+                    assertThat(deserialized.getMaxIndexVersion(), equalTo(node.getMaxIndexVersion()));
+                    assertThat(deserialized.getMinReadOnlyIndexVersion(), equalTo(node.getMinIndexVersion()));
+                    assertThat(
+                        deserialized.getVersionInformation(),
+                        equalTo(
+                            new VersionInformation(
+                                node.getBuildVersion(),
+                                node.getMinIndexVersion(),
+                                node.getMinIndexVersion(),
+                                node.getMaxIndexVersion()
+                            )
+                        )
+                    );
+                }
+            }
+        }
+    }
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodeUtils.java b/test/framework/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodeUtils.java
index 64f8fa88762b8..20368753eac1d 100644
--- a/test/framework/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodeUtils.java
+++ b/test/framework/src/main/java/org/elasticsearch/cluster/node/DiscoveryNodeUtils.java
@@ -76,6 +76,7 @@ public static class Builder {
         private BuildVersion buildVersion;
         private Version version;
         private IndexVersion minIndexVersion;
+        private IndexVersion minReadOnlyIndexVersion;
         private IndexVersion maxIndexVersion;
         private String externalId;
 
@@ -125,16 +126,23 @@ public Builder version(Version version, IndexVersion minIndexVersion, IndexVersi
             this.buildVersion = BuildVersion.fromVersionId(version.id());
             this.version = version;
             this.minIndexVersion = minIndexVersion;
+            this.minReadOnlyIndexVersion = minIndexVersion;
             this.maxIndexVersion = maxIndexVersion;
             return this;
         }
 
-        public Builder version(BuildVersion version, IndexVersion minIndexVersion, IndexVersion maxIndexVersion) {
+        public Builder version(
+            BuildVersion version,
+            IndexVersion minIndexVersion,
+            IndexVersion minReadOnlyIndexVersion,
+            IndexVersion maxIndexVersion
+        ) {
             // see comment in VersionInformation
             assert version.equals(BuildVersion.current());
             this.buildVersion = version;
             this.version = Version.CURRENT;
             this.minIndexVersion = minIndexVersion;
+            this.minReadOnlyIndexVersion = minReadOnlyIndexVersion;
             this.maxIndexVersion = maxIndexVersion;
             return this;
         }
@@ -143,6 +151,7 @@ public Builder version(VersionInformation versions) {
             this.buildVersion = versions.buildVersion();
             this.version = versions.nodeVersion();
             this.minIndexVersion = versions.minIndexVersion();
+            this.minReadOnlyIndexVersion = versions.minReadOnlyIndexVersion();
             this.maxIndexVersion = versions.maxIndexVersion();
             return this;
         }
@@ -170,10 +179,10 @@ public DiscoveryNode build() {
             }
 
             VersionInformation versionInfo;
-            if (minIndexVersion == null || maxIndexVersion == null) {
+            if (minIndexVersion == null || minReadOnlyIndexVersion == null || maxIndexVersion == null) {
                 versionInfo = VersionInformation.inferVersions(version);
             } else {
-                versionInfo = new VersionInformation(buildVersion, version, minIndexVersion, maxIndexVersion);
+                versionInfo = new VersionInformation(buildVersion, version, minIndexVersion, minReadOnlyIndexVersion, maxIndexVersion);
             }
 
             return new DiscoveryNode(name, id, ephemeralId, hostName, hostAddress, address, attributes, roles, versionInfo, externalId);
diff --git a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java
index f4d50df4ff613..35da4abec223a 100644
--- a/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java
+++ b/x-pack/plugin/monitoring/src/test/java/org/elasticsearch/xpack/monitoring/collector/cluster/ClusterStatsMonitoringDocTests.java
@@ -462,6 +462,7 @@ public void testToXContent() throws IOException {
             pluginEsBuildVersion,
             Version.CURRENT,
             IndexVersions.MINIMUM_COMPATIBLE,
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
             IndexVersion.current(),
             apmIndicesExist };
         final String expectedJson = """
@@ -817,6 +818,7 @@ public void testToXContent() throws IOException {
                     ],
                     "version": "%s",
                     "min_index_version":%s,
+                    "min_read_only_index_version":%s,
                     "max_index_version":%s
                   }
                 },

From a5c57ba966cfd088b8d79fd51fe3fb35163b22a2 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Tue, 17 Dec 2024 13:30:48 -0500
Subject: [PATCH 039/119] Adjust random_score default field to _seq_no field
 (#118671)

In an effort to improve performance and continue to provide unique
seeded scores for documents in the same index, we are switching from _id
to _seq_no.

Requiring a field that is "unique" for a field and to help with random
scores is burdensome for the user. So, we should default to a unique
field (per index) when the user provides a seed.

Using `_seq_no` should be better as:

 - We don't have to grab stored fields values
 - Bytes used are generally smaller

Additionally this removes the deprecation warning.

Marking as "breaking" as it does change the scores & behavior, but the
API provide is the same.
---
 .../src/main/resources/changelog-schema.json    |  1 +
 docs/changelog/118671.yaml                      | 11 +++++++++++
 .../RandomScoreFunctionBuilder.java             | 17 ++---------------
 .../ScoreFunctionBuilderTests.java              |  1 -
 4 files changed, 14 insertions(+), 16 deletions(-)
 create mode 100644 docs/changelog/118671.yaml

diff --git a/build-tools-internal/src/main/resources/changelog-schema.json b/build-tools-internal/src/main/resources/changelog-schema.json
index 451701d74d690..7d35951eaa2cf 100644
--- a/build-tools-internal/src/main/resources/changelog-schema.json
+++ b/build-tools-internal/src/main/resources/changelog-schema.json
@@ -295,6 +295,7 @@
         "Painless",
         "REST API",
         "Rollup",
+        "Search",
         "System requirement",
         "Transform"
       ]
diff --git a/docs/changelog/118671.yaml b/docs/changelog/118671.yaml
new file mode 100644
index 0000000000000..3931cc4179037
--- /dev/null
+++ b/docs/changelog/118671.yaml
@@ -0,0 +1,11 @@
+pr: 118671
+summary: Adjust `random_score` default field to `_seq_no` field
+area: Search
+type: breaking
+issues: []
+breaking:
+  title: Adjust `random_score` default field to `_seq_no` field
+  area: Search
+  details: When providing a 'seed' parameter to a 'random_score' function in the 'function_score' query but NOT providing a 'field', the default 'field' is switched from '_id' to '_seq_no'.
+  impact: The random scoring and ordering may change when providing a 'seed' and not providing a 'field' to a 'random_score' function. 
+  notable: false
diff --git a/server/src/main/java/org/elasticsearch/index/query/functionscore/RandomScoreFunctionBuilder.java b/server/src/main/java/org/elasticsearch/index/query/functionscore/RandomScoreFunctionBuilder.java
index 6d4b2dd4ab1f5..88f1ab1ba5c2e 100644
--- a/server/src/main/java/org/elasticsearch/index/query/functionscore/RandomScoreFunctionBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/functionscore/RandomScoreFunctionBuilder.java
@@ -13,12 +13,10 @@
 import org.elasticsearch.common.ParsingException;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.logging.DeprecationCategory;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.lucene.search.function.RandomScoreFunction;
 import org.elasticsearch.common.lucene.search.function.ScoreFunction;
-import org.elasticsearch.index.mapper.IdFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.SeqNoFieldMapper;
 import org.elasticsearch.index.query.SearchExecutionContext;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentParser;
@@ -30,7 +28,6 @@
  * A function that computes a random score for the matched documents
  */
 public class RandomScoreFunctionBuilder extends ScoreFunctionBuilder<RandomScoreFunctionBuilder> {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(RandomScoreFunctionBuilder.class);
 
     public static final String NAME = "random_score";
     private String field;
@@ -140,17 +137,7 @@ protected ScoreFunction doToFunction(SearchExecutionContext context) {
             // DocID-based random score generation
             return new RandomScoreFunction(hash(context.nowInMillis()), salt, null);
         } else {
-            String fieldName;
-            if (field == null) {
-                deprecationLogger.warn(
-                    DeprecationCategory.QUERIES,
-                    "seed_requires_field",
-                    "As of version 7.0 Elasticsearch will require that a [field] parameter is provided when a [seed] is set"
-                );
-                fieldName = IdFieldMapper.NAME;
-            } else {
-                fieldName = field;
-            }
+            final String fieldName = Objects.requireNonNullElse(field, SeqNoFieldMapper.NAME);
             if (context.isFieldMapped(fieldName) == false) {
                 if (context.hasMappings() == false) {
                     // no mappings: the index is empty anyway
diff --git a/server/src/test/java/org/elasticsearch/index/query/functionscore/ScoreFunctionBuilderTests.java b/server/src/test/java/org/elasticsearch/index/query/functionscore/ScoreFunctionBuilderTests.java
index 8d060d94e4c21..b58ac513a6449 100644
--- a/server/src/test/java/org/elasticsearch/index/query/functionscore/ScoreFunctionBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/index/query/functionscore/ScoreFunctionBuilderTests.java
@@ -66,7 +66,6 @@ public void testRandomScoreFunctionWithSeedNoField() throws Exception {
         Mockito.when(context.getFieldType(IdFieldMapper.NAME)).thenReturn(new KeywordFieldMapper.KeywordFieldType(IdFieldMapper.NAME));
         Mockito.when(context.isFieldMapped(IdFieldMapper.NAME)).thenReturn(true);
         builder.toFunction(context);
-        assertWarnings("As of version 7.0 Elasticsearch will require that a [field] parameter is provided when a [seed] is set");
     }
 
     public void testRandomScoreFunctionWithSeed() throws Exception {

From bac70647260ba0396a904b918a3dd3576c757a0d Mon Sep 17 00:00:00 2001
From: Brian Seeders <brian.seeders@elastic.co>
Date: Tue, 17 Dec 2024 13:34:26 -0500
Subject: [PATCH 040/119] Bump versions after 8.16.2 release

---
 .buildkite/pipelines/intake.yml                        |  2 +-
 .buildkite/pipelines/periodic-packaging.yml            |  6 +++---
 .buildkite/pipelines/periodic.yml                      | 10 +++++-----
 .ci/bwcVersions                                        |  2 +-
 .ci/snapshotBwcVersions                                |  2 +-
 server/src/main/java/org/elasticsearch/Version.java    |  1 +
 .../resources/org/elasticsearch/TransportVersions.csv  |  1 +
 .../org/elasticsearch/index/IndexVersions.csv          |  1 +
 8 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/.buildkite/pipelines/intake.yml b/.buildkite/pipelines/intake.yml
index 6e15d64154960..9efb9c8b498aa 100644
--- a/.buildkite/pipelines/intake.yml
+++ b/.buildkite/pipelines/intake.yml
@@ -56,7 +56,7 @@ steps:
         timeout_in_minutes: 300
         matrix:
           setup:
-            BWC_VERSION: ["8.16.2", "8.17.1", "8.18.0", "9.0.0"]
+            BWC_VERSION: ["8.16.3", "8.17.1", "8.18.0", "9.0.0"]
         agents:
           provider: gcp
           image: family/elasticsearch-ubuntu-2004
diff --git a/.buildkite/pipelines/periodic-packaging.yml b/.buildkite/pipelines/periodic-packaging.yml
index abd11068e7a65..b1e5a7bf933c9 100644
--- a/.buildkite/pipelines/periodic-packaging.yml
+++ b/.buildkite/pipelines/periodic-packaging.yml
@@ -287,8 +287,8 @@ steps:
         env:
           BWC_VERSION: 8.15.5
 
-      - label: "{{matrix.image}} / 8.16.2 / packaging-tests-upgrade"
-        command: ./.ci/scripts/packaging-test.sh -Dbwc.checkout.align=true destructiveDistroUpgradeTest.v8.16.2
+      - label: "{{matrix.image}} / 8.16.3 / packaging-tests-upgrade"
+        command: ./.ci/scripts/packaging-test.sh -Dbwc.checkout.align=true destructiveDistroUpgradeTest.v8.16.3
         timeout_in_minutes: 300
         matrix:
           setup:
@@ -301,7 +301,7 @@ steps:
           machineType: custom-16-32768
           buildDirectory: /dev/shm/bk
         env:
-          BWC_VERSION: 8.16.2
+          BWC_VERSION: 8.16.3
 
       - label: "{{matrix.image}} / 8.17.1 / packaging-tests-upgrade"
         command: ./.ci/scripts/packaging-test.sh -Dbwc.checkout.align=true destructiveDistroUpgradeTest.v8.17.1
diff --git a/.buildkite/pipelines/periodic.yml b/.buildkite/pipelines/periodic.yml
index f2d169cd2b30d..4c593bae62d7a 100644
--- a/.buildkite/pipelines/periodic.yml
+++ b/.buildkite/pipelines/periodic.yml
@@ -306,8 +306,8 @@ steps:
             - signal_reason: agent_stop
               limit: 3
 
-      - label: 8.16.2 / bwc
-        command: .ci/scripts/run-gradle.sh -Dbwc.checkout.align=true v8.16.2#bwcTest
+      - label: 8.16.3 / bwc
+        command: .ci/scripts/run-gradle.sh -Dbwc.checkout.align=true v8.16.3#bwcTest
         timeout_in_minutes: 300
         agents:
           provider: gcp
@@ -316,7 +316,7 @@ steps:
           buildDirectory: /dev/shm/bk
           preemptible: true
         env:
-          BWC_VERSION: 8.16.2
+          BWC_VERSION: 8.16.3
         retry:
           automatic:
             - exit_status: "-1"
@@ -448,7 +448,7 @@ steps:
           setup:
             ES_RUNTIME_JAVA:
               - openjdk21
-            BWC_VERSION: ["8.16.2", "8.17.1", "8.18.0", "9.0.0"]
+            BWC_VERSION: ["8.16.3", "8.17.1", "8.18.0", "9.0.0"]
         agents:
           provider: gcp
           image: family/elasticsearch-ubuntu-2004
@@ -490,7 +490,7 @@ steps:
             ES_RUNTIME_JAVA:
               - openjdk21
               - openjdk23
-            BWC_VERSION: ["8.16.2", "8.17.1", "8.18.0", "9.0.0"]
+            BWC_VERSION: ["8.16.3", "8.17.1", "8.18.0", "9.0.0"]
         agents:
           provider: gcp
           image: family/elasticsearch-ubuntu-2004
diff --git a/.ci/bwcVersions b/.ci/bwcVersions
index 3cb983373138f..cf12ee8c15419 100644
--- a/.ci/bwcVersions
+++ b/.ci/bwcVersions
@@ -15,7 +15,7 @@ BWC_VERSION:
   - "8.13.4"
   - "8.14.3"
   - "8.15.5"
-  - "8.16.2"
+  - "8.16.3"
   - "8.17.1"
   - "8.18.0"
   - "9.0.0"
diff --git a/.ci/snapshotBwcVersions b/.ci/snapshotBwcVersions
index e05c0774c9819..68c6ad5601546 100644
--- a/.ci/snapshotBwcVersions
+++ b/.ci/snapshotBwcVersions
@@ -1,5 +1,5 @@
 BWC_VERSION:
-  - "8.16.2"
+  - "8.16.3"
   - "8.17.1"
   - "8.18.0"
   - "9.0.0"
diff --git a/server/src/main/java/org/elasticsearch/Version.java b/server/src/main/java/org/elasticsearch/Version.java
index 47c43eadcfb03..8873c9b0e281e 100644
--- a/server/src/main/java/org/elasticsearch/Version.java
+++ b/server/src/main/java/org/elasticsearch/Version.java
@@ -191,6 +191,7 @@ public class Version implements VersionId<Version>, ToXContentFragment {
     public static final Version V_8_16_0 = new Version(8_16_00_99);
     public static final Version V_8_16_1 = new Version(8_16_01_99);
     public static final Version V_8_16_2 = new Version(8_16_02_99);
+    public static final Version V_8_16_3 = new Version(8_16_03_99);
     public static final Version V_8_17_0 = new Version(8_17_00_99);
     public static final Version V_8_17_1 = new Version(8_17_01_99);
     public static final Version V_8_18_0 = new Version(8_18_00_99);
diff --git a/server/src/main/resources/org/elasticsearch/TransportVersions.csv b/server/src/main/resources/org/elasticsearch/TransportVersions.csv
index 08db0822dfef5..2016f59b58a3e 100644
--- a/server/src/main/resources/org/elasticsearch/TransportVersions.csv
+++ b/server/src/main/resources/org/elasticsearch/TransportVersions.csv
@@ -135,4 +135,5 @@
 8.15.5,8702003
 8.16.0,8772001
 8.16.1,8772004
+8.16.2,8772004
 8.17.0,8797002
diff --git a/server/src/main/resources/org/elasticsearch/index/IndexVersions.csv b/server/src/main/resources/org/elasticsearch/index/IndexVersions.csv
index afe696f31d323..3bfeeded6494c 100644
--- a/server/src/main/resources/org/elasticsearch/index/IndexVersions.csv
+++ b/server/src/main/resources/org/elasticsearch/index/IndexVersions.csv
@@ -135,4 +135,5 @@
 8.15.5,8512000
 8.16.0,8518000
 8.16.1,8518000
+8.16.2,8518000
 8.17.0,8521000

From 5cb2d280201020c4246afa428095ae2e24c20be2 Mon Sep 17 00:00:00 2001
From: Brian Seeders <brian.seeders@elastic.co>
Date: Tue, 17 Dec 2024 13:35:51 -0500
Subject: [PATCH 041/119] Prune changelogs after 8.16.2 release

---
 docs/changelog/116358.yaml | 5 -----
 docs/changelog/117153.yaml | 5 -----
 docs/changelog/118380.yaml | 5 -----
 3 files changed, 15 deletions(-)
 delete mode 100644 docs/changelog/116358.yaml
 delete mode 100644 docs/changelog/117153.yaml
 delete mode 100644 docs/changelog/118380.yaml

diff --git a/docs/changelog/116358.yaml b/docs/changelog/116358.yaml
deleted file mode 100644
index 58b44a1e9bcf5..0000000000000
--- a/docs/changelog/116358.yaml
+++ /dev/null
@@ -1,5 +0,0 @@
-pr: 116358
-summary: Update Deberta tokenizer
-area: Machine Learning
-type: bug
-issues: []
diff --git a/docs/changelog/117153.yaml b/docs/changelog/117153.yaml
deleted file mode 100644
index f7640c0a7ed6a..0000000000000
--- a/docs/changelog/117153.yaml
+++ /dev/null
@@ -1,5 +0,0 @@
-pr: 117153
-summary: "ESQL: fix the column position in errors"
-area: ES|QL
-type: bug
-issues: []
diff --git a/docs/changelog/118380.yaml b/docs/changelog/118380.yaml
deleted file mode 100644
index 8b26c871fb172..0000000000000
--- a/docs/changelog/118380.yaml
+++ /dev/null
@@ -1,5 +0,0 @@
-pr: 118380
-summary: Restore original "is within leaf" value in `SparseVectorFieldMapper`
-area: Mapping
-type: bug
-issues: []

From bde485a84520539f98d3f08913af4b8b73434e6b Mon Sep 17 00:00:00 2001
From: Valeriy Khakhutskyy <1292899+valeriy42@users.noreply.github.com>
Date: Tue, 17 Dec 2024 20:23:00 +0100
Subject: [PATCH 042/119] [ML] Add dynamic templates for anomalies results
 index (#118845)

This PR enables the resolution of field names containing "." after the rollover of the anomalies results index. This way, the object parts of the field name, e.g., for an influencer, will indeed have the object type and can be resolved in search and filter operations.
---
 .../ml/anomalydetection/results_index_mappings.json    | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/core/template-resources/src/main/resources/ml/anomalydetection/results_index_mappings.json b/x-pack/plugin/core/template-resources/src/main/resources/ml/anomalydetection/results_index_mappings.json
index 4415afe50a998..e0bde4715839e 100644
--- a/x-pack/plugin/core/template-resources/src/main/resources/ml/anomalydetection/results_index_mappings.json
+++ b/x-pack/plugin/core/template-resources/src/main/resources/ml/anomalydetection/results_index_mappings.json
@@ -5,7 +5,15 @@
   },
   "dynamic_templates" : [
     {
-      "strings_as_keywords" : {
+      "map_objects": {
+        "match_mapping_type": "object",
+        "mapping": {
+          "type": "object"
+        }
+      }
+    },
+    {
+      "non_objects_as_keywords" : {
         "match" : "*",
         "mapping" : {
           "type" : "keyword"

From 4b90f01b49b820242608d54fae6b624fe950847d Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@gmail.com>
Date: Tue, 17 Dec 2024 14:36:02 -0500
Subject: [PATCH 043/119] Esql - fix some test failures due to results ordering
  (#118692)

fix some failing multi-shard tests. The backport for the PR that added these tests hasn't landed yet, so I'm going to just cherry pick this into there rather than do two back ports with conflict resolution.
---
 .../src/main/resources/date_nanos.csv-spec    | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
index f4b5c98d596ae..47191148e0205 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
@@ -555,7 +555,8 @@ required_capability: date_nanos_bucket
 
 FROM date_nanos 
 | WHERE millis > "2020-01-01" 
-| STATS ct = count(*) BY yr = BUCKET(nanos, 1 year);
+| STATS ct = count(*) BY yr = BUCKET(nanos, 1 year)
+| SORT yr DESC;
 
 ct:long | yr:date_nanos
 8       | 2023-01-01T00:00:00.000000000Z 
@@ -567,7 +568,8 @@ required_capability: date_nanos_bucket
 
 FROM date_nanos 
 | WHERE millis > "2020-01-01" 
-| STATS ct = count(*) BY yr = BUCKET(nanos, 5, "1999-01-01", NOW());
+| STATS ct = count(*) BY yr = BUCKET(nanos, 5, "1999-01-01", NOW())
+| SORT yr DESC;
 
 ct:long | yr:date_nanos
 8       | 2023-01-01T00:00:00.000000000Z 
@@ -579,7 +581,8 @@ required_capability: date_nanos_bucket
 
 FROM date_nanos 
 | WHERE millis > "2020-01-01" 
-| STATS ct = count(*) BY mo = BUCKET(nanos, 1 month);
+| STATS ct = count(*) BY mo = BUCKET(nanos, 1 month)
+| SORT mo DESC;
 
 ct:long | mo:date_nanos
 8       | 2023-10-01T00:00:00.000000000Z 
@@ -591,7 +594,8 @@ required_capability: date_nanos_bucket
 
 FROM date_nanos 
 | WHERE millis > "2020-01-01" 
-| STATS ct = count(*) BY mo = BUCKET(nanos, 20, "2023-01-01", "2023-12-31");
+| STATS ct = count(*) BY mo = BUCKET(nanos, 20, "2023-01-01", "2023-12-31")
+| SORT mo DESC;
 
 ct:long | mo:date_nanos
 8       | 2023-10-01T00:00:00.000000000Z 
@@ -603,18 +607,21 @@ required_capability: date_nanos_bucket
 
 FROM date_nanos 
 | WHERE millis > "2020-01-01" 
-| STATS ct = count(*) BY mo = BUCKET(nanos, 55, "2023-01-01", "2023-12-31");
+| STATS ct = count(*) BY mo = BUCKET(nanos, 55, "2023-01-01", "2023-12-31")
+| SORT mo DESC;
 
 ct:long | mo:date_nanos
 8       | 2023-10-23T00:00:00.000000000Z 
 ;
+
 Bucket Date nanos by 10 minutes
 required_capability: date_trunc_date_nanos
 required_capability: date_nanos_bucket
 
 FROM date_nanos 
 | WHERE millis > "2020-01-01" 
-| STATS ct = count(*) BY mn = BUCKET(nanos, 10 minutes);
+| STATS ct = count(*) BY mn = BUCKET(nanos, 10 minutes)
+| SORT mn DESC;
 
 ct:long | mn:date_nanos                 
 4       | 2023-10-23T13:50:00.000000000Z

From 517abe4ffdceb3c7ca771207fe20b0c813181810 Mon Sep 17 00:00:00 2001
From: Dianna Hohensee <dianna.hohensee@elastic.co>
Date: Tue, 17 Dec 2024 14:51:45 -0500
Subject: [PATCH 044/119] ConnectTransportException returns retryable
 BAD_GATEWAY (#118681)

ConnectTransportException and its subclasses previous translated to a
INTERNAL_SERVER_ERROR HTTP 500 code. We are changing it to 502
BAD_GATEWAY so that users may choose to retry it on connectivity
issues.

Related ES-10214
Closes #118320
---
 docs/changelog/118681.yaml                          |  6 ++++++
 .../transport/ConnectTransportException.java        | 13 +++++++++++++
 .../elasticsearch/ExceptionSerializationTests.java  |  1 +
 3 files changed, 20 insertions(+)
 create mode 100644 docs/changelog/118681.yaml

diff --git a/docs/changelog/118681.yaml b/docs/changelog/118681.yaml
new file mode 100644
index 0000000000000..a186c05e6cd7d
--- /dev/null
+++ b/docs/changelog/118681.yaml
@@ -0,0 +1,6 @@
+pr: 118681
+summary: '`ConnectTransportException` returns retryable BAD_GATEWAY'
+area: Network
+type: enhancement
+issues:
+ - 118320
diff --git a/server/src/main/java/org/elasticsearch/transport/ConnectTransportException.java b/server/src/main/java/org/elasticsearch/transport/ConnectTransportException.java
index 648d27c885843..302175cc4f5a0 100644
--- a/server/src/main/java/org/elasticsearch/transport/ConnectTransportException.java
+++ b/server/src/main/java/org/elasticsearch/transport/ConnectTransportException.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.rest.RestStatus;
 
 import java.io.IOException;
 
@@ -41,6 +42,18 @@ public ConnectTransportException(StreamInput in) throws IOException {
         }
     }
 
+    /**
+     * The ES REST API is a gateway to a single or multiple clusters. If there is an error connecting to other servers, then we should
+     * return a 502 BAD_GATEWAY status code instead of the parent class' 500 INTERNAL_SERVER_ERROR. Clients tend to retry on a 502 but not
+     * on a 500, and retrying may help on a connection error.
+     *
+     * @return a {@link RestStatus#BAD_GATEWAY} code
+     */
+    @Override
+    public final RestStatus status() {
+        return RestStatus.BAD_GATEWAY;
+    }
+
     @Override
     protected void writeTo(StreamOutput out, Writer<Throwable> nestedExceptionsWriter) throws IOException {
         super.writeTo(out, nestedExceptionsWriter);
diff --git a/server/src/test/java/org/elasticsearch/ExceptionSerializationTests.java b/server/src/test/java/org/elasticsearch/ExceptionSerializationTests.java
index 2abe4157583cd..31f54f9a16359 100644
--- a/server/src/test/java/org/elasticsearch/ExceptionSerializationTests.java
+++ b/server/src/test/java/org/elasticsearch/ExceptionSerializationTests.java
@@ -409,6 +409,7 @@ public void testConnectTransportException() throws IOException {
         ex = serialize(new ConnectTransportException(node, "msg", "action", new NullPointerException()));
         assertEquals("[][" + transportAddress + "][action] msg", ex.getMessage());
         assertThat(ex.getCause(), instanceOf(NullPointerException.class));
+        assertEquals(RestStatus.BAD_GATEWAY, ex.status());
     }
 
     public void testSearchPhaseExecutionException() throws IOException {

From ae3c0d703257996ac4b07dfdc4543eb625ee9a60 Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@gmail.com>
Date: Tue, 17 Dec 2024 14:54:19 -0500
Subject: [PATCH 045/119] Esql implicit casting for date nanos (#118697)

resolves #118476

This adds an implicit cast from string to date nanos, much the same as we do for millisecond dates. In the course of working on this, I found and fixed a couple of tests that were creating pre-epoch date nanos, which are not supported in elasticsearch. I also refactored the conversion code to use the standard DateUtils functions where appropriate, which caught some of the above errors in test data.
---
 docs/changelog/118697.yaml                    |   6 +
 .../src/main/resources/date_nanos.csv-spec    | 131 ++++++++++++++++++
 .../xpack/esql/action/EsqlCapabilities.java   |   5 +-
 .../xpack/esql/analysis/Analyzer.java         |  31 +++--
 .../esql/type/EsqlDataTypeConverter.java      |  14 +-
 .../esql/action/EsqlQueryResponseTests.java   |   2 +-
 .../esql/type/EsqlDataTypeConverterTests.java |  12 +-
 7 files changed, 179 insertions(+), 22 deletions(-)
 create mode 100644 docs/changelog/118697.yaml

diff --git a/docs/changelog/118697.yaml b/docs/changelog/118697.yaml
new file mode 100644
index 0000000000000..6e24e6ae4b47f
--- /dev/null
+++ b/docs/changelog/118697.yaml
@@ -0,0 +1,6 @@
+pr: 118697
+summary: Esql implicit casting for date nanos
+area: ES|QL
+type: enhancement
+issues:
+ - 118476
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
index 47191148e0205..4206d6b48699f 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
@@ -216,6 +216,137 @@ millis:date              | nanos:date_nanos               | num:long
 2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z | 1698068014937193000
 ;
 
+implicit casting to nanos, date only
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) > "2023-10-23" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+;
+
+implicit casting to nanos, date only, equality test
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) == "2023-10-23" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+;
+
+
+implicit casting to nanos, date plus time to seconds
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) > "2023-10-23T00:00:00" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+;
+
+implicit casting to nanos, date plus time to seconds, equality test
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) == "2023-10-23T12:27:28" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+;
+
+implicit casting to nanos, date plus time to millis
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) > "2023-10-23T00:00:00.000" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+;
+
+implicit casting to nanos, date plus time to millis, equality test
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) == "2023-10-23T12:27:28.948" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z
+;
+
+implicit casting to nanos, date plus time to nanos
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) > "2023-10-23T00:00:00.000000000" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z
+;
+
+implicit casting to nanos, date plus time to nanos, equality test
+required_capability: date_nanos_type
+required_capability: date_nanos_implicit_casting
+
+FROM date_nanos 
+| WHERE MV_MIN(nanos) == "2023-10-23T12:27:28.948000000" 
+| SORT nanos DESC 
+| KEEP millis, nanos;
+
+millis:date             | nanos:date_nanos              
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z
+;
+
 date nanos greater than millis
 required_capability: date_nanos_type
 required_capability: date_nanos_compare_to_millis
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index 4fcabb02b2d4f..f766beb76dd3d 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -352,7 +352,10 @@ public enum Cap {
          * Support for mixed comparisons between nanosecond and millisecond dates
          */
         DATE_NANOS_COMPARE_TO_MILLIS(),
-
+        /**
+         * Support implicit casting of strings to date nanos
+         */
+        DATE_NANOS_IMPLICIT_CASTING(),
         /**
          * Support Least and Greatest functions on Date Nanos type
          */
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
index d59745f03f608..e15731ca79038 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
@@ -118,6 +118,7 @@
 import static org.elasticsearch.xpack.core.enrich.EnrichPolicy.GEO_MATCH_TYPE;
 import static org.elasticsearch.xpack.esql.core.type.DataType.BOOLEAN;
 import static org.elasticsearch.xpack.esql.core.type.DataType.DATETIME;
+import static org.elasticsearch.xpack.esql.core.type.DataType.DATE_NANOS;
 import static org.elasticsearch.xpack.esql.core.type.DataType.DATE_PERIOD;
 import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
 import static org.elasticsearch.xpack.esql.core.type.DataType.FLOAT;
@@ -1050,21 +1051,23 @@ private BitSet gatherPreAnalysisMetrics(LogicalPlan plan, BitSet b) {
     /**
      * Cast string literals in ScalarFunction, EsqlArithmeticOperation, BinaryComparison, In and GroupingFunction to desired data types.
      * For example, the string literals in the following expressions will be cast implicitly to the field data type on the left hand side.
-     * date > "2024-08-21"
-     * date in ("2024-08-21", "2024-08-22", "2024-08-23")
-     * date = "2024-08-21" + 3 days
-     * ip == "127.0.0.1"
-     * version != "1.0"
-     * bucket(dateField, "1 month")
-     * date_trunc("1 minute", dateField)
-     *
+     * <ul>
+     * <li>date > "2024-08-21"</li>
+     * <li>date in ("2024-08-21", "2024-08-22", "2024-08-23")</li>
+     * <li>date = "2024-08-21" + 3 days</li>
+     * <li>ip == "127.0.0.1"</li>
+     * <li>version != "1.0"</li>
+     * <li>bucket(dateField, "1 month")</li>
+     * <li>date_trunc("1 minute", dateField)</li>
+     * </ul>
      * If the inputs to Coalesce are mixed numeric types, cast the rest of the numeric field or value to the first numeric data type if
      * applicable. For example, implicit casting converts:
-     * Coalesce(Long, Int) to Coalesce(Long, Long)
-     * Coalesce(null, Long, Int) to Coalesce(null, Long, Long)
-     * Coalesce(Double, Long, Int) to Coalesce(Double, Double, Double)
-     * Coalesce(null, Double, Long, Int) to Coalesce(null, Double, Double, Double)
-     *
+     * <ul>
+     * <li>Coalesce(Long, Int) to Coalesce(Long, Long)</li>
+     * <li>Coalesce(null, Long, Int) to Coalesce(null, Long, Long)</li>
+     * <li>Coalesce(Double, Long, Int) to Coalesce(Double, Double, Double)</li>
+     * <li>Coalesce(null, Double, Long, Int) to Coalesce(null, Double, Double, Double)</li>
+     * </ul>
      * Coalesce(Int, Long) will NOT be converted to Coalesce(Long, Long) or Coalesce(Int, Int).
      */
     private static class ImplicitCasting extends ParameterizedRule<LogicalPlan, LogicalPlan, AnalyzerContext> {
@@ -1245,7 +1248,7 @@ private static boolean supportsImplicitTemporalCasting(Expression e, BinaryOpera
         }
 
         private static boolean supportsStringImplicitCasting(DataType type) {
-            return type == DATETIME || type == IP || type == VERSION || type == BOOLEAN;
+            return type == DATETIME || type == DATE_NANOS || type == IP || type == VERSION || type == BOOLEAN;
         }
 
         private static UnresolvedAttribute unresolvedAttribute(Expression value, String type, Exception e) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverter.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverter.java
index 6ba2d8451f956..0847f71b1fb01 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverter.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverter.java
@@ -13,6 +13,8 @@
 import org.elasticsearch.common.logging.LoggerMessageFormat;
 import org.elasticsearch.common.lucene.BytesRefs;
 import org.elasticsearch.common.time.DateFormatter;
+import org.elasticsearch.common.time.DateFormatters;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.search.DocValueFormat;
 import org.elasticsearch.xpack.esql.core.InvalidArgumentException;
 import org.elasticsearch.xpack.esql.core.QlIllegalArgumentException;
@@ -51,7 +53,6 @@
 import java.time.Period;
 import java.time.ZoneId;
 import java.time.temporal.ChronoField;
-import java.time.temporal.TemporalAccessor;
 import java.time.temporal.TemporalAmount;
 import java.util.List;
 import java.util.Locale;
@@ -200,6 +201,9 @@ public static Converter converterFor(DataType from, DataType to) {
             if (to == DataType.DATETIME) {
                 return EsqlConverter.STRING_TO_DATETIME;
             }
+            if (to == DATE_NANOS) {
+                return EsqlConverter.STRING_TO_DATE_NANOS;
+            }
             if (to == DataType.IP) {
                 return EsqlConverter.STRING_TO_IP;
             }
@@ -514,13 +518,12 @@ public static long dateTimeToLong(String dateTime, DateFormatter formatter) {
     }
 
     public static long dateNanosToLong(String dateNano) {
-        return dateNanosToLong(dateNano, DateFormatter.forPattern("strict_date_optional_time_nanos"));
+        return dateNanosToLong(dateNano, DEFAULT_DATE_NANOS_FORMATTER);
     }
 
     public static long dateNanosToLong(String dateNano, DateFormatter formatter) {
-        TemporalAccessor parsed = formatter.parse(dateNano);
-        long nanos = parsed.getLong(ChronoField.INSTANT_SECONDS) * 1_000_000_000 + parsed.getLong(ChronoField.NANO_OF_SECOND);
-        return nanos;
+        Instant parsed = DateFormatters.from(formatter.parse(dateNano)).toInstant();
+        return DateUtils.toLong(parsed);
     }
 
     public static String dateTimeToString(long dateTime) {
@@ -639,6 +642,7 @@ public enum EsqlConverter implements Converter {
         STRING_TO_TIME_DURATION(x -> EsqlDataTypeConverter.parseTemporalAmount(x, DataType.TIME_DURATION)),
         STRING_TO_CHRONO_FIELD(EsqlDataTypeConverter::stringToChrono),
         STRING_TO_DATETIME(x -> EsqlDataTypeConverter.dateTimeToLong((String) x)),
+        STRING_TO_DATE_NANOS(x -> EsqlDataTypeConverter.dateNanosToLong((String) x)),
         STRING_TO_IP(x -> EsqlDataTypeConverter.stringToIP((String) x)),
         STRING_TO_VERSION(x -> EsqlDataTypeConverter.stringToVersion((String) x)),
         STRING_TO_DOUBLE(x -> EsqlDataTypeConverter.stringToDouble((String) x)),
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponseTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponseTests.java
index 35364089127cc..2deedb927331d 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponseTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponseTests.java
@@ -204,7 +204,7 @@ private Page randomPage(List<ColumnInfoImpl> columns) {
                 case BOOLEAN -> ((BooleanBlock.Builder) builder).appendBoolean(randomBoolean());
                 case UNSUPPORTED -> ((BytesRefBlock.Builder) builder).appendNull();
                 // TODO - add a random instant thing here?
-                case DATE_NANOS -> ((LongBlock.Builder) builder).appendLong(randomLong());
+                case DATE_NANOS -> ((LongBlock.Builder) builder).appendLong(randomNonNegativeLong());
                 case VERSION -> ((BytesRefBlock.Builder) builder).appendBytesRef(new Version(randomIdentifier()).toBytesRef());
                 case GEO_POINT -> ((BytesRefBlock.Builder) builder).appendBytesRef(GEO.asWkb(GeometryTestUtils.randomPoint()));
                 case CARTESIAN_POINT -> ((BytesRefBlock.Builder) builder).appendBytesRef(CARTESIAN.asWkb(ShapeTestUtils.randomPoint()));
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverterTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverterTests.java
index 8a57dfa968ccd..9a30c2281d742 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverterTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/type/EsqlDataTypeConverterTests.java
@@ -7,9 +7,11 @@
 
 package org.elasticsearch.xpack.esql.type;
 
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.esql.core.type.DataType;
 
+import java.time.Instant;
 import java.util.Arrays;
 import java.util.List;
 
@@ -50,11 +52,19 @@
 public class EsqlDataTypeConverterTests extends ESTestCase {
 
     public void testNanoTimeToString() {
-        long expected = randomLong();
+        long expected = randomNonNegativeLong();
         long actual = EsqlDataTypeConverter.dateNanosToLong(EsqlDataTypeConverter.nanoTimeToString(expected));
         assertEquals(expected, actual);
     }
 
+    public void testStringToDateNanos() {
+        assertEquals(
+            DateUtils.toLong(Instant.parse("2023-01-01T00:00:00.000Z")),
+            EsqlDataTypeConverter.convert("2023-01-01T00:00:00.000000000", DATE_NANOS)
+        );
+        assertEquals(DateUtils.toLong(Instant.parse("2023-01-01T00:00:00.000Z")), EsqlDataTypeConverter.convert("2023-01-01", DATE_NANOS));
+    }
+
     public void testCommonTypeNull() {
         for (DataType dataType : DataType.values()) {
             assertEqualsCommonType(dataType, NULL, dataType);

From 5d9c3a26631fa21ae72630fd76eec2b4eaea945f Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@gmail.com>
Date: Tue, 17 Dec 2024 15:56:51 -0500
Subject: [PATCH 046/119] Remove date histogram boolean support (#118484)

This removes support for running date aggregations over boolean fields. This has never been useful, was deprecated in 7.x, and is finally being disabled for 9.0.
---
 .../src/main/resources/changelog-schema.json  |  1 +
 docs/changelog/118484.yaml                    | 14 ++++++
 .../DateHistogramAggregatorFactory.java       | 44 -------------------
 .../DateHistogramAggregatorTests.java         |  8 ++--
 4 files changed, 19 insertions(+), 48 deletions(-)
 create mode 100644 docs/changelog/118484.yaml

diff --git a/build-tools-internal/src/main/resources/changelog-schema.json b/build-tools-internal/src/main/resources/changelog-schema.json
index 7d35951eaa2cf..9692af7adc5e6 100644
--- a/build-tools-internal/src/main/resources/changelog-schema.json
+++ b/build-tools-internal/src/main/resources/changelog-schema.json
@@ -279,6 +279,7 @@
     "compatibilityChangeArea": {
       "type": "string",
       "enum": [
+        "Aggregations",
         "Analysis",
         "Authorization",
         "Cluster and node setting",
diff --git a/docs/changelog/118484.yaml b/docs/changelog/118484.yaml
new file mode 100644
index 0000000000000..41db476a42523
--- /dev/null
+++ b/docs/changelog/118484.yaml
@@ -0,0 +1,14 @@
+pr: 118484
+summary: Remove date histogram boolean support
+area: Aggregations
+type: breaking
+issues: []
+breaking:
+  title: Remove date histogram boolean support
+  area: Aggregations
+  details: Elasticsearch no longer allows running Date Histogram aggregations
+           over boolean fields. Instead, use Terms aggregation for boolean
+           fields.
+  impact: We expect the impact to be minimal, as this never produced good
+          results, and has been deprecated for years.
+  notable: false
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java
index a8ccd1c76d031..4d0f58756b11c 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorFactory.java
@@ -11,7 +11,6 @@
 
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.common.Rounding;
-import org.elasticsearch.common.logging.DeprecationCategory;
 import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.search.aggregations.Aggregator;
@@ -42,49 +41,6 @@ public static void registerAggregators(ValuesSourceRegistry.Builder builder) {
         );
 
         builder.register(DateHistogramAggregationBuilder.REGISTRY_KEY, CoreValuesSourceType.RANGE, DateRangeHistogramAggregator::new, true);
-
-        builder.register(
-            DateHistogramAggregationBuilder.REGISTRY_KEY,
-            CoreValuesSourceType.BOOLEAN,
-            (
-                name,
-                factories,
-                rounding,
-                order,
-                keyed,
-                minDocCount,
-                downsampledResultsOffset,
-                extendedBounds,
-                hardBounds,
-                valuesSourceConfig,
-                context,
-                parent,
-                cardinality,
-                metadata) -> {
-                DEPRECATION_LOGGER.warn(
-                    DeprecationCategory.AGGREGATIONS,
-                    "date-histogram-boolean",
-                    "Running DateHistogram aggregations on [boolean] fields is deprecated"
-                );
-                return DateHistogramAggregator.build(
-                    name,
-                    factories,
-                    rounding,
-                    order,
-                    keyed,
-                    minDocCount,
-                    downsampledResultsOffset,
-                    extendedBounds,
-                    hardBounds,
-                    valuesSourceConfig,
-                    context,
-                    parent,
-                    cardinality,
-                    metadata
-                );
-            },
-            true
-        );
     }
 
     private final DateHistogramAggregationSupplier aggregatorSupplier;
diff --git a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorTests.java b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorTests.java
index 38294fb030ed4..bf26326abafbf 100644
--- a/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorTests.java
+++ b/server/src/test/java/org/elasticsearch/search/aggregations/bucket/histogram/DateHistogramAggregatorTests.java
@@ -83,9 +83,9 @@ public class DateHistogramAggregatorTests extends DateHistogramAggregatorTestCas
         "2017-12-12T22:55:46"
     );
 
-    public void testBooleanFieldDeprecated() throws IOException {
+    public void testBooleanFieldUnsupported() throws IOException {
         final String fieldName = "bogusBoolean";
-        testCase(iw -> {
+        IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> testCase(iw -> {
             Document d = new Document();
             d.add(new SortedNumericDocValuesField(fieldName, 0));
             iw.addDocument(d);
@@ -95,8 +95,8 @@ public void testBooleanFieldDeprecated() throws IOException {
                 new DateHistogramAggregationBuilder("name").calendarInterval(DateHistogramInterval.HOUR).field(fieldName),
                 new BooleanFieldMapper.BooleanFieldType(fieldName)
             )
-        );
-        assertWarnings("Running DateHistogram aggregations on [boolean] fields is deprecated");
+        ));
+        assertThat(e.getMessage(), equalTo("Field [bogusBoolean] of type [boolean] is not supported for aggregation [date_histogram]"));
     }
 
     public void testMatchNoDocs() throws IOException {

From 1054503ba8d42b8f592c20149eaf131a129576d3 Mon Sep 17 00:00:00 2001
From: Pius Fung <pius@elastic.co>
Date: Tue, 17 Dec 2024 13:03:28 -0800
Subject: [PATCH 047/119] Update start-trained-model-deployment.asciidoc
 (#118887)

Updating with changes in https://github.com/elastic/elasticsearch/pull/115041
---
 .../apis/start-trained-model-deployment.asciidoc          | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/reference/ml/trained-models/apis/start-trained-model-deployment.asciidoc b/docs/reference/ml/trained-models/apis/start-trained-model-deployment.asciidoc
index 6f7e2a4d9f988..bf9c4d14db290 100644
--- a/docs/reference/ml/trained-models/apis/start-trained-model-deployment.asciidoc
+++ b/docs/reference/ml/trained-models/apis/start-trained-model-deployment.asciidoc
@@ -138,8 +138,8 @@ normal priority deployments.
 Controls how many inference requests are allowed in the queue at a time.
 Every machine learning node in the cluster where the model can be allocated
 has a queue of this size; when the number of requests exceeds the total value,
-new requests are rejected with a 429 error. Defaults to 1024. Max allowed value
-is 1000000.
+new requests are rejected with a 429 error. Defaults to 10000. Max allowed value
+is 100000.
 
 `threads_per_allocation`::
 (Optional, integer)
@@ -173,7 +173,7 @@ The API returns the following results:
             "model_bytes": 265632637,
             "threads_per_allocation" : 1,
             "number_of_allocations" : 1,
-            "queue_capacity" : 1024,
+            "queue_capacity" : 10000,
             "priority": "normal"
         },
         "routing_table": {
@@ -229,4 +229,4 @@ POST _ml/trained_models/my_model/deployment/_start?deployment_id=my_model_for_se
   }
 }
 --------------------------------------------------
-// TEST[skip:TBD]
\ No newline at end of file
+// TEST[skip:TBD]

From 9c3d6ca9ec390b163ce8b5c6aaa46854152a87c7 Mon Sep 17 00:00:00 2001
From: Mike Pellegrini <mike.pellegrini@elastic.co>
Date: Tue, 17 Dec 2024 17:48:37 -0500
Subject: [PATCH 048/119] Mute test (#118897)

See https://github.com/elastic/elasticsearch/issues/118896
---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 93d1a6e6374b7..b5712b22fe583 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -302,6 +302,9 @@ tests:
 - class: org.elasticsearch.index.engine.RecoverySourcePruneMergePolicyTests
   method: testPruneSome
   issue: https://github.com/elastic/elasticsearch/issues/118728
+- class: org.elasticsearch.smoketest.DocsClientYamlTestSuiteIT
+  method: test {yaml=reference/indices/shard-stores/line_150}
+  issue: https://github.com/elastic/elasticsearch/issues/118896
 
 # Examples:
 #

From 127fa2782a4b40cf4b47de3529df0b2308fbddc6 Mon Sep 17 00:00:00 2001
From: Rene Groeschke <rene@elastic.co>
Date: Tue, 17 Dec 2024 23:53:24 +0100
Subject: [PATCH 049/119] [Build] Add 8.16 and 8.17 as base branches for wolfi
 updates (#118726)

Furthermore add auto-merge label to PRs created by renovate
---
 renovate.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/renovate.json b/renovate.json
index c1637ae651c1c..71c6301f8e0c2 100644
--- a/renovate.json
+++ b/renovate.json
@@ -7,8 +7,8 @@
   "schedule": [
     "after 1pm on tuesday"
   ],
-  "labels": [">non-issue", ":Delivery/Packaging", "Team:Delivery"],
-  "baseBranches": ["main", "8.x"],
+  "labels": [">non-issue", ":Delivery/Packaging", "Team:Delivery", "auto-merge-without-approval"],
+  "baseBranches": ["main", "8.x", "8.17", "8.16"],
   "packageRules": [
     {
       "groupName": "wolfi (versioned)",

From 41c3dde414c35bca765be46b90b43f918381e315 Mon Sep 17 00:00:00 2001
From: Satyam Mishra <satyyam.misshra1121@gmail.com>
Date: Wed, 18 Dec 2024 05:02:39 +0530
Subject: [PATCH 050/119] Updated ilm docs as per the issue (#118148)

This PR updates the Elasticsearch ILM tutorial for the newer screenshot
and the primary shard update in the text.
---
 .../example-index-lifecycle-policy.asciidoc   |   4 ++--
 .../tutorial-ilm-hotphaserollover-default.png | Bin 219715 -> 1427109 bytes
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ilm/example-index-lifecycle-policy.asciidoc b/docs/reference/ilm/example-index-lifecycle-policy.asciidoc
index 6ec261fabc448..0b3c17fb2caae 100644
--- a/docs/reference/ilm/example-index-lifecycle-policy.asciidoc
+++ b/docs/reference/ilm/example-index-lifecycle-policy.asciidoc
@@ -24,7 +24,7 @@ and retention requirements.
 You want to send log files to an {es} cluster so you can visualize and analyze
 the data. This data has the following retention requirements:
 
-* When the write index reaches 50GB or is 30 days old, roll over to a new index.
+* When the primary shard size of the write index reaches 50GB or the index is 30 days old, roll over to a new index.
 * After rollover, keep indices in the hot data tier for 30 days.
 * 30 days after rollover:
 ** Move indices to the warm data tier.
@@ -84,7 +84,7 @@ To save the `logs@lifecycle` policy as a new policy in {kib}:
 . On the **Edit policy logs** page, toggle **Save as new policy**, and then provide a new name for the policy, for example, `logs-custom`.
 
 The `logs@lifecycle` policy uses the recommended rollover defaults: Start writing to a new
-index when the current write index reaches 50GB or becomes 30 days old.
+index when the primary shard size of the current write index reaches 50GB or the index becomes 30 days old.
 
 To view or change the rollover settings, click **Advanced settings** for the hot
 phase. Then disable **Use recommended defaults** to display the rollover
diff --git a/docs/reference/images/ilm/tutorial-ilm-hotphaserollover-default.png b/docs/reference/images/ilm/tutorial-ilm-hotphaserollover-default.png
index 14ff66e4108354f16240ca60b7f16dce8fc6b963..d7f314cedb2612b1a9f4b534e697328ef86f8296 100644
GIT binary patch
literal 1427109
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%0D4jeX~+XO(&AF&d+
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%0Alsihvt(0YtbR8#@wUD}_o
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%0Ar|D%2^oKSq{`gP^cRN$V*z2E4^
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%0Dk$33i672kD0l-!J8OF;K!Y*GrGyD3q2lS;Kiu1
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
Wke0rm>-ul6KhiVREr0O*?f(VPR39<`

literal 219715
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


From 7c65a8e5db25fa6422a4a3b05dc086c757187635 Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Tue, 17 Dec 2024 18:03:57 -0600
Subject: [PATCH 051/119] Reindex status api updates (#118803)

---
 .../ReindexDataStreamTransportActionIT.java   |   9 +-
 .../GetMigrationReindexStatusAction.java      |  26 ++-
 ...MigrationReindexStatusTransportAction.java | 115 +++++++++++-
 .../task/ReindexDataStreamEnrichedStatus.java | 104 +++++++++++
 ...indexDataStreamPersistentTaskExecutor.java |   4 +-
 .../migrate/task/ReindexDataStreamStatus.java |  17 +-
 .../migrate/task/ReindexDataStreamTask.java   |  19 +-
 ...ationReindexStatusActionResponseTests.java | 112 ++++--------
 .../ReindexDataStreamEnrichedStatusTests.java | 165 ++++++++++++++++++
 .../task/ReindexDataStreamStatusTests.java    |  18 +-
 .../test/migrate/20_reindex_status.yml        |   4 +-
 11 files changed, 464 insertions(+), 129 deletions(-)
 create mode 100644 x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatus.java
 create mode 100644 x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java

diff --git a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java
index 6e24e644cb2af..b32a6efb854d7 100644
--- a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java
+++ b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java
@@ -29,7 +29,7 @@
 import org.elasticsearch.xpack.migrate.MigratePlugin;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.ReindexDataStreamRequest;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.ReindexDataStreamResponse;
-import org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatus;
+import org.elasticsearch.xpack.migrate.task.ReindexDataStreamEnrichedStatus;
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamTask;
 
 import java.util.Collection;
@@ -37,6 +37,7 @@
 import java.util.Locale;
 import java.util.Map;
 import java.util.Optional;
+import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.atomic.AtomicReference;
 
@@ -100,7 +101,7 @@ public void testAlreadyUpToDateDataStream() throws Exception {
         assertThat(task.getStatus().complete(), equalTo(true));
         assertNull(task.getStatus().exception());
         assertThat(task.getStatus().pending(), equalTo(0));
-        assertThat(task.getStatus().inProgress(), equalTo(0));
+        assertThat(task.getStatus().inProgress(), equalTo(Set.of()));
         assertThat(task.getStatus().errors().size(), equalTo(0));
 
         assertBusy(() -> {
@@ -108,12 +109,12 @@ public void testAlreadyUpToDateDataStream() throws Exception {
                 new ActionType<GetMigrationReindexStatusAction.Response>(GetMigrationReindexStatusAction.NAME),
                 new GetMigrationReindexStatusAction.Request(dataStreamName)
             ).actionGet();
-            ReindexDataStreamStatus status = (ReindexDataStreamStatus) statusResponse.getTask().getTask().status();
+            ReindexDataStreamEnrichedStatus status = statusResponse.getEnrichedStatus();
             assertThat(status.complete(), equalTo(true));
             assertThat(status.errors(), equalTo(List.of()));
             assertThat(status.exception(), equalTo(null));
             assertThat(status.pending(), equalTo(0));
-            assertThat(status.inProgress(), equalTo(0));
+            assertThat(status.inProgress().size(), equalTo(0));
             assertThat(status.totalIndices(), equalTo(backingIndexCount));
             assertThat(status.totalIndicesToBeUpgraded(), equalTo(0));
         });
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusAction.java
index 68ccaef4bf02c..bc084f3e0b5d6 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusAction.java
@@ -16,10 +16,9 @@
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.tasks.Task;
-import org.elasticsearch.tasks.TaskResult;
 import org.elasticsearch.xcontent.ToXContentObject;
 import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.migrate.task.ReindexDataStreamEnrichedStatus;
 
 import java.io.IOException;
 import java.util.Objects;
@@ -36,46 +35,43 @@ public GetMigrationReindexStatusAction() {
     }
 
     public static class Response extends ActionResponse implements ToXContentObject {
-        private final TaskResult task;
+        private final ReindexDataStreamEnrichedStatus enrichedStatus;
 
-        public Response(TaskResult task) {
-            this.task = requireNonNull(task, "task is required");
+        public Response(ReindexDataStreamEnrichedStatus enrichedStatus) {
+            this.enrichedStatus = requireNonNull(enrichedStatus, "status is required");
         }
 
         public Response(StreamInput in) throws IOException {
             super(in);
-            task = in.readOptionalWriteable(TaskResult::new);
+            enrichedStatus = in.readOptionalWriteable(ReindexDataStreamEnrichedStatus::new);
         }
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
-            out.writeOptionalWriteable(task);
+            out.writeOptionalWriteable(enrichedStatus);
         }
 
         /**
          * Get the actual result of the fetch.
          */
-        public TaskResult getTask() {
-            return task;
+        public ReindexDataStreamEnrichedStatus getEnrichedStatus() {
+            return enrichedStatus;
         }
 
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-            Task.Status status = task.getTask().status();
-            if (status != null) {
-                task.getTask().status().toXContent(builder, params);
-            }
+            enrichedStatus.toXContent(builder, params);
             return builder;
         }
 
         @Override
         public int hashCode() {
-            return Objects.hashCode(task);
+            return Objects.hashCode(enrichedStatus);
         }
 
         @Override
         public boolean equals(Object other) {
-            return other instanceof Response && task.equals(((Response) other).task);
+            return other instanceof Response && enrichedStatus.equals(((Response) other).enrichedStatus);
         }
 
         @Override
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusTransportAction.java
index ca81a03fc5630..64864491191e5 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusTransportAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusTransportAction.java
@@ -11,40 +11,55 @@
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionListenerResponseHandler;
+import org.elasticsearch.action.admin.indices.stats.IndexStats;
+import org.elasticsearch.action.admin.indices.stats.IndicesStatsAction;
+import org.elasticsearch.action.admin.indices.stats.IndicesStatsRequest;
+import org.elasticsearch.action.admin.indices.stats.IndicesStatsResponse;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
+import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.client.internal.Client;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.util.concurrent.EsExecutors;
 import org.elasticsearch.core.Strings;
+import org.elasticsearch.core.Tuple;
+import org.elasticsearch.index.shard.DocsStats;
 import org.elasticsearch.injection.guice.Inject;
 import org.elasticsearch.persistent.AllocatedPersistentTask;
 import org.elasticsearch.persistent.PersistentTasksCustomMetadata;
 import org.elasticsearch.tasks.CancellableTask;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.tasks.TaskInfo;
-import org.elasticsearch.tasks.TaskResult;
 import org.elasticsearch.transport.TransportRequestOptions;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.migrate.action.GetMigrationReindexStatusAction.Request;
 import org.elasticsearch.xpack.migrate.action.GetMigrationReindexStatusAction.Response;
+import org.elasticsearch.xpack.migrate.task.ReindexDataStreamEnrichedStatus;
+import org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatus;
 
+import java.util.HashMap;
 import java.util.Map;
 import java.util.Optional;
+import java.util.Set;
+import java.util.stream.Stream;
 
 public class GetMigrationReindexStatusTransportAction extends HandledTransportAction<Request, Response> {
     private final ClusterService clusterService;
     private final TransportService transportService;
+    private final Client client;
 
     @Inject
     public GetMigrationReindexStatusTransportAction(
         ClusterService clusterService,
         TransportService transportService,
-        ActionFilters actionFilters
+        ActionFilters actionFilters,
+        Client client
     ) {
         super(GetMigrationReindexStatusAction.NAME, transportService, actionFilters, Request::new, EsExecutors.DIRECT_EXECUTOR_SERVICE);
         this.clusterService = clusterService;
         this.transportService = transportService;
+        this.client = client;
     }
 
     @Override
@@ -60,9 +75,9 @@ protected void doExecute(Task task, Request request, ActionListener<Response> li
         } else if (persistentTask.isAssigned()) {
             String nodeId = persistentTask.getExecutorNode();
             if (clusterService.localNode().getId().equals(nodeId)) {
-                getRunningTaskFromNode(persistentTaskId, listener);
+                fetchAndReportStatusForTaskOnThisNode(persistentTaskId, listener);
             } else {
-                runOnNodeWithTaskIfPossible(task, request, nodeId, listener);
+                fetchAndReportStatusForTaskOnRemoteNode(task, request, nodeId, listener);
             }
         } else {
             listener.onFailure(new ElasticsearchException("Persistent task with id [{}] is not assigned to a node", persistentTaskId));
@@ -82,7 +97,7 @@ private Task getRunningPersistentTaskFromTaskManager(String persistentTaskId) {
         return optionalTask.<Task>map(Map.Entry::getValue).orElse(null);
     }
 
-    void getRunningTaskFromNode(String persistentTaskId, ActionListener<Response> listener) {
+    void fetchAndReportStatusForTaskOnThisNode(String persistentTaskId, ActionListener<Response> listener) {
         Task runningTask = getRunningPersistentTaskFromTaskManager(persistentTaskId);
         if (runningTask == null) {
             listener.onFailure(
@@ -96,11 +111,97 @@ void getRunningTaskFromNode(String persistentTaskId, ActionListener<Response> li
             );
         } else {
             TaskInfo info = runningTask.taskInfo(clusterService.localNode().getId(), true);
-            listener.onResponse(new Response(new TaskResult(false, info)));
+            ReindexDataStreamStatus status = (ReindexDataStreamStatus) info.status();
+            Set<String> inProgressIndices = status.inProgress();
+            if (inProgressIndices.isEmpty()) {
+                // We have no reason to fetch index stats since there are no in progress indices
+                reportStatus(Map.of(), status, listener);
+            } else {
+                fetchInProgressStatsAndReportStatus(inProgressIndices, status, listener);
+            }
         }
     }
 
-    private void runOnNodeWithTaskIfPossible(Task thisTask, Request request, String nodeId, ActionListener<Response> listener) {
+    /*
+     * The status is enriched with the information from inProgressMap to create a new ReindexDataStreamEnrichedStatus, which is used in the
+     * response sent to the listener.
+     */
+    private void reportStatus(
+        Map<String, Tuple<Long, Long>> inProgressMap,
+        ReindexDataStreamStatus status,
+        ActionListener<Response> listener
+    ) {
+        ReindexDataStreamEnrichedStatus enrichedStatus = new ReindexDataStreamEnrichedStatus(
+            status.persistentTaskStartTime(),
+            status.totalIndices(),
+            status.totalIndicesToBeUpgraded(),
+            status.complete(),
+            status.exception(),
+            inProgressMap,
+            status.pending(),
+            status.errors()
+        );
+        listener.onResponse(new Response(enrichedStatus));
+    }
+
+    /*
+     * This method feches doc counts for all indices in inProgressIndices (and the indices they are being reindexed into). After
+     * successfully fetching those, reportStatus is called.
+     */
+    private void fetchInProgressStatsAndReportStatus(
+        Set<String> inProgressIndices,
+        ReindexDataStreamStatus status,
+        ActionListener<Response> listener
+    ) {
+        IndicesStatsRequest indicesStatsRequest = new IndicesStatsRequest();
+        String[] indices = inProgressIndices.stream()
+            .flatMap(index -> Stream.of(index, ReindexDataStreamIndexTransportAction.generateDestIndexName(index)))
+            .toList()
+            .toArray(new String[0]);
+        indicesStatsRequest.indices(indices);
+        /*
+         * It is possible that the destination index will not exist yet, so we want to ignore the fact that it is missing
+         */
+        indicesStatsRequest.indicesOptions(IndicesOptions.fromOptions(true, true, true, true));
+        client.execute(IndicesStatsAction.INSTANCE, indicesStatsRequest, new ActionListener<IndicesStatsResponse>() {
+            @Override
+            public void onResponse(IndicesStatsResponse indicesStatsResponse) {
+                Map<String, Tuple<Long, Long>> inProgressMap = new HashMap<>();
+                for (String index : inProgressIndices) {
+                    IndexStats sourceIndexStats = indicesStatsResponse.getIndex(index);
+                    final long totalDocsInIndex;
+                    if (sourceIndexStats == null) {
+                        totalDocsInIndex = 0;
+                    } else {
+                        DocsStats totalDocsStats = sourceIndexStats.getTotal().getDocs();
+                        totalDocsInIndex = totalDocsStats == null ? 0 : totalDocsStats.getCount();
+                    }
+                    IndexStats migratedIndexStats = indicesStatsResponse.getIndex(
+                        ReindexDataStreamIndexTransportAction.generateDestIndexName(index)
+                    );
+                    final long reindexedDocsInIndex;
+                    if (migratedIndexStats == null) {
+                        reindexedDocsInIndex = 0;
+                    } else {
+                        DocsStats reindexedDocsStats = migratedIndexStats.getTotal().getDocs();
+                        reindexedDocsInIndex = reindexedDocsStats == null ? 0 : reindexedDocsStats.getCount();
+                    }
+                    inProgressMap.put(index, Tuple.tuple(totalDocsInIndex, reindexedDocsInIndex));
+                }
+                reportStatus(inProgressMap, status, listener);
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                listener.onFailure(e);
+            }
+        });
+    }
+
+    /*
+     * The task and its status exist on some other node, so this method forwards the request to that node.
+     */
+    private void fetchAndReportStatusForTaskOnRemoteNode(Task thisTask, Request request, String nodeId, ActionListener<Response> listener) {
         DiscoveryNode node = clusterService.state().nodes().get(nodeId);
         if (node == null) {
             listener.onFailure(
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatus.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatus.java
new file mode 100644
index 0000000000000..9dbe1f0c8eebc
--- /dev/null
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatus.java
@@ -0,0 +1,104 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.migrate.task;
+
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.core.Tuple;
+import org.elasticsearch.xcontent.ToXContentObject;
+import org.elasticsearch.xcontent.XContentBuilder;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+/*
+ * This class represents information similar to that in ReindexDataStreamStatus, but enriched from other sources besides just the task
+ * itself.
+ */
+public record ReindexDataStreamEnrichedStatus(
+    long persistentTaskStartTime,
+    int totalIndices,
+    int totalIndicesToBeUpgraded,
+    boolean complete,
+    Exception exception,
+    Map<String, Tuple<Long, Long>> inProgress,
+    int pending,
+    List<Tuple<String, Exception>> errors
+) implements ToXContentObject, Writeable {
+    public ReindexDataStreamEnrichedStatus {
+        Objects.requireNonNull(inProgress);
+        Objects.requireNonNull(errors);
+    }
+
+    public ReindexDataStreamEnrichedStatus(StreamInput in) throws IOException {
+        this(
+            in.readLong(),
+            in.readInt(),
+            in.readInt(),
+            in.readBoolean(),
+            in.readException(),
+            in.readMap(StreamInput::readString, in2 -> Tuple.tuple(in2.readLong(), in2.readLong())),
+            in.readInt(),
+            in.readCollectionAsList(in1 -> Tuple.tuple(in1.readString(), in1.readException()))
+        );
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeLong(persistentTaskStartTime);
+        out.writeInt(totalIndices);
+        out.writeInt(totalIndicesToBeUpgraded);
+        out.writeBoolean(complete);
+        out.writeException(exception);
+        out.writeMap(inProgress, StreamOutput::writeString, (out2, tuple) -> {
+            out2.writeLong(tuple.v1());
+            out2.writeLong(tuple.v2());
+        });
+        out.writeInt(pending);
+        out.writeCollection(errors, (out1, tuple) -> {
+            out1.writeString(tuple.v1());
+            out1.writeException(tuple.v2());
+        });
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.timestampFieldsFromUnixEpochMillis("start_time_millis", "start_time", persistentTaskStartTime);
+        builder.field("complete", complete);
+        builder.field("total_indices_in_data_stream", totalIndices);
+        builder.field("total_indices_requiring_upgrade", totalIndicesToBeUpgraded);
+        builder.field("successes", totalIndicesToBeUpgraded - (inProgress.size() + pending + errors.size()));
+        builder.startArray("in_progress");
+        for (Map.Entry<String, Tuple<Long, Long>> inProgressEntry : inProgress.entrySet()) {
+            builder.startObject();
+            builder.field("index", inProgressEntry.getKey());
+            builder.field("total_doc_count", inProgressEntry.getValue().v1());
+            builder.field("reindexed_doc_count", inProgressEntry.getValue().v2());
+            builder.endObject();
+        }
+        builder.endArray();
+        builder.field("pending", pending);
+        builder.startArray("errors");
+        for (Tuple<String, Exception> error : errors) {
+            builder.startObject();
+            builder.field("index", error.v1());
+            builder.field("message", error.v2() == null ? "unknown" : error.v2().getMessage());
+            builder.endObject();
+        }
+        builder.endArray();
+        if (exception != null) {
+            builder.field("exception", exception.getMessage());
+        }
+        builder.endObject();
+        return builder;
+    }
+}
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
index 176220a1ccae8..494be303980a7 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
@@ -78,9 +78,9 @@ protected void nodeOperation(AllocatedPersistentTask task, ReindexDataStreamTask
                     .toList();
                 reindexDataStreamTask.setPendingIndicesCount(indicesToBeReindexed.size());
                 for (Index index : indicesToBeReindexed) {
-                    reindexDataStreamTask.incrementInProgressIndicesCount();
+                    reindexDataStreamTask.incrementInProgressIndicesCount(index.getName());
                     // TODO This is just a placeholder. This is where the real data stream reindex logic will go
-                    reindexDataStreamTask.reindexSucceeded();
+                    reindexDataStreamTask.reindexSucceeded(index.getName());
                 }
 
                 completeSuccessfulPersistentTask(reindexDataStreamTask);
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatus.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatus.java
index 358062550b50a..632aea076ea5a 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatus.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatus.java
@@ -16,6 +16,7 @@
 import java.io.IOException;
 import java.util.List;
 import java.util.Objects;
+import java.util.Set;
 
 public record ReindexDataStreamStatus(
     long persistentTaskStartTime,
@@ -23,11 +24,12 @@ public record ReindexDataStreamStatus(
     int totalIndicesToBeUpgraded,
     boolean complete,
     Exception exception,
-    int inProgress,
+    Set<String> inProgress,
     int pending,
     List<Tuple<String, Exception>> errors
 ) implements Task.Status {
     public ReindexDataStreamStatus {
+        Objects.requireNonNull(inProgress);
         Objects.requireNonNull(errors);
     }
 
@@ -40,7 +42,7 @@ public ReindexDataStreamStatus(StreamInput in) throws IOException {
             in.readInt(),
             in.readBoolean(),
             in.readException(),
-            in.readInt(),
+            in.readCollectionAsSet((Reader<String>) StreamInput::readString),
             in.readInt(),
             in.readCollectionAsList(in1 -> Tuple.tuple(in1.readString(), in1.readException()))
         );
@@ -58,7 +60,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeInt(totalIndicesToBeUpgraded);
         out.writeBoolean(complete);
         out.writeException(exception);
-        out.writeInt(inProgress);
+        out.writeStringCollection(inProgress);
         out.writeInt(pending);
         out.writeCollection(errors, (out1, tuple) -> {
             out1.writeString(tuple.v1());
@@ -69,12 +71,13 @@ public void writeTo(StreamOutput out) throws IOException {
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
         builder.startObject();
-        builder.field("start_time", persistentTaskStartTime);
+        builder.timestampFieldsFromUnixEpochMillis("start_time_millis", "start_time", persistentTaskStartTime);
         builder.field("complete", complete);
-        builder.field("total_indices", totalIndices);
+        builder.field("total_indices_in_data_stream", totalIndices);
         builder.field("total_indices_requiring_upgrade", totalIndicesToBeUpgraded);
-        builder.field("successes", totalIndicesToBeUpgraded - (inProgress + pending + errors.size()));
-        builder.field("in_progress", inProgress);
+        final int inProgressSize = inProgress.size();
+        builder.field("successes", totalIndicesToBeUpgraded - (inProgressSize + pending + errors.size()));
+        builder.field("in_progress", inProgressSize);
         builder.field("pending", pending);
         builder.startArray("errors");
         for (Tuple<String, Exception> error : errors) {
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java
index 844f24f45ab77..7a2b759dfd17a 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java
@@ -15,8 +15,11 @@
 import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
 
 public class ReindexDataStreamTask extends AllocatedPersistentTask {
@@ -26,9 +29,9 @@ public class ReindexDataStreamTask extends AllocatedPersistentTask {
     private final int totalIndicesToBeUpgraded;
     private volatile boolean complete = false;
     private volatile Exception exception;
-    private final AtomicInteger inProgress = new AtomicInteger(0);
+    private final Set<String> inProgress = Collections.synchronizedSet(new HashSet<>());
     private final AtomicInteger pending = new AtomicInteger();
-    private final List<Tuple<String, Exception>> errors = new ArrayList<>();
+    private final List<Tuple<String, Exception>> errors = Collections.synchronizedList(new ArrayList<>());
     private final RunOnce completeTask;
 
     @SuppressWarnings("this-escape")
@@ -64,7 +67,7 @@ public ReindexDataStreamStatus getStatus() {
             totalIndicesToBeUpgraded,
             complete,
             exception,
-            inProgress.get(),
+            inProgress,
             pending.get(),
             errors
         );
@@ -84,17 +87,17 @@ public void taskFailed(ThreadPool threadPool, TimeValue timeToLive, Exception e)
         allReindexesCompleted(threadPool, timeToLive);
     }
 
-    public void reindexSucceeded() {
-        inProgress.decrementAndGet();
+    public void reindexSucceeded(String index) {
+        inProgress.remove(index);
     }
 
     public void reindexFailed(String index, Exception error) {
         this.errors.add(Tuple.tuple(index, error));
-        inProgress.decrementAndGet();
+        inProgress.remove(index);
     }
 
-    public void incrementInProgressIndicesCount() {
-        inProgress.incrementAndGet();
+    public void incrementInProgressIndicesCount(String index) {
+        inProgress.add(index);
         pending.decrementAndGet();
     }
 
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusActionResponseTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusActionResponseTests.java
index a18030edbf42c..1361f30840c87 100644
--- a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusActionResponseTests.java
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/GetMigrationReindexStatusActionResponseTests.java
@@ -7,25 +7,17 @@
 
 package org.elasticsearch.xpack.migrate.action;
 
-import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.common.network.NetworkModule;
-import org.elasticsearch.tasks.RawTaskStatus;
-import org.elasticsearch.tasks.Task;
-import org.elasticsearch.tasks.TaskId;
-import org.elasticsearch.tasks.TaskInfo;
-import org.elasticsearch.tasks.TaskResult;
+import org.elasticsearch.core.Tuple;
 import org.elasticsearch.test.AbstractWireSerializingTestCase;
-import org.elasticsearch.xcontent.ToXContent;
-import org.elasticsearch.xcontent.XContentBuilder;
-import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.migrate.action.GetMigrationReindexStatusAction.Response;
+import org.elasticsearch.xpack.migrate.task.ReindexDataStreamEnrichedStatus;
 
 import java.io.IOException;
-import java.util.Collections;
+import java.util.List;
 import java.util.Map;
-import java.util.TreeMap;
 
 public class GetMigrationReindexStatusActionResponseTests extends AbstractWireSerializingTestCase<Response> {
     @Override
@@ -35,11 +27,7 @@ protected Writeable.Reader<Response> instanceReader() {
 
     @Override
     protected Response createTestInstance() {
-        try {
-            return new Response(randomTaskResult());
-        } catch (IOException e) {
-            throw new RuntimeException(e);
-        }
+        return new Response(getRandomStatus());
     }
 
     @Override
@@ -47,76 +35,44 @@ protected Response mutateInstance(Response instance) throws IOException {
         return createTestInstance(); // There's only one field
     }
 
-    private static TaskResult randomTaskResult() throws IOException {
-        return switch (between(0, 2)) {
-            case 0 -> new TaskResult(randomBoolean(), randomTaskInfo());
-            case 1 -> new TaskResult(randomTaskInfo(), new RuntimeException("error"));
-            case 2 -> new TaskResult(randomTaskInfo(), randomTaskResponse());
-            default -> throw new UnsupportedOperationException("Unsupported random TaskResult constructor");
-        };
-    }
-
-    static TaskInfo randomTaskInfo() {
-        String nodeId = randomAlphaOfLength(5);
-        TaskId taskId = randomTaskId(nodeId);
-        String type = randomAlphaOfLength(5);
-        String action = randomAlphaOfLength(5);
-        Task.Status status = randomBoolean() ? randomRawTaskStatus() : null;
-        String description = randomBoolean() ? randomAlphaOfLength(5) : null;
-        long startTime = randomLong();
-        long runningTimeNanos = randomNonNegativeLong();
-        boolean cancellable = randomBoolean();
-        boolean cancelled = cancellable && randomBoolean();
-        TaskId parentTaskId = randomBoolean() ? TaskId.EMPTY_TASK_ID : randomTaskId(randomAlphaOfLength(5));
-        Map<String, String> headers = randomBoolean()
-            ? Collections.emptyMap()
-            : Collections.singletonMap(randomAlphaOfLength(5), randomAlphaOfLength(5));
-        return new TaskInfo(
-            taskId,
-            type,
-            nodeId,
-            action,
-            description,
-            status,
-            startTime,
-            runningTimeNanos,
-            cancellable,
-            cancelled,
-            parentTaskId,
-            headers
+    private ReindexDataStreamEnrichedStatus getRandomStatus() {
+        return new ReindexDataStreamEnrichedStatus(
+            randomLong(),
+            randomNegativeInt(),
+            randomNegativeInt(),
+            randomBoolean(),
+            nullableTestException(),
+            randomInProgressMap(),
+            randomNegativeInt(),
+            randomErrorList()
         );
     }
 
-    private static TaskId randomTaskId(String nodeId) {
-        return new TaskId(nodeId, randomLong());
+    private Map<String, Tuple<Long, Long>> randomInProgressMap() {
+        return randomMap(1, 50, () -> Tuple.tuple(randomAlphaOfLength(50), Tuple.tuple(randomNonNegativeLong(), randomNonNegativeLong())));
     }
 
-    private static RawTaskStatus randomRawTaskStatus() {
-        try (XContentBuilder builder = XContentBuilder.builder(XContentType.JSON.xContent())) {
-            builder.startObject();
-            int fields = between(0, 10);
-            for (int f = 0; f < fields; f++) {
-                builder.field(randomAlphaOfLength(5), randomAlphaOfLength(5));
-            }
-            builder.endObject();
-            return new RawTaskStatus(BytesReference.bytes(builder));
-        } catch (IOException e) {
-            throw new IllegalStateException(e);
+    private Exception nullableTestException() {
+        if (randomBoolean()) {
+            return testException();
         }
+        return null;
     }
 
-    private static ToXContent randomTaskResponse() {
-        Map<String, String> result = new TreeMap<>();
-        int fields = between(0, 10);
-        for (int f = 0; f < fields; f++) {
-            result.put(randomAlphaOfLength(5), randomAlphaOfLength(5));
-        }
-        return (builder, params) -> {
-            for (Map.Entry<String, String> entry : result.entrySet()) {
-                builder.field(entry.getKey(), entry.getValue());
-            }
-            return builder;
-        };
+    private Exception testException() {
+        /*
+         * Unfortunately ElasticsearchException doesn't have an equals and just falls back to Object::equals. So we can't test for equality
+         * when we're using an exception. So always just use null.
+         */
+        return null;
+    }
+
+    private List<Tuple<String, Exception>> randomErrorList() {
+        return randomErrorList(0);
+    }
+
+    private List<Tuple<String, Exception>> randomErrorList(int minSize) {
+        return randomList(minSize, Math.max(minSize, 100), () -> Tuple.tuple(randomAlphaOfLength(30), testException()));
     }
 
     @Override
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java
new file mode 100644
index 0000000000000..acd8cd1a6add2
--- /dev/null
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java
@@ -0,0 +1,165 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.migrate.task;
+
+import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.core.Tuple;
+import org.elasticsearch.test.AbstractWireSerializingTestCase;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xcontent.json.JsonXContent;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static java.util.Map.entry;
+import static org.elasticsearch.xcontent.ToXContent.EMPTY_PARAMS;
+import static org.hamcrest.Matchers.equalTo;
+
+public class ReindexDataStreamEnrichedStatusTests extends AbstractWireSerializingTestCase<ReindexDataStreamEnrichedStatus> {
+
+    @Override
+    protected Writeable.Reader<ReindexDataStreamEnrichedStatus> instanceReader() {
+        return ReindexDataStreamEnrichedStatus::new;
+    }
+
+    @Override
+    protected ReindexDataStreamEnrichedStatus createTestInstance() {
+        return new ReindexDataStreamEnrichedStatus(
+            randomLong(),
+            randomNegativeInt(),
+            randomNegativeInt(),
+            randomBoolean(),
+            nullableTestException(),
+            randomInProgressMap(),
+            randomNegativeInt(),
+            randomErrorList()
+        );
+    }
+
+    private Map<String, Tuple<Long, Long>> randomInProgressMap() {
+        return randomMap(1, 50, () -> Tuple.tuple(randomAlphaOfLength(50), Tuple.tuple(randomNonNegativeLong(), randomNonNegativeLong())));
+    }
+
+    private Exception nullableTestException() {
+        if (randomBoolean()) {
+            return testException();
+        }
+        return null;
+    }
+
+    private Exception testException() {
+        /*
+         * Unfortunately ElasticsearchException doesn't have an equals and just falls back to Object::equals. So we can't test for equality
+         * when we're using an exception. So always just use null.
+         */
+        return null;
+    }
+
+    private List<String> randomList() {
+        return randomList(0);
+    }
+
+    private List<String> randomList(int minSize) {
+        return randomList(minSize, Math.max(minSize, 100), () -> randomAlphaOfLength(50));
+    }
+
+    private Set<String> randomSet(int minSize) {
+        return randomSet(minSize, 100, () -> randomAlphaOfLength(50));
+    }
+
+    private List<Tuple<String, Exception>> randomErrorList() {
+        return randomErrorList(0);
+    }
+
+    private List<Tuple<String, Exception>> randomErrorList(int minSize) {
+        return randomList(minSize, Math.max(minSize, 100), () -> Tuple.tuple(randomAlphaOfLength(30), testException()));
+    }
+
+    @Override
+    protected ReindexDataStreamEnrichedStatus mutateInstance(ReindexDataStreamEnrichedStatus instance) throws IOException {
+        long startTime = instance.persistentTaskStartTime();
+        int totalIndices = instance.totalIndices();
+        int totalIndicesToBeUpgraded = instance.totalIndicesToBeUpgraded();
+        boolean complete = instance.complete();
+        Exception exception = instance.exception();
+        Map<String, Tuple<Long, Long>> inProgress = instance.inProgress();
+        int pending = instance.pending();
+        List<Tuple<String, Exception>> errors = instance.errors();
+        switch (randomIntBetween(0, 6)) {
+            case 0 -> startTime = randomLong();
+            case 1 -> totalIndices = totalIndices + 1;
+            case 2 -> totalIndicesToBeUpgraded = totalIndicesToBeUpgraded + 1;
+            case 3 -> complete = complete == false;
+            case 4 -> inProgress = randomInProgressMap();
+            case 5 -> pending = pending + 1;
+            case 6 -> errors = randomErrorList(errors.size() + 1);
+            default -> throw new UnsupportedOperationException();
+        }
+        return new ReindexDataStreamEnrichedStatus(
+            startTime,
+            totalIndices,
+            totalIndicesToBeUpgraded,
+            complete,
+            exception,
+            inProgress,
+            pending,
+            errors
+        );
+    }
+
+    public void testToXContent() throws IOException {
+        ReindexDataStreamEnrichedStatus status = new ReindexDataStreamEnrichedStatus(
+            1234L,
+            200,
+            100,
+            true,
+            new ElasticsearchException("the whole task failed"),
+            Map.of("index-1", Tuple.tuple(10L, 8L)),
+            8,
+            List.of(
+                Tuple.tuple("index7", new ElasticsearchException("index7 failed")),
+                Tuple.tuple("index8", new ElasticsearchException("index8 " + "failed"))
+            )
+        );
+        try (XContentBuilder builder = XContentBuilder.builder(JsonXContent.jsonXContent)) {
+            builder.humanReadable(true);
+            status.toXContent(builder, EMPTY_PARAMS);
+            try (XContentParser parser = createParser(JsonXContent.jsonXContent, BytesReference.bytes(builder))) {
+                Map<String, Object> parserMap = parser.map();
+                assertThat(
+                    parserMap,
+                    equalTo(
+                        Map.ofEntries(
+                            entry("start_time", "1970-01-01T00:00:01.234Z"),
+                            entry("start_time_millis", 1234),
+                            entry("total_indices_in_data_stream", 200),
+                            entry("total_indices_requiring_upgrade", 100),
+                            entry("complete", true),
+                            entry("exception", "the whole task failed"),
+                            entry("successes", 89),
+                            entry("in_progress", List.of(Map.of("index", "index-1", "total_doc_count", 10, "reindexed_doc_count", 8))),
+                            entry("pending", 8),
+                            entry(
+                                "errors",
+                                List.of(
+                                    Map.of("index", "index7", "message", "index7 failed"),
+                                    Map.of("index", "index8", "message", "index8 failed")
+                                )
+                            )
+                        )
+                    )
+                );
+            }
+        }
+    }
+}
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java
index d81e9d35cd490..47e2d02bee3b0 100644
--- a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java
@@ -19,6 +19,7 @@
 import java.io.IOException;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 import static java.util.Map.entry;
 import static org.elasticsearch.xcontent.ToXContent.EMPTY_PARAMS;
@@ -39,7 +40,7 @@ protected ReindexDataStreamStatus createTestInstance() {
             randomNegativeInt(),
             randomBoolean(),
             nullableTestException(),
-            randomNegativeInt(),
+            randomSet(0),
             randomNegativeInt(),
             randomErrorList()
         );
@@ -68,6 +69,10 @@ private List<String> randomList(int minSize) {
         return randomList(minSize, Math.max(minSize, 100), () -> randomAlphaOfLength(50));
     }
 
+    private Set<String> randomSet(int minSize) {
+        return randomSet(minSize, 100, () -> randomAlphaOfLength(50));
+    }
+
     private List<Tuple<String, Exception>> randomErrorList() {
         return randomErrorList(0);
     }
@@ -83,7 +88,7 @@ protected ReindexDataStreamStatus mutateInstance(ReindexDataStreamStatus instanc
         int totalIndicesToBeUpgraded = instance.totalIndicesToBeUpgraded();
         boolean complete = instance.complete();
         Exception exception = instance.exception();
-        int inProgress = instance.inProgress();
+        Set<String> inProgress = instance.inProgress();
         int pending = instance.pending();
         List<Tuple<String, Exception>> errors = instance.errors();
         switch (randomIntBetween(0, 6)) {
@@ -91,7 +96,7 @@ protected ReindexDataStreamStatus mutateInstance(ReindexDataStreamStatus instanc
             case 1 -> totalIndices = totalIndices + 1;
             case 2 -> totalIndicesToBeUpgraded = totalIndicesToBeUpgraded + 1;
             case 3 -> complete = complete == false;
-            case 4 -> inProgress = inProgress + 1;
+            case 4 -> inProgress = randomSet(inProgress.size() + 1);
             case 5 -> pending = pending + 1;
             case 6 -> errors = randomErrorList(errors.size() + 1);
             default -> throw new UnsupportedOperationException();
@@ -115,7 +120,7 @@ public void testToXContent() throws IOException {
             100,
             true,
             new ElasticsearchException("the whole task failed"),
-            12,
+            randomSet(12, 12, () -> randomAlphaOfLength(50)),
             8,
             List.of(
                 Tuple.tuple("index7", new ElasticsearchException("index7 failed")),
@@ -131,8 +136,9 @@ public void testToXContent() throws IOException {
                     parserMap,
                     equalTo(
                         Map.ofEntries(
-                            entry("start_time", 1234),
-                            entry("total_indices", 200),
+                            entry("start_time", "1970-01-01T00:00:01.234Z"),
+                            entry("start_time_millis", 1234),
+                            entry("total_indices_in_data_stream", 200),
                             entry("total_indices_requiring_upgrade", 100),
                             entry("complete", true),
                             entry("exception", "the whole task failed"),
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/20_reindex_status.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/20_reindex_status.yml
index c94ce8dd211ae..80ca95d631491 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/20_reindex_status.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/20_reindex_status.yml
@@ -61,10 +61,10 @@ setup:
       migrate.get_reindex_status:
         index: "my-data-stream"
   - match: { complete: true }
-  - match: { total_indices: 1 }
+  - match: { total_indices_in_data_stream: 1 }
   - match: { total_indices_requiring_upgrade: 0 }
   - match: { successes: 0 }
-  - match: { in_progress: 0 }
+  - match: { in_progress: [] }
   - match: { pending: 0 }
   - match: { errors: [] }
 

From 15bec3cefa48c958dada0fba42f452fd278c1ab6 Mon Sep 17 00:00:00 2001
From: Kathleen DeRusso <kathleen.derusso@elastic.co>
Date: Tue, 17 Dec 2024 19:06:54 -0500
Subject: [PATCH 052/119] Add support for sparse_vector queries against
 semantic_text fields (#118617)

---
 docs/changelog/118617.yaml                    |   5 +
 .../ml/search/SparseVectorQueryBuilder.java   |  38 ++-
 .../search/SparseVectorQueryBuilderTests.java |   6 +-
 .../xpack/inference/InferenceFeatures.java    |   7 +-
 .../xpack/inference/InferencePlugin.java      |   3 +-
 .../SemanticMatchQueryRewriteInterceptor.java |  88 ++-----
 .../queries/SemanticQueryBuilder.java         |   8 +
 .../SemanticQueryRewriteInterceptor.java      | 148 +++++++++++
 ...icSparseVectorQueryRewriteInterceptor.java | 124 +++++++++
 ...nticMatchQueryRewriteInterceptorTests.java | 110 ++++++++
 ...rseVectorQueryRewriteInterceptorTests.java | 137 ++++++++++
 .../46_semantic_text_sparse_vector.yml        | 249 ++++++++++++++++++
 .../test/ml/sparse_vector_search.yml          |  40 ++-
 13 files changed, 887 insertions(+), 76 deletions(-)
 create mode 100644 docs/changelog/118617.yaml
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryRewriteInterceptor.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticSparseVectorQueryRewriteInterceptor.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticMatchQueryRewriteInterceptorTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticSparseVectorQueryRewriteInterceptorTests.java
 create mode 100644 x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/46_semantic_text_sparse_vector.yml

diff --git a/docs/changelog/118617.yaml b/docs/changelog/118617.yaml
new file mode 100644
index 0000000000000..a8793a114e913
--- /dev/null
+++ b/docs/changelog/118617.yaml
@@ -0,0 +1,5 @@
+pr: 118617
+summary: Add support for `sparse_vector` queries against `semantic_text` fields
+area: "Search"
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilder.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilder.java
index e9e4e90421adc..35cba890e5e0c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilder.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilder.java
@@ -90,7 +90,8 @@ public SparseVectorQueryBuilder(
             : (this.shouldPruneTokens ? new TokenPruningConfig() : null));
         this.weightedTokensSupplier = null;
 
-        if (queryVectors == null ^ inferenceId == null == false) {
+        // Preserve BWC error messaging
+        if (queryVectors != null && inferenceId != null) {
             throw new IllegalArgumentException(
                 "["
                     + NAME
@@ -98,18 +99,24 @@ public SparseVectorQueryBuilder(
                     + QUERY_VECTOR_FIELD.getPreferredName()
                     + "] or ["
                     + INFERENCE_ID_FIELD.getPreferredName()
-                    + "]"
+                    + "] for "
+                    + ALLOWED_FIELD_TYPE
+                    + " fields"
             );
         }
-        if (inferenceId != null && query == null) {
+
+        // Preserve BWC error messaging
+        if ((queryVectors == null) == (query == null)) {
             throw new IllegalArgumentException(
                 "["
                     + NAME
-                    + "] requires ["
-                    + QUERY_FIELD.getPreferredName()
-                    + "] when ["
+                    + "] requires one of ["
+                    + QUERY_VECTOR_FIELD.getPreferredName()
+                    + "] or ["
                     + INFERENCE_ID_FIELD.getPreferredName()
-                    + "] is specified"
+                    + "] for "
+                    + ALLOWED_FIELD_TYPE
+                    + " fields"
             );
         }
     }
@@ -143,6 +150,14 @@ public List<WeightedToken> getQueryVectors() {
         return queryVectors;
     }
 
+    public String getInferenceId() {
+        return inferenceId;
+    }
+
+    public String getQuery() {
+        return query;
+    }
+
     public boolean shouldPruneTokens() {
         return shouldPruneTokens;
     }
@@ -176,7 +191,9 @@ protected void doXContent(XContentBuilder builder, Params params) throws IOExcep
             }
             builder.endObject();
         } else {
-            builder.field(INFERENCE_ID_FIELD.getPreferredName(), inferenceId);
+            if (inferenceId != null) {
+                builder.field(INFERENCE_ID_FIELD.getPreferredName(), inferenceId);
+            }
             builder.field(QUERY_FIELD.getPreferredName(), query);
         }
         builder.field(PRUNE_FIELD.getPreferredName(), shouldPruneTokens);
@@ -228,6 +245,11 @@ protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext) {
                 shouldPruneTokens,
                 tokenPruningConfig
             );
+        } else if (inferenceId == null) {
+            // Edge case, where inference_id was not specified in the request,
+            // but we did not intercept this and rewrite to a query o field with
+            // pre-configured inference. So we trap here and output a nicer error message.
+            throw new IllegalArgumentException("inference_id required to perform vector search on query string");
         }
 
         // TODO move this to xpack core and use inference APIs
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java
index a5c1ba45d90b7..af557ed6b7f82 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java
@@ -260,16 +260,16 @@ public void testIllegalValues() {
         {
             IllegalArgumentException e = expectThrows(
                 IllegalArgumentException.class,
-                () -> new SparseVectorQueryBuilder("field name", null, "model id")
+                () -> new SparseVectorQueryBuilder("field name", null, null)
             );
-            assertEquals("[sparse_vector] requires one of [query_vector] or [inference_id]", e.getMessage());
+            assertEquals("[sparse_vector] requires one of [query_vector] or [inference_id] for sparse_vector fields", e.getMessage());
         }
         {
             IllegalArgumentException e = expectThrows(
                 IllegalArgumentException.class,
                 () -> new SparseVectorQueryBuilder("field name", "model text", null)
             );
-            assertEquals("[sparse_vector] requires [query] when [inference_id] is specified", e.getMessage());
+            assertEquals("[sparse_vector] requires one of [query_vector] or [inference_id] for sparse_vector fields", e.getMessage());
         }
     }
 
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java
index 3b7613b8b0e1f..876ff01812064 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java
@@ -10,13 +10,15 @@
 import org.elasticsearch.features.FeatureSpecification;
 import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.xpack.inference.mapper.SemanticTextFieldMapper;
-import org.elasticsearch.xpack.inference.queries.SemanticMatchQueryRewriteInterceptor;
 import org.elasticsearch.xpack.inference.queries.SemanticQueryBuilder;
 import org.elasticsearch.xpack.inference.rank.random.RandomRankRetrieverBuilder;
 import org.elasticsearch.xpack.inference.rank.textsimilarity.TextSimilarityRankRetrieverBuilder;
 
 import java.util.Set;
 
+import static org.elasticsearch.xpack.inference.queries.SemanticMatchQueryRewriteInterceptor.SEMANTIC_MATCH_QUERY_REWRITE_INTERCEPTION_SUPPORTED;
+import static org.elasticsearch.xpack.inference.queries.SemanticSparseVectorQueryRewriteInterceptor.SEMANTIC_SPARSE_VECTOR_QUERY_REWRITE_INTERCEPTION_SUPPORTED;
+
 /**
  * Provides inference features.
  */
@@ -45,7 +47,8 @@ public Set<NodeFeature> getTestFeatures() {
             SemanticTextFieldMapper.SEMANTIC_TEXT_ZERO_SIZE_FIX,
             SemanticTextFieldMapper.SEMANTIC_TEXT_ALWAYS_EMIT_INFERENCE_ID_FIX,
             SEMANTIC_TEXT_HIGHLIGHTER,
-            SemanticMatchQueryRewriteInterceptor.SEMANTIC_MATCH_QUERY_REWRITE_INTERCEPTION_SUPPORTED
+            SEMANTIC_MATCH_QUERY_REWRITE_INTERCEPTION_SUPPORTED,
+            SEMANTIC_SPARSE_VECTOR_QUERY_REWRITE_INTERCEPTION_SUPPORTED
         );
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
index 93743a5485c2c..169c8f87043e8 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
@@ -80,6 +80,7 @@
 import org.elasticsearch.xpack.inference.mapper.SemanticTextFieldMapper;
 import org.elasticsearch.xpack.inference.queries.SemanticMatchQueryRewriteInterceptor;
 import org.elasticsearch.xpack.inference.queries.SemanticQueryBuilder;
+import org.elasticsearch.xpack.inference.queries.SemanticSparseVectorQueryRewriteInterceptor;
 import org.elasticsearch.xpack.inference.rank.random.RandomRankBuilder;
 import org.elasticsearch.xpack.inference.rank.random.RandomRankRetrieverBuilder;
 import org.elasticsearch.xpack.inference.rank.textsimilarity.TextSimilarityRankBuilder;
@@ -440,7 +441,7 @@ public List<QuerySpec<?>> getQueries() {
 
     @Override
     public List<QueryRewriteInterceptor> getQueryRewriteInterceptors() {
-        return List.of(new SemanticMatchQueryRewriteInterceptor());
+        return List.of(new SemanticMatchQueryRewriteInterceptor(), new SemanticSparseVectorQueryRewriteInterceptor());
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticMatchQueryRewriteInterceptor.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticMatchQueryRewriteInterceptor.java
index a4a8123935c3e..fd1d65d00faf5 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticMatchQueryRewriteInterceptor.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticMatchQueryRewriteInterceptor.java
@@ -7,24 +7,12 @@
 
 package org.elasticsearch.xpack.inference.queries;
 
-import org.elasticsearch.action.ResolvedIndices;
-import org.elasticsearch.cluster.metadata.IndexMetadata;
-import org.elasticsearch.cluster.metadata.InferenceFieldMetadata;
 import org.elasticsearch.features.NodeFeature;
-import org.elasticsearch.index.mapper.IndexFieldMapper;
 import org.elasticsearch.index.query.BoolQueryBuilder;
 import org.elasticsearch.index.query.MatchQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.index.query.QueryRewriteContext;
-import org.elasticsearch.index.query.TermQueryBuilder;
-import org.elasticsearch.index.query.TermsQueryBuilder;
-import org.elasticsearch.plugins.internal.rewriter.QueryRewriteInterceptor;
 
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.List;
-
-public class SemanticMatchQueryRewriteInterceptor implements QueryRewriteInterceptor {
+public class SemanticMatchQueryRewriteInterceptor extends SemanticQueryRewriteInterceptor {
 
     public static final NodeFeature SEMANTIC_MATCH_QUERY_REWRITE_INTERCEPTION_SUPPORTED = new NodeFeature(
         "search.semantic_match_query_rewrite_interception_supported"
@@ -33,63 +21,45 @@ public class SemanticMatchQueryRewriteInterceptor implements QueryRewriteInterce
     public SemanticMatchQueryRewriteInterceptor() {}
 
     @Override
-    public QueryBuilder interceptAndRewrite(QueryRewriteContext context, QueryBuilder queryBuilder) {
+    protected String getFieldName(QueryBuilder queryBuilder) {
         assert (queryBuilder instanceof MatchQueryBuilder);
         MatchQueryBuilder matchQueryBuilder = (MatchQueryBuilder) queryBuilder;
-        QueryBuilder rewritten = queryBuilder;
-        ResolvedIndices resolvedIndices = context.getResolvedIndices();
-        if (resolvedIndices != null) {
-            Collection<IndexMetadata> indexMetadataCollection = resolvedIndices.getConcreteLocalIndicesMetadata().values();
-            List<String> inferenceIndices = new ArrayList<>();
-            List<String> nonInferenceIndices = new ArrayList<>();
-            for (IndexMetadata indexMetadata : indexMetadataCollection) {
-                String indexName = indexMetadata.getIndex().getName();
-                InferenceFieldMetadata inferenceFieldMetadata = indexMetadata.getInferenceFields().get(matchQueryBuilder.fieldName());
-                if (inferenceFieldMetadata != null) {
-                    inferenceIndices.add(indexName);
-                } else {
-                    nonInferenceIndices.add(indexName);
-                }
-            }
-
-            if (inferenceIndices.isEmpty()) {
-                return rewritten;
-            } else if (nonInferenceIndices.isEmpty() == false) {
-                BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
-                for (String inferenceIndexName : inferenceIndices) {
-                    // Add a separate clause for each semantic query, because they may be using different inference endpoints
-                    // TODO - consolidate this to a single clause once the semantic query supports multiple inference endpoints
-                    boolQueryBuilder.should(
-                        createSemanticSubQuery(inferenceIndexName, matchQueryBuilder.fieldName(), (String) matchQueryBuilder.value())
-                    );
-                }
-                boolQueryBuilder.should(createMatchSubQuery(nonInferenceIndices, matchQueryBuilder));
-                rewritten = boolQueryBuilder;
-            } else {
-                rewritten = new SemanticQueryBuilder(matchQueryBuilder.fieldName(), (String) matchQueryBuilder.value(), false);
-            }
-        }
-
-        return rewritten;
+        return matchQueryBuilder.fieldName();
+    }
 
+    @Override
+    protected String getQuery(QueryBuilder queryBuilder) {
+        assert (queryBuilder instanceof MatchQueryBuilder);
+        MatchQueryBuilder matchQueryBuilder = (MatchQueryBuilder) queryBuilder;
+        return (String) matchQueryBuilder.value();
     }
 
     @Override
-    public String getQueryName() {
-        return MatchQueryBuilder.NAME;
+    protected QueryBuilder buildInferenceQuery(QueryBuilder queryBuilder, InferenceIndexInformationForField indexInformation) {
+        return new SemanticQueryBuilder(indexInformation.fieldName(), getQuery(queryBuilder), false);
     }
 
-    private QueryBuilder createSemanticSubQuery(String indexName, String fieldName, String value) {
+    @Override
+    protected QueryBuilder buildCombinedInferenceAndNonInferenceQuery(
+        QueryBuilder queryBuilder,
+        InferenceIndexInformationForField indexInformation
+    ) {
+        assert (queryBuilder instanceof MatchQueryBuilder);
+        MatchQueryBuilder matchQueryBuilder = (MatchQueryBuilder) queryBuilder;
         BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
-        boolQueryBuilder.must(new SemanticQueryBuilder(fieldName, value, true));
-        boolQueryBuilder.filter(new TermQueryBuilder(IndexFieldMapper.NAME, indexName));
+        boolQueryBuilder.should(
+            createSemanticSubQuery(
+                indexInformation.getInferenceIndices(),
+                matchQueryBuilder.fieldName(),
+                (String) matchQueryBuilder.value()
+            )
+        );
+        boolQueryBuilder.should(createSubQueryForIndices(indexInformation.nonInferenceIndices(), matchQueryBuilder));
         return boolQueryBuilder;
     }
 
-    private QueryBuilder createMatchSubQuery(List<String> indices, MatchQueryBuilder matchQueryBuilder) {
-        BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
-        boolQueryBuilder.must(matchQueryBuilder);
-        boolQueryBuilder.filter(new TermsQueryBuilder(IndexFieldMapper.NAME, indices));
-        return boolQueryBuilder;
+    @Override
+    public String getQueryName() {
+        return MatchQueryBuilder.NAME;
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilder.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilder.java
index 2a34651efcd9d..dd0f6fe59ab23 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilder.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilder.java
@@ -148,6 +148,14 @@ public String getWriteableName() {
         return NAME;
     }
 
+    public String getFieldName() {
+        return fieldName;
+    }
+
+    public String getQuery() {
+        return query;
+    }
+
     @Override
     public TransportVersion getMinimalSupportedVersion() {
         return TransportVersions.V_8_15_0;
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryRewriteInterceptor.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryRewriteInterceptor.java
new file mode 100644
index 0000000000000..bb76ef0be24e9
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticQueryRewriteInterceptor.java
@@ -0,0 +1,148 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.queries;
+
+import org.elasticsearch.action.ResolvedIndices;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.InferenceFieldMetadata;
+import org.elasticsearch.index.mapper.IndexFieldMapper;
+import org.elasticsearch.index.query.BoolQueryBuilder;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.query.QueryRewriteContext;
+import org.elasticsearch.index.query.TermsQueryBuilder;
+import org.elasticsearch.plugins.internal.rewriter.QueryRewriteInterceptor;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/**
+ * Intercepts and adapts a query to be rewritten to work seamlessly on a semantic_text field.
+ */
+public abstract class SemanticQueryRewriteInterceptor implements QueryRewriteInterceptor {
+
+    public SemanticQueryRewriteInterceptor() {}
+
+    @Override
+    public QueryBuilder interceptAndRewrite(QueryRewriteContext context, QueryBuilder queryBuilder) {
+        String fieldName = getFieldName(queryBuilder);
+        ResolvedIndices resolvedIndices = context.getResolvedIndices();
+
+        if (resolvedIndices == null) {
+            // No resolved indices, so return the original query.
+            return queryBuilder;
+        }
+
+        InferenceIndexInformationForField indexInformation = resolveIndicesForField(fieldName, resolvedIndices);
+        if (indexInformation.getInferenceIndices().isEmpty()) {
+            // No inference fields were identified, so return the original query.
+            return queryBuilder;
+        } else if (indexInformation.nonInferenceIndices().isEmpty() == false) {
+            // Combined case where the field name requested by this query contains both
+            // semantic_text and non-inference fields, so we have to combine queries per index
+            // containing each field type.
+            return buildCombinedInferenceAndNonInferenceQuery(queryBuilder, indexInformation);
+        } else {
+            // The only fields we've identified are inference fields (e.g. semantic_text),
+            // so rewrite the entire query to work on a semantic_text field.
+            return buildInferenceQuery(queryBuilder, indexInformation);
+        }
+    }
+
+    /**
+     * @param queryBuilder {@link QueryBuilder}
+     * @return The singular field name requested by the provided query builder.
+     */
+    protected abstract String getFieldName(QueryBuilder queryBuilder);
+
+    /**
+     * @param queryBuilder {@link QueryBuilder}
+     * @return The text/query string requested by the provided query builder.
+     */
+    protected abstract String getQuery(QueryBuilder queryBuilder);
+
+    /**
+     * Builds the inference query
+     *
+     * @param queryBuilder {@link QueryBuilder}
+     * @param indexInformation {@link InferenceIndexInformationForField}
+     * @return {@link QueryBuilder}
+     */
+    protected abstract QueryBuilder buildInferenceQuery(QueryBuilder queryBuilder, InferenceIndexInformationForField indexInformation);
+
+    /**
+     * Builds a combined inference and non-inference query,
+     * which separates the different queries into appropriate indices based on field type.
+     * @param queryBuilder {@link QueryBuilder}
+     * @param indexInformation {@link InferenceIndexInformationForField}
+     * @return {@link QueryBuilder}
+     */
+    protected abstract QueryBuilder buildCombinedInferenceAndNonInferenceQuery(
+        QueryBuilder queryBuilder,
+        InferenceIndexInformationForField indexInformation
+    );
+
+    private InferenceIndexInformationForField resolveIndicesForField(String fieldName, ResolvedIndices resolvedIndices) {
+        Collection<IndexMetadata> indexMetadataCollection = resolvedIndices.getConcreteLocalIndicesMetadata().values();
+        Map<String, InferenceFieldMetadata> inferenceIndicesMetadata = new HashMap<>();
+        List<String> nonInferenceIndices = new ArrayList<>();
+        for (IndexMetadata indexMetadata : indexMetadataCollection) {
+            String indexName = indexMetadata.getIndex().getName();
+            InferenceFieldMetadata inferenceFieldMetadata = indexMetadata.getInferenceFields().get(fieldName);
+            if (inferenceFieldMetadata != null) {
+                inferenceIndicesMetadata.put(indexName, inferenceFieldMetadata);
+            } else {
+                nonInferenceIndices.add(indexName);
+            }
+        }
+
+        return new InferenceIndexInformationForField(fieldName, inferenceIndicesMetadata, nonInferenceIndices);
+    }
+
+    protected QueryBuilder createSubQueryForIndices(Collection<String> indices, QueryBuilder queryBuilder) {
+        BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
+        boolQueryBuilder.must(queryBuilder);
+        boolQueryBuilder.filter(new TermsQueryBuilder(IndexFieldMapper.NAME, indices));
+        return boolQueryBuilder;
+    }
+
+    protected QueryBuilder createSemanticSubQuery(Collection<String> indices, String fieldName, String value) {
+        BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
+        boolQueryBuilder.must(new SemanticQueryBuilder(fieldName, value, true));
+        boolQueryBuilder.filter(new TermsQueryBuilder(IndexFieldMapper.NAME, indices));
+        return boolQueryBuilder;
+    }
+
+    /**
+     * Represents the indices and associated inference information for a field.
+     */
+    public record InferenceIndexInformationForField(
+        String fieldName,
+        Map<String, InferenceFieldMetadata> inferenceIndicesMetadata,
+        List<String> nonInferenceIndices
+    ) {
+
+        public Collection<String> getInferenceIndices() {
+            return inferenceIndicesMetadata.keySet();
+        }
+
+        public Map<String, List<String>> getInferenceIdsIndices() {
+            return inferenceIndicesMetadata.entrySet()
+                .stream()
+                .collect(
+                    Collectors.groupingBy(
+                        entry -> entry.getValue().getSearchInferenceId(),
+                        Collectors.mapping(Map.Entry::getKey, Collectors.toList())
+                    )
+                );
+        }
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticSparseVectorQueryRewriteInterceptor.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticSparseVectorQueryRewriteInterceptor.java
new file mode 100644
index 0000000000000..a35e83450c55a
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/queries/SemanticSparseVectorQueryRewriteInterceptor.java
@@ -0,0 +1,124 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.queries;
+
+import org.apache.lucene.search.join.ScoreMode;
+import org.elasticsearch.features.NodeFeature;
+import org.elasticsearch.index.query.BoolQueryBuilder;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryBuilder;
+import org.elasticsearch.xpack.inference.mapper.SemanticTextField;
+
+import java.util.List;
+import java.util.Map;
+
+public class SemanticSparseVectorQueryRewriteInterceptor extends SemanticQueryRewriteInterceptor {
+
+    public static final NodeFeature SEMANTIC_SPARSE_VECTOR_QUERY_REWRITE_INTERCEPTION_SUPPORTED = new NodeFeature(
+        "search.semantic_sparse_vector_query_rewrite_interception_supported"
+    );
+
+    public SemanticSparseVectorQueryRewriteInterceptor() {}
+
+    @Override
+    protected String getFieldName(QueryBuilder queryBuilder) {
+        assert (queryBuilder instanceof SparseVectorQueryBuilder);
+        SparseVectorQueryBuilder sparseVectorQueryBuilder = (SparseVectorQueryBuilder) queryBuilder;
+        return sparseVectorQueryBuilder.getFieldName();
+    }
+
+    @Override
+    protected String getQuery(QueryBuilder queryBuilder) {
+        assert (queryBuilder instanceof SparseVectorQueryBuilder);
+        SparseVectorQueryBuilder sparseVectorQueryBuilder = (SparseVectorQueryBuilder) queryBuilder;
+        return sparseVectorQueryBuilder.getQuery();
+    }
+
+    @Override
+    protected QueryBuilder buildInferenceQuery(QueryBuilder queryBuilder, InferenceIndexInformationForField indexInformation) {
+        Map<String, List<String>> inferenceIdsIndices = indexInformation.getInferenceIdsIndices();
+        if (inferenceIdsIndices.size() == 1) {
+            // Simple case, everything uses the same inference ID
+            String searchInferenceId = inferenceIdsIndices.keySet().iterator().next();
+            return buildNestedQueryFromSparseVectorQuery(queryBuilder, searchInferenceId);
+        } else {
+            // Multiple inference IDs, construct a boolean query
+            return buildInferenceQueryWithMultipleInferenceIds(queryBuilder, inferenceIdsIndices);
+        }
+    }
+
+    private QueryBuilder buildInferenceQueryWithMultipleInferenceIds(
+        QueryBuilder queryBuilder,
+        Map<String, List<String>> inferenceIdsIndices
+    ) {
+        BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
+        for (String inferenceId : inferenceIdsIndices.keySet()) {
+            boolQueryBuilder.should(
+                createSubQueryForIndices(
+                    inferenceIdsIndices.get(inferenceId),
+                    buildNestedQueryFromSparseVectorQuery(queryBuilder, inferenceId)
+                )
+            );
+        }
+        return boolQueryBuilder;
+    }
+
+    @Override
+    protected QueryBuilder buildCombinedInferenceAndNonInferenceQuery(
+        QueryBuilder queryBuilder,
+        InferenceIndexInformationForField indexInformation
+    ) {
+        assert (queryBuilder instanceof SparseVectorQueryBuilder);
+        SparseVectorQueryBuilder sparseVectorQueryBuilder = (SparseVectorQueryBuilder) queryBuilder;
+        Map<String, List<String>> inferenceIdsIndices = indexInformation.getInferenceIdsIndices();
+
+        BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
+        boolQueryBuilder.should(
+            createSubQueryForIndices(
+                indexInformation.nonInferenceIndices(),
+                createSubQueryForIndices(indexInformation.nonInferenceIndices(), sparseVectorQueryBuilder)
+            )
+        );
+        // We always perform nested subqueries on semantic_text fields, to support
+        // sparse_vector queries using query vectors.
+        for (String inferenceId : inferenceIdsIndices.keySet()) {
+            boolQueryBuilder.should(
+                createSubQueryForIndices(
+                    inferenceIdsIndices.get(inferenceId),
+                    buildNestedQueryFromSparseVectorQuery(sparseVectorQueryBuilder, inferenceId)
+                )
+            );
+        }
+        return boolQueryBuilder;
+    }
+
+    private QueryBuilder buildNestedQueryFromSparseVectorQuery(QueryBuilder queryBuilder, String searchInferenceId) {
+        assert (queryBuilder instanceof SparseVectorQueryBuilder);
+        SparseVectorQueryBuilder sparseVectorQueryBuilder = (SparseVectorQueryBuilder) queryBuilder;
+        return QueryBuilders.nestedQuery(
+            SemanticTextField.getChunksFieldName(sparseVectorQueryBuilder.getFieldName()),
+            new SparseVectorQueryBuilder(
+                SemanticTextField.getEmbeddingsFieldName(sparseVectorQueryBuilder.getFieldName()),
+                sparseVectorQueryBuilder.getQueryVectors(),
+                (sparseVectorQueryBuilder.getInferenceId() == null && sparseVectorQueryBuilder.getQuery() != null)
+                    ? searchInferenceId
+                    : sparseVectorQueryBuilder.getInferenceId(),
+                sparseVectorQueryBuilder.getQuery(),
+                sparseVectorQueryBuilder.shouldPruneTokens(),
+                sparseVectorQueryBuilder.getTokenPruningConfig()
+            ),
+            ScoreMode.Max
+        );
+    }
+
+    @Override
+    public String getQueryName() {
+        return SparseVectorQueryBuilder.NAME;
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticMatchQueryRewriteInterceptorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticMatchQueryRewriteInterceptorTests.java
new file mode 100644
index 0000000000000..47705c14d5941
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticMatchQueryRewriteInterceptorTests.java
@@ -0,0 +1,110 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.action.MockResolvedIndices;
+import org.elasticsearch.action.OriginalIndices;
+import org.elasticsearch.action.ResolvedIndices;
+import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.InferenceFieldMetadata;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.plugins.internal.rewriter.QueryRewriteInterceptor;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.client.NoOpClient;
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.xpack.inference.queries.SemanticMatchQueryRewriteInterceptor;
+import org.elasticsearch.xpack.inference.queries.SemanticQueryBuilder;
+import org.junit.After;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.util.Map;
+
+public class SemanticMatchQueryRewriteInterceptorTests extends ESTestCase {
+
+    private TestThreadPool threadPool;
+    private NoOpClient client;
+    private Index index;
+
+    private static final String FIELD_NAME = "fieldName";
+    private static final String VALUE = "value";
+
+    @Before
+    public void setup() {
+        threadPool = createThreadPool();
+        client = new NoOpClient(threadPool);
+        index = new Index(randomAlphaOfLength(10), randomAlphaOfLength(10));
+    }
+
+    @After
+    public void cleanup() {
+        threadPool.close();
+    }
+
+    public void testMatchQueryOnInferenceFieldIsInterceptedAndRewrittenToSemanticQuery() throws IOException {
+        Map<String, InferenceFieldMetadata> inferenceFields = Map.of(
+            FIELD_NAME,
+            new InferenceFieldMetadata(index.getName(), "inferenceId", new String[] { FIELD_NAME })
+        );
+        QueryRewriteContext context = createQueryRewriteContext(inferenceFields);
+        QueryBuilder original = createTestQueryBuilder();
+        QueryBuilder rewritten = original.rewrite(context);
+        assertTrue(
+            "Expected query to be intercepted, but was [" + rewritten.getClass().getName() + "]",
+            rewritten instanceof InterceptedQueryBuilderWrapper
+        );
+        InterceptedQueryBuilderWrapper intercepted = (InterceptedQueryBuilderWrapper) rewritten;
+        assertTrue(intercepted.queryBuilder instanceof SemanticQueryBuilder);
+        SemanticQueryBuilder semanticQueryBuilder = (SemanticQueryBuilder) intercepted.queryBuilder;
+        assertEquals(FIELD_NAME, semanticQueryBuilder.getFieldName());
+        assertEquals(VALUE, semanticQueryBuilder.getQuery());
+    }
+
+    public void testMatchQueryOnNonInferenceFieldRemainsMatchQuery() throws IOException {
+        QueryRewriteContext context = createQueryRewriteContext(Map.of()); // No inference fields
+        QueryBuilder original = createTestQueryBuilder();
+        QueryBuilder rewritten = original.rewrite(context);
+        assertTrue(
+            "Expected query to remain match but was [" + rewritten.getClass().getName() + "]",
+            rewritten instanceof MatchQueryBuilder
+        );
+        assertEquals(original, rewritten);
+    }
+
+    private MatchQueryBuilder createTestQueryBuilder() {
+        return new MatchQueryBuilder(FIELD_NAME, VALUE);
+    }
+
+    private QueryRewriteContext createQueryRewriteContext(Map<String, InferenceFieldMetadata> inferenceFields) {
+        IndexMetadata indexMetadata = IndexMetadata.builder(index.getName())
+            .settings(
+                Settings.builder()
+                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersion.current())
+                    .put(IndexMetadata.SETTING_INDEX_UUID, index.getUUID())
+            )
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .putInferenceFields(inferenceFields)
+            .build();
+
+        ResolvedIndices resolvedIndices = new MockResolvedIndices(
+            Map.of(),
+            new OriginalIndices(new String[] { index.getName() }, IndicesOptions.DEFAULT),
+            Map.of(index, indexMetadata)
+        );
+
+        return new QueryRewriteContext(null, client, null, resolvedIndices, null, createRewriteInterceptor());
+    }
+
+    private QueryRewriteInterceptor createRewriteInterceptor() {
+        return new SemanticMatchQueryRewriteInterceptor();
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticSparseVectorQueryRewriteInterceptorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticSparseVectorQueryRewriteInterceptorTests.java
new file mode 100644
index 0000000000000..1adad1df7b29b
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/index/query/SemanticSparseVectorQueryRewriteInterceptorTests.java
@@ -0,0 +1,137 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.index.query;
+
+import org.elasticsearch.action.MockResolvedIndices;
+import org.elasticsearch.action.OriginalIndices;
+import org.elasticsearch.action.ResolvedIndices;
+import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.InferenceFieldMetadata;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.plugins.internal.rewriter.QueryRewriteInterceptor;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.client.NoOpClient;
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryBuilder;
+import org.elasticsearch.xpack.inference.mapper.SemanticTextField;
+import org.elasticsearch.xpack.inference.queries.SemanticSparseVectorQueryRewriteInterceptor;
+import org.junit.After;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.util.Map;
+
+public class SemanticSparseVectorQueryRewriteInterceptorTests extends ESTestCase {
+
+    private TestThreadPool threadPool;
+    private NoOpClient client;
+    private Index index;
+
+    private static final String FIELD_NAME = "fieldName";
+    private static final String INFERENCE_ID = "inferenceId";
+    private static final String QUERY = "query";
+
+    @Before
+    public void setup() {
+        threadPool = createThreadPool();
+        client = new NoOpClient(threadPool);
+        index = new Index(randomAlphaOfLength(10), randomAlphaOfLength(10));
+    }
+
+    @After
+    public void cleanup() {
+        threadPool.close();
+    }
+
+    public void testSparseVectorQueryOnInferenceFieldIsInterceptedAndRewritten() throws IOException {
+        Map<String, InferenceFieldMetadata> inferenceFields = Map.of(
+            FIELD_NAME,
+            new InferenceFieldMetadata(index.getName(), "inferenceId", new String[] { FIELD_NAME })
+        );
+        QueryRewriteContext context = createQueryRewriteContext(inferenceFields);
+        QueryBuilder original = new SparseVectorQueryBuilder(FIELD_NAME, INFERENCE_ID, QUERY);
+        QueryBuilder rewritten = original.rewrite(context);
+        assertTrue(
+            "Expected query to be intercepted, but was [" + rewritten.getClass().getName() + "]",
+            rewritten instanceof InterceptedQueryBuilderWrapper
+        );
+        InterceptedQueryBuilderWrapper intercepted = (InterceptedQueryBuilderWrapper) rewritten;
+        assertTrue(intercepted.queryBuilder instanceof NestedQueryBuilder);
+        NestedQueryBuilder nestedQueryBuilder = (NestedQueryBuilder) intercepted.queryBuilder;
+        assertEquals(SemanticTextField.getChunksFieldName(FIELD_NAME), nestedQueryBuilder.path());
+        QueryBuilder innerQuery = nestedQueryBuilder.query();
+        assertTrue(innerQuery instanceof SparseVectorQueryBuilder);
+        SparseVectorQueryBuilder sparseVectorQueryBuilder = (SparseVectorQueryBuilder) innerQuery;
+        assertEquals(SemanticTextField.getEmbeddingsFieldName(FIELD_NAME), sparseVectorQueryBuilder.getFieldName());
+        assertEquals(INFERENCE_ID, sparseVectorQueryBuilder.getInferenceId());
+        assertEquals(QUERY, sparseVectorQueryBuilder.getQuery());
+    }
+
+    public void testSparseVectorQueryOnInferenceFieldWithoutInferenceIdIsInterceptedAndRewritten() throws IOException {
+        Map<String, InferenceFieldMetadata> inferenceFields = Map.of(
+            FIELD_NAME,
+            new InferenceFieldMetadata(index.getName(), "inferenceId", new String[] { FIELD_NAME })
+        );
+        QueryRewriteContext context = createQueryRewriteContext(inferenceFields);
+        QueryBuilder original = new SparseVectorQueryBuilder(FIELD_NAME, null, QUERY);
+        QueryBuilder rewritten = original.rewrite(context);
+        assertTrue(
+            "Expected query to be intercepted, but was [" + rewritten.getClass().getName() + "]",
+            rewritten instanceof InterceptedQueryBuilderWrapper
+        );
+        InterceptedQueryBuilderWrapper intercepted = (InterceptedQueryBuilderWrapper) rewritten;
+        assertTrue(intercepted.queryBuilder instanceof NestedQueryBuilder);
+        NestedQueryBuilder nestedQueryBuilder = (NestedQueryBuilder) intercepted.queryBuilder;
+        assertEquals(SemanticTextField.getChunksFieldName(FIELD_NAME), nestedQueryBuilder.path());
+        QueryBuilder innerQuery = nestedQueryBuilder.query();
+        assertTrue(innerQuery instanceof SparseVectorQueryBuilder);
+        SparseVectorQueryBuilder sparseVectorQueryBuilder = (SparseVectorQueryBuilder) innerQuery;
+        assertEquals(SemanticTextField.getEmbeddingsFieldName(FIELD_NAME), sparseVectorQueryBuilder.getFieldName());
+        assertEquals(INFERENCE_ID, sparseVectorQueryBuilder.getInferenceId());
+        assertEquals(QUERY, sparseVectorQueryBuilder.getQuery());
+    }
+
+    public void testSparseVectorQueryOnNonInferenceFieldRemainsUnchanged() throws IOException {
+        QueryRewriteContext context = createQueryRewriteContext(Map.of()); // No inference fields
+        QueryBuilder original = new SparseVectorQueryBuilder(FIELD_NAME, INFERENCE_ID, QUERY);
+        QueryBuilder rewritten = original.rewrite(context);
+        assertTrue(
+            "Expected query to remain sparse_vector but was [" + rewritten.getClass().getName() + "]",
+            rewritten instanceof SparseVectorQueryBuilder
+        );
+        assertEquals(original, rewritten);
+    }
+
+    private QueryRewriteContext createQueryRewriteContext(Map<String, InferenceFieldMetadata> inferenceFields) {
+        IndexMetadata indexMetadata = IndexMetadata.builder(index.getName())
+            .settings(
+                Settings.builder()
+                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersion.current())
+                    .put(IndexMetadata.SETTING_INDEX_UUID, index.getUUID())
+            )
+            .numberOfShards(1)
+            .numberOfReplicas(0)
+            .putInferenceFields(inferenceFields)
+            .build();
+
+        ResolvedIndices resolvedIndices = new MockResolvedIndices(
+            Map.of(),
+            new OriginalIndices(new String[] { index.getName() }, IndicesOptions.DEFAULT),
+            Map.of(index, indexMetadata)
+        );
+
+        return new QueryRewriteContext(null, client, null, resolvedIndices, null, createRewriteInterceptor());
+    }
+
+    private QueryRewriteInterceptor createRewriteInterceptor() {
+        return new SemanticSparseVectorQueryRewriteInterceptor();
+    }
+}
diff --git a/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/46_semantic_text_sparse_vector.yml b/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/46_semantic_text_sparse_vector.yml
new file mode 100644
index 0000000000000..f1cff512fd209
--- /dev/null
+++ b/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/46_semantic_text_sparse_vector.yml
@@ -0,0 +1,249 @@
+setup:
+  - requires:
+      cluster_features: "search.semantic_sparse_vector_query_rewrite_interception_supported"
+      reason: semantic_text sparse_vector support introduced in 8.18.0
+
+  - do:
+      inference.put:
+        task_type: sparse_embedding
+        inference_id: sparse-inference-id
+        body: >
+          {
+            "service": "test_service",
+            "service_settings": {
+              "model": "my_model",
+              "api_key": "abc64"
+            },
+            "task_settings": {
+            }
+          }
+
+  - do:
+      inference.put:
+        task_type: sparse_embedding
+        inference_id: sparse-inference-id-2
+        body: >
+          {
+            "service": "test_service",
+            "service_settings": {
+              "model": "my_model",
+              "api_key": "abc64"
+            },
+            "task_settings": {
+            }
+          }
+
+  - do:
+      indices.create:
+        index: test-semantic-text-index
+        body:
+          mappings:
+            properties:
+              inference_field:
+                type: semantic_text
+                inference_id: sparse-inference-id
+
+  - do:
+      indices.create:
+        index: test-semantic-text-index-2
+        body:
+          mappings:
+            properties:
+              inference_field:
+                type: semantic_text
+                inference_id: sparse-inference-id-2
+
+  - do:
+      indices.create:
+        index: test-sparse-vector-index
+        body:
+          mappings:
+            properties:
+              inference_field:
+                type: sparse_vector
+
+  - do:
+      index:
+        index: test-semantic-text-index
+        id: doc_1
+        body:
+          inference_field: [ "inference test", "another inference test" ]
+        refresh: true
+
+  - do:
+      index:
+        index: test-semantic-text-index-2
+        id: doc_3
+        body:
+          inference_field: [ "inference test", "another inference test" ]
+        refresh: true
+
+  - do:
+      index:
+        index: test-sparse-vector-index
+        id: doc_2
+        body:
+          inference_field: { "feature_0": 1, "feature_1": 2, "feature_2": 3, "feature_3": 4, "feature_4": 5 }
+        refresh: true
+
+---
+"Nested sparse_vector queries using the old format on semantic_text embeddings and inference still work":
+  - skip:
+      features: [ "headers" ]
+
+  - do:
+      headers:
+        # Force JSON content type so that we use a parser that interprets the floating-point score as a double
+        Content-Type: application/json
+      search:
+        index: test-semantic-text-index
+        body:
+          query:
+            nested:
+              path: inference_field.inference.chunks
+              query:
+                sparse_vector:
+                  field: inference_field.inference.chunks.embeddings
+                  inference_id: sparse-inference-id
+                  query: test
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.hits.0._id: "doc_1" }
+
+---
+"Nested sparse_vector queries using the old format on semantic_text embeddings and query vectors still work":
+  - skip:
+      features: [ "headers" ]
+
+  - do:
+      headers:
+        # Force JSON content type so that we use a parser that interprets the floating-point score as a double
+        Content-Type: application/json
+      search:
+        index: test-semantic-text-index
+        body:
+          query:
+            nested:
+              path: inference_field.inference.chunks
+              query:
+                sparse_vector:
+                  field: inference_field.inference.chunks.embeddings
+                  query_vector: { "feature_0": 1, "feature_1": 2, "feature_2": 3, "feature_3": 4, "feature_4": 5 }
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.hits.0._id: "doc_1" }
+
+---
+"sparse_vector query against semantic_text field using a specified inference ID":
+
+  - do:
+      search:
+        index: test-semantic-text-index
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              inference_id: sparse-inference-id
+              query: "inference test"
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.hits.0._id: "doc_1" }
+
+---
+"sparse_vector query against semantic_text field using inference ID configured in semantic_text field":
+
+  - do:
+      search:
+        index: test-semantic-text-index
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              query: "inference test"
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.hits.0._id: "doc_1" }
+
+---
+"sparse_vector query against semantic_text field using query vectors":
+
+  - do:
+      search:
+        index: test-semantic-text-index
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              query_vector: { "feature_0": 1, "feature_1": 2, "feature_2": 3, "feature_3": 4, "feature_4": 5 }
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.hits.0._id: "doc_1" }
+
+---
+"sparse_vector query against combined sparse_vector and semantic_text fields using inference":
+
+  - do:
+      search:
+        index:
+          - test-semantic-text-index
+          - test-sparse-vector-index
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              inference_id: sparse-inference-id
+              query: "inference test"
+
+  - match: { hits.total.value: 2 }
+
+---
+"sparse_vector query against combined sparse_vector and semantic_text fields still requires inference ID":
+
+  - do:
+      catch: bad_request
+      search:
+        index:
+          - test-semantic-text-index
+          - test-sparse-vector-index
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              query: "inference test"
+
+  - match: { error.type: "illegal_argument_exception" }
+  - match: { error.reason: "inference_id required to perform vector search on query string" }
+
+---
+"sparse_vector query against combined sparse_vector and semantic_text fields using query vectors":
+
+  - do:
+      search:
+        index:
+          - test-semantic-text-index
+          - test-sparse-vector-index
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              query_vector: { "feature_0": 1, "feature_1": 2, "feature_2": 3, "feature_3": 4, "feature_4": 5 }
+
+  - match: { hits.total.value: 2 }
+
+
+---
+"sparse_vector query against multiple semantic_text fields with multiple inference IDs specified in semantic_text fields":
+
+  - do:
+      search:
+        index:
+          - test-semantic-text-index
+          - test-semantic-text-index-2
+        body:
+          query:
+            sparse_vector:
+              field: inference_field
+              query: "inference test"
+
+  - match: { hits.total.value: 2 }
+
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/ml/sparse_vector_search.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/ml/sparse_vector_search.yml
index 332981a580802..3481773b0bab3 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/ml/sparse_vector_search.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/ml/sparse_vector_search.yml
@@ -268,7 +268,7 @@ setup:
   - match: { hits.hits.0._score: 0.25 }
 
 ---
-"Test sparse_vector requires one of inference_id or query_vector":
+"Test sparse_vector requires one of query or query_vector":
   - do:
       catch: /\[sparse_vector\] requires one of \[query_vector\] or \[inference_id\]/
       search:
@@ -281,7 +281,41 @@ setup:
   - match: { status: 400 }
 
 ---
-"Test sparse_vector only allows one of inference_id or query_vector":
+"Test sparse_vector returns an error if inference ID not specified with query":
+  - do:
+      catch: bad_request # This is for BWC, the actual error message is tested in a subsequent test
+      search:
+        index: index-with-sparse-vector
+        body:
+          query:
+            sparse_vector:
+              field: text
+              query: "octopus comforter smells"
+
+  - match: { status: 400 }
+
+---
+"Test sparse_vector requires an inference ID to be specified on sparse_vector fields":
+  - requires:
+      cluster_features: [ "search.semantic_sparse_vector_query_rewrite_interception_supported" ]
+      reason: "Error message changed in 8.18"
+  - do:
+      catch: /inference_id required to perform vector search on query string/
+      search:
+        index: index-with-sparse-vector
+        body:
+          query:
+            sparse_vector:
+              field: text
+              query: "octopus comforter smells"
+
+  - match: { status: 400 }
+
+---
+"Test sparse_vector only allows one of query or query_vector (note the error message is misleading)":
+  - requires:
+      cluster_features: [ "search.semantic_sparse_vector_query_rewrite_interception_supported" ]
+      reason: "sparse vector inference checks updated in 8.18 to support sparse_vector on semantic_text fields"
   - do:
       catch: /\[sparse_vector\] requires one of \[query_vector\] or \[inference_id\]/
       search:
@@ -290,7 +324,7 @@ setup:
           query:
             sparse_vector:
               field: text
-              inference_id: text_expansion_model
+              query: "octopus comforter smells"
               query_vector:
                 the: 1.0
                 comforter: 1.0

From a6dcaee4199353d8cbd4a2fd67df9d833684b8ab Mon Sep 17 00:00:00 2001
From: Nick Tindall <nick.tindall@elastic.co>
Date: Wed, 18 Dec 2024 11:58:16 +1100
Subject: [PATCH 053/119] Add test for GCS fixture (#118737)

Relates: ES-5679
---
 .../org/elasticsearch/rest/RestUtils.java     |   8 +
 test/fixtures/gcs-fixture/build.gradle        |   1 -
 .../gcs/GoogleCloudStorageHttpHandler.java    |   8 +-
 .../GoogleCloudStorageHttpHandlerTests.java   | 509 ++++++++++++++++++
 4 files changed, 520 insertions(+), 6 deletions(-)
 create mode 100644 test/fixtures/gcs-fixture/src/test/java/fixture/gcs/GoogleCloudStorageHttpHandlerTests.java

diff --git a/server/src/main/java/org/elasticsearch/rest/RestUtils.java b/server/src/main/java/org/elasticsearch/rest/RestUtils.java
index df51b57f0859c..bbca086e345f7 100644
--- a/server/src/main/java/org/elasticsearch/rest/RestUtils.java
+++ b/server/src/main/java/org/elasticsearch/rest/RestUtils.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.core.Nullable;
 import org.elasticsearch.core.TimeValue;
 
+import java.net.URI;
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
 import java.util.Arrays;
@@ -35,6 +36,13 @@ public class RestUtils {
 
     public static final UnaryOperator<String> REST_DECODER = RestUtils::decodeComponent;
 
+    public static void decodeQueryString(URI uri, Map<String, String> params) {
+        final var rawQuery = uri.getRawQuery();
+        if (Strings.hasLength(rawQuery)) {
+            decodeQueryString(rawQuery, 0, params);
+        }
+    }
+
     public static void decodeQueryString(String s, int fromIndex, Map<String, String> params) {
         if (fromIndex < 0) {
             return;
diff --git a/test/fixtures/gcs-fixture/build.gradle b/test/fixtures/gcs-fixture/build.gradle
index e8f1a2e15a4e0..6cf2e1ee52c2c 100644
--- a/test/fixtures/gcs-fixture/build.gradle
+++ b/test/fixtures/gcs-fixture/build.gradle
@@ -9,7 +9,6 @@
 apply plugin: 'elasticsearch.java'
 
 description = 'Fixture for Google Cloud Storage service'
-tasks.named("test").configure { enabled = false }
 
 dependencies {
   api project(':server')
diff --git a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
index f6b52a32a9a1d..163712fb05a50 100644
--- a/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
+++ b/test/fixtures/gcs-fixture/src/main/java/fixture/gcs/GoogleCloudStorageHttpHandler.java
@@ -95,7 +95,7 @@ public void handle(final HttpExchange exchange) throws IOException {
             } else if (Regex.simpleMatch("GET /storage/v1/b/" + bucket + "/o*", request)) {
                 // List Objects https://cloud.google.com/storage/docs/json_api/v1/objects/list
                 final Map<String, String> params = new HashMap<>();
-                RestUtils.decodeQueryString(exchange.getRequestURI().getQuery(), 0, params);
+                RestUtils.decodeQueryString(exchange.getRequestURI(), params);
                 final String prefix = params.getOrDefault("prefix", "");
                 final String delimiter = params.get("delimiter");
 
@@ -212,7 +212,7 @@ public void handle(final HttpExchange exchange) throws IOException {
             } else if (Regex.simpleMatch("POST /upload/storage/v1/b/" + bucket + "/*uploadType=resumable*", request)) {
                 // Resumable upload initialization https://cloud.google.com/storage/docs/json_api/v1/how-tos/resumable-upload
                 final Map<String, String> params = new HashMap<>();
-                RestUtils.decodeQueryString(exchange.getRequestURI().getQuery(), 0, params);
+                RestUtils.decodeQueryString(exchange.getRequestURI(), params);
                 final String blobName = params.get("name");
                 blobs.put(blobName, BytesArray.EMPTY);
 
@@ -237,7 +237,7 @@ public void handle(final HttpExchange exchange) throws IOException {
             } else if (Regex.simpleMatch("PUT /upload/storage/v1/b/" + bucket + "/o?*uploadType=resumable*", request)) {
                 // Resumable upload https://cloud.google.com/storage/docs/json_api/v1/how-tos/resumable-upload
                 final Map<String, String> params = new HashMap<>();
-                RestUtils.decodeQueryString(exchange.getRequestURI().getQuery(), 0, params);
+                RestUtils.decodeQueryString(exchange.getRequestURI(), params);
 
                 final String blobName = params.get("test_blob_name");
                 if (blobs.containsKey(blobName) == false) {
@@ -269,8 +269,6 @@ public void handle(final HttpExchange exchange) throws IOException {
                 exchange.sendResponseHeaders(RestStatus.NOT_FOUND.getStatus(), -1);
             }
         } finally {
-            int read = exchange.getRequestBody().read();
-            assert read == -1 : "Request body should have been fully read here but saw [" + read + "]";
             exchange.close();
         }
     }
diff --git a/test/fixtures/gcs-fixture/src/test/java/fixture/gcs/GoogleCloudStorageHttpHandlerTests.java b/test/fixtures/gcs-fixture/src/test/java/fixture/gcs/GoogleCloudStorageHttpHandlerTests.java
new file mode 100644
index 0000000000000..0caaa983f76df
--- /dev/null
+++ b/test/fixtures/gcs-fixture/src/test/java/fixture/gcs/GoogleCloudStorageHttpHandlerTests.java
@@ -0,0 +1,509 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package fixture.gcs;
+
+import com.sun.net.httpserver.Headers;
+import com.sun.net.httpserver.HttpContext;
+import com.sun.net.httpserver.HttpExchange;
+import com.sun.net.httpserver.HttpPrincipal;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.bytes.CompositeBytesReference;
+import org.elasticsearch.common.io.stream.BytesStreamOutput;
+import org.elasticsearch.core.Nullable;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.test.ESTestCase;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.net.InetSocketAddress;
+import java.net.URI;
+import java.nio.charset.StandardCharsets;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Objects;
+import java.util.concurrent.atomic.AtomicInteger;
+import java.util.zip.GZIPOutputStream;
+
+public class GoogleCloudStorageHttpHandlerTests extends ESTestCase {
+
+    private static final String HOST = "http://127.0.0.1:12345";
+    private static final int RESUME_INCOMPLETE = 308;
+
+    public void testRejectsBadUri() {
+        assertEquals(
+            RestStatus.NOT_FOUND.getStatus(),
+            handleRequest(new GoogleCloudStorageHttpHandler("bucket"), randomFrom("GET", "PUT", "POST", "DELETE", "HEAD"), "/not-in-bucket")
+                .status()
+        );
+    }
+
+    public void testCheckEndpoint() {
+        final var handler = new GoogleCloudStorageHttpHandler("bucket");
+
+        assertEquals(
+            RestStatus.OK,
+            handleRequest(handler, "GET", "/", BytesArray.EMPTY, Headers.of("Metadata-Flavor", "Google")).restStatus()
+        );
+    }
+
+    public void testSimpleObjectOperations() {
+        final var bucket = randomAlphaOfLength(10);
+        final var handler = new GoogleCloudStorageHttpHandler(bucket);
+
+        assertEquals(RestStatus.NOT_FOUND, handleRequest(handler, "GET", "/download/storage/v1/b/" + bucket + "/o/blob").restStatus());
+
+        assertEquals(
+            new TestHttpResponse(RestStatus.OK, "{\"kind\":\"storage#objects\",\"items\":[],\"prefixes\":[]}"),
+            handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o")
+        );
+
+        // Multipart upload
+        final var body = randomAlphaOfLength(50);
+        assertEquals(
+            RestStatus.OK,
+            handleRequest(
+                handler,
+                "POST",
+                "/upload/storage/v1/b/" + bucket + "/?uploadType=multipart",
+                createGzipCompressedMultipartUploadBody(bucket, "path/blob", body)
+            ).restStatus()
+        );
+        assertEquals(
+            new TestHttpResponse(RestStatus.OK, body),
+            handleRequest(handler, "GET", "/download/storage/v1/b/" + bucket + "/o/path/blob")
+        );
+
+        assertEquals(new TestHttpResponse(RestStatus.OK, Strings.format("""
+            {"kind":"storage#objects","items":[{"kind":"storage#object","bucket":"%s","name":"path/blob","id":"path/blob","size":"50"}
+            ],"prefixes":[]}""", bucket)), handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o"));
+
+        assertEquals(new TestHttpResponse(RestStatus.OK, Strings.format("""
+            {"kind":"storage#objects","items":[{"kind":"storage#object","bucket":"%s","name":"path/blob","id":"path/blob","size":"50"}
+            ],"prefixes":[]}""", bucket)), handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o?prefix=path/"));
+
+        assertEquals(
+            new TestHttpResponse(RestStatus.OK, """
+                {"kind":"storage#objects","items":[],"prefixes":[]}"""),
+            handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o?prefix=path/other")
+        );
+
+        assertEquals(
+            new TestHttpResponse(RestStatus.OK, """
+                --__END_OF_PART__d8b50acb-87dc-4630-a3d3-17d187132ebc__
+                Content-Length: 162
+                Content-Type: application/http
+                content-id: 1
+                content-transfer-encoding: binary
+
+                HTTP/1.1 204 NO_CONTENT
+
+
+
+
+                --__END_OF_PART__d8b50acb-87dc-4630-a3d3-17d187132ebc__
+                """.replaceAll("\n", "\r\n")),
+            handleRequest(
+                handler,
+                "POST",
+                "/batch/storage/v1",
+                createBatchDeleteRequest(bucket, "path/blob"),
+                Headers.of("Content-Type", "mixed/multipart")
+            )
+        );
+        assertEquals(
+            RestStatus.OK,
+            handleRequest(
+                handler,
+                "POST",
+                "/batch/storage/v1",
+                createBatchDeleteRequest(bucket, "path/blob"),
+                Headers.of("Content-Type", "mixed/multipart")
+            ).restStatus()
+        );
+
+        assertEquals(
+            new TestHttpResponse(RestStatus.OK, """
+                {"kind":"storage#objects","items":[],"prefixes":[]}"""),
+            handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o?prefix=path/")
+        );
+    }
+
+    public void testGetWithBytesRange() {
+        final var bucket = randomIdentifier();
+        final var handler = new GoogleCloudStorageHttpHandler(bucket);
+        final var blobName = "blob_name_" + randomIdentifier();
+        final var blobPath = "/download/storage/v1/b/" + bucket + "/o/" + blobName;
+        final var blobBytes = randomBytesReference(256);
+
+        assertEquals(
+            RestStatus.OK,
+            handleRequest(
+                handler,
+                "POST",
+                "/upload/storage/v1/b/" + bucket + "/?uploadType=multipart",
+                createGzipCompressedMultipartUploadBody(bucket, blobName, blobBytes)
+            ).restStatus()
+        );
+
+        assertEquals(
+            "No Range",
+            new TestHttpResponse(RestStatus.OK, blobBytes, TestHttpExchange.EMPTY_HEADERS),
+            handleRequest(handler, "GET", blobPath)
+        );
+
+        var end = blobBytes.length() - 1;
+        assertEquals(
+            "Exact Range: bytes=0-" + end,
+            new TestHttpResponse(RestStatus.OK, blobBytes, TestHttpExchange.EMPTY_HEADERS),
+            handleRequest(handler, "GET", blobPath, BytesArray.EMPTY, rangeHeader(0, end))
+        );
+
+        end = randomIntBetween(blobBytes.length() - 1, Integer.MAX_VALUE);
+        assertEquals(
+            "Larger Range: bytes=0-" + end,
+            new TestHttpResponse(RestStatus.OK, blobBytes, TestHttpExchange.EMPTY_HEADERS),
+            handleRequest(handler, "GET", blobPath, BytesArray.EMPTY, rangeHeader(0, end))
+        );
+
+        var start = randomIntBetween(blobBytes.length(), Integer.MAX_VALUE - 1);
+        end = randomIntBetween(start, Integer.MAX_VALUE);
+        assertEquals(
+            "Invalid Range: bytes=" + start + '-' + end,
+            new TestHttpResponse(RestStatus.REQUESTED_RANGE_NOT_SATISFIED, BytesArray.EMPTY, TestHttpExchange.EMPTY_HEADERS),
+            handleRequest(handler, "GET", blobPath, BytesArray.EMPTY, rangeHeader(start, end))
+        );
+
+        start = randomIntBetween(0, blobBytes.length() - 1);
+        var length = randomIntBetween(1, blobBytes.length() - start);
+        end = start + length - 1;
+        assertEquals(
+            "Range: bytes=" + start + '-' + end,
+            new TestHttpResponse(RestStatus.OK, blobBytes.slice(start, length), TestHttpExchange.EMPTY_HEADERS),
+            handleRequest(handler, "GET", blobPath, BytesArray.EMPTY, rangeHeader(start, end))
+        );
+    }
+
+    public void testResumableUpload() {
+        final var bucket = randomIdentifier();
+        final var handler = new GoogleCloudStorageHttpHandler(bucket);
+        final var blobName = "blob_name_" + randomIdentifier();
+
+        final var createUploadResponse = handleRequest(
+            handler,
+            "POST",
+            "/upload/storage/v1/b/" + bucket + "/?uploadType=resumable&name=" + blobName
+        );
+        final var locationHeader = createUploadResponse.headers.getFirst("Location");
+        final var sessionURI = locationHeader.substring(locationHeader.indexOf(HOST) + HOST.length());
+        assertEquals(RestStatus.OK, createUploadResponse.restStatus());
+
+        final var part1 = randomAlphaOfLength(50);
+        final var uploadPart1Response = handleRequest(handler, "PUT", sessionURI, part1, contentRangeHeader(0, 50, null));
+        assertEquals(new TestHttpResponse(RESUME_INCOMPLETE, rangeHeader(0, 50)), uploadPart1Response);
+
+        assertEquals(
+            new TestHttpResponse(RESUME_INCOMPLETE, TestHttpExchange.EMPTY_HEADERS),
+            handleRequest(handler, "PUT", sessionURI, BytesArray.EMPTY, contentRangeHeader(null, null, null))
+        );
+
+        final var part2 = randomAlphaOfLength(50);
+        final var uploadPart2Response = handleRequest(handler, "PUT", sessionURI, part2, contentRangeHeader(51, 100, null));
+        assertEquals(new TestHttpResponse(RESUME_INCOMPLETE, rangeHeader(51, 100)), uploadPart2Response);
+
+        final var part3 = randomAlphaOfLength(30);
+        final var uploadPart3Response = handleRequest(handler, "PUT", sessionURI, part3, contentRangeHeader(101, 130, 130));
+        assertEquals(new TestHttpResponse(RestStatus.OK, TestHttpExchange.EMPTY_HEADERS), uploadPart3Response);
+
+        // complete upload should be visible now
+
+        // can download contents
+        assertEquals(
+            new TestHttpResponse(RestStatus.OK, part1 + part2 + part3),
+            handleRequest(handler, "GET", "/download/storage/v1/b/" + bucket + "/o/" + blobName)
+        );
+
+        // can see in listing
+        assertEquals(new TestHttpResponse(RestStatus.OK, Strings.format("""
+            {"kind":"storage#objects","items":[{"kind":"storage#object","bucket":"%s","name":"%s","id":"%s","size":"130"}
+            ],"prefixes":[]}""", bucket, blobName, blobName)), handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o"));
+
+        // can get metadata
+        assertEquals(new TestHttpResponse(RestStatus.OK, Strings.format("""
+            {"kind":"storage#object","bucket":"%s","name":"%s","id":"%s","size":"130"}
+            """, bucket, blobName, blobName)), handleRequest(handler, "GET", "/storage/v1/b/" + bucket + "/o/" + blobName));
+    }
+
+    private record TestHttpResponse(int status, BytesReference body, Headers headers) {
+        TestHttpResponse(RestStatus status, BytesReference body, Headers headers) {
+            this(status.getStatus(), body, headers);
+        }
+
+        TestHttpResponse(RestStatus status, String body) {
+            this(status.getStatus(), new BytesArray(body.getBytes(StandardCharsets.UTF_8)), TestHttpExchange.EMPTY_HEADERS);
+        }
+
+        TestHttpResponse(RestStatus status, Headers headers) {
+            this(status.getStatus(), BytesArray.EMPTY, headers);
+        }
+
+        TestHttpResponse(int statusCode, Headers headers) {
+            this(statusCode, BytesArray.EMPTY, headers);
+        }
+
+        RestStatus restStatus() {
+            return Objects.requireNonNull(RestStatus.fromCode(status));
+        }
+
+        @Override
+        public String toString() {
+            return "TestHttpResponse{" + "status=" + status + ", body={size=" + body.utf8ToString() + "}, headers=" + headers + '}';
+        }
+    }
+
+    private static TestHttpResponse handleRequest(GoogleCloudStorageHttpHandler handler, String method, String uri) {
+        return handleRequest(handler, method, uri, "");
+    }
+
+    private static TestHttpResponse handleRequest(GoogleCloudStorageHttpHandler handler, String method, String uri, String requestBody) {
+        return handleRequest(handler, method, uri, new BytesArray(requestBody.getBytes(StandardCharsets.UTF_8)));
+    }
+
+    private static TestHttpResponse handleRequest(
+        GoogleCloudStorageHttpHandler handler,
+        String method,
+        String uri,
+        String requestBody,
+        Headers headers
+    ) {
+        return handleRequest(handler, method, uri, new BytesArray(requestBody.getBytes(StandardCharsets.UTF_8)), headers);
+    }
+
+    private static TestHttpResponse handleRequest(
+        GoogleCloudStorageHttpHandler handler,
+        String method,
+        String uri,
+        BytesReference requestBody
+    ) {
+        return handleRequest(handler, method, uri, requestBody, TestHttpExchange.EMPTY_HEADERS);
+    }
+
+    private static TestHttpResponse handleRequest(
+        GoogleCloudStorageHttpHandler handler,
+        String method,
+        String uri,
+        BytesReference requestBody,
+        Headers requestHeaders
+    ) {
+        final var httpExchange = new TestHttpExchange(method, uri, requestBody, requestHeaders);
+        try {
+            handler.handle(httpExchange);
+        } catch (IOException e) {
+            fail(e);
+        }
+        assertNotEquals(0, httpExchange.getResponseCode());
+        var responseHeaders = new Headers();
+        httpExchange.getResponseHeaders().forEach((header, values) -> {
+            // com.sun.net.httpserver.Headers.Headers() normalize keys
+            if ("Range".equals(header) || "Content-range".equals(header) || "Location".equals(header)) {
+                responseHeaders.put(header, List.copyOf(values));
+            }
+        });
+        return new TestHttpResponse(httpExchange.getResponseCode(), httpExchange.getResponseBodyContents(), responseHeaders);
+    }
+
+    private static Headers contentRangeHeader(@Nullable Integer startInclusive, @Nullable Integer endInclusive, @Nullable Integer limit) {
+        final String rangeString = startInclusive != null && endInclusive != null ? startInclusive + "-" + endInclusive : "*";
+        final String limitString = limit == null ? "*" : limit.toString();
+        return Headers.of("Content-Range", "bytes " + rangeString + "/" + limitString);
+    }
+
+    private static Headers rangeHeader(long start, long end) {
+        return Headers.of("Range", Strings.format("bytes=%d-%d", start, end));
+    }
+
+    private static BytesReference createGzipCompressedMultipartUploadBody(String bucketName, String path, String content) {
+        return createGzipCompressedMultipartUploadBody(bucketName, path, new BytesArray(content.getBytes(StandardCharsets.UTF_8)));
+    }
+
+    private static BytesReference createGzipCompressedMultipartUploadBody(String bucketName, String path, BytesReference content) {
+        final String metadataString = Strings.format("{\"bucket\":\"%s\", \"name\":\"%s\"}", bucketName, path);
+        final BytesReference header = new BytesArray(Strings.format("""
+            --__END_OF_PART__a607a67c-6df7-4b87-b8a1-81f639a75a97__
+            Content-Length: %d
+            Content-Type: application/json; charset=UTF-8
+            content-transfer-encoding: binary
+
+            %s
+            --__END_OF_PART__a607a67c-6df7-4b87-b8a1-81f639a75a97__
+            Content-Type: application/octet-stream
+            content-transfer-encoding: binary
+
+            """.replaceAll("\n", "\r\n"), metadataString.length(), metadataString).getBytes(StandardCharsets.UTF_8));
+
+        final BytesReference footer = new BytesArray("""
+
+            --__END_OF_PART__a607a67c-6df7-4b87-b8a1-81f639a75a97__--
+            """.replaceAll("\n", "\r\n"));
+        final ByteArrayOutputStream out = new ByteArrayOutputStream();
+        try (GZIPOutputStream gzipOutputStream = new GZIPOutputStream(out)) {
+            gzipOutputStream.write(BytesReference.toBytes(CompositeBytesReference.of(header, content, footer)));
+        } catch (IOException e) {
+            fail(e);
+        }
+        return new BytesArray(out.toByteArray());
+    }
+
+    private static String createBatchDeleteRequest(String bucketName, String... paths) {
+        final String deleteRequestTemplate = """
+            DELETE %s/storage/v1/b/%s/o/%s HTTP/1.1
+            Authorization: Bearer foo
+            x-goog-api-client: gl-java/23.0.0 gdcl/2.1.1 mac-os-x/15.2
+
+
+            """;
+        final String partTemplate = """
+            --__END_OF_PART__d8b50acb-87dc-4630-a3d3-17d187132ebc__
+            Content-Length: %d
+            Content-Type: application/http
+            content-id: %d
+            content-transfer-encoding: binary
+
+            %s
+            """;
+        StringBuilder builder = new StringBuilder();
+        AtomicInteger contentId = new AtomicInteger();
+        Arrays.stream(paths).forEach(p -> {
+            final String deleteRequest = Strings.format(deleteRequestTemplate, HOST, bucketName, p);
+            final String part = Strings.format(partTemplate, deleteRequest.length(), contentId.incrementAndGet(), deleteRequest);
+            builder.append(part);
+        });
+        builder.append("--__END_OF_PART__d8b50acb-87dc-4630-a3d3-17d187132ebc__");
+        return builder.toString();
+    }
+
+    private static class TestHttpExchange extends HttpExchange {
+
+        private static final Headers EMPTY_HEADERS = new Headers();
+
+        private final String method;
+        private final URI uri;
+        private final BytesReference requestBody;
+        private final Headers requestHeaders;
+
+        private final Headers responseHeaders = new Headers();
+        private final BytesStreamOutput responseBody = new BytesStreamOutput();
+        private int responseCode;
+
+        TestHttpExchange(String method, String uri, BytesReference requestBody, Headers requestHeaders) {
+            this.method = method;
+            this.uri = URI.create(uri);
+            this.requestBody = requestBody;
+            this.requestHeaders = new Headers(requestHeaders);
+            this.requestHeaders.add("Host", HOST);
+        }
+
+        @Override
+        public Headers getRequestHeaders() {
+            return requestHeaders;
+        }
+
+        @Override
+        public Headers getResponseHeaders() {
+            return responseHeaders;
+        }
+
+        @Override
+        public URI getRequestURI() {
+            return uri;
+        }
+
+        @Override
+        public String getRequestMethod() {
+            return method;
+        }
+
+        @Override
+        public HttpContext getHttpContext() {
+            return null;
+        }
+
+        @Override
+        public void close() {}
+
+        @Override
+        public InputStream getRequestBody() {
+            try {
+                return requestBody.streamInput();
+            } catch (IOException e) {
+                throw new AssertionError(e);
+            }
+        }
+
+        @Override
+        public OutputStream getResponseBody() {
+            return responseBody;
+        }
+
+        @Override
+        public void sendResponseHeaders(int rCode, long responseLength) {
+            this.responseCode = rCode;
+        }
+
+        @Override
+        public InetSocketAddress getRemoteAddress() {
+            return null;
+        }
+
+        @Override
+        public int getResponseCode() {
+            return responseCode;
+        }
+
+        public BytesReference getResponseBodyContents() {
+            return responseBody.bytes();
+        }
+
+        @Override
+        public InetSocketAddress getLocalAddress() {
+            return null;
+        }
+
+        @Override
+        public String getProtocol() {
+            return "HTTP/1.1";
+        }
+
+        @Override
+        public Object getAttribute(String name) {
+            return null;
+        }
+
+        @Override
+        public void setAttribute(String name, Object value) {
+            fail("setAttribute not implemented");
+        }
+
+        @Override
+        public void setStreams(InputStream i, OutputStream o) {
+            fail("setStreams not implemented");
+        }
+
+        @Override
+        public HttpPrincipal getPrincipal() {
+            fail("getPrincipal not implemented");
+            throw new UnsupportedOperationException("getPrincipal not implemented");
+        }
+    }
+}

From ffe9002d3252315b2af453b662ad5c10bc626768 Mon Sep 17 00:00:00 2001
From: Quentin Pradet <quentin.pradet@elastic.co>
Date: Wed, 18 Dec 2024 08:17:37 +0400
Subject: [PATCH 054/119] Add missing timeouts to rest-api-spec ILM APIs
 (#118837)

---
 docs/changelog/118837.yaml                            |  5 +++++
 .../rest-api-spec/api/ilm.delete_lifecycle.json       | 11 ++++++++++-
 .../rest-api-spec/api/ilm.explain_lifecycle.json      |  4 ++++
 .../rest-api-spec/api/ilm.get_lifecycle.json          | 11 ++++++++++-
 .../rest-api-spec/api/ilm.put_lifecycle.json          | 11 ++++++++++-
 .../main/resources/rest-api-spec/api/ilm.start.json   | 11 ++++++++++-
 .../main/resources/rest-api-spec/api/ilm.stop.json    | 11 ++++++++++-
 7 files changed, 59 insertions(+), 5 deletions(-)
 create mode 100644 docs/changelog/118837.yaml

diff --git a/docs/changelog/118837.yaml b/docs/changelog/118837.yaml
new file mode 100644
index 0000000000000..38cd32f3a3513
--- /dev/null
+++ b/docs/changelog/118837.yaml
@@ -0,0 +1,5 @@
+pr: 118837
+summary: Add missing timeouts to rest-api-spec ILM APIs
+area: "ILM+SLM"
+type: bug
+issues: []
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.delete_lifecycle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.delete_lifecycle.json
index 2ff1031ad5c52..cd6397fb61586 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.delete_lifecycle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.delete_lifecycle.json
@@ -25,6 +25,15 @@
         }
       ]
     },
-    "params":{}
+    "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.explain_lifecycle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.explain_lifecycle.json
index c793ed09281ae..94c37adb802f6 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.explain_lifecycle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.explain_lifecycle.json
@@ -33,6 +33,10 @@
       "only_errors": {
         "type": "boolean",
         "description": "filters the indices included in the response to ones in an ILM error state, implies only_managed"
+      },
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
       }
     }
   }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.get_lifecycle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.get_lifecycle.json
index 17bf813093dd6..5abdfac7f5b30 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.get_lifecycle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.get_lifecycle.json
@@ -31,6 +31,15 @@
         }
       ]
     },
-    "params":{}
+    "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.put_lifecycle.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.put_lifecycle.json
index 5a12a778241b3..b7fdbe04a0ffb 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.put_lifecycle.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.put_lifecycle.json
@@ -26,7 +26,16 @@
         }
       ]
     },
-    "params":{},
+    "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
+    },
     "body":{
       "description":"The lifecycle policy definition to register"
     }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.start.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.start.json
index 88b020071ab82..7141673ff9a9d 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.start.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.start.json
@@ -19,6 +19,15 @@
         }
       ]
     },
-    "params":{}
+    "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.stop.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.stop.json
index 8401f93badfc4..962fa77263ee4 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.stop.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.stop.json
@@ -19,6 +19,15 @@
         }
       ]
     },
-    "params":{}
+    "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
+    }
   }
 }

From 2ceade4234ab2323184cfb9ff11259542508453f Mon Sep 17 00:00:00 2001
From: Quentin Pradet <quentin.pradet@elastic.co>
Date: Wed, 18 Dec 2024 08:18:43 +0400
Subject: [PATCH 055/119] Add missing timeouts to rest-api-spec ingest APIs
 (#118844)

---
 docs/changelog/118844.yaml                                | 5 +++++
 .../rest-api-spec/api/ingest.delete_geoip_database.json   | 8 ++++++++
 .../api/ingest.delete_ip_location_database.json           | 8 ++++++++
 .../rest-api-spec/api/ingest.put_geoip_database.json      | 8 ++++++++
 .../api/ingest.put_ip_location_database.json              | 8 ++++++++
 5 files changed, 37 insertions(+)
 create mode 100644 docs/changelog/118844.yaml

diff --git a/docs/changelog/118844.yaml b/docs/changelog/118844.yaml
new file mode 100644
index 0000000000000..f9f92bcaeb8cb
--- /dev/null
+++ b/docs/changelog/118844.yaml
@@ -0,0 +1,5 @@
+pr: 118844
+summary: Add missing timeouts to rest-api-spec ingest APIs
+area: Ingest Node
+type: bug
+issues: []
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_geoip_database.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_geoip_database.json
index fe50da720a4da..f76d328836d90 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_geoip_database.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_geoip_database.json
@@ -26,6 +26,14 @@
       ]
     },
     "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
     }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_ip_location_database.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_ip_location_database.json
index e97d1da276906..341ff5081e270 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_ip_location_database.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.delete_ip_location_database.json
@@ -26,6 +26,14 @@
       ]
     },
     "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
     }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_geoip_database.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_geoip_database.json
index 6d088e3f164f4..9c2677d1f7b2f 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_geoip_database.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_geoip_database.json
@@ -27,6 +27,14 @@
       ]
     },
     "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
     },
     "body":{
       "description":"The database configuration definition",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_ip_location_database.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_ip_location_database.json
index 18487969b1a90..782048b98160a 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_ip_location_database.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.put_ip_location_database.json
@@ -27,6 +27,14 @@
       ]
     },
     "params":{
+      "master_timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout for connection to master node"
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Explicit operation timeout"
+      }
     },
     "body":{
       "description":"The database configuration definition",

From a0ce7420af1bad48ffd0c5f19978b5943b4b32aa Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 18 Dec 2024 16:30:02 +1100
Subject: [PATCH 056/119] Mute
 org.elasticsearch.cluster.service.MasterServiceTests testThreadContext
 #118914

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index b5712b22fe583..ef302671de998 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -305,6 +305,9 @@ tests:
 - class: org.elasticsearch.smoketest.DocsClientYamlTestSuiteIT
   method: test {yaml=reference/indices/shard-stores/line_150}
   issue: https://github.com/elastic/elasticsearch/issues/118896
+- class: org.elasticsearch.cluster.service.MasterServiceTests
+  method: testThreadContext
+  issue: https://github.com/elastic/elasticsearch/issues/118914
 
 # Examples:
 #

From 3f1fed0f0900e486d328c6aaede5578a3a1f9919 Mon Sep 17 00:00:00 2001
From: Carlos Delgado <6339205+carlosdelest@users.noreply.github.com>
Date: Wed, 18 Dec 2024 07:50:54 +0100
Subject: [PATCH 057/119] ESQL - Remove restrictions for disjunctions in full
 text functions (#118544)

---
 docs/changelog/118544.yaml                    |   5 +
 x-pack/plugin/build.gradle                    |   1 +
 .../main/resources/match-function.csv-spec    |  74 +++++++++++
 .../main/resources/match-operator.csv-spec    | 121 ++++++++++++++----
 .../xpack/esql/plugin/MatchFunctionIT.java    |  29 +++--
 .../xpack/esql/plugin/MatchOperatorIT.java    |   3 +-
 .../xpack/esql/action/EsqlCapabilities.java   |   7 +-
 .../xpack/esql/analysis/Verifier.java         |  81 ++++++++----
 .../xpack/esql/analysis/VerifierTests.java    |  84 ++++++------
 .../LocalPhysicalPlanOptimizerTests.java      |  42 ++++++
 .../test/esql/180_match_operator.yml          |  17 ++-
 11 files changed, 364 insertions(+), 100 deletions(-)
 create mode 100644 docs/changelog/118544.yaml

diff --git a/docs/changelog/118544.yaml b/docs/changelog/118544.yaml
new file mode 100644
index 0000000000000..d59783c4e6194
--- /dev/null
+++ b/docs/changelog/118544.yaml
@@ -0,0 +1,5 @@
+pr: 118544
+summary: ESQL - Remove restrictions for disjunctions in full text functions
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/build.gradle b/x-pack/plugin/build.gradle
index fb37fb3575551..aa6e8de4ec27c 100644
--- a/x-pack/plugin/build.gradle
+++ b/x-pack/plugin/build.gradle
@@ -94,5 +94,6 @@ tasks.named("yamlRestCompatTestTransform").configure({ task ->
   task.skipTest("privileges/11_builtin/Test get builtin privileges" ,"unnecessary to test compatibility")
   task.skipTest("esql/61_enrich_ip/Invalid IP strings", "We switched from exceptions to null+warnings for ENRICH runtime errors")
   task.skipTest("esql/180_match_operator/match with non text field", "Match operator can now be used on non-text fields")
+  task.skipTest("esql/180_match_operator/match with functions", "Error message changed")
 })
 
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec
index 03b24555dbeff..5ea169e1b110d 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec
@@ -115,6 +115,80 @@ book_no:keyword | title:text
 7140            |The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1)     
 ;
 
+matchWithDisjunction
+required_capability: match_function
+required_capability: full_text_functions_disjunctions
+
+from books
+| where match(author, "Vonnegut") or match(author, "Guinane") 
+| keep book_no, author;
+ignoreOrder:true
+
+book_no:keyword | author:text
+2464            | Kurt Vonnegut  
+6970            | Edith Vonnegut 
+8956            | Kurt Vonnegut  
+3950            | Kurt Vonnegut  
+4382            | Carole Guinane 
+;
+
+matchWithDisjunctionAndFiltersConjunction
+required_capability: match_function
+required_capability: full_text_functions_disjunctions
+
+from books
+| where (match(author, "Vonnegut") or match(author, "Guinane")) and year > 1997
+| keep book_no, author, year;
+ignoreOrder:true
+
+book_no:keyword | author:text       | year:integer
+6970            | Edith Vonnegut    | 1998
+4382            | Carole Guinane    | 2001
+;
+
+matchWithDisjunctionAndConjunction
+required_capability: match_function
+required_capability: full_text_functions_disjunctions
+
+from books
+| where (match(author, "Vonnegut") or match(author, "Marquez")) and match(description, "realism")
+| keep book_no;
+
+book_no:keyword
+4814
+;
+
+matchWithMoreComplexDisjunctionAndConjunction
+required_capability: match_function
+required_capability: full_text_functions_disjunctions
+
+from books
+| where (match(author, "Vonnegut") and match(description, "charming")) or (match(author, "Marquez") and match(description, "realism"))
+| keep book_no;
+ignoreOrder:true
+
+book_no:keyword
+6970
+4814
+;
+
+matchWithDisjunctionIncludingConjunction
+required_capability: match_function
+required_capability: full_text_functions_disjunctions
+
+from books
+| where match(author, "Vonnegut") or (match(author, "Marquez") and match(description, "realism"))
+| keep book_no;
+ignoreOrder:true
+
+book_no:keyword
+2464
+6970
+4814
+8956
+3950
+;
+
 matchWithFunctionPushedToLucene
 required_capability: match_function
 
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec
index 56f7f5ccd8823..7906f8b69162b 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec
@@ -102,6 +102,81 @@ book_no:keyword | title:text
 7140            |The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1)     
 ;
 
+
+matchWithDisjunction
+required_capability: match_operator_colon
+required_capability: full_text_functions_disjunctions
+
+from books
+| where author : "Vonnegut" or author : "Guinane" 
+| keep book_no, author;
+ignoreOrder:true
+
+book_no:keyword | author:text
+2464            | Kurt Vonnegut  
+6970            | Edith Vonnegut 
+8956            | Kurt Vonnegut  
+3950            | Kurt Vonnegut  
+4382            | Carole Guinane 
+;
+
+matchWithDisjunctionAndFiltersConjunction
+required_capability: match_operator_colon
+required_capability: full_text_functions_disjunctions
+
+from books
+| where (author : "Vonnegut" or author : "Guinane") and year > 1997
+| keep book_no, author, year;
+ignoreOrder:true
+
+book_no:keyword | author:text       | year:integer
+6970            | Edith Vonnegut    | 1998
+4382            | Carole Guinane    | 2001
+;
+
+matchWithDisjunctionAndConjunction
+required_capability: match_operator_colon
+required_capability: full_text_functions_disjunctions
+
+from books
+| where (author : "Vonnegut" or author : "Marquez") and description : "realism"
+| keep book_no;
+
+book_no:keyword
+4814
+;
+
+matchWithMoreComplexDisjunctionAndConjunction
+required_capability: match_function
+required_capability: full_text_functions_disjunctions
+
+from books
+| where (author : "Vonnegut" and description : "charming") or (author : "Marquez" and description : "realism")
+| keep book_no;
+ignoreOrder:true
+
+book_no:keyword
+6970
+4814
+;
+
+matchWithDisjunctionIncludingConjunction
+required_capability: match_operator_colon
+required_capability: full_text_functions_disjunctions
+
+from books
+| where author : "Vonnegut" or (author : "Marquez" and description : "realism")
+| keep book_no;
+ignoreOrder:true
+
+book_no:keyword
+2464
+6970
+4814
+8956
+3950
+;
+
 matchWithFunctionPushedToLucene
 required_capability: match_operator_colon
 
@@ -219,7 +294,7 @@ count(*): long  | author.keyword:keyword
 ;
 
 testMatchBooleanField
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -235,7 +310,7 @@ Amabile             | true                  | 2.09
 ;
 
 testMatchIntegerField
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -247,7 +322,7 @@ emp_no:integer | first_name:keyword
 ;
 
 testMatchDoubleField
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -259,7 +334,7 @@ emp_no:integer | salary_change:double
 ;  
 
 testMatchLongField
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from date_nanos
@@ -271,7 +346,7 @@ num:long
 ;
 
 testMatchUnsignedLongField
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from ul_logs
@@ -283,7 +358,7 @@ bytes_out:unsigned_long
 ;
 
 testMatchIpFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from sample_data
@@ -295,7 +370,7 @@ client_ip:ip   | message:keyword
 ;
 
 testMatchDateFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from date_nanos
@@ -307,7 +382,7 @@ millis:date
 ;
 
 testMatchDateNanosFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from date_nanos
@@ -319,7 +394,7 @@ nanos:date_nanos
 ;
 
 testMatchBooleanFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -335,7 +410,7 @@ Amabile             | true                  | 2.09
 ;
 
 testMatchIntegerFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -347,7 +422,7 @@ emp_no:integer | first_name:keyword
 ;
 
 testMatchDoubleFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -359,7 +434,7 @@ emp_no:integer | salary_change:double
 ;
 
 testMatchLongFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from date_nanos
@@ -371,7 +446,7 @@ num:long
 ;
 
 testMatchUnsignedLongFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from ul_logs
@@ -383,7 +458,7 @@ bytes_out:unsigned_long
 ;
 
 testMatchVersionFieldAsString
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from apps 
@@ -395,7 +470,7 @@ bbbbb        | 2.1
 ;
 
 testMatchIntegerAsDouble
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees 
@@ -408,7 +483,7 @@ emp_no:integer | first_name:keyword
 ;
 
 testMatchDoubleAsIntegerField
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees
@@ -423,7 +498,7 @@ emp_no:integer | height:double
 ;
 
 testMatchMultipleFieldTypes
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible 
@@ -440,7 +515,7 @@ emp_as_int:integer | name_as_kw:keyword
 
 
 testMatchMultipleFieldTypesKeywordText
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible 
@@ -455,7 +530,7 @@ Kazuhito
 ;
 
 testMatchMultipleFieldTypesDoubleFloat
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible
@@ -474,7 +549,7 @@ emp_no:integer | height_dbl:double
 ;
 
 testMatchMultipleFieldTypesBooleanKeyword
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible
@@ -491,7 +566,7 @@ true
 ;
 
 testMatchMultipleFieldTypesLongUnsignedLong
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible  
@@ -506,7 +581,7 @@ avg_worked_seconds_ul:unsigned_long
 ;
 
 testMatchMultipleFieldTypesDateNanosDate
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible
@@ -521,7 +596,7 @@ hire_date_nanos:date_nanos
 ;
 
 testMatchWithWrongFieldValue
-required_capability: match_function
+required_capability: match_operator_colon
 required_capability: match_additional_types
 
 from employees,employees_incompatible
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchFunctionIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchFunctionIT.java
index 58b1652653ca3..ad90bbf6ae9db 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchFunctionIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchFunctionIT.java
@@ -168,7 +168,7 @@ public void testWhereMatchWithScoringNoSort() {
         var query = """
             FROM test
             METADATA _score
-            | WHERE content:"fox"
+            | WHERE match(content, "fox")
             | KEEP id, _score
             """;
 
@@ -182,7 +182,7 @@ public void testWhereMatchWithScoringNoSort() {
     public void testNonExistingColumn() {
         var query = """
             FROM test
-            | WHERE something:"fox"
+            | WHERE match(something, "fox")
             """;
 
         var error = expectThrows(VerificationException.class, () -> run(query));
@@ -193,14 +193,14 @@ public void testWhereMatchEvalColumn() {
         var query = """
             FROM test
             | EVAL upper_content = to_upper(content)
-            | WHERE upper_content:"FOX"
+            | WHERE match(upper_content, "FOX")
             | KEEP id
             """;
 
         var error = expectThrows(VerificationException.class, () -> run(query));
         assertThat(
             error.getMessage(),
-            containsString("[:] operator cannot operate on [upper_content], which is not a field from an index mapping")
+            containsString("[MATCH] function cannot operate on [upper_content], which is not a field from an index mapping")
         );
     }
 
@@ -209,13 +209,13 @@ public void testWhereMatchOverWrittenColumn() {
             FROM test
             | DROP content
             | EVAL content = CONCAT("document with ID ", to_str(id))
-            | WHERE content:"document"
+            | WHERE match(content, "document")
             """;
 
         var error = expectThrows(VerificationException.class, () -> run(query));
         assertThat(
             error.getMessage(),
-            containsString("[:] operator cannot operate on [content], which is not a field from an index mapping")
+            containsString("[MATCH] function cannot operate on [content], which is not a field from an index mapping")
         );
     }
 
@@ -223,7 +223,7 @@ public void testWhereMatchAfterStats() {
         var query = """
             FROM test
             | STATS count(*)
-            | WHERE content:"fox"
+            | WHERE match(content, "fox")
             """;
 
         var error = expectThrows(VerificationException.class, () -> run(query));
@@ -233,14 +233,15 @@ public void testWhereMatchAfterStats() {
     public void testWhereMatchWithFunctions() {
         var query = """
             FROM test
-            | WHERE content:"fox" OR to_upper(content) == "FOX"
+            | WHERE match(content, "fox") OR to_upper(content) == "FOX"
             """;
         var error = expectThrows(ElasticsearchException.class, () -> run(query));
         assertThat(
             error.getMessage(),
             containsString(
-                "Invalid condition [content:\"fox\" OR to_upper(content) == \"FOX\"]. "
-                    + "[:] operator can't be used as part of an or condition"
+                "Invalid condition [match(content, \"fox\") OR to_upper(content) == \"FOX\"]. "
+                    + "Full text functions can be used in an OR condition,"
+                    + " but only if just full text functions are used in the OR condition"
             )
         );
     }
@@ -248,24 +249,24 @@ public void testWhereMatchWithFunctions() {
     public void testWhereMatchWithRow() {
         var query = """
             ROW content = "a brown fox"
-            | WHERE content:"fox"
+            | WHERE match(content, "fox")
             """;
 
         var error = expectThrows(ElasticsearchException.class, () -> run(query));
         assertThat(
             error.getMessage(),
-            containsString("[:] operator cannot operate on [\"a brown fox\"], which is not a field from an index mapping")
+            containsString("[MATCH] function cannot operate on [\"a brown fox\"], which is not a field from an index mapping")
         );
     }
 
     public void testMatchWithinEval() {
         var query = """
             FROM test
-            | EVAL matches_query = content:"fox"
+            | EVAL matches_query = match(content, "fox")
             """;
 
         var error = expectThrows(VerificationException.class, () -> run(query));
-        assertThat(error.getMessage(), containsString("[:] operator is only supported in WHERE commands"));
+        assertThat(error.getMessage(), containsString("[MATCH] function is only supported in WHERE commands"));
     }
 
     private void createAndPopulateIndex() {
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchOperatorIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchOperatorIT.java
index d0a641f086fe4..758878b46d51f 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchOperatorIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/MatchOperatorIT.java
@@ -216,7 +216,8 @@ public void testWhereMatchWithFunctions() {
             error.getMessage(),
             containsString(
                 "Invalid condition [content:\"fox\" OR to_upper(content) == \"FOX\"]. "
-                    + "[:] operator can't be used as part of an or condition"
+                    + "Full text functions can be used in an OR condition, "
+                    + "but only if just full text functions are used in the OR condition"
             )
         );
     }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index f766beb76dd3d..8c7e381d33322 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -585,7 +585,12 @@ public enum Cap {
         /**
          * Fix for regex folding with case-insensitive pattern https://github.com/elastic/elasticsearch/issues/118371
          */
-        FIXED_REGEX_FOLD;
+        FIXED_REGEX_FOLD,
+
+        /**
+         * Full text functions can be used in disjunctions
+         */
+        FULL_TEXT_FUNCTIONS_DISJUNCTIONS;
 
         private final boolean enabled;
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
index f01cc265e330b..6b98b7d69834f 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
@@ -766,41 +766,78 @@ private static void checkRemoteEnrich(LogicalPlan plan, Set<Failure> failures) {
     }
 
     /**
-     * Checks whether a condition contains a disjunction with the specified typeToken. Adds to failure if it does.
+     * Checks whether a condition contains a disjunction with a full text search.
+     * If it does, check that every element of the disjunction is a full text search or combinations (AND, OR, NOT) of them.
+     * If not, add a failure to the failures collection.
      *
-     * @param condition        condition to check for disjunctions
+     * @param condition        condition to check for disjunctions of full text searches
      * @param typeNameProvider provider for the type name to add in the failure message
      * @param failures         failures collection to add to
      */
-    private static void checkNotPresentInDisjunctions(
+    private static void checkFullTextSearchDisjunctions(
         Expression condition,
         java.util.function.Function<FullTextFunction, String> typeNameProvider,
         Set<Failure> failures
     ) {
-        condition.forEachUp(Or.class, or -> {
-            checkNotPresentInDisjunctions(or.left(), or, typeNameProvider, failures);
-            checkNotPresentInDisjunctions(or.right(), or, typeNameProvider, failures);
+        int failuresCount = failures.size();
+        condition.forEachDown(Or.class, or -> {
+            if (failures.size() > failuresCount) {
+                // Exit early if we already have a failures
+                return;
+            }
+            boolean hasFullText = or.anyMatch(FullTextFunction.class::isInstance);
+            if (hasFullText) {
+                boolean hasOnlyFullText = onlyFullTextFunctionsInExpression(or);
+                if (hasOnlyFullText == false) {
+                    failures.add(
+                        fail(
+                            or,
+                            "Invalid condition [{}]. Full text functions can be used in an OR condition, "
+                                + "but only if just full text functions are used in the OR condition",
+                            or.sourceText()
+                        )
+                    );
+                }
+            }
         });
     }
 
     /**
-     * Checks whether a condition contains a disjunction with the specified typeToken. Adds to failure if it does.
+     * Checks whether an expression contains just full text functions or negations (NOT) and combinations (AND, OR) of full text functions
      *
-     * @param parentExpression parent expression to add to the failure message
-     * @param or               disjunction that is being checked
-     * @param failures         failures collection to add to
+     * @param expression expression to check
+     * @return true if all children are full text functions or negations of full text functions, false otherwise
      */
-    private static void checkNotPresentInDisjunctions(
-        Expression parentExpression,
-        Or or,
-        java.util.function.Function<FullTextFunction, String> elementName,
-        Set<Failure> failures
-    ) {
-        parentExpression.forEachDown(FullTextFunction.class, ftp -> {
-            failures.add(
-                fail(or, "Invalid condition [{}]. {} can't be used as part of an or condition", or.sourceText(), elementName.apply(ftp))
-            );
-        });
+    private static boolean onlyFullTextFunctionsInExpression(Expression expression) {
+        if (expression instanceof FullTextFunction) {
+            return true;
+        } else if (expression instanceof Not) {
+            return onlyFullTextFunctionsInExpression(expression.children().get(0));
+        } else if (expression instanceof BinaryLogic binaryLogic) {
+            return onlyFullTextFunctionsInExpression(binaryLogic.left()) && onlyFullTextFunctionsInExpression(binaryLogic.right());
+        }
+
+        return false;
+    }
+
+    /**
+     * Checks whether an expression contains a full text function as part of it
+     *
+     * @param expression expression to check
+     * @return true if the expression or any of its children is a full text function, false otherwise
+     */
+    private static boolean anyFullTextFunctionsInExpression(Expression expression) {
+        if (expression instanceof FullTextFunction) {
+            return true;
+        }
+
+        for (Expression child : expression.children()) {
+            if (anyFullTextFunctionsInExpression(child)) {
+                return true;
+            }
+        }
+
+        return false;
     }
 
     /**
@@ -870,7 +907,7 @@ private static void checkFullTextQueryFunctions(LogicalPlan plan, Set<Failure> f
                 m -> "[" + m.functionName() + "] " + m.functionType(),
                 failures
             );
-            checkNotPresentInDisjunctions(condition, ftf -> "[" + ftf.functionName() + "] " + ftf.functionType(), failures);
+            checkFullTextSearchDisjunctions(condition, ftf -> "[" + ftf.functionName() + "] " + ftf.functionType(), failures);
             checkFullTextFunctionsParents(condition, failures);
         } else {
             plan.forEachExpression(FullTextFunction.class, ftf -> {
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
index 182e87d1ab9dd..a1e29117a25d3 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
@@ -1166,12 +1166,14 @@ public void testMatchInsideEval() throws Exception {
     public void testMatchFilter() throws Exception {
         assertEquals(
             "1:19: Invalid condition [first_name:\"Anna\" or starts_with(first_name, \"Anne\")]. "
-                + "[:] operator can't be used as part of an or condition",
+                + "Full text functions can be used in an OR condition, "
+                + "but only if just full text functions are used in the OR condition",
             error("from test | where first_name:\"Anna\" or starts_with(first_name, \"Anne\")")
         );
 
         assertEquals(
-            "1:51: Invalid condition [first_name:\"Anna\" OR new_salary > 100]. " + "[:] operator can't be used as part of an or condition",
+            "1:51: Invalid condition [first_name:\"Anna\" OR new_salary > 100]. Full text functions can be"
+                + " used in an OR condition, but only if just full text functions are used in the OR condition",
             error("from test | eval new_salary = salary + 10 | where first_name:\"Anna\" OR new_salary > 100")
         );
     }
@@ -1409,48 +1411,56 @@ public void testMatchOperatorWithDisjunctions() {
     }
 
     private void checkWithDisjunctions(String functionName, String functionInvocation, String functionType) {
+        String expression = functionInvocation + " or length(first_name) > 12";
+        checkdisjunctionError("1:19", expression, functionName, functionType);
+        expression = "(" + functionInvocation + " or first_name is not null) or (length(first_name) > 12 and match(last_name, \"Smith\"))";
+        checkdisjunctionError("1:19", expression, functionName, functionType);
+        expression = functionInvocation + " or (last_name is not null and first_name is null)";
+        checkdisjunctionError("1:19", expression, functionName, functionType);
+    }
+
+    private void checkdisjunctionError(String position, String expression, String functionName, String functionType) {
         assertEquals(
             LoggerMessageFormat.format(
                 null,
-                "1:19: Invalid condition [{} or length(first_name) > 12]. "
-                    + "[{}] "
-                    + functionType
-                    + " can't be used as part of an or condition",
-                functionInvocation,
-                functionName
-            ),
-            error("from test | where " + functionInvocation + " or length(first_name) > 12")
-        );
-        assertEquals(
-            LoggerMessageFormat.format(
-                null,
-                "1:19: Invalid condition [({} and first_name is not null) or (length(first_name) > 12 and first_name is null)]. "
-                    + "[{}] "
-                    + functionType
-                    + " can't be used as part of an or condition",
-                functionInvocation,
-                functionName
-            ),
-            error(
-                "from test | where ("
-                    + functionInvocation
-                    + " and first_name is not null) or (length(first_name) > 12 and first_name is null)"
-            )
-        );
-        assertEquals(
-            LoggerMessageFormat.format(
-                null,
-                "1:19: Invalid condition [({} and first_name is not null) or first_name is null]. "
-                    + "[{}] "
-                    + functionType
-                    + " can't be used as part of an or condition",
-                functionInvocation,
-                functionName
+                "{}: Invalid condition [{}]. Full text functions can be used in an OR condition, "
+                    + "but only if just full text functions are used in the OR condition",
+                position,
+                expression
             ),
-            error("from test | where (" + functionInvocation + " and first_name is not null) or first_name is null")
+            error("from test | where " + expression)
         );
     }
 
+    public void testFullTextFunctionsDisjunctions() {
+        checkWithFullTextFunctionsDisjunctions("MATCH", "match(last_name, \"Smith\")", "function");
+        checkWithFullTextFunctionsDisjunctions(":", "last_name : \"Smith\"", "operator");
+        checkWithFullTextFunctionsDisjunctions("QSTR", "qstr(\"last_name: Smith\")", "function");
+
+        assumeTrue("KQL function capability not available", EsqlCapabilities.Cap.KQL_FUNCTION.isEnabled());
+        checkWithFullTextFunctionsDisjunctions("KQL", "kql(\"last_name: Smith\")", "function");
+    }
+
+    private void checkWithFullTextFunctionsDisjunctions(String functionName, String functionInvocation, String functionType) {
+
+        String expression = functionInvocation + " or length(first_name) > 10";
+        checkdisjunctionError("1:19", expression, functionName, functionType);
+
+        expression = "match(last_name, \"Anneke\") or (" + functionInvocation + " and length(first_name) > 10)";
+        checkdisjunctionError("1:19", expression, functionName, functionType);
+
+        expression = "("
+            + functionInvocation
+            + " and length(first_name) > 0) or (match(last_name, \"Anneke\") and length(first_name) > 10)";
+        checkdisjunctionError("1:19", expression, functionName, functionType);
+
+        query("from test | where " + functionInvocation + " or match(first_name, \"Anna\")");
+        query("from test | where " + functionInvocation + " or not match(first_name, \"Anna\")");
+        query("from test | where (" + functionInvocation + " or match(first_name, \"Anna\")) and length(first_name) > 10");
+        query("from test | where (" + functionInvocation + " or match(first_name, \"Anna\")) and match(last_name, \"Smith\")");
+        query("from test | where " + functionInvocation + " or (match(first_name, \"Anna\") and match(last_name, \"Smith\"))");
+    }
+
     public void testQueryStringFunctionWithNonBooleanFunctions() {
         checkFullTextFunctionsWithNonBooleanFunctions("QSTR", "qstr(\"first_name: Anna\")", "function");
     }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
index 879a413615202..406e27c1517e5 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.index.query.MatchQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
+import org.elasticsearch.index.query.QueryStringQueryBuilder;
 import org.elasticsearch.index.query.RangeQueryBuilder;
 import org.elasticsearch.index.query.SearchExecutionContext;
 import org.elasticsearch.license.XPackLicenseState;
@@ -57,6 +58,7 @@
 import org.elasticsearch.xpack.esql.plan.physical.EvalExec;
 import org.elasticsearch.xpack.esql.plan.physical.ExchangeExec;
 import org.elasticsearch.xpack.esql.plan.physical.FieldExtractExec;
+import org.elasticsearch.xpack.esql.plan.physical.FilterExec;
 import org.elasticsearch.xpack.esql.plan.physical.LimitExec;
 import org.elasticsearch.xpack.esql.plan.physical.LocalSourceExec;
 import org.elasticsearch.xpack.esql.plan.physical.PhysicalPlan;
@@ -1543,6 +1545,46 @@ public void testMultipleMatchFilterPushdown() {
         assertThat(actualLuceneQuery.toString(), is(expectedLuceneQuery.toString()));
     }
 
+    public void testFullTextFunctionsDisjunctionPushdown() {
+        String query = """
+            from test
+            | where (match(first_name, "Anna") or qstr("first_name: Anneke")) and last_name: "Smith"
+            | sort emp_no
+            """;
+        var plan = plannerOptimizer.plan(query);
+        var topNExec = as(plan, TopNExec.class);
+        var exchange = as(topNExec.child(), ExchangeExec.class);
+        var project = as(exchange.child(), ProjectExec.class);
+        var fieldExtract = as(project.child(), FieldExtractExec.class);
+        var actualLuceneQuery = as(fieldExtract.child(), EsQueryExec.class).query();
+        var expectedLuceneQuery = new BoolQueryBuilder().must(
+            new BoolQueryBuilder().should(new MatchQueryBuilder("first_name", "Anna").lenient(true))
+                .should(new QueryStringQueryBuilder("first_name: Anneke"))
+        ).must(new MatchQueryBuilder("last_name", "Smith").lenient(true));
+        assertThat(actualLuceneQuery.toString(), is(expectedLuceneQuery.toString()));
+    }
+
+    public void testFullTextFunctionsDisjunctionWithFiltersPushdown() {
+        String query = """
+            from test
+            | where (first_name:"Anna" or first_name:"Anneke") and length(last_name) > 5
+            | sort emp_no
+            """;
+        var plan = plannerOptimizer.plan(query);
+        var topNExec = as(plan, TopNExec.class);
+        var exchange = as(topNExec.child(), ExchangeExec.class);
+        var project = as(exchange.child(), ProjectExec.class);
+        var fieldExtract = as(project.child(), FieldExtractExec.class);
+        var secondTopNExec = as(fieldExtract.child(), TopNExec.class);
+        var secondFieldExtract = as(secondTopNExec.child(), FieldExtractExec.class);
+        var filterExec = as(secondFieldExtract.child(), FilterExec.class);
+        var thirdFilterExtract = as(filterExec.child(), FieldExtractExec.class);
+        var actualLuceneQuery = as(thirdFilterExtract.child(), EsQueryExec.class).query();
+        var expectedLuceneQuery = new BoolQueryBuilder().should(new MatchQueryBuilder("first_name", "Anna").lenient(true))
+            .should(new MatchQueryBuilder("first_name", "Anneke").lenient(true));
+        assertThat(actualLuceneQuery.toString(), is(expectedLuceneQuery.toString()));
+    }
+
     /**
      * Expecting
      * LimitExec[1000[INTEGER]]
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/180_match_operator.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/180_match_operator.yml
index 663c0dc78acb3..118783b412d48 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/180_match_operator.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/180_match_operator.yml
@@ -170,7 +170,7 @@ setup:
   - match: { error.reason: "Found 1 problem\nline 1:36: Unknown column [content], did you mean [count(*)]?" }
 
 ---
-"match with functions":
+"match with disjunctions":
   - do:
       catch: bad_request
       allowed_warnings_regex:
@@ -181,7 +181,20 @@ setup:
 
   - match: { status: 400 }
   - match: { error.type: verification_exception }
-  - match: { error.reason: "Found 1 problem\nline 1:19: Invalid condition [content:\"fox\" OR to_upper(content) == \"FOX\"]. [:] operator can't be used as part of an or condition" }
+  - match: { error.reason: "/.+Invalid\\ condition\\ \\[content\\:\"fox\"\\ OR\\ to_upper\\(content\\)\\ ==\\ \"FOX\"\\]\\./" }
+
+  - do:
+      catch: bad_request
+      allowed_warnings_regex:
+        - "No limit defined, adding default limit of \\[.*\\]"
+      esql.query:
+        body:
+          query: 'FROM test | WHERE content:"fox" OR to_upper(content) == "FOX"'
+
+  - match: { status: 400 }
+  - match: { error.type: verification_exception }
+  - match: { error.reason: "/.+Invalid\\ condition\\ \\[content\\:\"fox\"\\ OR\\ to_upper\\(content\\)\\ ==\\ \"FOX\"\\]\\./" }
+
 
 ---
 "match within eval":

From d118cbf529ec4da9f9d7378cb48e4355ee61c9ab Mon Sep 17 00:00:00 2001
From: Rene Groeschke <rene@elastic.co>
Date: Wed, 18 Dec 2024 09:22:08 +0100
Subject: [PATCH 058/119] [Build] Make ThirdPartyAudit task uptodate more
 effective (#118723)

We should basically be able to skip the third party dependency audit
tasks if no third party dependency has changed.

Filtering out the project dependencies allows way better uptodate and
caching behaviour. We are only interested in thirdparty libs anyhow in
this context.

A positive side effect of the reduced class path is a quicker execution
of the task
---
 .../ThirdPartyAuditPrecommitPlugin.java       |  9 +++--
 .../precommit/ThirdPartyAuditTask.java        | 15 ++------
 .../internal/util/DependenciesUtils.java      | 36 ++++++++++++++++---
 3 files changed, 41 insertions(+), 19 deletions(-)

diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditPrecommitPlugin.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditPrecommitPlugin.java
index e45a1d3dd25b1..7046a22204efa 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditPrecommitPlugin.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditPrecommitPlugin.java
@@ -16,12 +16,14 @@
 import org.gradle.api.Task;
 import org.gradle.api.artifacts.Configuration;
 import org.gradle.api.artifacts.component.ModuleComponentIdentifier;
+import org.gradle.api.file.FileCollection;
 import org.gradle.api.tasks.TaskProvider;
 
 import java.io.File;
 import java.nio.file.Path;
 
 import static org.elasticsearch.gradle.internal.util.DependenciesUtils.createFileCollectionFromNonTransitiveArtifactsView;
+import static org.elasticsearch.gradle.internal.util.DependenciesUtils.thirdPartyDependenciesView;
 import static org.elasticsearch.gradle.internal.util.ParamsUtils.loadBuildParams;
 
 public class ThirdPartyAuditPrecommitPlugin extends PrecommitPlugin {
@@ -47,7 +49,6 @@ public TaskProvider<? extends Task> createTask(Project project) {
                 project.getDependencies().add(JDK_JAR_HELL_CONFIG_NAME, elasticsearchCoreProject);
             }
         }
-
         TaskProvider<ExportElasticsearchBuildResourcesTask> resourcesTask = project.getTasks()
             .register("thirdPartyAuditResources", ExportElasticsearchBuildResourcesTask.class);
         Path resourcesDir = project.getBuildDir().toPath().resolve("third-party-audit-config");
@@ -59,9 +60,11 @@ public TaskProvider<? extends Task> createTask(Project project) {
         // usually only one task is created. but this construct makes our integTests easier to setup
         project.getTasks().withType(ThirdPartyAuditTask.class).configureEach(t -> {
             Configuration runtimeConfiguration = project.getConfigurations().getByName("runtimeClasspath");
+            FileCollection runtimeThirdParty = thirdPartyDependenciesView(runtimeConfiguration);
             Configuration compileOnly = project.getConfigurations()
                 .getByName(CompileOnlyResolvePlugin.RESOLVEABLE_COMPILE_ONLY_CONFIGURATION_NAME);
-            t.setClasspath(runtimeConfiguration.plus(compileOnly));
+            FileCollection compileOnlyThirdParty = thirdPartyDependenciesView(compileOnly);
+            t.getThirdPartyClasspath().from(runtimeThirdParty, compileOnlyThirdParty);
             t.getJarsToScan()
                 .from(
                     createFileCollectionFromNonTransitiveArtifactsView(
@@ -78,7 +81,7 @@ public TaskProvider<? extends Task> createTask(Project project) {
             t.getJavaHome().set(buildParams.flatMap(params -> params.getRuntimeJavaHome()).map(File::getPath));
             t.setSignatureFile(resourcesDir.resolve("forbidden/third-party-audit.txt").toFile());
             t.getJdkJarHellClasspath().from(jdkJarHellConfig);
-            t.getForbiddenAPIsClasspath().from(project.getConfigurations().getByName("forbiddenApisCliJar").plus(compileOnly));
+            t.getForbiddenAPIsClasspath().from(project.getConfigurations().getByName("forbiddenApisCliJar").plus(compileOnlyThirdParty));
         });
         return audit;
     }
diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditTask.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditTask.java
index 442797775de2f..59ba9bae0a57d 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditTask.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/precommit/ThirdPartyAuditTask.java
@@ -17,7 +17,6 @@
 import org.gradle.api.JavaVersion;
 import org.gradle.api.file.ArchiveOperations;
 import org.gradle.api.file.ConfigurableFileCollection;
-import org.gradle.api.file.FileCollection;
 import org.gradle.api.file.FileSystemOperations;
 import org.gradle.api.file.FileTree;
 import org.gradle.api.file.ProjectLayout;
@@ -96,8 +95,6 @@ public abstract class ThirdPartyAuditTask extends DefaultTask {
 
     private final ProjectLayout projectLayout;
 
-    private FileCollection classpath;
-
     @Inject
     public ThirdPartyAuditTask(
         ArchiveOperations archiveOperations,
@@ -198,9 +195,7 @@ public Set<String> getMissingClassExcludes() {
     public abstract Property<JavaVersion> getRuntimeJavaVersion();
 
     @Classpath
-    public FileCollection getClasspath() {
-        return classpath;
-    }
+    public abstract ConfigurableFileCollection getThirdPartyClasspath();
 
     @TaskAction
     public void runThirdPartyAudit() throws IOException {
@@ -345,7 +340,7 @@ private String runForbiddenAPIsCli() throws IOException {
             if (javaHome.isPresent()) {
                 spec.setExecutable(javaHome.get() + "/bin/java");
             }
-            spec.classpath(getForbiddenAPIsClasspath(), classpath);
+            spec.classpath(getForbiddenAPIsClasspath(), getThirdPartyClasspath());
             // Enable explicitly for each release as appropriate. Just JDK 20/21/22/23 for now, and just the vector module.
             if (isJavaVersion(VERSION_20) || isJavaVersion(VERSION_21) || isJavaVersion(VERSION_22) || isJavaVersion(VERSION_23)) {
                 spec.jvmArgs("--add-modules", "jdk.incubator.vector");
@@ -383,7 +378,7 @@ private boolean isJavaVersion(JavaVersion version) {
     private Set<String> runJdkJarHellCheck() throws IOException {
         ByteArrayOutputStream standardOut = new ByteArrayOutputStream();
         ExecResult execResult = execOperations.javaexec(spec -> {
-            spec.classpath(getJdkJarHellClasspath(), classpath);
+            spec.classpath(getJdkJarHellClasspath(), getThirdPartyClasspath());
             spec.getMainClass().set(JDK_JAR_HELL_MAIN_CLASS);
             spec.args(getJarExpandDir());
             spec.setIgnoreExitValue(true);
@@ -402,8 +397,4 @@ private Set<String> runJdkJarHellCheck() throws IOException {
         return new TreeSet<>(Arrays.asList(jdkJarHellCheckList.split("\\r?\\n")));
     }
 
-    public void setClasspath(FileCollection classpath) {
-        this.classpath = classpath;
-    }
-
 }
diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/util/DependenciesUtils.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/util/DependenciesUtils.java
index 9080f62f19937..5d7386e2c2150 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/util/DependenciesUtils.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/util/DependenciesUtils.java
@@ -9,12 +9,16 @@
 
 package org.elasticsearch.gradle.internal.util;
 
+import com.github.jengelman.gradle.plugins.shadow.ShadowBasePlugin;
+
 import org.gradle.api.artifacts.Configuration;
 import org.gradle.api.artifacts.ResolvableDependencies;
 import org.gradle.api.artifacts.component.ComponentIdentifier;
+import org.gradle.api.artifacts.component.ProjectComponentIdentifier;
 import org.gradle.api.artifacts.result.ResolvedComponentResult;
 import org.gradle.api.artifacts.result.ResolvedDependencyResult;
 import org.gradle.api.file.FileCollection;
+import org.gradle.api.provider.Provider;
 import org.gradle.api.specs.AndSpec;
 import org.gradle.api.specs.Spec;
 
@@ -29,7 +33,7 @@ public static FileCollection createFileCollectionFromNonTransitiveArtifactsView(
     ) {
         ResolvableDependencies incoming = configuration.getIncoming();
         return incoming.artifactView(viewConfiguration -> {
-            Set<ComponentIdentifier> firstLevelDependencyComponents = incoming.getResolutionResult()
+            Provider<Set<ComponentIdentifier>> firstLevelDependencyComponents = incoming.getResolutionResult()
                 .getRootComponent()
                 .map(
                     rootComponent -> rootComponent.getDependencies()
@@ -39,12 +43,36 @@ public static FileCollection createFileCollectionFromNonTransitiveArtifactsView(
                         .filter(dependency -> dependency.getSelected() instanceof ResolvedComponentResult)
                         .map(dependency -> dependency.getSelected().getId())
                         .collect(Collectors.toSet())
-                )
-                .get();
+                );
             viewConfiguration.componentFilter(
-                new AndSpec<>(identifier -> firstLevelDependencyComponents.contains(identifier), componentFilter)
+                new AndSpec<>(identifier -> firstLevelDependencyComponents.get().contains(identifier), componentFilter)
             );
         }).getFiles();
     }
 
+    /**
+     * This method gives us an artifact view of a configuration that filters out all
+     * project dependencies that are not shadowed jars.
+     * Basically a thirdparty only view of the dependency tree.
+     */
+    public static FileCollection thirdPartyDependenciesView(Configuration configuration) {
+        ResolvableDependencies incoming = configuration.getIncoming();
+        return incoming.artifactView(v -> {
+            // resolve componentIdentifier for all shadowed project dependencies
+            Provider<Set<ComponentIdentifier>> shadowedDependencies = incoming.getResolutionResult()
+                .getRootComponent()
+                .map(
+                    root -> root.getDependencies()
+                        .stream()
+                        .filter(dep -> dep instanceof ResolvedDependencyResult)
+                        .map(dep -> (ResolvedDependencyResult) dep)
+                        .filter(dep -> dep.getResolvedVariant().getDisplayName() == ShadowBasePlugin.COMPONENT_NAME)
+                        .filter(dep -> dep.getSelected() instanceof ResolvedComponentResult)
+                        .map(dep -> dep.getSelected().getId())
+                        .collect(Collectors.toSet())
+                );
+            // filter out project dependencies if they are not a shadowed dependency
+            v.componentFilter(i -> (i instanceof ProjectComponentIdentifier == false || shadowedDependencies.get().contains(i)));
+        }).getFiles();
+    }
 }

From 140beb11849b42ceae311b34f2865f3db68df578 Mon Sep 17 00:00:00 2001
From: Tommaso Teofili <tommaso.teofili@elastic.co>
Date: Wed, 18 Dec 2024 09:42:51 +0100
Subject: [PATCH 059/119] Make ES|QL scoring tests running consistently in
 serverless (#118854)

* make scoring tests running consistently in serverless

enforce _id in books dataset to make doc distribution across shards consistent.
books settings with 3 shards to accomodate serverless settings.
unmuting scoring tests.
scoring test fixed.
---
 muted-tests.yml                               |  18 --
 .../xpack/esql/CsvTestsDataLoader.java        |   2 +-
 .../src/main/resources/books-settings.json    |   5 +
 .../testFixtures/src/main/resources/books.csv | 160 +++++++++---------
 .../src/main/resources/scoring.csv-spec       | 104 ++++++------
 5 files changed, 140 insertions(+), 149 deletions(-)
 create mode 100644 x-pack/plugin/esql/qa/testFixtures/src/main/resources/books-settings.json

diff --git a/muted-tests.yml b/muted-tests.yml
index ef302671de998..2677b3e75d86e 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -153,24 +153,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/117473
 - class: org.elasticsearch.repositories.s3.RepositoryS3EcsClientYamlTestSuiteIT
   issue: https://github.com/elastic/elasticsearch/issues/117525
-- class: "org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT"
-  method: "test {scoring.*}"
-  issue: https://github.com/elastic/elasticsearch/issues/117641
-- class: "org.elasticsearch.xpack.esql.qa.single_node.EsqlSpecIT"
-  method: "test {scoring.*}"
-  issue: https://github.com/elastic/elasticsearch/issues/117641
-- class: "org.elasticsearch.xpack.esql.qa.mixed.MixedClusterEsqlSpecIT"
-  method: "test {scoring.*}"
-  issue: https://github.com/elastic/elasticsearch/issues/117641
-- class: "org.elasticsearch.xpack.esql.qa.mixed.MultiClusterEsqlSpecIT"
-  method: "test {scoring.*}"
-  issue: https://github.com/elastic/elasticsearch/issues/118460
-- class: "org.elasticsearch.xpack.esql.ccq.MultiClusterSpecIT"
-  method: "test {scoring.*}"
-  issue: https://github.com/elastic/elasticsearch/issues/118460
-- class: org.elasticsearch.xpack.esql.ccq.MultiClusterSpecIT
-  method: test {scoring.QstrWithFieldAndScoringSortedEval}
-  issue: https://github.com/elastic/elasticsearch/issues/117751
 - class: org.elasticsearch.search.ccs.CrossClusterIT
   method: testCancel
   issue: https://github.com/elastic/elasticsearch/issues/108061
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
index abfe90f80e372..8e81d14b4dfd7 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
@@ -104,7 +104,7 @@ public class CsvTestsDataLoader {
     private static final TestsDataset DISTANCES = new TestsDataset("distances");
     private static final TestsDataset K8S = new TestsDataset("k8s", "k8s-mappings.json", "k8s.csv").withSetting("k8s-settings.json");
     private static final TestsDataset ADDRESSES = new TestsDataset("addresses");
-    private static final TestsDataset BOOKS = new TestsDataset("books");
+    private static final TestsDataset BOOKS = new TestsDataset("books").withSetting("books-settings.json");
     private static final TestsDataset SEMANTIC_TEXT = new TestsDataset("semantic_text").withInferenceEndpoint(true);
 
     public static final Map<String, TestsDataset> CSV_DATASET_MAP = Map.ofEntries(
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books-settings.json b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books-settings.json
new file mode 100644
index 0000000000000..b324c27b40653
--- /dev/null
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books-settings.json
@@ -0,0 +1,5 @@
+{
+  "index": {
+    "number_of_shards": 3
+  }
+}
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books.csv
index 1deefaa3c6475..1cb01687e6511 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books.csv
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books.csv
@@ -1,80 +1,80 @@
-book_no:keyword,title:text,author:text,year:integer,publisher:text,ratings:float,description:text
-2924,A Gentle Creature and Other Stories: White Nights\, A Gentle Creature\, and The Dream of a Ridiculous Man (The World's Classics),[Fyodor Dostoevsky, Alan Myers, W. J. Leatherbarrow],2009,Oxford Paperbacks,4.00,In these stories Dostoevsky explores both the figure of the dreamer divorced from reality and also his own ambiguous attitude to utopianism\, themes central to many of his great novels. This new translation captures the power and lyricism of Dostoevsky's writing\, while the introduction examines the stories in relation to one another and to his novels.
-7670,A Middle English Reader and Vocabulary,[Kenneth Sisam, J. R. R. Tolkien],2011,Courier Corporation,4.33,This highly respected anthology of medieval English literature features poetry\, prose and popular tales from Arthurian legend and classical mythology. Includes notes on each extract\, appendices\, and an extensive glossary by J. R. R. Tolkien.
-7381,A Psychic in the Heartland: The Extraordinary Experiences of a Small Town Doctor,Bettilu Stein Faulkner,2003,Red Wheel/Weiser,4.50,The true story of a small-town doctor destined to live his life along two paths: one as a successful physician\, the other as a psychic with ever more interesting adventures. Experiencing a wide range of spiritual phenomena\, Dr. Riblet Hout learned about the connection between the healer and the healed\, our individual missions on earth\, free will\, and our relationship with God. He also paints a vivid picture of life on the other side as well as the moment of transition from physical life to afterlife.
-2883,A Summer of Faulkner: As I Lay Dying/The Sound and the Fury/Light in August (Oprah's Book Club),William Faulkner,2005,Vintage Books,3.89,Presents three novels\, including As I Lay Dying\, in which the Bundren family journeys across Mississippi to bury their mother\, The Sound and the Fury\, in which Caddy Compson's story is narrated by her three brothers\, and Light in August\, in which th
-4023,A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings,[Walter Scheps, Agnes Perkins, Charles Adolph Huttar, John Ronald Reuel Tolkien],1975,Open Court Publishing,4.67,The structure\, content\, and character of Tolkien's The Hobbit and The Lord of the Rings are dealt with in ten critical essays.
-2382,A Wizard of Earthsea (Earthsea Trilogy Ser.),Ursula K. Le Guin,1991,Atheneum Books for Young Readers,4.01,A boy grows to manhood while attempting to subdue the evil he unleashed on the world as an apprentice to the Master Wizard.
-7541,A Writer's Diary (Volume 1: 1873-1876),Fyodor Dostoevsky,1997,Northwestern University Press,4.50,Winner of the AATSEEL Outstanding Translation Award This is the first paperback edition of the complete collection of writings that has been called Dostoevsky's boldest experiment with literary form\, it is a uniquely encyclopedic forum of fictional and nonfictional genres. The Diary's radical format was matched by the extreme range of its contents. In a single frame it incorporated an astonishing variety of material: short stories\, humorous sketches\, reports on sensational crimes\, historical predictions\, portraits of famous people\, autobiographical pieces\, and plans for stories\, some of which were never written while others appeared in the Diary itself.
-7400,Anna Karenina: Television Tie-In Edition (Signet classics),[Leo Tolstoy, SBP Editors],2019,Samaira Book Publishers,4.45,The Russian novelist and moral philosopher Leo Tolstoy (1828-1910) ranks as one of the world s great writers\, and his 'War and Peace' has been called the greatest novel ever written. But during his long lifetime\, Tolstoy also wrote enough shorter works to fill many volumes. The message in all his stories is presented with such humour that the reader hardly realises that it is strongly didactic. These stories give a snapshot of Russia and its people in the late nineteenth century.
-4917,Autumn of the Patriarch,Gabriel Garcia Marquez,2014,Penguin UK,4.33,Gabriel Garcia Marquez\, winner of the 1982 Nobel Prize for Literature and author of One Hundred Years of Solitude\, explores the loneliness of power in Autumn of the Patriarch. 'Over the weekend the vultures got into the presidential palace by pecking through the screens on the balcony windows and the flapping of their wings stirred up the stagnant time inside' As the citizens of an unnamed Caribbean nation creep through dusty corridors in search of their tyrannical leader\, they cannot comprehend that the frail and withered man lying dead on the floor can be the self-styled General of the Universe. Their arrogant\, manically violent leader\, known for serving up traitors to dinner guests and drowning young children at sea\, can surely not die the humiliating death of a mere mortal? Tracing the demands of a man whose egocentric excesses mask the loneliness of isolation and whose lies have become so ingrained that they are indistinguishable from truth\, Marquez has created a fantastical portrait of despotism that rings with an air of reality. 'Delights with its quirky humanity and black humour and impresses by its total originality' Vogue 'Captures perfectly the moral squalor and political paralysis that enshrouds a society awaiting the death of a long-term dictator' Guardian 'Marquez writes in this lyrical\, magical language that no-one else can do' Salman Rushdie
-9896,Barn burning (A tale blazer book),William Faulkner,1979,Perfection Learning,3.50,Reprinted from Collected Stories of William Faulkner\, by permission of Random House\, Inc.
-9607,Beowolf: The monsters and the critics,John Ronald Reuel Tolkien,1997,HarperCollins UK,4.12,A collection of seven essays by J.R.R. Tolkien arising out of Tolkien's work in medieval literature
-1985,Brothers Karamazov,Fyodor Dostoevsky,2015,First Avenue Editions,5.00,Four brothers reunite in their hometown in Russia. The murder of their father forces the brothers to question their beliefs about each other\, religion\, and morality.
-2713,Collected Stories of William Faulkner,William Faulkner,1995,Vintage,4.53,A collection of short stories focuses on the people of rural Mississippi
-2464,Conversations with Kurt Vonnegut (Literary Conversations),Kurt Vonnegut,1988,Univ. Press of Mississippi,4.40,Gathers interviews with Vonnegut from each period of his career and offers a brief profile of his life and accomplishments
-8534,Crime and Punishment (Oxford World's Classics),Fyodor Dostoevsky,2017,Oxford University Press,4.38,'One death\, in exchange for thousands of lives - it's simple arithmetic!' A new translation of Dostoevsky's epic masterpiece\, Crime and Punishment (1866). The impoverished student Raskolnikov decides to free himself from debt by killing an old moneylender\, an act he sees as elevating himself above conventional morality. Like Napoleon he will assert his will and his crime will be justified by its elimination of 'vermin' for the sake of the greater good. But Raskolnikov is torn apart by fear\, guilt\, and a growing conscience under the influence of his love for Sonya. Meanwhile the police detective Porfiry is on his trial. It is a powerfully psychological novel\, in which the St Petersburg setting\, Dostoevsky's own circumstances\, and contemporary social problems all play their part.
-8605,Dead Souls,Nikolai Gogol,1997,Vintage,4.28,Chichikov\, an amusing and often confused schemer\, buys deceased serfs' names from landholders' poll tax lists hoping to mortgage them for profit
-6970,Domestic Goddesses,Edith Vonnegut,1998,Pomegranate,4.67,In this immensely charming and insightful book\, artist Edith Vonnegut takes issue with traditional art imagery in which women are shown as weak and helpless. Through twenty-seven of her own paintings interspersed with her text\, she poignantly -- and humorously -- illustrates her maxim that the lives of mothers and homemakers are filled with endless challenges and vital decisions that should be portrayed with the dignity they deserve. In Vonnegut's paintings\, one woman bravely blocks the sun from harming a child (Sun Block) while another vacuums the stairs with angelic figures singing her praises (Electrolux). In contrasting her own Domestic Goddesses with the diaphanous women of classical art (seven paintings by masters such as Titian and Botticelli are included)\, she 'expresses the importance of traditional roles of women so cleverly and with such joy that her message and images will be forever emblazoned on our collective psyche.
-4814,El Coronel No Tiene Quien Le Escriba / No One Writes to the Colonel (Spanish Edition),Gabriel Garcia Marquez,2005,Harper Collins,4.45,Written with compassionate realism and wit\, the stories in this mesmerizing collection depict the disparities of town and village life in South America\, of the frightfully poor and outrageously rich\, of memories and illusions\, and of lost opportunities and present joys.
-4636,FINAL WITNESS,Simon Tolkien,2004,Random House Digital\, Inc.,3.94,The murder of Lady Anne Robinson by two intruders causes a schism in the victim's family when her son convinces police that his father's beautiful personal assistant hired the killers\, while his father\, the British minister of defense\, refuses to believe his son and marries the accused. A first novel. Reprint.
-2936,Fellowship of the Ring 2ND Edition,John Ronald Reuel Tolkien,2008,HarperCollins UK,4.43,Sauron\, the Dark Lord\, has gathered to him all the Rings of Power - the means by which he intends to rule Middle-earth. All he lacks in his plans for dominion is the One Ring - the ring that rules them all - which has fallen into the hands of the hobbit\, Bilbo Baggins. In a sleepy village in the Shire\, young Frodo Baggins finds himself faced with an immense task\, as his elderly cousin Bilbo entrusts the Ring to his care. Frodo must leave his home and make a perilous journey across Middle-earth to the Cracks of Doom\, there to destroy the Ring and foil the Dark Lord in his evil purpose. JRR Tolkien's great work of imaginative fiction has been labelled both a heroic romance and a classic fantasy fiction. By turns comic and homely\, epic and diabolic\, the narrative moves through countless changes of scene and character in an imaginary world which is totally convincing in its detail.
-8956,GOD BLESS YOU MR. ROSEWATER : Or Pearls Before Swine,Kurt Vonnegut,1970,New York : Dell,4.00,A lawyer schemes to gain control of a large fortune by having the present claimant declared insane.
-6818,Hadji Murad,Leo Tolstoy,2022,Hachette UK,3.88,'How truth thickens and deepens when it migrates from didactic fable to the raw experience of a visceral awakening is one of the thrills of Tolstoy's stories' Sharon Cameron in her preface to Hadji Murad and Other Stories This\, the third volume of Tolstoy's shorter fiction concentrates on his later stories\, including one of his greatest\, 'Hadji Murad'. In the stark form of homily that shapes these later works\, life considered as one's own has no rational meaning. From the chain of events that follows in the wake of two schoolboys' deception in 'The Forged Coupon' to the disillusionment of the narrator in 'After the Ball' we see\, in Virginia Woolf's observation\, that Tolstoy puts at the centre of his writing one 'who gathers into himself all experience\, turns the world round between his fingers\, and never ceases to ask\, even as he enjoys it\, what is the meaning of it'. The riverrun edition reissues the translation of Louise and Aylmer Maude\, whose influential versions of Tolstoy first brought his work to a wide readership in English.
-3950,Hocus,Kurt Vonnegut,1997,Penguin,4.67,Tarkington College\, a small\, exclusive college in upstate New York\, is turned upside down when ten thousand prisoners from the maximum security prison across Lake Mohiga break out and head for the college
-5404,Intruder in the dust,William Faulkner,2011,Vintage,3.18,A classic Faulkner novel which explores the lives of a family of characters in the South. An aging black who has long refused to adopt the black's traditionally servile attitude is wrongfully accused of murdering a white man.
-5578,Intruder in the dust: A novel,William Faulkner,1991,Vintage,3.18,Dramatizes the events that surround the murder of a white man in a volatile Southern community
-6380,La hojarasca (Spanish Edition),Gabriel Garcia Marquez,1979,Harper Collins,3.75,Translated from the Spanish by Gregory Rabassa
-5335,Letters of J R R Tolkien,J.R.R. Tolkien,2014,HarperCollins,4.70,This collection will entertain all who appreciate the art of masterful letter writing. The Letters of J.R.R Tolkien sheds much light on Tolkien's creative genius and grand design for the creation of a whole new world: Middle-earth. Featuring a radically expanded index\, this volume provides a valuable research tool for all fans wishing to trace the evolution of THE HOBBIT and THE LORD OF THE RINGS.
-3870,My First 100 Words in Spanish/English (My First 100 Words Pull-Tab Book),Keith Faulkner,1998,Libros Para Ninos,4.50,Learning a foreign language has never been this much fun! Just pull the sturdy tabs and change the words under the pictures from English to Spanish and back again to English!
-4502,O'Brian's Bride,Colleen Faulkner,1995,Zebra Books,5.00,Abandoning her pampered English life to marry a man in the American colonies\, Elizabeth finds her new world shattered when her husband is killed in an accident\, leaving her in charge of a business on the untamed frontier. Original.
-7635,Oliphaunt (Beastly Verse),J. R. R. Tolkien,1989,Contemporary Books,2.50,A poem in which an elephant describes himself and his way of life. On board pages.
-3254,Pearl and Sir Orfeo,[John Ronald Reuel Tolkien, Christopher Tolkien],1995,Harpercollins Pub Limited,5.00,Three epic poems from 14th century England speak of life during the age of chivalry. Translated from medieval English.
-3677,Planet of Exile,Ursula K. Le Guin,1979,Orion,4.20,PLAYAWAY: An alliance between the powerful Tevars and the brown-skinned\, clairvoyant Farbons must take place if the two colonies are to withstand the fierce attack of the nomadic tribes from the north of the planet Eltanin.
-4289,Poems from the Hobbit,J R R Tolkien,1999,HarperCollins Publishers,4.00,A collection of J.R.R. Tolkien's Hobbit poems in a miniature hardback volume complete with illustrations by Tolkien himself. Far over misty mountains cold To dungeons deep and caverns old We must away ere break of day To seek the pale enchanted gold. J.R.R. Tolkien's acclaimed The Hobbit contains 12 poems which are themselves masterpieces of writing. This miniature book\, illustrated with 30 of Tolkien's own paintings and drawings from the book -- some quite rare and all in full colour -- includes all the poems\, plus Gollum's eight riddles in verse\, and will be a perfect keepsake for lovers of The Hobbit and of accomplished poetry.
-6151,Pop! Went Another Balloon: A Magical Counting Storybook (Magical Counting Storybooks),[Keith Faulkner, Rory Tyger],2003,Dutton Childrens Books,5.00,Toby the turtle goes from in-line skates to a motorcycle to a rocketship with a handful of balloons that pop\, one by one\, along the way.
-3535,Rainbow's End: A Magical Story and Moneybox,[Keith Faulkner, Beverlie Manson],2003,Barrons Juveniles,4.00,In this combination picture storybook and coin bank\, the unusual front cover shows an illustration from the story that's embellished with five transparent plastic windows. Opening the book\, children will find a story about a poor little ballerina who is crying because her dancing shoes are worn and she has no money to replace them. Full color. Consumable.
-8423,Raising Faithful Kids in a Fast-Paced World,Paul Faulkner,1995,Howard Publishing Company,5.00,To find help for struggling parents\, Dr. Paul Faulkner--renowned family counselor and popular speaker--interviewed 30 successful families who have managed to raise faithful kids while also maintaining demanding careers. The invaluable strategies and methods he gleaned are now available in this powerful book delivered in Dr. Faulkner's warm\, humorous style.
-1463,Realms of Tolkien: Images of Middle-earth,J. R. R. Tolkien,1997,HarperCollins Publishers,4.00,Twenty new and familiar Tolkien artists are represented in this fabulous volume\, breathing an extraordinary variety of life into 58 different scenes\, each of which is accompanied by appropriate passage from The Hobbit and The Lord of the Rings and The Silmarillion
-6323,Resurrection (The Penguin classics),Leo Tolstoy,2009,Penguin,3.25,Leo Tolstoy's last completed novel\, Resurrection is an intimate\, psychological tale of guilt\, anger and forgiveness Serving on the jury at a murder trial\, Prince Dmitri Nekhlyudov is devastated when he sees the prisoner - Katyusha\, a young maid he seduced and abandoned years before. As Dmitri faces the consequences of his actions\, he decides to give up his life of wealth and luxury to devote himself to rescuing Katyusha\, even if it means following her into exile in Siberia. But can a man truly find redemption by saving another person? Tolstoy's most controversial novel\, Resurrection (1899) is a scathing indictment of injustice\, corruption and hypocrisy at all levels of society. Creating a vast panorama of Russian life\, from peasants to aristocrats\, bureaucrats to convicts\, it reveals Tolstoy's magnificent storytelling powers. Anthony Briggs' superb new translation preserves Tolstoy's gripping realism and satirical humour. In his introduction\, Briggs discusses the true story behind Resurrection\, Tolstoy's political and religious reasons for writing the novel\, his gift for characterization and the compelling psychological portrait of Dmitri. This edition also includes a chronology\, notes and a summary of chapters. For more than seventy years\, Penguin has been the leading publisher of classic literature in the English-speaking world. With more than 1\,700 titles\, Penguin Classics represents a global bookshelf of the best works throughout history and across genres and disciplines. Readers trust the series to provide authoritative texts enhanced by introductions and notes by distinguished scholars and contemporary authors\, as well as up-to-date translations by award-winning translators.
-2714,Return of the King Being the Third Part of The Lord of the Rings,J. R. R. Tolkien,2012,HarperCollins,4.60,Concluding the story begun in The Hobbit\, this is the final part of Tolkien s epic masterpiece\, The Lord of the Rings\, featuring an exclusive cover image from the film\, the definitive text\, and a detailed map of Middle-earth. The armies of the Dark Lord Sauron are massing as his evil shadow spreads ever wider. Men\, Dwarves\, Elves and Ents unite forces to do battle agains the Dark. Meanwhile\, Frodo and Sam struggle further into Mordor in their heroic quest to destroy the One Ring. The devastating conclusion of J.R.R. Tolkien s classic tale of magic and adventure\, begun in The Fellowship of the Ring and The Two Towers\, features the definitive edition of the text and includes the Appendices and a revised Index in full. To celebrate the release of the first of Peter Jackson s two-part film adaptation of The Hobbit\, THE HOBBIT: AN UNEXPECTED JOURNEY\, this third part of The Lord of the Rings is available for a limited time with an exclusive cover image from Peter Jackson s award-winning trilogy.
-7350,Return of the Shadow,[John Ronald Reuel Tolkien, Christopher Tolkien],2000,Mariner Books,5.00,In this sixth volume of The History of Middle-earth the story reaches The Lord of the Rings. In The Return of the Shadow (an abandoned title for the first volume) Christopher Tolkien describes\, with full citation of the earliest notes\, outline plans\, and narrative drafts\, the intricate evolution of The Fellowship of the Ring and the gradual emergence of the conceptions that transformed what J.R.R. Tolkien for long believed would be a far shorter book\, 'a sequel to The Hobbit'. The enlargement of Bilbo's 'magic ring' into the supremely potent and dangerous Ruling Ring of the Dark Lord is traced and the precise moment is seen when\, in an astonishing and unforeseen leap in the earliest narrative\, a Black Rider first rode into the Shire\, his significance still unknown. The character of the hobbit called Trotter (afterwards Strider or Aragorn) is developed while his indentity remains an absolute puzzle\, and the suspicion only very slowly becomes certainty that he must after all be a Man. The hobbits\, Frodo's companions\, undergo intricate permutations of name and personality\, and other major figures appear in strange modes: a sinister Treebeard\, in league with the Enemy\, a ferocious and malevolent Farmer Maggot. The story in this book ends at the point where J.R.R. Tolkien halted in the story for a long time\, as the Company of the Ring\, still lacking Legolas and Gimli\, stood before the tomb of Balin in the Mines of Moria. The Return of the Shadow is illustrated with reproductions of the first maps and notable pages from the earliest manuscripts.
-6760,Roverandom,J. R. R. Tolkien,1999,Mariner Books,4.38,Rover\, a dog who has been turned into a toy dog encounters rival wizards and experiences various adventures on the moon with giant spiders\, dragon moths\, and the Great White Dragon. By the author of The Hobbit. Reprint.
-8873,Searoad: Chronicles of Klatsand,Ursula K. Le Guin,2004,Shambhala Publications,5.00,A series of interlinking tales and a novella by the author of the Earthsea trilogy portrays the triumphs and struggles of several generations of women who independently control Klatsand\, a small resort town on the Oregon coast. Reprint.
-2378,Selected Letters of Lucretia Coffin Mott (Women in American History),[Lucretia Mott, Holly Byers Ochoa, Carol Faulkner],2002,University of Illinois Press,5.00,Dedicated to reform of almost every kind - temperance\, peace\, equal rights\, woman suffrage\, nonresistance\, and the abolition of slavery - Mott viewed women's rights as only one element of a broad-based reform agenda for American society.
-1502,Selected Passages from Correspondence with Friends,Nikolai Vasilevich Gogol,2009,Vanderbilt University Press,4.00,Nikolai Gogol wrote some letters to his friends\, none of which were a nose of high rank. Many are reproduced here (the letters\, not noses).
-5996,Smith of Wooten Manor & Farmer Giles of Ham,John Ronald Reuel Tolkien,1969,Del Rey,4.91,Two bewitching fantasies by J.R.R. Tolkien\, beloved author of THE HOBBIT. In SMITH OF WOOTTON MAJOR\, Tolkien explores the gift of fantasy\, and what it means to the life and character of the man who receives it. And FARMER GILES OF HAM tells a delightfully ribald mock-heroic tale\, where a dragon who invades a town refuses to fight\, and a farmer is chosen to slay him.
-2301,Smith of Wootton Major & Farmer Giles of Ham,John Ronald Reuel Tolkien,1969,Del Rey,5.00,Two bewitching fantasies by J.R.R. Tolkien\, beloved author of THE HOBBIT. In SMITH OF WOOTTON MAJOR\, Tolkien explores the gift of fantasy\, and what it means to the life and character of the man who receives it. And FARMER GILES OF HAM tells a delightfully ribald mock-heroic tale\, where a dragon who invades a town refuses to fight\, and a farmer is chosen to slay him.
-2236,Steering the Craft,Ursula K. Le Guin,2015,Houghton Mifflin Harcourt,4.73,A revised and updated guide to the essentials of a writer's craft\, presented by a brilliant practitioner of the art Completely revised and rewritten to address the challenges and opportunities of the modern era\, this handbook is a short\, deceptively simple guide to the craft of writing. Le Guin lays out ten chapters that address the most fundamental components of narrative\, from the sound of language to sentence construction to point of view. Each chapter combines illustrative examples from the global canon with Le Guin's own witty commentary and an exercise that the writer can do solo or in a group. She also offers a comprehensive guide to working in writing groups\, both actual and online. Masterly and concise\, Steering the Craft deserves a place on every writer's shelf.
-4724,THE UNVANQUISHED,William Faulkner,2011,Vintage,3.50,Set in Mississippi during the Civil War and Reconstruction\, THE UNVANQUISHED focuses on the Sartoris family\, who\, with their code of personal responsibility and courage\, stand for the best of the Old South's traditions.
-5948,That We Are Gentle Creatures,Fyodor Dostoevsky,2009,OUP Oxford,4.33,In the stories in this volume Dostoevsky explores both the figure of the dreamer divorced from reality and also his own ambiguous attitude to utopianism\, themes central to many of his great novels. In White Nights the apparent idyll of the dreamer's romantic fantasies disguises profound loneliness and estrangement from 'living life'. Despite his sentimental friendship with Nastenka\, his final withdrawal into the world of the imagination anticipates the retreat into the 'underground' of many of Dostoevsky's later intellectual heroes. A Gentle Creature and The Dream of a Ridiculous Man show how such withdrawal from reality can end in spiritual desolation and moral indifference and how\, in Dostoevsky's view\, the tragedy of the alienated individual can be resolved only by the rediscovery of a sense of compassion and responsibility towards fellow human beings. This new translation captures the power and lyricism of Dostoevsky's writing\, while the introduction examines the stories in relation to one another and to his novels. ABOUT THE SERIES: For over 100 years Oxford World's Classics has made available the widest range of literature from around the globe. Each affordable volume reflects Oxford's commitment to scholarship\, providing the most accurate text plus a wealth of other valuable features\, including expert introductions by leading authorities\, helpful notes to clarify the text\, up-to-date bibliographies for further study\, and much more.
-1937,The Best Short Stories of Dostoevsky (Modern Library),Fyodor Dostoevsky,2012,Modern Library,4.33,This collection\, unique to the Modern Library\, gathers seven of Dostoevsky's key works and shows him to be equally adept at the short story as with the novel. Exploring many of the same themes as in his longer works\, these small masterpieces move from the tender and romantic White Nights\, an archetypal nineteenth-century morality tale of pathos and loss\, to the famous Notes from the Underground\, a story of guilt\, ineffectiveness\, and uncompromising cynicism\, and the first major work of existential literature. Among Dostoevsky's prototypical characters is Yemelyan in The Honest Thief\, whose tragedy turns on an inability to resist crime. Presented in chronological order\, in David Magarshack's celebrated translation\, this is the definitive edition of Dostoevsky's best stories.
-2776,The Devil and Other Stories (Oxford World's Classics),Leo Tolstoy,2003,OUP Oxford,5.00,'It is impossible to explain why Yevgeny chose Liza Annenskaya\, as it is always impossible to explain why a man chooses this and not that woman.' This collection of eleven stories spans virtually the whole of Tolstoy's creative life. While each is unique in form\, as a group they are representative of his style\, and touch on the central themes that surface in War and Peace and Anna Karenina. Stories as different as 'The Snowstorm'\, 'Lucerne'\, 'The Diary of a Madman'\, and 'The Devil' are grounded in autobiographical experience. They deal with journeys of self-discovery and the moral and religious questioning that characterizes Tolstoy's works of criticism and philosophy. 'Strider' and 'Father Sergy'\, as well as reflecting Tolstoy's own experiences\, also reveal profound psychological insights. These stories range over much of the Russian world of the nineteenth century\, from the nobility to the peasantry\, the military to the clergy\, from merchants and cobblers to a horse and a tree. Together they present a fascinating picture of Tolstoy's skill and artistry. ABOUT THE SERIES: For over 100 years Oxford World's Classics has made available the widest range of literature from around the globe. Each affordable volume reflects Oxford's commitment to scholarship\, providing the most accurate text plus a wealth of other valuable features\, including expert introductions by leading authorities\, helpful notes to clarify the text\, up-to-date bibliographies for further study\, and much more.
-4231,The Dispossessed,Ursula K. Le Guin,1974,Harpercollins,4.26,Frequently reissued with the same ISBN\, but with slightly differing bibliographical details.
-7480,The Hobbit,J. R. R. Tolkien,2012,Mariner Books,4.64,Celebrating 75 years of one of the world's most treasured classics with an all new trade paperback edition. Repackaged with new cover art. 500\,000 first printing.
-6405,The Hobbit or There and Back Again,J. R. R. Tolkien,2012,Mariner Books,4.63,Celebrating 75 years of one of the world's most treasured classics with an all new trade paperback edition. Repackaged with new cover art. 500\,000 first printing.
-2540,The Inspector General (Language - Russian) (Russian Edition),[Nicolai Gogol, Thomas Seltzer],2014,CreateSpace,3.50,The Inspector-General is a national institution. To place a purely literary valuation upon it and call it the greatest of Russian comedies would not convey the significance of its position either in Russian literature or in Russian life itself. There is no other single work in the modern literature of any language that carries with it the wealth of associations which the Inspector-General does to the educated Russian.
-2951,The Insulted and Injured,Fyodor Dostoevsky,2011,Wm. B. Eerdmans Publishing,4.00,The Insulted and Injured\, which came out in 1861\, was Fyodor Dostoevsky's first major work of fiction after his Siberian exile and the first of the long novels that made him famous. Set in nineteenth-century Petersburg\, this gripping novel features a vividly drawn set of characters - including Vanya (Dostoevsky's semi-autobiographical hero)\, Natasha (the woman he loves)\, and Alyosha (Natasha's aristocratic lover) - all suffering from the cruelly selfish machinations of Alyosha's father\, the dark and powerful Prince Valkovsky. Boris Jakim's fresh English-language rendering of this gem in the Doestoevsky canon is both more colorful and more accurate than any earlier translation. --from back cover.
-2130,The J. R. R. Tolkien Audio Collection,[John Ronald Reuel Tolkien, Christopher Tolkien],2002,HarperCollins Publishers,4.89,For generations\, J R R Tolkien's words have brought to thrilling life a world of hobbits\, magic\, and historic myth\, woken from its foggy slumber within our minds. Here\, he tells the tales in his own voice.
-9801,The Karamazov Brothers (Oxford World's Classics),Fyodor Dostoevsky,2008,Oxford University Press,4.40,A remarkable work showing the author's power to depict Russian character and his understanding of human nature. Driven by intense\, uncontrollable emotions of rage and revenge\, the four Karamazov brothers all become involved in the brutal murder of their despicable father.
-5469,The Lays of Beleriand,[John Ronald Reuel Tolkien, Christopher Tolkien],2002,Harpercollins Pub Limited,4.42,The third volume that contains the early myths and legends which led to the writing of Tolkien's epic tale of war\, The Silmarillion. This\, the third volume of The History of Middle-earth\, gives us a priviledged insight into the creation of the mythology of Middle-earth\, through the alliterative verse tales of two of the most crucial stories in Tolkien's world -- those of Turien and Luthien. The first of the poems is the unpublished Lay of The Children of Hurin\, narrating on a grand scale the tragedy of Turin Turambar. The second is the moving Lay of Leithian\, the chief source of the tale of Beren and Luthien in The Silmarillion\, telling of the Quest of the Silmaril and the encounter with Morgoth in his subterranean fortress. Accompanying the poems are commentaries on the evolution of the history of the Elder Days. Also included is the notable criticism of The Lay of The Leithian by CS Lewis\, who read the poem in 1929.
-2675,The Lord of the Rings - Boxed Set,J.R.R. Tolkien,2012,HarperCollins,4.56,This beautiful gift edition of The Hobbit\, J.R.R. Tolkien's classic prelude to his Lord of the Rings trilogy\, features cover art\, illustrations\, and watercolor paintings by the artist Alan Lee. Bilbo Baggins is a hobbit who enjoys a comfortable\, unambitious life\, rarely traveling any farther than his pantry or cellar. But his contentment is disturbed when the wizard Gandalf and a company of dwarves arrive on his doorstep one day to whisk him away on an adventure. They have launched a plot to raid the treasure hoard guarded by Smaug the Magnificent\, a large and very dangerous dragon. Bilbo reluctantly joins their quest\, unaware that on his journey to the Lonely Mountain he will encounter both a magic ring and a frightening creature known as Gollum. Written for J.R.R. Tolkien's own children\, The Hobbit has sold many millions of copies worldwide and established itself as a modern classic.
-7140,The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1),[J. R. R. Tolkien, Alan Lee],2002,HarperSport,4.75,A selection of stunning poster paintings from the celebrated Tolkien artist Alan Lee - the man behind many of the striking images from The Lord of The Rings movie. The 50 paintings contained within the centenary edition of The Lord of the Rings in 1992 have themselves become classics and Alan Lee's interpretations are hailed as the most faithful to Tolkien's own vision. This new poster collection\, a perfect complement to volume one\, reproduces six more of the most popular paintings from the book in a format suitable either for hanging as posters or mounting and framing.
-5127,The Overcoat, Nikolai Gogol,1992,Courier Corporation,3.75,Four short stories include a satirical tale of Russian bureaucrats and a portrayal of an elderly couple living in the secluded countryside.
-8875,The Two Towers,John Ronald Reuel Tolkien,2007,HarperCollins UK,4.64,The second volume in The Lord of the Rings\, This title is also available as a film.
-4977,The Unvanquished,William Faulkner,2011,Vintage,3.50,Set in Mississippi during the Civil War and Reconstruction\, THE UNVANQUISHED focuses on the Sartoris family\, who\, with their code of personal responsibility and courage\, stand for the best of the Old South's traditions.
-4382,The Wolves of Witchmaker,Carole Guinane,2001,iUniverse,5.00,Polly Lavender is mysteriously lured onto Witchmaker's grounds along with her best friends Tony Rico\, Gracie Reene\, and Zeus\, the wolf they rescued as a pup. The three must quickly learn to master the art of magic because they have been chosen to lead Witchmaker Prep against a threat that has grim consequences.
-7912,The Word For World is Forest,Ursula K. Le Guin,2015,Gollancz,4.22,When the inhabitants of a peaceful world are conquered by the bloodthirsty yumens\, their existence is irrevocably altered. Forced into servitude\, the Athsheans find themselves at the mercy of their brutal masters. Desperation causes the Athsheans\, led by Selver\, to retaliate against their captors\, abandoning their strictures against violence. But in defending their lives\, they have endangered the very foundations of their society. For every blow against the invaders is a blow to the humanity of the Athsheans. And once the killing starts\, there is no turning back.
-1211,The brothers Karamazov,Fyodor Dostoevsky,2003,Bantam Classics,1.00,In 1880 Dostoevsky completed The Brothers Karamazov\, the literary effort for which he had been preparing all his life. Compelling\, profound\, complex\, it is the story of a patricide and of the four sons who each had a motive for murder: Dmitry\, the sensualist\, Ivan\, the intellectual\, Alyosha\, the mystic\, and twisted\, cunning Smerdyakov\, the bastard child. Frequently lurid\, nightmarish\, always brilliant\, the novel plunges the reader into a sordid love triangle\, a pathological obsession\, and a gripping courtroom drama. But throughout the whole\, Dostoevsky searhes for the truth--about man\, about life\, about the existence of God. A terrifying answer to man's eternal questions\, this monumental work remains the crowning achievement of perhaps the finest novelist of all time. From the Paperback edition.
-8086,The grand inquisitor (Milestones of thought),Fyodor Dostoevsky,1981,A&C Black,4.09,Dostoevsky's portrayal of the Catholic Church during the Inquisition is a plea for the power of pure faith\, and a critique of the tyrannies of institutionalized religion. This is an except from the Brothers Karamazov which stands alone as a statement of philiosophy and a warning about the surrender of freedom for the sake of comfort.
-8077,The unvanquished,William Faulkner,2011,Vintage,4.00,Set in Mississippi during the Civil War and Reconstruction\, THE UNVANQUISHED focuses on the Sartoris family\, who\, with their code of personal responsibility and courage\, stand for the best of the Old South's traditions.
-8480,The wind's twelve quarters: Short stories,Ursula K. Le Guin,2017,HarperCollins,5.00,The recipient of numerous literary prizes\, including the National Book Award\, the Kafka Award\, and the Pushcart Prize\, Ursula K. Le Guin is renowned for her lyrical writing\, rich characters\, and diverse worlds. The Wind's Twelve Quarters collects seventeen powerful stories\, each with an introduction by the author\, ranging from fantasy to intriguing scientific concepts\, from medieval settings to the future. Including an insightful foreword by Le Guin\, describing her experience\, her inspirations\, and her approach to writing\, this stunning collection explores human values\, relationships\, and survival\, and showcases the myriad talents of one of the most provocative writers of our time.
-2847,To Love A Dark Stranger (Lovegram Historical Romance),Colleen Faulkner,1997,Zebra Books,5.00,Bestselling author Colleen Faulkner's tumultuous saga of royal intrigue and forbidden desire sweeps from the magnificent estates of the aristocracy to the shadowy streets of London to King Charles II's glittering Restoration court.
-3293,Universe by Design,Danny Faulkner,2004,New Leaf Publishing Group,4.25,Views the stars and planets from a creationist standpoint\, addresses common misconceptions and difficulties about relativity and cosmology\, and discusses problems with the big bang theory with many analogies\, examples\, diagrams\, and illustrations. Original.
-5327,War and Peace,Leo Tolstoy,2016,Lulu.com,3.84,Covering the period from the French invasion under Napoleon into Russia. Although not covering solely the war itself\, the serialized novel does cover the effects the war had on Russian society from the common person right up to the Tsar himself. The book starts to move more to a philosophical consideration on war and peace near the end making the book as a whole an important piece of literature.
-4536,War and Peace (Signet Classics),[Leo Tolstoy, Pat Conroy, John Hockenberry],2012,Signet Classics,4.75,Presents the classical epic of the Napoleonic Wars and their effects on four Russian families.
-9032,War and Peace: A Novel (6 Volumes),Tolstoy Leo,2013,Hardpress Publishing,3.81,Unlike some other reproductions of classic texts (1) We have not used OCR(Optical Character Recognition)\, as this leads to bad quality books with introduced typos. (2) In books where there are images such as portraits\, maps\, sketches etc We have endeavoured to keep the quality of these images\, so they represent accurately the original artefact. Although occasionally there may be certain imperfections with these old texts\, we feel they deserve to be made available for future generations to enjoy.
-5119,William Faulkner,William Faulkner,2011,Vintage,4.00,This invaluable volume\, which has been republished to commemorate the one-hundredth anniversary of Faulkner's birth\, contains some of the greatest short fiction by a writer who defined the course of American literature. Its forty-five stories fall into three categories: those not included in Faulkner's earlier collections\, previously unpublished short fiction\, and stories that were later expanded into such novels as The Unvanquished\, The Hamlet\, and Go Down\, Moses. With its Introduction and extensive notes by the biographer Joseph Blotner\, Uncollected Stories of William Faulkner is an essential addition to its author's canon--as well as a book of some of the most haunting\, harrowing\, and atmospheric short fiction written in the twentieth century.
-8615,Winter notes on summer impressions,Fyodor Dostoevsky,2018,Alma Books,4.75,In June 1862\, Dostoevsky left Petersburg on his first excursion to Western Europe. Ostensibly making the trip to consult Western specialists about his epilepsy\, he also wished to see first-hand the source of the Western ideas he believed were corrupting Russia. Over the course of his journey he visited a number of major cities\, including Berlin\, Paris\, London\, Florence\, Milan and Vienna.His record of the trip\, Winter Notes on Summer Impressions - first published in the February 1863 issue of Vremya\, the periodical he edited - is the chrysalis out of which many elements of his later masterpieces developed.
-6478,Woman-The Full Story: A Dynamic Celebration of Freedoms,Michele Guinness,2003,Zondervan,5.00,What does it mean to be a woman today? What have women inherited from their radical\, risk-taking sisters of the past? And how does God view this half of humanity? Michele Guinness invites us on an adventure of discovery\, exploring the biblical texts\, the annals of history and the experiences of women today in search of the challenges and achievements\, failures and joys\, of women throughout the ages.
-8678,Worlds of Exile and Illusion: Three Complete Novels of the Hainish Series in One Volume--Rocannon's World\, Planet of Exile\, City of Illusions,Ursula K. Le Guin,2016,Orb Books,4.41,Worlds of Exile and Illusion contains three novels in the Hainish Series from Ursula K. Le Guin\, one of the greatest science fiction writers and many times the winner of the Hugo and Nebula Awards. Her career as a novelist was launched by the three novels contained here. These books\, Rocannon's World\, Planet of Exile\, and City of Illusions\, are set in the same universe as Le Guin's groundbreaking classic\, The Left Hand of Darkness. At the Publisher's request\, this title is being sold without Digital Rights Management Software (DRM) applied.
+_id:keyword,book_no:keyword,title:text,author:text,year:integer,publisher:text,ratings:float,description:text
+0,2924,A Gentle Creature and Other Stories: White Nights\, A Gentle Creature\, and The Dream of a Ridiculous Man (The World's Classics),[Fyodor Dostoevsky, Alan Myers, W. J. Leatherbarrow],2009,Oxford Paperbacks,4.00,In these stories Dostoevsky explores both the figure of the dreamer divorced from reality and also his own ambiguous attitude to utopianism\, themes central to many of his great novels. This new translation captures the power and lyricism of Dostoevsky's writing\, while the introduction examines the stories in relation to one another and to his novels.
+1,7670,A Middle English Reader and Vocabulary,[Kenneth Sisam, J. R. R. Tolkien],2011,Courier Corporation,4.33,This highly respected anthology of medieval English literature features poetry\, prose and popular tales from Arthurian legend and classical mythology. Includes notes on each extract\, appendices\, and an extensive glossary by J. R. R. Tolkien.
+2,7381,A Psychic in the Heartland: The Extraordinary Experiences of a Small Town Doctor,Bettilu Stein Faulkner,2003,Red Wheel/Weiser,4.50,The true story of a small-town doctor destined to live his life along two paths: one as a successful physician\, the other as a psychic with ever more interesting adventures. Experiencing a wide range of spiritual phenomena\, Dr. Riblet Hout learned about the connection between the healer and the healed\, our individual missions on earth\, free will\, and our relationship with God. He also paints a vivid picture of life on the other side as well as the moment of transition from physical life to afterlife.
+3,2883,A Summer of Faulkner: As I Lay Dying/The Sound and the Fury/Light in August (Oprah's Book Club),William Faulkner,2005,Vintage Books,3.89,Presents three novels\, including As I Lay Dying\, in which the Bundren family journeys across Mississippi to bury their mother\, The Sound and the Fury\, in which Caddy Compson's story is narrated by her three brothers\, and Light in August\, in which th
+4,4023,A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings,[Walter Scheps, Agnes Perkins, Charles Adolph Huttar, John Ronald Reuel Tolkien],1975,Open Court Publishing,4.67,The structure\, content\, and character of Tolkien's The Hobbit and The Lord of the Rings are dealt with in ten critical essays.
+5,2382,A Wizard of Earthsea (Earthsea Trilogy Ser.),Ursula K. Le Guin,1991,Atheneum Books for Young Readers,4.01,A boy grows to manhood while attempting to subdue the evil he unleashed on the world as an apprentice to the Master Wizard.
+6,7541,A Writer's Diary (Volume 1: 1873-1876),Fyodor Dostoevsky,1997,Northwestern University Press,4.50,Winner of the AATSEEL Outstanding Translation Award This is the first paperback edition of the complete collection of writings that has been called Dostoevsky's boldest experiment with literary form\, it is a uniquely encyclopedic forum of fictional and nonfictional genres. The Diary's radical format was matched by the extreme range of its contents. In a single frame it incorporated an astonishing variety of material: short stories\, humorous sketches\, reports on sensational crimes\, historical predictions\, portraits of famous people\, autobiographical pieces\, and plans for stories\, some of which were never written while others appeared in the Diary itself.
+7,7400,Anna Karenina: Television Tie-In Edition (Signet classics),[Leo Tolstoy, SBP Editors],2019,Samaira Book Publishers,4.45,The Russian novelist and moral philosopher Leo Tolstoy (1828-1910) ranks as one of the world s great writers\, and his 'War and Peace' has been called the greatest novel ever written. But during his long lifetime\, Tolstoy also wrote enough shorter works to fill many volumes. The message in all his stories is presented with such humour that the reader hardly realises that it is strongly didactic. These stories give a snapshot of Russia and its people in the late nineteenth century.
+8,4917,Autumn of the Patriarch,Gabriel Garcia Marquez,2014,Penguin UK,4.33,Gabriel Garcia Marquez\, winner of the 1982 Nobel Prize for Literature and author of One Hundred Years of Solitude\, explores the loneliness of power in Autumn of the Patriarch. 'Over the weekend the vultures got into the presidential palace by pecking through the screens on the balcony windows and the flapping of their wings stirred up the stagnant time inside' As the citizens of an unnamed Caribbean nation creep through dusty corridors in search of their tyrannical leader\, they cannot comprehend that the frail and withered man lying dead on the floor can be the self-styled General of the Universe. Their arrogant\, manically violent leader\, known for serving up traitors to dinner guests and drowning young children at sea\, can surely not die the humiliating death of a mere mortal? Tracing the demands of a man whose egocentric excesses mask the loneliness of isolation and whose lies have become so ingrained that they are indistinguishable from truth\, Marquez has created a fantastical portrait of despotism that rings with an air of reality. 'Delights with its quirky humanity and black humour and impresses by its total originality' Vogue 'Captures perfectly the moral squalor and political paralysis that enshrouds a society awaiting the death of a long-term dictator' Guardian 'Marquez writes in this lyrical\, magical language that no-one else can do' Salman Rushdie
+9,9896,Barn burning (A tale blazer book),William Faulkner,1979,Perfection Learning,3.50,Reprinted from Collected Stories of William Faulkner\, by permission of Random House\, Inc.
+10,9607,Beowolf: The monsters and the critics,John Ronald Reuel Tolkien,1997,HarperCollins UK,4.12,A collection of seven essays by J.R.R. Tolkien arising out of Tolkien's work in medieval literature
+11,1985,Brothers Karamazov,Fyodor Dostoevsky,2015,First Avenue Editions,5.00,Four brothers reunite in their hometown in Russia. The murder of their father forces the brothers to question their beliefs about each other\, religion\, and morality.
+12,2713,Collected Stories of William Faulkner,William Faulkner,1995,Vintage,4.53,A collection of short stories focuses on the people of rural Mississippi
+13,2464,Conversations with Kurt Vonnegut (Literary Conversations),Kurt Vonnegut,1988,Univ. Press of Mississippi,4.40,Gathers interviews with Vonnegut from each period of his career and offers a brief profile of his life and accomplishments
+14,8534,Crime and Punishment (Oxford World's Classics),Fyodor Dostoevsky,2017,Oxford University Press,4.38,'One death\, in exchange for thousands of lives - it's simple arithmetic!' A new translation of Dostoevsky's epic masterpiece\, Crime and Punishment (1866). The impoverished student Raskolnikov decides to free himself from debt by killing an old moneylender\, an act he sees as elevating himself above conventional morality. Like Napoleon he will assert his will and his crime will be justified by its elimination of 'vermin' for the sake of the greater good. But Raskolnikov is torn apart by fear\, guilt\, and a growing conscience under the influence of his love for Sonya. Meanwhile the police detective Porfiry is on his trial. It is a powerfully psychological novel\, in which the St Petersburg setting\, Dostoevsky's own circumstances\, and contemporary social problems all play their part.
+15,8605,Dead Souls,Nikolai Gogol,1997,Vintage,4.28,Chichikov\, an amusing and often confused schemer\, buys deceased serfs' names from landholders' poll tax lists hoping to mortgage them for profit
+16,6970,Domestic Goddesses,Edith Vonnegut,1998,Pomegranate,4.67,In this immensely charming and insightful book\, artist Edith Vonnegut takes issue with traditional art imagery in which women are shown as weak and helpless. Through twenty-seven of her own paintings interspersed with her text\, she poignantly -- and humorously -- illustrates her maxim that the lives of mothers and homemakers are filled with endless challenges and vital decisions that should be portrayed with the dignity they deserve. In Vonnegut's paintings\, one woman bravely blocks the sun from harming a child (Sun Block) while another vacuums the stairs with angelic figures singing her praises (Electrolux). In contrasting her own Domestic Goddesses with the diaphanous women of classical art (seven paintings by masters such as Titian and Botticelli are included)\, she 'expresses the importance of traditional roles of women so cleverly and with such joy that her message and images will be forever emblazoned on our collective psyche.
+17,4814,El Coronel No Tiene Quien Le Escriba / No One Writes to the Colonel (Spanish Edition),Gabriel Garcia Marquez,2005,Harper Collins,4.45,Written with compassionate realism and wit\, the stories in this mesmerizing collection depict the disparities of town and village life in South America\, of the frightfully poor and outrageously rich\, of memories and illusions\, and of lost opportunities and present joys.
+18,4636,FINAL WITNESS,Simon Tolkien,2004,Random House Digital\, Inc.,3.94,The murder of Lady Anne Robinson by two intruders causes a schism in the victim's family when her son convinces police that his father's beautiful personal assistant hired the killers\, while his father\, the British minister of defense\, refuses to believe his son and marries the accused. A first novel. Reprint.
+19,2936,Fellowship of the Ring 2ND Edition,John Ronald Reuel Tolkien,2008,HarperCollins UK,4.43,Sauron\, the Dark Lord\, has gathered to him all the Rings of Power - the means by which he intends to rule Middle-earth. All he lacks in his plans for dominion is the One Ring - the ring that rules them all - which has fallen into the hands of the hobbit\, Bilbo Baggins. In a sleepy village in the Shire\, young Frodo Baggins finds himself faced with an immense task\, as his elderly cousin Bilbo entrusts the Ring to his care. Frodo must leave his home and make a perilous journey across Middle-earth to the Cracks of Doom\, there to destroy the Ring and foil the Dark Lord in his evil purpose. JRR Tolkien's great work of imaginative fiction has been labelled both a heroic romance and a classic fantasy fiction. By turns comic and homely\, epic and diabolic\, the narrative moves through countless changes of scene and character in an imaginary world which is totally convincing in its detail.
+20,8956,GOD BLESS YOU MR. ROSEWATER : Or Pearls Before Swine,Kurt Vonnegut,1970,New York : Dell,4.00,A lawyer schemes to gain control of a large fortune by having the present claimant declared insane.
+21,6818,Hadji Murad,Leo Tolstoy,2022,Hachette UK,3.88,'How truth thickens and deepens when it migrates from didactic fable to the raw experience of a visceral awakening is one of the thrills of Tolstoy's stories' Sharon Cameron in her preface to Hadji Murad and Other Stories This\, the third volume of Tolstoy's shorter fiction concentrates on his later stories\, including one of his greatest\, 'Hadji Murad'. In the stark form of homily that shapes these later works\, life considered as one's own has no rational meaning. From the chain of events that follows in the wake of two schoolboys' deception in 'The Forged Coupon' to the disillusionment of the narrator in 'After the Ball' we see\, in Virginia Woolf's observation\, that Tolstoy puts at the centre of his writing one 'who gathers into himself all experience\, turns the world round between his fingers\, and never ceases to ask\, even as he enjoys it\, what is the meaning of it'. The riverrun edition reissues the translation of Louise and Aylmer Maude\, whose influential versions of Tolstoy first brought his work to a wide readership in English.
+22,3950,Hocus,Kurt Vonnegut,1997,Penguin,4.67,Tarkington College\, a small\, exclusive college in upstate New York\, is turned upside down when ten thousand prisoners from the maximum security prison across Lake Mohiga break out and head for the college
+23,5404,Intruder in the dust,William Faulkner,2011,Vintage,3.18,A classic Faulkner novel which explores the lives of a family of characters in the South. An aging black who has long refused to adopt the black's traditionally servile attitude is wrongfully accused of murdering a white man.
+24,5578,Intruder in the dust: A novel,William Faulkner,1991,Vintage,3.18,Dramatizes the events that surround the murder of a white man in a volatile Southern community
+25,6380,La hojarasca (Spanish Edition),Gabriel Garcia Marquez,1979,Harper Collins,3.75,Translated from the Spanish by Gregory Rabassa
+26,5335,Letters of J R R Tolkien,J.R.R. Tolkien,2014,HarperCollins,4.70,This collection will entertain all who appreciate the art of masterful letter writing. The Letters of J.R.R Tolkien sheds much light on Tolkien's creative genius and grand design for the creation of a whole new world: Middle-earth. Featuring a radically expanded index\, this volume provides a valuable research tool for all fans wishing to trace the evolution of THE HOBBIT and THE LORD OF THE RINGS.
+27,3870,My First 100 Words in Spanish/English (My First 100 Words Pull-Tab Book),Keith Faulkner,1998,Libros Para Ninos,4.50,Learning a foreign language has never been this much fun! Just pull the sturdy tabs and change the words under the pictures from English to Spanish and back again to English!
+28,4502,O'Brian's Bride,Colleen Faulkner,1995,Zebra Books,5.00,Abandoning her pampered English life to marry a man in the American colonies\, Elizabeth finds her new world shattered when her husband is killed in an accident\, leaving her in charge of a business on the untamed frontier. Original.
+29,7635,Oliphaunt (Beastly Verse),J. R. R. Tolkien,1989,Contemporary Books,2.50,A poem in which an elephant describes himself and his way of life. On board pages.
+30,3254,Pearl and Sir Orfeo,[John Ronald Reuel Tolkien, Christopher Tolkien],1995,Harpercollins Pub Limited,5.00,Three epic poems from 14th century England speak of life during the age of chivalry. Translated from medieval English.
+31,3677,Planet of Exile,Ursula K. Le Guin,1979,Orion,4.20,PLAYAWAY: An alliance between the powerful Tevars and the brown-skinned\, clairvoyant Farbons must take place if the two colonies are to withstand the fierce attack of the nomadic tribes from the north of the planet Eltanin.
+32,4289,Poems from the Hobbit,J R R Tolkien,1999,HarperCollins Publishers,4.00,A collection of J.R.R. Tolkien's Hobbit poems in a miniature hardback volume complete with illustrations by Tolkien himself. Far over misty mountains cold To dungeons deep and caverns old We must away ere break of day To seek the pale enchanted gold. J.R.R. Tolkien's acclaimed The Hobbit contains 12 poems which are themselves masterpieces of writing. This miniature book\, illustrated with 30 of Tolkien's own paintings and drawings from the book -- some quite rare and all in full colour -- includes all the poems\, plus Gollum's eight riddles in verse\, and will be a perfect keepsake for lovers of The Hobbit and of accomplished poetry.
+33,6151,Pop! Went Another Balloon: A Magical Counting Storybook (Magical Counting Storybooks),[Keith Faulkner, Rory Tyger],2003,Dutton Childrens Books,5.00,Toby the turtle goes from in-line skates to a motorcycle to a rocketship with a handful of balloons that pop\, one by one\, along the way.
+34,3535,Rainbow's End: A Magical Story and Moneybox,[Keith Faulkner, Beverlie Manson],2003,Barrons Juveniles,4.00,In this combination picture storybook and coin bank\, the unusual front cover shows an illustration from the story that's embellished with five transparent plastic windows. Opening the book\, children will find a story about a poor little ballerina who is crying because her dancing shoes are worn and she has no money to replace them. Full color. Consumable.
+35,8423,Raising Faithful Kids in a Fast-Paced World,Paul Faulkner,1995,Howard Publishing Company,5.00,To find help for struggling parents\, Dr. Paul Faulkner--renowned family counselor and popular speaker--interviewed 30 successful families who have managed to raise faithful kids while also maintaining demanding careers. The invaluable strategies and methods he gleaned are now available in this powerful book delivered in Dr. Faulkner's warm\, humorous style.
+36,1463,Realms of Tolkien: Images of Middle-earth,J. R. R. Tolkien,1997,HarperCollins Publishers,4.00,Twenty new and familiar Tolkien artists are represented in this fabulous volume\, breathing an extraordinary variety of life into 58 different scenes\, each of which is accompanied by appropriate passage from The Hobbit and The Lord of the Rings and The Silmarillion
+37,6323,Resurrection (The Penguin classics),Leo Tolstoy,2009,Penguin,3.25,Leo Tolstoy's last completed novel\, Resurrection is an intimate\, psychological tale of guilt\, anger and forgiveness Serving on the jury at a murder trial\, Prince Dmitri Nekhlyudov is devastated when he sees the prisoner - Katyusha\, a young maid he seduced and abandoned years before. As Dmitri faces the consequences of his actions\, he decides to give up his life of wealth and luxury to devote himself to rescuing Katyusha\, even if it means following her into exile in Siberia. But can a man truly find redemption by saving another person? Tolstoy's most controversial novel\, Resurrection (1899) is a scathing indictment of injustice\, corruption and hypocrisy at all levels of society. Creating a vast panorama of Russian life\, from peasants to aristocrats\, bureaucrats to convicts\, it reveals Tolstoy's magnificent storytelling powers. Anthony Briggs' superb new translation preserves Tolstoy's gripping realism and satirical humour. In his introduction\, Briggs discusses the true story behind Resurrection\, Tolstoy's political and religious reasons for writing the novel\, his gift for characterization and the compelling psychological portrait of Dmitri. This edition also includes a chronology\, notes and a summary of chapters. For more than seventy years\, Penguin has been the leading publisher of classic literature in the English-speaking world. With more than 1\,700 titles\, Penguin Classics represents a global bookshelf of the best works throughout history and across genres and disciplines. Readers trust the series to provide authoritative texts enhanced by introductions and notes by distinguished scholars and contemporary authors\, as well as up-to-date translations by award-winning translators.
+38,2714,Return of the King Being the Third Part of The Lord of the Rings,J. R. R. Tolkien,2012,HarperCollins,4.60,Concluding the story begun in The Hobbit\, this is the final part of Tolkien s epic masterpiece\, The Lord of the Rings\, featuring an exclusive cover image from the film\, the definitive text\, and a detailed map of Middle-earth. The armies of the Dark Lord Sauron are massing as his evil shadow spreads ever wider. Men\, Dwarves\, Elves and Ents unite forces to do battle agains the Dark. Meanwhile\, Frodo and Sam struggle further into Mordor in their heroic quest to destroy the One Ring. The devastating conclusion of J.R.R. Tolkien s classic tale of magic and adventure\, begun in The Fellowship of the Ring and The Two Towers\, features the definitive edition of the text and includes the Appendices and a revised Index in full. To celebrate the release of the first of Peter Jackson s two-part film adaptation of The Hobbit\, THE HOBBIT: AN UNEXPECTED JOURNEY\, this third part of The Lord of the Rings is available for a limited time with an exclusive cover image from Peter Jackson s award-winning trilogy.
+39,7350,Return of the Shadow,[John Ronald Reuel Tolkien, Christopher Tolkien],2000,Mariner Books,5.00,In this sixth volume of The History of Middle-earth the story reaches The Lord of the Rings. In The Return of the Shadow (an abandoned title for the first volume) Christopher Tolkien describes\, with full citation of the earliest notes\, outline plans\, and narrative drafts\, the intricate evolution of The Fellowship of the Ring and the gradual emergence of the conceptions that transformed what J.R.R. Tolkien for long believed would be a far shorter book\, 'a sequel to The Hobbit'. The enlargement of Bilbo's 'magic ring' into the supremely potent and dangerous Ruling Ring of the Dark Lord is traced and the precise moment is seen when\, in an astonishing and unforeseen leap in the earliest narrative\, a Black Rider first rode into the Shire\, his significance still unknown. The character of the hobbit called Trotter (afterwards Strider or Aragorn) is developed while his indentity remains an absolute puzzle\, and the suspicion only very slowly becomes certainty that he must after all be a Man. The hobbits\, Frodo's companions\, undergo intricate permutations of name and personality\, and other major figures appear in strange modes: a sinister Treebeard\, in league with the Enemy\, a ferocious and malevolent Farmer Maggot. The story in this book ends at the point where J.R.R. Tolkien halted in the story for a long time\, as the Company of the Ring\, still lacking Legolas and Gimli\, stood before the tomb of Balin in the Mines of Moria. The Return of the Shadow is illustrated with reproductions of the first maps and notable pages from the earliest manuscripts.
+40,6760,Roverandom,J. R. R. Tolkien,1999,Mariner Books,4.38,Rover\, a dog who has been turned into a toy dog encounters rival wizards and experiences various adventures on the moon with giant spiders\, dragon moths\, and the Great White Dragon. By the author of The Hobbit. Reprint.
+41,8873,Searoad: Chronicles of Klatsand,Ursula K. Le Guin,2004,Shambhala Publications,5.00,A series of interlinking tales and a novella by the author of the Earthsea trilogy portrays the triumphs and struggles of several generations of women who independently control Klatsand\, a small resort town on the Oregon coast. Reprint.
+42,2378,Selected Letters of Lucretia Coffin Mott (Women in American History),[Lucretia Mott, Holly Byers Ochoa, Carol Faulkner],2002,University of Illinois Press,5.00,Dedicated to reform of almost every kind - temperance\, peace\, equal rights\, woman suffrage\, nonresistance\, and the abolition of slavery - Mott viewed women's rights as only one element of a broad-based reform agenda for American society.
+43,1502,Selected Passages from Correspondence with Friends,Nikolai Vasilevich Gogol,2009,Vanderbilt University Press,4.00,Nikolai Gogol wrote some letters to his friends\, none of which were a nose of high rank. Many are reproduced here (the letters\, not noses).
+44,5996,Smith of Wooten Manor & Farmer Giles of Ham,John Ronald Reuel Tolkien,1969,Del Rey,4.91,Two bewitching fantasies by J.R.R. Tolkien\, beloved author of THE HOBBIT. In SMITH OF WOOTTON MAJOR\, Tolkien explores the gift of fantasy\, and what it means to the life and character of the man who receives it. And FARMER GILES OF HAM tells a delightfully ribald mock-heroic tale\, where a dragon who invades a town refuses to fight\, and a farmer is chosen to slay him.
+45,2301,Smith of Wootton Major & Farmer Giles of Ham,John Ronald Reuel Tolkien,1969,Del Rey,5.00,Two bewitching fantasies by J.R.R. Tolkien\, beloved author of THE HOBBIT. In SMITH OF WOOTTON MAJOR\, Tolkien explores the gift of fantasy\, and what it means to the life and character of the man who receives it. And FARMER GILES OF HAM tells a delightfully ribald mock-heroic tale\, where a dragon who invades a town refuses to fight\, and a farmer is chosen to slay him.
+46,2236,Steering the Craft,Ursula K. Le Guin,2015,Houghton Mifflin Harcourt,4.73,A revised and updated guide to the essentials of a writer's craft\, presented by a brilliant practitioner of the art Completely revised and rewritten to address the challenges and opportunities of the modern era\, this handbook is a short\, deceptively simple guide to the craft of writing. Le Guin lays out ten chapters that address the most fundamental components of narrative\, from the sound of language to sentence construction to point of view. Each chapter combines illustrative examples from the global canon with Le Guin's own witty commentary and an exercise that the writer can do solo or in a group. She also offers a comprehensive guide to working in writing groups\, both actual and online. Masterly and concise\, Steering the Craft deserves a place on every writer's shelf.
+47,4724,THE UNVANQUISHED,William Faulkner,2011,Vintage,3.50,Set in Mississippi during the Civil War and Reconstruction\, THE UNVANQUISHED focuses on the Sartoris family\, who\, with their code of personal responsibility and courage\, stand for the best of the Old South's traditions.
+48,5948,That We Are Gentle Creatures,Fyodor Dostoevsky,2009,OUP Oxford,4.33,In the stories in this volume Dostoevsky explores both the figure of the dreamer divorced from reality and also his own ambiguous attitude to utopianism\, themes central to many of his great novels. In White Nights the apparent idyll of the dreamer's romantic fantasies disguises profound loneliness and estrangement from 'living life'. Despite his sentimental friendship with Nastenka\, his final withdrawal into the world of the imagination anticipates the retreat into the 'underground' of many of Dostoevsky's later intellectual heroes. A Gentle Creature and The Dream of a Ridiculous Man show how such withdrawal from reality can end in spiritual desolation and moral indifference and how\, in Dostoevsky's view\, the tragedy of the alienated individual can be resolved only by the rediscovery of a sense of compassion and responsibility towards fellow human beings. This new translation captures the power and lyricism of Dostoevsky's writing\, while the introduction examines the stories in relation to one another and to his novels. ABOUT THE SERIES: For over 100 years Oxford World's Classics has made available the widest range of literature from around the globe. Each affordable volume reflects Oxford's commitment to scholarship\, providing the most accurate text plus a wealth of other valuable features\, including expert introductions by leading authorities\, helpful notes to clarify the text\, up-to-date bibliographies for further study\, and much more.
+49,1937,The Best Short Stories of Dostoevsky (Modern Library),Fyodor Dostoevsky,2012,Modern Library,4.33,This collection\, unique to the Modern Library\, gathers seven of Dostoevsky's key works and shows him to be equally adept at the short story as with the novel. Exploring many of the same themes as in his longer works\, these small masterpieces move from the tender and romantic White Nights\, an archetypal nineteenth-century morality tale of pathos and loss\, to the famous Notes from the Underground\, a story of guilt\, ineffectiveness\, and uncompromising cynicism\, and the first major work of existential literature. Among Dostoevsky's prototypical characters is Yemelyan in The Honest Thief\, whose tragedy turns on an inability to resist crime. Presented in chronological order\, in David Magarshack's celebrated translation\, this is the definitive edition of Dostoevsky's best stories.
+50,2776,The Devil and Other Stories (Oxford World's Classics),Leo Tolstoy,2003,OUP Oxford,5.00,'It is impossible to explain why Yevgeny chose Liza Annenskaya\, as it is always impossible to explain why a man chooses this and not that woman.' This collection of eleven stories spans virtually the whole of Tolstoy's creative life. While each is unique in form\, as a group they are representative of his style\, and touch on the central themes that surface in War and Peace and Anna Karenina. Stories as different as 'The Snowstorm'\, 'Lucerne'\, 'The Diary of a Madman'\, and 'The Devil' are grounded in autobiographical experience. They deal with journeys of self-discovery and the moral and religious questioning that characterizes Tolstoy's works of criticism and philosophy. 'Strider' and 'Father Sergy'\, as well as reflecting Tolstoy's own experiences\, also reveal profound psychological insights. These stories range over much of the Russian world of the nineteenth century\, from the nobility to the peasantry\, the military to the clergy\, from merchants and cobblers to a horse and a tree. Together they present a fascinating picture of Tolstoy's skill and artistry. ABOUT THE SERIES: For over 100 years Oxford World's Classics has made available the widest range of literature from around the globe. Each affordable volume reflects Oxford's commitment to scholarship\, providing the most accurate text plus a wealth of other valuable features\, including expert introductions by leading authorities\, helpful notes to clarify the text\, up-to-date bibliographies for further study\, and much more.
+51,4231,The Dispossessed,Ursula K. Le Guin,1974,Harpercollins,4.26,Frequently reissued with the same ISBN\, but with slightly differing bibliographical details.
+52,7480,The Hobbit,J. R. R. Tolkien,2012,Mariner Books,4.64,Celebrating 75 years of one of the world's most treasured classics with an all new trade paperback edition. Repackaged with new cover art. 500\,000 first printing.
+53,6405,The Hobbit or There and Back Again,J. R. R. Tolkien,2012,Mariner Books,4.63,Celebrating 75 years of one of the world's most treasured classics with an all new trade paperback edition. Repackaged with new cover art. 500\,000 first printing.
+54,2540,The Inspector General (Language - Russian) (Russian Edition),[Nicolai Gogol, Thomas Seltzer],2014,CreateSpace,3.50,The Inspector-General is a national institution. To place a purely literary valuation upon it and call it the greatest of Russian comedies would not convey the significance of its position either in Russian literature or in Russian life itself. There is no other single work in the modern literature of any language that carries with it the wealth of associations which the Inspector-General does to the educated Russian.
+55,2951,The Insulted and Injured,Fyodor Dostoevsky,2011,Wm. B. Eerdmans Publishing,4.00,The Insulted and Injured\, which came out in 1861\, was Fyodor Dostoevsky's first major work of fiction after his Siberian exile and the first of the long novels that made him famous. Set in nineteenth-century Petersburg\, this gripping novel features a vividly drawn set of characters - including Vanya (Dostoevsky's semi-autobiographical hero)\, Natasha (the woman he loves)\, and Alyosha (Natasha's aristocratic lover) - all suffering from the cruelly selfish machinations of Alyosha's father\, the dark and powerful Prince Valkovsky. Boris Jakim's fresh English-language rendering of this gem in the Doestoevsky canon is both more colorful and more accurate than any earlier translation. --from back cover.
+56,2130,The J. R. R. Tolkien Audio Collection,[John Ronald Reuel Tolkien, Christopher Tolkien],2002,HarperCollins Publishers,4.89,For generations\, J R R Tolkien's words have brought to thrilling life a world of hobbits\, magic\, and historic myth\, woken from its foggy slumber within our minds. Here\, he tells the tales in his own voice.
+57,9801,The Karamazov Brothers (Oxford World's Classics),Fyodor Dostoevsky,2008,Oxford University Press,4.40,A remarkable work showing the author's power to depict Russian character and his understanding of human nature. Driven by intense\, uncontrollable emotions of rage and revenge\, the four Karamazov brothers all become involved in the brutal murder of their despicable father.
+58,5469,The Lays of Beleriand,[John Ronald Reuel Tolkien, Christopher Tolkien],2002,Harpercollins Pub Limited,4.42,The third volume that contains the early myths and legends which led to the writing of Tolkien's epic tale of war\, The Silmarillion. This\, the third volume of The History of Middle-earth\, gives us a priviledged insight into the creation of the mythology of Middle-earth\, through the alliterative verse tales of two of the most crucial stories in Tolkien's world -- those of Turien and Luthien. The first of the poems is the unpublished Lay of The Children of Hurin\, narrating on a grand scale the tragedy of Turin Turambar. The second is the moving Lay of Leithian\, the chief source of the tale of Beren and Luthien in The Silmarillion\, telling of the Quest of the Silmaril and the encounter with Morgoth in his subterranean fortress. Accompanying the poems are commentaries on the evolution of the history of the Elder Days. Also included is the notable criticism of The Lay of The Leithian by CS Lewis\, who read the poem in 1929.
+59,2675,The Lord of the Rings - Boxed Set,J.R.R. Tolkien,2012,HarperCollins,4.56,This beautiful gift edition of The Hobbit\, J.R.R. Tolkien's classic prelude to his Lord of the Rings trilogy\, features cover art\, illustrations\, and watercolor paintings by the artist Alan Lee. Bilbo Baggins is a hobbit who enjoys a comfortable\, unambitious life\, rarely traveling any farther than his pantry or cellar. But his contentment is disturbed when the wizard Gandalf and a company of dwarves arrive on his doorstep one day to whisk him away on an adventure. They have launched a plot to raid the treasure hoard guarded by Smaug the Magnificent\, a large and very dangerous dragon. Bilbo reluctantly joins their quest\, unaware that on his journey to the Lonely Mountain he will encounter both a magic ring and a frightening creature known as Gollum. Written for J.R.R. Tolkien's own children\, The Hobbit has sold many millions of copies worldwide and established itself as a modern classic.
+60,7140,The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1),[J. R. R. Tolkien, Alan Lee],2002,HarperSport,4.75,A selection of stunning poster paintings from the celebrated Tolkien artist Alan Lee - the man behind many of the striking images from The Lord of The Rings movie. The 50 paintings contained within the centenary edition of The Lord of the Rings in 1992 have themselves become classics and Alan Lee's interpretations are hailed as the most faithful to Tolkien's own vision. This new poster collection\, a perfect complement to volume one\, reproduces six more of the most popular paintings from the book in a format suitable either for hanging as posters or mounting and framing.
+61,5127,The Overcoat, Nikolai Gogol,1992,Courier Corporation,3.75,Four short stories include a satirical tale of Russian bureaucrats and a portrayal of an elderly couple living in the secluded countryside.
+62,8875,The Two Towers,John Ronald Reuel Tolkien,2007,HarperCollins UK,4.64,The second volume in The Lord of the Rings\, This title is also available as a film.
+63,4977,The Unvanquished,William Faulkner,2011,Vintage,3.50,Set in Mississippi during the Civil War and Reconstruction\, THE UNVANQUISHED focuses on the Sartoris family\, who\, with their code of personal responsibility and courage\, stand for the best of the Old South's traditions.
+64,4382,The Wolves of Witchmaker,Carole Guinane,2001,iUniverse,5.00,Polly Lavender is mysteriously lured onto Witchmaker's grounds along with her best friends Tony Rico\, Gracie Reene\, and Zeus\, the wolf they rescued as a pup. The three must quickly learn to master the art of magic because they have been chosen to lead Witchmaker Prep against a threat that has grim consequences.
+65,7912,The Word For World is Forest,Ursula K. Le Guin,2015,Gollancz,4.22,When the inhabitants of a peaceful world are conquered by the bloodthirsty yumens\, their existence is irrevocably altered. Forced into servitude\, the Athsheans find themselves at the mercy of their brutal masters. Desperation causes the Athsheans\, led by Selver\, to retaliate against their captors\, abandoning their strictures against violence. But in defending their lives\, they have endangered the very foundations of their society. For every blow against the invaders is a blow to the humanity of the Athsheans. And once the killing starts\, there is no turning back.
+66,1211,The brothers Karamazov,Fyodor Dostoevsky,2003,Bantam Classics,1.00,In 1880 Dostoevsky completed The Brothers Karamazov\, the literary effort for which he had been preparing all his life. Compelling\, profound\, complex\, it is the story of a patricide and of the four sons who each had a motive for murder: Dmitry\, the sensualist\, Ivan\, the intellectual\, Alyosha\, the mystic\, and twisted\, cunning Smerdyakov\, the bastard child. Frequently lurid\, nightmarish\, always brilliant\, the novel plunges the reader into a sordid love triangle\, a pathological obsession\, and a gripping courtroom drama. But throughout the whole\, Dostoevsky searhes for the truth--about man\, about life\, about the existence of God. A terrifying answer to man's eternal questions\, this monumental work remains the crowning achievement of perhaps the finest novelist of all time. From the Paperback edition.
+67,8086,The grand inquisitor (Milestones of thought),Fyodor Dostoevsky,1981,A&C Black,4.09,Dostoevsky's portrayal of the Catholic Church during the Inquisition is a plea for the power of pure faith\, and a critique of the tyrannies of institutionalized religion. This is an except from the Brothers Karamazov which stands alone as a statement of philiosophy and a warning about the surrender of freedom for the sake of comfort.
+68,8077,The unvanquished,William Faulkner,2011,Vintage,4.00,Set in Mississippi during the Civil War and Reconstruction\, THE UNVANQUISHED focuses on the Sartoris family\, who\, with their code of personal responsibility and courage\, stand for the best of the Old South's traditions.
+69,8480,The wind's twelve quarters: Short stories,Ursula K. Le Guin,2017,HarperCollins,5.00,The recipient of numerous literary prizes\, including the National Book Award\, the Kafka Award\, and the Pushcart Prize\, Ursula K. Le Guin is renowned for her lyrical writing\, rich characters\, and diverse worlds. The Wind's Twelve Quarters collects seventeen powerful stories\, each with an introduction by the author\, ranging from fantasy to intriguing scientific concepts\, from medieval settings to the future. Including an insightful foreword by Le Guin\, describing her experience\, her inspirations\, and her approach to writing\, this stunning collection explores human values\, relationships\, and survival\, and showcases the myriad talents of one of the most provocative writers of our time.
+70,2847,To Love A Dark Stranger (Lovegram Historical Romance),Colleen Faulkner,1997,Zebra Books,5.00,Bestselling author Colleen Faulkner's tumultuous saga of royal intrigue and forbidden desire sweeps from the magnificent estates of the aristocracy to the shadowy streets of London to King Charles II's glittering Restoration court.
+71,3293,Universe by Design,Danny Faulkner,2004,New Leaf Publishing Group,4.25,Views the stars and planets from a creationist standpoint\, addresses common misconceptions and difficulties about relativity and cosmology\, and discusses problems with the big bang theory with many analogies\, examples\, diagrams\, and illustrations. Original.
+72,5327,War and Peace,Leo Tolstoy,2016,Lulu.com,3.84,Covering the period from the French invasion under Napoleon into Russia. Although not covering solely the war itself\, the serialized novel does cover the effects the war had on Russian society from the common person right up to the Tsar himself. The book starts to move more to a philosophical consideration on war and peace near the end making the book as a whole an important piece of literature.
+73,4536,War and Peace (Signet Classics),[Leo Tolstoy, Pat Conroy, John Hockenberry],2012,Signet Classics,4.75,Presents the classical epic of the Napoleonic Wars and their effects on four Russian families.
+74,9032,War and Peace: A Novel (6 Volumes),Tolstoy Leo,2013,Hardpress Publishing,3.81,Unlike some other reproductions of classic texts (1) We have not used OCR(Optical Character Recognition)\, as this leads to bad quality books with introduced typos. (2) In books where there are images such as portraits\, maps\, sketches etc We have endeavoured to keep the quality of these images\, so they represent accurately the original artefact. Although occasionally there may be certain imperfections with these old texts\, we feel they deserve to be made available for future generations to enjoy.
+75,5119,William Faulkner,William Faulkner,2011,Vintage,4.00,This invaluable volume\, which has been republished to commemorate the one-hundredth anniversary of Faulkner's birth\, contains some of the greatest short fiction by a writer who defined the course of American literature. Its forty-five stories fall into three categories: those not included in Faulkner's earlier collections\, previously unpublished short fiction\, and stories that were later expanded into such novels as The Unvanquished\, The Hamlet\, and Go Down\, Moses. With its Introduction and extensive notes by the biographer Joseph Blotner\, Uncollected Stories of William Faulkner is an essential addition to its author's canon--as well as a book of some of the most haunting\, harrowing\, and atmospheric short fiction written in the twentieth century.
+76,8615,Winter notes on summer impressions,Fyodor Dostoevsky,2018,Alma Books,4.75,In June 1862\, Dostoevsky left Petersburg on his first excursion to Western Europe. Ostensibly making the trip to consult Western specialists about his epilepsy\, he also wished to see first-hand the source of the Western ideas he believed were corrupting Russia. Over the course of his journey he visited a number of major cities\, including Berlin\, Paris\, London\, Florence\, Milan and Vienna.His record of the trip\, Winter Notes on Summer Impressions - first published in the February 1863 issue of Vremya\, the periodical he edited - is the chrysalis out of which many elements of his later masterpieces developed.
+77,6478,Woman-The Full Story: A Dynamic Celebration of Freedoms,Michele Guinness,2003,Zondervan,5.00,What does it mean to be a woman today? What have women inherited from their radical\, risk-taking sisters of the past? And how does God view this half of humanity? Michele Guinness invites us on an adventure of discovery\, exploring the biblical texts\, the annals of history and the experiences of women today in search of the challenges and achievements\, failures and joys\, of women throughout the ages.
+78,8678,Worlds of Exile and Illusion: Three Complete Novels of the Hainish Series in One Volume--Rocannon's World\, Planet of Exile\, City of Illusions,Ursula K. Le Guin,2016,Orb Books,4.41,Worlds of Exile and Illusion contains three novels in the Hainish Series from Ursula K. Le Guin\, one of the greatest science fiction writers and many times the winner of the Hugo and Nebula Awards. Her career as a novelist was launched by the three novels contained here. These books\, Rocannon's World\, Planet of Exile\, and City of Illusions\, are set in the same universe as Le Guin's groundbreaking classic\, The Left Hand of Darkness. At the Publisher's request\, this title is being sold without Digital Rights Management Software (DRM) applied.
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec
index cb38204a71ab0..72632c62603aa 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec
@@ -13,9 +13,9 @@ from books metadata _score
 | sort c_score desc, book_no asc
 | LIMIT 2;
 
-book_no:keyword | title:text                                                                                  | c_score:double
-2675            | The Lord of the Rings - Boxed Set                                                           | 6.0
-4023            | A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings | 6.0
+book_no:keyword | title:text                                | c_score:double
+1463            | Realms of Tolkien: Images of Middle-earth | 6.0           
+2675            | The Lord of the Rings - Boxed Set         | 6.0
 ;
 
 singleMatchWithKeywordFieldScoring
@@ -28,15 +28,15 @@ from books metadata _score
 | sort book_no;
 
 book_no:keyword | author:text | _score:double
-2713            | William Faulkner | 2.3142893314361572
-2883            | William Faulkner | 2.3142893314361572
-4724            | William Faulkner | 2.3142893314361572
-4977            | William Faulkner | 2.3142893314361572
-5119            | William Faulkner | 2.3142893314361572
-5404            | William Faulkner | 2.3142893314361572
-5578            | William Faulkner | 2.3142893314361572
-8077            | William Faulkner | 2.3142893314361572
-9896            | William Faulkner | 2.3142893314361572
+2713            | William Faulkner | 1.7589385509490967
+2883            | William Faulkner | 1.7589385509490967
+4724            | William Faulkner | 1.7589385509490967
+4977            | William Faulkner | 2.6145541667938232
+5119            | William Faulkner | 2.513157367706299 
+5404            | William Faulkner | 1.7589385509490967
+5578            | William Faulkner | 2.513157367706299 
+8077            | William Faulkner | 1.7589385509490967
+9896            | William Faulkner | 2.6145541667938232
 ;
 
 qstrWithFieldAndScoringSortedEval
@@ -51,9 +51,9 @@ from books metadata _score
 | limit 3;
 
 book_no:keyword | title:text                                                                 | _score:double 
-2675            | The Lord of the Rings - Boxed Set                                          | 2.7583377361297607
-7140            | The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1) | 1.9239964485168457
-2714            | Return of the King Being the Third Part of The Lord of the Rings           | 1.9239964485168457
+2675            | The Lord of the Rings - Boxed Set                                          | 2.5619282722473145
+2714            | Return of the King Being the Third Part of The Lord of the Rings           | 1.9245924949645996
+7140            | The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1) | 1.746896743774414
 ;
 
 qstrWithFieldAndScoringSorted
@@ -67,9 +67,9 @@ from books metadata _score
 | limit 3;
 
 book_no:keyword | title:text                                                                 | _score:double 
-2675            | The Lord of the Rings - Boxed Set                                          | 2.7583377361297607
-7140            | The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1) | 1.9239964485168457
-2714            | Return of the King Being the Third Part of The Lord of the Rings           | 1.9239964485168457
+2675            | The Lord of the Rings - Boxed Set                                          | 2.5619282722473145
+2714            | Return of the King Being the Third Part of The Lord of the Rings           | 1.9245924949645996
+7140            | The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1) | 1.746896743774414
 ;
 
 singleQstrScoringManipulated
@@ -84,8 +84,8 @@ from books metadata _score
 | LIMIT 2;
 
 book_no:keyword | author:text                                        | add_score:double
-2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] | 2.0
-2713            | William Faulkner                                   | 7.0
+2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] | 3.0
+2713            | William Faulkner                                   | 6.0
 ;
 
 testMultiValuedFieldWithConjunctionWithScore
@@ -125,7 +125,7 @@ from books metadata _score
 
 ignoreOrder:true
 book_no:keyword | title:text                                | author:text        | _score:double
-8480            | The wind's twelve quarters: Short stories | Ursula K. Le Guin  | 14.489097595214844
+8480            | The wind's twelve quarters: Short stories | Ursula K. Le Guin  | 11.193471908569336
 ;
 
 multipleWhereWithMatchScoring
@@ -139,7 +139,7 @@ from books metadata _score
 | sort book_no;
 
 book_no:keyword | title:text                                | author:text        | _score:double
-8480            | The wind's twelve quarters: Short stories | Ursula K. Le Guin  | 14.489097595214844
+8480            | The wind's twelve quarters: Short stories | Ursula K. Le Guin  | 11.193471908569336
 ;
 
 combinedMatchWithFunctionsScoring
@@ -153,7 +153,7 @@ from books metadata _score
 | sort book_no;
 
 book_no:keyword | title:text               | author:text    | year:integer | _score:double
-5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 5.448054313659668
+5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 4.733664035797119
 ;
 
 singleQstrScoring
@@ -167,8 +167,8 @@ from books metadata _score
 | LIMIT 2;
 
 book_no:keyword | author:text                                        | _score:double
-2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] | 0.9976131916046143
-2713            | William Faulkner                                   | 5.9556169509887695
+2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] | 1.3697924613952637
+2713            | William Faulkner                                   | 4.631696701049805
 ;
 
 singleQstrScoringGrok
@@ -183,9 +183,9 @@ from books metadata _score
 | LIMIT 3;
 
 book_no:keyword | title:keyword | _score:double
-8875            | The | 2.9505908489227295
-4023            | A   | 2.8327860832214355
-2675            | The | 2.7583377361297607
+8875            | The           | 2.769660472869873 
+1463            | Realms        | 2.6714818477630615
+2675            | The           | 2.5619282722473145
 ;
 
 combinedMatchWithScoringEvalNoSort
@@ -200,7 +200,7 @@ from books metadata _score
 
 ignoreOrder:true
 book_no:keyword | title:text               | author:text    | year:integer | c_score:double
-5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 6
+5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 5.0
 ;
 
 singleQstrScoringRename
@@ -215,9 +215,9 @@ from books metadata _score
 | LIMIT 3;
 
 book_no:keyword | rank:double
-8875            | 2.9505908489227295
-4023            | 2.8327860832214355
-2675            | 2.7583377361297607
+8875            | 2.769660472869873 
+1463            | 2.6714818477630615
+2675            | 2.5619282722473145
 ;
 
 singleMatchWithTextFieldScoring
@@ -231,11 +231,11 @@ from books metadata _score
 | limit 5;
 
 book_no:keyword | author:text                                        | _score:double
-2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] | 0.9976131916046143
-2713            | William Faulkner                                   | 4.272439002990723
-2847            | Colleen Faulkner                                   | 1.7401835918426514
-2883            | William Faulkner                                   | 4.272439002990723
-3293            | Danny Faulkner                                     | 1.7401835918426514
+2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott] | 1.3697924613952637
+2713            | William Faulkner                                   | 3.2750158309936523
+2847            | Colleen Faulkner                                   | 1.593343734741211 
+2883            | William Faulkner                                   | 3.2750158309936523
+3293            | Danny Faulkner                                     | 1.593343734741211
 ;
 
 combinedMatchWithFunctionsScoringNoSort
@@ -249,7 +249,7 @@ from books metadata _score
 
 ignoreOrder:true
 book_no:keyword | title:text               | author:text    | year:integer | _score:double
-5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 5.448054313659668
+5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 4.733664035797119
 ;
 
 combinedMatchWithScoringEval
@@ -264,7 +264,7 @@ from books metadata _score
 | sort book_no;
 
 book_no:keyword | title:text               | author:text    | year:integer | c_score:double
-5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 6
+5335            | Letters of J R R Tolkien | J.R.R. Tolkien | 2014         | 5.0
 ;
 
 singleQstrScoringEval
@@ -280,7 +280,7 @@ from books metadata _score
 
 book_no:keyword | c_score:double
 8875            | 3.0
-7350            | 2.0
+7350            | 1.0
 7140            | 3.0
 ;
 
@@ -289,14 +289,16 @@ required_capability: metadata_score
 required_capability: qstr_function
 
 from books metadata _score 
-| where qstr("title:rings") 
+| where qstr("title:gentle") 
 | eval _score = _score + 1 
 | keep book_no, title, _score
-| limit 2;
+| limit 10
+;
+ignoreOrder:true
 
-book_no:keyword | title:text                                                                                  | _score:double
-4023            | A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings | 2.6404519081115723
-2714            | Return of the King Being the Third Part of The Lord of the Rings                            | 2.9239964485168457
+book_no:keyword | title:text                                                                                                                     | _score:double
+2924            | A Gentle Creature and Other Stories: White Nights, A Gentle Creature, and The Dream of a Ridiculous Man (The World's Classics) | 3.158426523208618
+5948            | That We Are Gentle Creatures                                                                                                   | 3.727346897125244 
 ;
 
 QstrScoreOverride
@@ -304,12 +306,14 @@ required_capability: metadata_score
 required_capability: qstr_function
 
 from books metadata _score 
-| where qstr("title:rings") 
+| where qstr("title:gentle") 
 | eval _score = "foobar"
 | keep book_no, title, _score 
-| limit 2;
+| limit 10
+;
+ignoreOrder:true
 
-book_no:keyword | title:text                                                                                  | _score:keyword
-4023            | A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings | foobar
-2714            | Return of the King Being the Third Part of The Lord of the Rings                            | foobar
+book_no:keyword | title:text                                                                                                                     | _score:keyword
+2924            | A Gentle Creature and Other Stories: White Nights, A Gentle Creature, and The Dream of a Ridiculous Man (The World's Classics) | foobar        
+5948            | That We Are Gentle Creatures                                                                                                   | foobar
 ;

From 7cf28a910e6aa8e5679a73eb54075b6778277b67 Mon Sep 17 00:00:00 2001
From: Ievgen Degtiarenko <ievgen.degtiarenko@elastic.co>
Date: Wed, 18 Dec 2024 09:56:42 +0100
Subject: [PATCH 060/119] ESQL Add esql hash function (#117989)

This change introduces esql hash(alg, input) function that relies on the Java MessageDigest to compute the hash.
---
 docs/changelog/117989.yaml                    |   5 +
 .../esql/functions/description/hash.asciidoc  |   5 +
 .../functions/kibana/definition/hash.json     |  82 +++++++
 .../esql/functions/kibana/docs/hash.md        |   7 +
 .../esql/functions/layout/hash.asciidoc       |  14 ++
 .../esql/functions/parameters/hash.asciidoc   |   9 +
 .../esql/functions/signature/hash.svg         |   1 +
 .../esql/functions/string-functions.asciidoc  |   2 +
 .../esql/functions/types/hash.asciidoc        |  12 +
 .../src/main/resources/hash.csv-spec          | 105 +++++++++
 .../scalar/string/HashConstantEvaluator.java  | 142 ++++++++++++
 .../function/scalar/string/HashEvaluator.java | 174 ++++++++++++++
 .../xpack/esql/action/EsqlCapabilities.java   |   5 +
 .../function/EsqlFunctionRegistry.java        |   2 +
 .../scalar/ScalarFunctionWritables.java       |   2 +
 .../function/scalar/string/Hash.java          | 217 ++++++++++++++++++
 .../AbstractExpressionSerializationTests.java |   5 +
 .../scalar/string/HashSerializationTests.java |  27 +++
 .../scalar/string/HashStaticTests.java        |  66 ++++++
 .../function/scalar/string/HashTests.java     | 107 +++++++++
 .../rest-api-spec/test/esql/60_usage.yml      |   4 +-
 21 files changed, 991 insertions(+), 2 deletions(-)
 create mode 100644 docs/changelog/117989.yaml
 create mode 100644 docs/reference/esql/functions/description/hash.asciidoc
 create mode 100644 docs/reference/esql/functions/kibana/definition/hash.json
 create mode 100644 docs/reference/esql/functions/kibana/docs/hash.md
 create mode 100644 docs/reference/esql/functions/layout/hash.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/hash.asciidoc
 create mode 100644 docs/reference/esql/functions/signature/hash.svg
 create mode 100644 docs/reference/esql/functions/types/hash.asciidoc
 create mode 100644 x-pack/plugin/esql/qa/testFixtures/src/main/resources/hash.csv-spec
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashConstantEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Hash.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashSerializationTests.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashStaticTests.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashTests.java

diff --git a/docs/changelog/117989.yaml b/docs/changelog/117989.yaml
new file mode 100644
index 0000000000000..e4967141b3ebd
--- /dev/null
+++ b/docs/changelog/117989.yaml
@@ -0,0 +1,5 @@
+pr: 117989
+summary: ESQL Add esql hash function
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/docs/reference/esql/functions/description/hash.asciidoc b/docs/reference/esql/functions/description/hash.asciidoc
new file mode 100644
index 0000000000000..e074915c5132a
--- /dev/null
+++ b/docs/reference/esql/functions/description/hash.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Computes the hash of the input using various algorithms such as MD5, SHA, SHA-224, SHA-256, SHA-384, SHA-512.
diff --git a/docs/reference/esql/functions/kibana/definition/hash.json b/docs/reference/esql/functions/kibana/definition/hash.json
new file mode 100644
index 0000000000000..17a60cf45acfe
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/hash.json
@@ -0,0 +1,82 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "hash",
+  "description" : "Computes the hash of the input using various algorithms such as MD5, SHA, SHA-224, SHA-256, SHA-384, SHA-512.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "algorithm",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Hash algorithm to use."
+        },
+        {
+          "name" : "input",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Input to hash."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "keyword"
+    },
+    {
+      "params" : [
+        {
+          "name" : "algorithm",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Hash algorithm to use."
+        },
+        {
+          "name" : "input",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Input to hash."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "keyword"
+    },
+    {
+      "params" : [
+        {
+          "name" : "algorithm",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Hash algorithm to use."
+        },
+        {
+          "name" : "input",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Input to hash."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "keyword"
+    },
+    {
+      "params" : [
+        {
+          "name" : "algorithm",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Hash algorithm to use."
+        },
+        {
+          "name" : "input",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Input to hash."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "keyword"
+    }
+  ],
+  "preview" : false,
+  "snapshot_only" : false
+}
diff --git a/docs/reference/esql/functions/kibana/docs/hash.md b/docs/reference/esql/functions/kibana/docs/hash.md
new file mode 100644
index 0000000000000..9826e80ec5bec
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/hash.md
@@ -0,0 +1,7 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### HASH
+Computes the hash of the input using various algorithms such as MD5, SHA, SHA-224, SHA-256, SHA-384, SHA-512.
+
diff --git a/docs/reference/esql/functions/layout/hash.asciidoc b/docs/reference/esql/functions/layout/hash.asciidoc
new file mode 100644
index 0000000000000..27c55ada6319b
--- /dev/null
+++ b/docs/reference/esql/functions/layout/hash.asciidoc
@@ -0,0 +1,14 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-hash]]
+=== `HASH`
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/hash.svg[Embedded,opts=inline]
+
+include::../parameters/hash.asciidoc[]
+include::../description/hash.asciidoc[]
+include::../types/hash.asciidoc[]
diff --git a/docs/reference/esql/functions/parameters/hash.asciidoc b/docs/reference/esql/functions/parameters/hash.asciidoc
new file mode 100644
index 0000000000000..d47a82d4ab214
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/hash.asciidoc
@@ -0,0 +1,9 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`algorithm`::
+Hash algorithm to use.
+
+`input`::
+Input to hash.
diff --git a/docs/reference/esql/functions/signature/hash.svg b/docs/reference/esql/functions/signature/hash.svg
new file mode 100644
index 0000000000000..f819e14c9d1a4
--- /dev/null
+++ b/docs/reference/esql/functions/signature/hash.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="432" height="46" viewbox="0 0 432 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m68 0h10m32 0h10m128 0h10m32 0h10m80 0h10m32 0h5"/><rect class="s" x="5" y="5" width="68" height="36"/><text class="k" x="15" y="31">HASH</text><rect class="s" x="83" y="5" width="32" height="36" rx="7"/><text class="syn" x="93" y="31">(</text><rect class="s" x="125" y="5" width="128" height="36" rx="7"/><text class="k" x="135" y="31">algorithm</text><rect class="s" x="263" y="5" width="32" height="36" rx="7"/><text class="syn" x="273" y="31">,</text><rect class="s" x="305" y="5" width="80" height="36" rx="7"/><text class="k" x="315" y="31">input</text><rect class="s" x="395" y="5" width="32" height="36" rx="7"/><text class="syn" x="405" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/string-functions.asciidoc b/docs/reference/esql/functions/string-functions.asciidoc
index ce9636f5c5a3a..da9580a55151a 100644
--- a/docs/reference/esql/functions/string-functions.asciidoc
+++ b/docs/reference/esql/functions/string-functions.asciidoc
@@ -13,6 +13,7 @@
 * <<esql-concat>>
 * <<esql-ends_with>>
 * <<esql-from_base64>>
+* <<esql-hash>>
 * <<esql-left>>
 * <<esql-length>>
 * <<esql-locate>>
@@ -37,6 +38,7 @@ include::layout/byte_length.asciidoc[]
 include::layout/concat.asciidoc[]
 include::layout/ends_with.asciidoc[]
 include::layout/from_base64.asciidoc[]
+include::layout/hash.asciidoc[]
 include::layout/left.asciidoc[]
 include::layout/length.asciidoc[]
 include::layout/locate.asciidoc[]
diff --git a/docs/reference/esql/functions/types/hash.asciidoc b/docs/reference/esql/functions/types/hash.asciidoc
new file mode 100644
index 0000000000000..786ba03b2aa60
--- /dev/null
+++ b/docs/reference/esql/functions/types/hash.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+algorithm | input | result
+keyword | keyword | keyword
+keyword | text | keyword
+text | keyword | keyword
+text | text | keyword
+|===
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/hash.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/hash.csv-spec
new file mode 100644
index 0000000000000..fcac1e1859c6d
--- /dev/null
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/hash.csv-spec
@@ -0,0 +1,105 @@
+hash
+required_capability: hash_function
+
+FROM sample_data 
+| WHERE message != "Connection error"
+| EVAL md5 = hash("md5", message), sha256 = hash("sha256", message) 
+| KEEP message, md5, sha256;
+ignoreOrder:true
+
+message:keyword       | md5:keyword                      | sha256:keyword
+Connected to 10.1.0.1 | abd7d1ce2bb636842a29246b3512dcae | 6d8372129ad78770f7185554dd39864749a62690216460752d6c075fa38ad85c
+Connected to 10.1.0.2 | 8f8f1cb60832d153f5b9ec6dc828b93f | b0db24720f15857091b3c99f4c4833586d0ea3229911b8777efb8d917cf27e9a
+Connected to 10.1.0.3 | 912b6dc13503165a15de43304bb77c78 | 75b0480188db8acc4d5cc666a51227eb2bc5b989cd8ca912609f33e0846eff57
+Disconnected          | ef70e46fd3bbc21e3e1f0b6815e750c0 | 04dfac3671b494ad53fcd152f7a14511bfb35747278aad8ce254a0d6e4ba4718
+;
+
+
+hashOfConvertedType
+required_capability: hash_function
+
+FROM sample_data 
+| WHERE message != "Connection error"
+| EVAL input = event_duration::STRING, md5 = hash("md5", input), sha256 = hash("sha256", input) 
+| KEEP message, input, md5, sha256;
+ignoreOrder:true
+
+message:keyword       | input:keyword | md5:keyword                      | sha256:keyword
+Connected to 10.1.0.1 | 1756467       | c4fc1c57ee9b1d2b2023b70c8c167b54 | 8376a50a7ba7e6bd1bf9ad0c32d27d2f49fd0fa422573f98f239e21048b078f3
+Connected to 10.1.0.2 | 2764889       | 8e8cf005e11a7b5df1d9478a4715a444 | 1031f2bef8eaecbf47319505422300b27ea1f7c38b6717d41332325062f9a56a
+Connected to 10.1.0.3 | 3450233       | 09f2c64f5a55e9edf8ffbad336b561d8 | f77d7545769c4ecc85092f4f0b7ec8c20f467e4beb15fe67ca29f9aa8e9a6900
+Disconnected          | 1232382       | 6beac1485638d51e13c2c53990a2f611 | 9a03c1274a3ebb6c1cb85d170ce0a6fdb9d2232724e06b9f5e7cb9274af3cad6
+;
+
+
+hashOfEmptyInput
+required_capability: hash_function
+
+ROW input="" | EVAL md5 = hash("md5", input), sha256 = hash("sha256", input);
+
+input:keyword | md5:keyword                      | sha256:keyword
+              | d41d8cd98f00b204e9800998ecf8427e | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
+;
+
+hashOfNullInput
+required_capability: hash_function
+
+ROW input=null::STRING | EVAL md5 = hash("md5", input), sha256 = hash("sha256", input);
+
+input:keyword | md5:keyword | sha256:keyword
+null          | null        | null
+;
+
+
+hashWithNullAlgorithm
+required_capability: hash_function
+
+ROW input="input" | EVAL hash = hash(null, input);
+
+input:keyword | hash:keyword
+input         | null
+;
+
+
+hashWithMv
+required_capability: hash_function
+
+ROW input=["foo", "bar"] | mv_expand input | EVAL md5 = hash("md5", input), sha256 = hash("sha256", input);
+
+input:keyword  | md5:keyword                      | sha256:keyword
+foo            | acbd18db4cc2f85cedef654fccc4a4d8 | 2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae
+bar            | 37b51d194a7513e45b56f6524f2d51f2 | fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9
+;
+
+
+hashWithNestedFunctions
+required_capability: hash_function
+
+ROW input=["foo", "bar"] | EVAL hash = concat(hash("md5", mv_concat(input, "-")), "-", hash("sha256", mv_concat(input, "-")));
+
+input:keyword  | hash:keyword
+["foo", "bar"] | e5f9ec048d1dbe19c70f720e002f9cb1-7d89c4f517e3bd4b5e8e76687937005b602ea00c5cba3e25ef1fc6575a55103e
+;
+
+
+hashWithConvertedTypes
+required_capability: hash_function
+
+ROW input=42 | EVAL md5 = hash("md5", input::STRING), sha256 = hash("sha256", to_string(input));
+
+input:integer | md5:keyword                      | sha256:keyword
+42            | a1d0c6e83f027327d8461063f4ac58a6 | 73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049
+;
+
+
+hashWithStats
+required_capability: hash_function
+
+FROM sample_data 
+| EVAL md5="md5"
+| STATS count = count(*) by hash(md5, message)
+| WHERE count > 1;
+
+count:long | hash(md5, message):keyword
+3          | 2e92ae79ff32b37fee4368a594792183
+;
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashConstantEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashConstantEvaluator.java
new file mode 100644
index 0000000000000..34cff73018634
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashConstantEvaluator.java
@@ -0,0 +1,142 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.string;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import java.util.function.Function;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.BreakingBytesRefBuilder;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link Hash}.
+ * This class is generated. Do not edit it.
+ */
+public final class HashConstantEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final BreakingBytesRefBuilder scratch;
+
+  private final Hash.HashFunction algorithm;
+
+  private final EvalOperator.ExpressionEvaluator input;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public HashConstantEvaluator(Source source, BreakingBytesRefBuilder scratch,
+      Hash.HashFunction algorithm, EvalOperator.ExpressionEvaluator input,
+      DriverContext driverContext) {
+    this.source = source;
+    this.scratch = scratch;
+    this.algorithm = algorithm;
+    this.input = input;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (BytesRefBlock inputBlock = (BytesRefBlock) input.eval(page)) {
+      BytesRefVector inputVector = inputBlock.asVector();
+      if (inputVector == null) {
+        return eval(page.getPositionCount(), inputBlock);
+      }
+      return eval(page.getPositionCount(), inputVector).asBlock();
+    }
+  }
+
+  public BytesRefBlock eval(int positionCount, BytesRefBlock inputBlock) {
+    try(BytesRefBlock.Builder result = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      BytesRef inputScratch = new BytesRef();
+      position: for (int p = 0; p < positionCount; p++) {
+        if (inputBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (inputBlock.getValueCount(p) != 1) {
+          if (inputBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBytesRef(Hash.processConstant(this.scratch, this.algorithm, inputBlock.getBytesRef(inputBlock.getFirstValueIndex(p), inputScratch)));
+      }
+      return result.build();
+    }
+  }
+
+  public BytesRefVector eval(int positionCount, BytesRefVector inputVector) {
+    try(BytesRefVector.Builder result = driverContext.blockFactory().newBytesRefVectorBuilder(positionCount)) {
+      BytesRef inputScratch = new BytesRef();
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBytesRef(Hash.processConstant(this.scratch, this.algorithm, inputVector.getBytesRef(p, inputScratch)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "HashConstantEvaluator[" + "algorithm=" + algorithm + ", input=" + input + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(scratch, input);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final Function<DriverContext, BreakingBytesRefBuilder> scratch;
+
+    private final Function<DriverContext, Hash.HashFunction> algorithm;
+
+    private final EvalOperator.ExpressionEvaluator.Factory input;
+
+    public Factory(Source source, Function<DriverContext, BreakingBytesRefBuilder> scratch,
+        Function<DriverContext, Hash.HashFunction> algorithm,
+        EvalOperator.ExpressionEvaluator.Factory input) {
+      this.source = source;
+      this.scratch = scratch;
+      this.algorithm = algorithm;
+      this.input = input;
+    }
+
+    @Override
+    public HashConstantEvaluator get(DriverContext context) {
+      return new HashConstantEvaluator(source, scratch.apply(context), algorithm.apply(context), input.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "HashConstantEvaluator[" + "algorithm=" + algorithm + ", input=" + input + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashEvaluator.java
new file mode 100644
index 0000000000000..8b01cc0330142
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashEvaluator.java
@@ -0,0 +1,174 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.string;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import java.security.NoSuchAlgorithmException;
+import java.util.function.Function;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.BreakingBytesRefBuilder;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link Hash}.
+ * This class is generated. Do not edit it.
+ */
+public final class HashEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final BreakingBytesRefBuilder scratch;
+
+  private final EvalOperator.ExpressionEvaluator algorithm;
+
+  private final EvalOperator.ExpressionEvaluator input;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public HashEvaluator(Source source, BreakingBytesRefBuilder scratch,
+      EvalOperator.ExpressionEvaluator algorithm, EvalOperator.ExpressionEvaluator input,
+      DriverContext driverContext) {
+    this.source = source;
+    this.scratch = scratch;
+    this.algorithm = algorithm;
+    this.input = input;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (BytesRefBlock algorithmBlock = (BytesRefBlock) algorithm.eval(page)) {
+      try (BytesRefBlock inputBlock = (BytesRefBlock) input.eval(page)) {
+        BytesRefVector algorithmVector = algorithmBlock.asVector();
+        if (algorithmVector == null) {
+          return eval(page.getPositionCount(), algorithmBlock, inputBlock);
+        }
+        BytesRefVector inputVector = inputBlock.asVector();
+        if (inputVector == null) {
+          return eval(page.getPositionCount(), algorithmBlock, inputBlock);
+        }
+        return eval(page.getPositionCount(), algorithmVector, inputVector);
+      }
+    }
+  }
+
+  public BytesRefBlock eval(int positionCount, BytesRefBlock algorithmBlock,
+      BytesRefBlock inputBlock) {
+    try(BytesRefBlock.Builder result = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      BytesRef algorithmScratch = new BytesRef();
+      BytesRef inputScratch = new BytesRef();
+      position: for (int p = 0; p < positionCount; p++) {
+        if (algorithmBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (algorithmBlock.getValueCount(p) != 1) {
+          if (algorithmBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (inputBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (inputBlock.getValueCount(p) != 1) {
+          if (inputBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        try {
+          result.appendBytesRef(Hash.process(this.scratch, algorithmBlock.getBytesRef(algorithmBlock.getFirstValueIndex(p), algorithmScratch), inputBlock.getBytesRef(inputBlock.getFirstValueIndex(p), inputScratch)));
+        } catch (NoSuchAlgorithmException e) {
+          warnings().registerException(e);
+          result.appendNull();
+        }
+      }
+      return result.build();
+    }
+  }
+
+  public BytesRefBlock eval(int positionCount, BytesRefVector algorithmVector,
+      BytesRefVector inputVector) {
+    try(BytesRefBlock.Builder result = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      BytesRef algorithmScratch = new BytesRef();
+      BytesRef inputScratch = new BytesRef();
+      position: for (int p = 0; p < positionCount; p++) {
+        try {
+          result.appendBytesRef(Hash.process(this.scratch, algorithmVector.getBytesRef(p, algorithmScratch), inputVector.getBytesRef(p, inputScratch)));
+        } catch (NoSuchAlgorithmException e) {
+          warnings().registerException(e);
+          result.appendNull();
+        }
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "HashEvaluator[" + "algorithm=" + algorithm + ", input=" + input + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(scratch, algorithm, input);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final Function<DriverContext, BreakingBytesRefBuilder> scratch;
+
+    private final EvalOperator.ExpressionEvaluator.Factory algorithm;
+
+    private final EvalOperator.ExpressionEvaluator.Factory input;
+
+    public Factory(Source source, Function<DriverContext, BreakingBytesRefBuilder> scratch,
+        EvalOperator.ExpressionEvaluator.Factory algorithm,
+        EvalOperator.ExpressionEvaluator.Factory input) {
+      this.source = source;
+      this.scratch = scratch;
+      this.algorithm = algorithm;
+      this.input = input;
+    }
+
+    @Override
+    public HashEvaluator get(DriverContext context) {
+      return new HashEvaluator(source, scratch.apply(context), algorithm.get(context), input.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "HashEvaluator[" + "algorithm=" + algorithm + ", input=" + input + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index 8c7e381d33322..d6c1539088d47 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -449,6 +449,11 @@ public enum Cap {
          */
         KQL_FUNCTION(Build.current().isSnapshot()),
 
+        /**
+         * Hash function
+         */
+        HASH_FUNCTION,
+
         /**
          * Don't optimize CASE IS NOT NULL function by not requiring the fields to be not null as well.
          * https://github.com/elastic/elasticsearch/issues/112704
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
index a59ef5bb1575d..908c9c5f197a8 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
@@ -129,6 +129,7 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.ByteLength;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Concat;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.EndsWith;
+import org.elasticsearch.xpack.esql.expression.function.scalar.string.Hash;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.LTrim;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Left;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Length;
@@ -327,6 +328,7 @@ private static FunctionDefinition[][] functions() {
                 def(ByteLength.class, ByteLength::new, "byte_length"),
                 def(Concat.class, Concat::new, "concat"),
                 def(EndsWith.class, EndsWith::new, "ends_with"),
+                def(Hash.class, Hash::new, "hash"),
                 def(LTrim.class, LTrim::new, "ltrim"),
                 def(Left.class, Left::new, "left"),
                 def(Length.class, Length::new, "length"),
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ScalarFunctionWritables.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ScalarFunctionWritables.java
index 192ca6c43e57d..3cf0eef9074ad 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ScalarFunctionWritables.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/ScalarFunctionWritables.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.BitLength;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Concat;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.EndsWith;
+import org.elasticsearch.xpack.esql.expression.function.scalar.string.Hash;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Left;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Locate;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Repeat;
@@ -64,6 +65,7 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         entries.add(E.ENTRY);
         entries.add(EndsWith.ENTRY);
         entries.add(Greatest.ENTRY);
+        entries.add(Hash.ENTRY);
         entries.add(Hypot.ENTRY);
         entries.add(In.ENTRY);
         entries.add(InsensitiveEquals.ENTRY);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Hash.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Hash.java
new file mode 100644
index 0000000000000..99c5908699ec2
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/Hash.java
@@ -0,0 +1,217 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.string;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.compute.ann.Evaluator;
+import org.elasticsearch.compute.ann.Fixed;
+import org.elasticsearch.compute.operator.BreakingBytesRefBuilder;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.InvalidArgumentException;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.expression.function.scalar.EsqlScalarFunction;
+import org.elasticsearch.xpack.esql.io.stream.PlanStreamInput;
+
+import java.io.IOException;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.List;
+import java.util.function.Function;
+
+import static org.elasticsearch.compute.ann.Fixed.Scope.THREAD_LOCAL;
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
+
+public class Hash extends EsqlScalarFunction {
+
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(Expression.class, "Hash", Hash::new);
+
+    private final Expression algorithm;
+    private final Expression input;
+
+    @FunctionInfo(
+        returnType = "keyword",
+        description = "Computes the hash of the input using various algorithms such as MD5, SHA, SHA-224, SHA-256, SHA-384, SHA-512."
+    )
+    public Hash(
+        Source source,
+        @Param(name = "algorithm", type = { "keyword", "text" }, description = "Hash algorithm to use.") Expression algorithm,
+        @Param(name = "input", type = { "keyword", "text" }, description = "Input to hash.") Expression input
+    ) {
+        super(source, List.of(algorithm, input));
+        this.algorithm = algorithm;
+        this.input = input;
+    }
+
+    private Hash(StreamInput in) throws IOException {
+        this(Source.readFrom((PlanStreamInput) in), in.readNamedWriteable(Expression.class), in.readNamedWriteable(Expression.class));
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        source().writeTo(out);
+        out.writeNamedWriteable(algorithm);
+        out.writeNamedWriteable(input);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    public DataType dataType() {
+        return DataType.KEYWORD;
+    }
+
+    @Override
+    protected TypeResolution resolveType() {
+        if (childrenResolved() == false) {
+            return new TypeResolution("Unresolved children");
+        }
+
+        TypeResolution resolution = isString(algorithm, sourceText(), FIRST);
+        if (resolution.unresolved()) {
+            return resolution;
+        }
+
+        return isString(input, sourceText(), SECOND);
+    }
+
+    @Override
+    public boolean foldable() {
+        return algorithm.foldable() && input.foldable();
+    }
+
+    @Evaluator(warnExceptions = NoSuchAlgorithmException.class)
+    static BytesRef process(
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BreakingBytesRefBuilder scratch,
+        BytesRef algorithm,
+        BytesRef input
+    ) throws NoSuchAlgorithmException {
+        return hash(scratch, MessageDigest.getInstance(algorithm.utf8ToString()), input);
+    }
+
+    @Evaluator(extraName = "Constant")
+    static BytesRef processConstant(
+        @Fixed(includeInToString = false, scope = THREAD_LOCAL) BreakingBytesRefBuilder scratch,
+        @Fixed(scope = THREAD_LOCAL) HashFunction algorithm,
+        BytesRef input
+    ) {
+        return hash(scratch, algorithm.digest, input);
+    }
+
+    private static BytesRef hash(BreakingBytesRefBuilder scratch, MessageDigest algorithm, BytesRef input) {
+        algorithm.reset();
+        algorithm.update(input.bytes, input.offset, input.length);
+        var digest = algorithm.digest();
+        scratch.clear();
+        scratch.grow(digest.length * 2);
+        appendUtf8HexDigest(scratch, digest);
+        return scratch.bytesRefView();
+    }
+
+    private static final byte[] ASCII_HEX_BYTES = new byte[] { 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 97, 98, 99, 100, 101, 102 };
+
+    /**
+     * This function allows to append hex bytes dirrectly to the {@link BreakingBytesRefBuilder}
+     * bypassing unnecessary array allocations and byte array copying.
+     */
+    private static void appendUtf8HexDigest(BreakingBytesRefBuilder scratch, byte[] bytes) {
+        for (byte b : bytes) {
+            scratch.append(ASCII_HEX_BYTES[b >> 4 & 0xf]);
+            scratch.append(ASCII_HEX_BYTES[b & 0xf]);
+        }
+    }
+
+    @Override
+    public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
+        if (algorithm.foldable()) {
+            try {
+                // hash function is created here in order to validate the algorithm is valid before evaluator is created
+                var hf = HashFunction.create((BytesRef) algorithm.fold());
+                return new HashConstantEvaluator.Factory(
+                    source(),
+                    context -> new BreakingBytesRefBuilder(context.breaker(), "hash"),
+                    new Function<>() {
+                        @Override
+                        public HashFunction apply(DriverContext context) {
+                            return hf.copy();
+                        }
+
+                        @Override
+                        public String toString() {
+                            return hf.toString();
+                        }
+                    },
+                    toEvaluator.apply(input)
+                );
+            } catch (NoSuchAlgorithmException e) {
+                throw new InvalidArgumentException(e, "invalid algorithm for [{}]: {}", sourceText(), e.getMessage());
+            }
+        } else {
+            return new HashEvaluator.Factory(
+                source(),
+                context -> new BreakingBytesRefBuilder(context.breaker(), "hash"),
+                toEvaluator.apply(algorithm),
+                toEvaluator.apply(input)
+            );
+        }
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new Hash(source(), newChildren.get(0), newChildren.get(1));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, Hash::new, children().get(0), children().get(1));
+    }
+
+    public record HashFunction(String algorithm, MessageDigest digest) {
+
+        public static HashFunction create(BytesRef literal) throws NoSuchAlgorithmException {
+            var algorithm = literal.utf8ToString();
+            var digest = MessageDigest.getInstance(algorithm);
+            return new HashFunction(algorithm, digest);
+        }
+
+        public HashFunction copy() {
+            try {
+                return new HashFunction(algorithm, MessageDigest.getInstance(algorithm));
+            } catch (NoSuchAlgorithmException e) {
+                assert false : "Algorithm should be valid at this point";
+                throw new IllegalStateException(e);
+            }
+        }
+
+        @Override
+        public String toString() {
+            return algorithm;
+        }
+    }
+
+    Expression algorithm() {
+        return algorithm;
+    }
+
+    Expression input() {
+        return input;
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/AbstractExpressionSerializationTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/AbstractExpressionSerializationTests.java
index 6dd0c5fe88afd..050293e58c19d 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/AbstractExpressionSerializationTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/AbstractExpressionSerializationTests.java
@@ -14,10 +14,15 @@
 import org.elasticsearch.xpack.esql.plan.AbstractNodeSerializationTests;
 
 public abstract class AbstractExpressionSerializationTests<T extends Expression> extends AbstractNodeSerializationTests<T> {
+
     public static Expression randomChild() {
         return ReferenceAttributeTests.randomReferenceAttribute(false);
     }
 
+    public static Expression mutateExpression(Expression expression) {
+        return randomValueOtherThan(expression, AbstractExpressionSerializationTests::randomChild);
+    }
+
     @Override
     protected final NamedWriteableRegistry getNamedWriteableRegistry() {
         return new NamedWriteableRegistry(ExpressionWritables.getNamedWriteables());
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashSerializationTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashSerializationTests.java
new file mode 100644
index 0000000000000..f21105c2c8bca
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashSerializationTests.java
@@ -0,0 +1,27 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.string;
+
+import org.elasticsearch.xpack.esql.expression.AbstractExpressionSerializationTests;
+
+import java.io.IOException;
+
+public class HashSerializationTests extends AbstractExpressionSerializationTests<Hash> {
+
+    @Override
+    protected Hash createTestInstance() {
+        return new Hash(randomSource(), randomChild(), randomChild());
+    }
+
+    @Override
+    protected Hash mutateInstance(Hash instance) throws IOException {
+        return randomBoolean()
+            ? new Hash(instance.source(), mutateExpression(instance.algorithm()), instance.input())
+            : new Hash(instance.source(), instance.algorithm(), mutateExpression(instance.input()));
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashStaticTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashStaticTests.java
new file mode 100644
index 0000000000000..871bec7c06804
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashStaticTests.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.string;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.breaker.CircuitBreaker;
+import org.elasticsearch.common.unit.ByteSizeValue;
+import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.common.util.MockBigArrays;
+import org.elasticsearch.common.util.PageCacheRecycler;
+import org.elasticsearch.compute.data.BlockFactory;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.esql.core.InvalidArgumentException;
+import org.elasticsearch.xpack.esql.core.expression.Literal;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.junit.After;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.expression.function.AbstractFunctionTestCase.evaluator;
+import static org.elasticsearch.xpack.esql.expression.function.AbstractFunctionTestCase.field;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.startsWith;
+
+public class HashStaticTests extends ESTestCase {
+
+    public void testInvalidAlgorithmLiteral() {
+        Source source = new Source(0, 0, "hast(\"invalid\", input)");
+        DriverContext driverContext = driverContext();
+        InvalidArgumentException e = expectThrows(
+            InvalidArgumentException.class,
+            () -> evaluator(
+                new Hash(source, new Literal(source, new BytesRef("invalid"), DataType.KEYWORD), field("input", DataType.KEYWORD))
+            ).get(driverContext)
+        );
+        assertThat(e.getMessage(), startsWith("invalid algorithm for [hast(\"invalid\", input)]: invalid MessageDigest not available"));
+    }
+
+    /**
+     * The following fields and methods were borrowed from AbstractScalarFunctionTestCase
+     */
+    private final List<CircuitBreaker> breakers = Collections.synchronizedList(new ArrayList<>());
+
+    private DriverContext driverContext() {
+        BigArrays bigArrays = new MockBigArrays(PageCacheRecycler.NON_RECYCLING_INSTANCE, ByteSizeValue.ofMb(256)).withCircuitBreaking();
+        CircuitBreaker breaker = bigArrays.breakerService().getBreaker(CircuitBreaker.REQUEST);
+        breakers.add(breaker);
+        return new DriverContext(bigArrays, new BlockFactory(breaker, bigArrays));
+    }
+
+    @After
+    public void allMemoryReleased() {
+        for (CircuitBreaker breaker : breakers) {
+            assertThat(breaker.getUsed(), equalTo(0L));
+        }
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashTests.java
new file mode 100644
index 0000000000000..c5cdf97eccd17
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/string/HashTests.java
@@ -0,0 +1,107 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.string;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.lucene.BytesRefs;
+import org.elasticsearch.xpack.esql.core.InvalidArgumentException;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.AbstractScalarFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.nio.charset.StandardCharsets;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.ArrayList;
+import java.util.HexFormat;
+import java.util.List;
+import java.util.function.Supplier;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.nullValue;
+
+public class HashTests extends AbstractScalarFunctionTestCase {
+
+    public HashTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        List<TestCaseSupplier> cases = new ArrayList<>();
+        for (String algorithm : List.of("MD5", "SHA", "SHA-224", "SHA-256", "SHA-384", "SHA-512")) {
+            cases.addAll(createTestCases(algorithm));
+        }
+        cases.add(new TestCaseSupplier("Invalid algorithm", List.of(DataType.KEYWORD, DataType.KEYWORD), () -> {
+            var input = randomAlphaOfLength(10);
+            return new TestCaseSupplier.TestCase(
+                List.of(
+                    new TestCaseSupplier.TypedData(new BytesRef("invalid"), DataType.KEYWORD, "algorithm"),
+                    new TestCaseSupplier.TypedData(new BytesRef(input), DataType.KEYWORD, "input")
+                ),
+                "HashEvaluator[algorithm=Attribute[channel=0], input=Attribute[channel=1]]",
+                DataType.KEYWORD,
+                is(nullValue())
+            ).withWarning("Line -1:-1: evaluation of [] failed, treating result as null. Only first 20 failures recorded.")
+                .withWarning("Line -1:-1: java.security.NoSuchAlgorithmException: invalid MessageDigest not available")
+                .withFoldingException(InvalidArgumentException.class, "invalid algorithm for []: invalid MessageDigest not available");
+        }));
+        return parameterSuppliersFromTypedDataWithDefaultChecks(true, cases, (v, p) -> "string");
+    }
+
+    private static List<TestCaseSupplier> createTestCases(String algorithm) {
+        return List.of(
+            createTestCase(algorithm, false, DataType.KEYWORD, DataType.KEYWORD),
+            createTestCase(algorithm, false, DataType.KEYWORD, DataType.TEXT),
+            createTestCase(algorithm, false, DataType.TEXT, DataType.KEYWORD),
+            createTestCase(algorithm, false, DataType.TEXT, DataType.TEXT),
+            createTestCase(algorithm, true, DataType.KEYWORD, DataType.KEYWORD),
+            createTestCase(algorithm, true, DataType.KEYWORD, DataType.TEXT),
+            createTestCase(algorithm, true, DataType.TEXT, DataType.KEYWORD),
+            createTestCase(algorithm, true, DataType.TEXT, DataType.TEXT)
+        );
+    }
+
+    private static TestCaseSupplier createTestCase(String algorithm, boolean forceLiteral, DataType algorithmType, DataType inputType) {
+        return new TestCaseSupplier(algorithm, List.of(algorithmType, inputType), () -> {
+            var input = randomFrom(TestCaseSupplier.stringCases(inputType)).get();
+            return new TestCaseSupplier.TestCase(
+                List.of(createTypedData(algorithm, forceLiteral, algorithmType, "algorithm"), input),
+                forceLiteral
+                    ? "HashConstantEvaluator[algorithm=" + algorithm + ", input=Attribute[channel=0]]"
+                    : "HashEvaluator[algorithm=Attribute[channel=0], input=Attribute[channel=1]]",
+                DataType.KEYWORD,
+                equalTo(new BytesRef(hash(algorithm, BytesRefs.toString(input.data()))))
+            );
+        });
+    }
+
+    private static TestCaseSupplier.TypedData createTypedData(String value, boolean forceLiteral, DataType type, String name) {
+        var data = new TestCaseSupplier.TypedData(new BytesRef(value), type, name);
+        return forceLiteral ? data.forceLiteral() : data;
+    }
+
+    private static String hash(String algorithm, String input) {
+        try {
+            return HexFormat.of().formatHex(MessageDigest.getInstance(algorithm).digest(input.getBytes(StandardCharsets.UTF_8)));
+        } catch (NoSuchAlgorithmException e) {
+            throw new IllegalArgumentException("Unknown algorithm: " + algorithm);
+        }
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new Hash(source, args.get(0), args.get(1));
+    }
+}
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
index 2a4cde9a680e9..b6d75048591e5 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
@@ -92,7 +92,7 @@ setup:
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
   # Testing for the entire function set isn't feasbile, so we just check that we return the correct count as an approximation.
-  - length: {esql.functions: 129} # check the "sister" test below for a likely update to the same esql.functions length check
+  - length: {esql.functions: 130} # check the "sister" test below for a likely update to the same esql.functions length check
 
 ---
 "Basic ESQL usage output (telemetry) non-snapshot version":
@@ -163,4 +163,4 @@ setup:
   - match: {esql.functions.cos: $functions_cos}
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
-  - length: {esql.functions: 125} # check the "sister" test above for a likely update to the same esql.functions length check
+  - length: {esql.functions: 126} # check the "sister" test above for a likely update to the same esql.functions length check

From c75e92a5e3d46cfae264fc54c0245be5a328c9c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Iv=C3=A1n=20Cea=20Fontenla?= <ivancea96@outlook.com>
Date: Wed, 18 Dec 2024 11:13:46 +0100
Subject: [PATCH 061/119] ESQL: Allow using the same index in FROM and LOOKUP
 (#118768)

Changed the logic so that, instead of getting all the indices of the plan and then subtracting the lookup ones, it will now directly ignore the lookup part in the initial calculation.
---
 .../src/main/resources/lookup-join.csv-spec   | 17 ++++++-
 .../xpack/esql/action/EsqlCapabilities.java   |  5 ++
 .../xpack/esql/planner/PlannerUtils.java      | 24 ++++++++-
 .../xpack/esql/plugin/ComputeService.java     | 49 ++-----------------
 4 files changed, 47 insertions(+), 48 deletions(-)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index 8bcc2c2ff3502..e75c68f4a379d 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -182,6 +182,22 @@ language_code:integer | language_name:keyword       | country:keyword
 2                     | [German, German, German]    | [Austria, Germany, Switzerland]
 ;
 
+repeatedIndexOnFrom
+required_capability: join_lookup_v7
+required_capability: join_lookup_repeated_index_from
+
+FROM languages_lookup
+| LOOKUP JOIN languages_lookup ON language_code
+| SORT language_code
+;
+
+language_code:integer | language_name:keyword
+1                     | English
+2                     | French
+3                     | Spanish
+4                     | German
+;
+
 ###############################################
 # Filtering tests with languages_lookup index
 ###############################################
@@ -1061,4 +1077,3 @@ ignoreOrder:true
 2023-10-23T12:27:28.948Z | 172.21.2.113      | 2764889             | QA              | null
 2023-10-23T12:15:03.360Z | 172.21.2.162      | 3450233             | QA              | null
 ;
-
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index d6c1539088d47..bfc2675d59791 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -557,6 +557,11 @@ public enum Cap {
          */
         JOIN_LOOKUP_V7(Build.current().isSnapshot()),
 
+        /**
+         * LOOKUP JOIN with the same index as the FROM
+         */
+        JOIN_LOOKUP_REPEATED_INDEX_FROM(JOIN_LOOKUP_V7.isEnabled()),
+
         /**
          * Fix for https://github.com/elastic/elasticsearch/issues/117054
          */
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/PlannerUtils.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/PlannerUtils.java
index 37f89891860d8..a312d048db0ad 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/PlannerUtils.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/PlannerUtils.java
@@ -22,6 +22,7 @@
 import org.elasticsearch.xpack.esql.core.expression.AttributeSet;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Predicates;
+import org.elasticsearch.xpack.esql.core.tree.Node;
 import org.elasticsearch.xpack.esql.core.tree.Source;
 import org.elasticsearch.xpack.esql.core.type.DataType;
 import org.elasticsearch.xpack.esql.core.util.Holder;
@@ -40,6 +41,7 @@
 import org.elasticsearch.xpack.esql.plan.physical.ExchangeSinkExec;
 import org.elasticsearch.xpack.esql.plan.physical.ExchangeSourceExec;
 import org.elasticsearch.xpack.esql.plan.physical.FragmentExec;
+import org.elasticsearch.xpack.esql.plan.physical.LookupJoinExec;
 import org.elasticsearch.xpack.esql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.esql.planner.mapper.LocalMapper;
 import org.elasticsearch.xpack.esql.planner.mapper.Mapper;
@@ -48,9 +50,12 @@
 import org.elasticsearch.xpack.esql.stats.SearchStats;
 
 import java.util.ArrayList;
+import java.util.Collection;
 import java.util.LinkedHashSet;
 import java.util.List;
 import java.util.Set;
+import java.util.function.Consumer;
+import java.util.function.Function;
 
 import static java.util.Arrays.asList;
 import static org.elasticsearch.index.mapper.MappedFieldType.FieldExtractPreference.DOC_VALUES;
@@ -105,10 +110,27 @@ public static Set<String> planConcreteIndices(PhysicalPlan plan) {
             return Set.of();
         }
         var indices = new LinkedHashSet<String>();
-        plan.forEachUp(FragmentExec.class, f -> f.fragment().forEachUp(EsRelation.class, r -> indices.addAll(r.index().concreteIndices())));
+        // TODO: This only works for LEFT join, we still need to support RIGHT join
+        forEachUpWithChildren(plan, node -> {
+            if (node instanceof FragmentExec f) {
+                f.fragment().forEachUp(EsRelation.class, r -> indices.addAll(r.index().concreteIndices()));
+            }
+        }, node -> node instanceof LookupJoinExec join ? List.of(join.left()) : node.children());
         return indices;
     }
 
+    /**
+     * Similar to {@link Node#forEachUp(Consumer)}, but with a custom callback to get the node children.
+     */
+    private static <T extends Node<T>> void forEachUpWithChildren(
+        T node,
+        Consumer<? super T> action,
+        Function<? super T, Collection<T>> childrenGetter
+    ) {
+        childrenGetter.apply(node).forEach(c -> forEachUpWithChildren(c, action, childrenGetter));
+        action.accept(node);
+    }
+
     /**
      * Returns the original indices specified in the FROM command of the query. We need the original query to resolve alias filters.
      */
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
index 9b59b98a7cdc2..e77a2443df2dd 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
@@ -63,12 +63,8 @@
 import org.elasticsearch.xpack.esql.core.expression.Attribute;
 import org.elasticsearch.xpack.esql.enrich.EnrichLookupService;
 import org.elasticsearch.xpack.esql.enrich.LookupFromIndexService;
-import org.elasticsearch.xpack.esql.plan.logical.EsRelation;
-import org.elasticsearch.xpack.esql.plan.logical.join.Join;
 import org.elasticsearch.xpack.esql.plan.physical.ExchangeSinkExec;
 import org.elasticsearch.xpack.esql.plan.physical.ExchangeSourceExec;
-import org.elasticsearch.xpack.esql.plan.physical.FragmentExec;
-import org.elasticsearch.xpack.esql.plan.physical.LookupJoinExec;
 import org.elasticsearch.xpack.esql.plan.physical.OutputExec;
 import org.elasticsearch.xpack.esql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.esql.planner.EsPhysicalOperationProviders;
@@ -81,7 +77,6 @@
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
-import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
@@ -167,11 +162,9 @@ public void execute(
         Map<String, OriginalIndices> clusterToConcreteIndices = transportService.getRemoteClusterService()
             .groupIndices(SearchRequest.DEFAULT_INDICES_OPTIONS, PlannerUtils.planConcreteIndices(physicalPlan).toArray(String[]::new));
         QueryPragmas queryPragmas = configuration.pragmas();
-        Set<String> lookupIndexNames = findLookupIndexNames(physicalPlan);
-        Set<String> concreteIndexNames = selectConcreteIndices(clusterToConcreteIndices, lookupIndexNames);
         if (dataNodePlan == null) {
-            if (concreteIndexNames.isEmpty() == false) {
-                String error = "expected no concrete indices without data node plan; got " + concreteIndexNames;
+            if (clusterToConcreteIndices.values().stream().allMatch(v -> v.indices().length == 0) == false) {
+                String error = "expected no concrete indices without data node plan; got " + clusterToConcreteIndices;
                 assert false : error;
                 listener.onFailure(new IllegalStateException(error));
                 return;
@@ -194,7 +187,7 @@ public void execute(
                 return;
             }
         } else {
-            if (concreteIndexNames.isEmpty()) {
+            if (clusterToConcreteIndices.values().stream().allMatch(v -> v.indices().length == 0)) {
                 var error = "expected concrete indices with data node plan but got empty; data node plan " + dataNodePlan;
                 assert false : error;
                 listener.onFailure(new IllegalStateException(error));
@@ -268,42 +261,6 @@ public void execute(
         }
     }
 
-    private Set<String> selectConcreteIndices(Map<String, OriginalIndices> clusterToConcreteIndices, Set<String> indexesToIgnore) {
-        Set<String> concreteIndexNames = new HashSet<>();
-        clusterToConcreteIndices.forEach((clusterAlias, concreteIndices) -> {
-            for (String index : concreteIndices.indices()) {
-                if (indexesToIgnore.contains(index) == false) {
-                    concreteIndexNames.add(index);
-                }
-            }
-        });
-        return concreteIndexNames;
-    }
-
-    private Set<String> findLookupIndexNames(PhysicalPlan physicalPlan) {
-        Set<String> lookupIndexNames = new HashSet<>();
-        // When planning JOIN on the coordinator node: "LookupJoinExec.lookup()->FragmentExec.fragment()->EsRelation.index()"
-        physicalPlan.forEachDown(
-            LookupJoinExec.class,
-            lookupJoinExec -> lookupJoinExec.lookup()
-                .forEachDown(
-                    FragmentExec.class,
-                    frag -> frag.fragment().forEachDown(EsRelation.class, esRelation -> lookupIndexNames.add(esRelation.index().name()))
-                )
-        );
-        // When planning JOIN on the data node: "FragmentExec.fragment()->Join.right()->EsRelation.index()"
-        // TODO this only works for LEFT join, so we still need to support RIGHT join
-        physicalPlan.forEachDown(
-            FragmentExec.class,
-            fragmentExec -> fragmentExec.fragment()
-                .forEachDown(
-                    Join.class,
-                    join -> join.right().forEachDown(EsRelation.class, esRelation -> lookupIndexNames.add(esRelation.index().name()))
-                )
-        );
-        return lookupIndexNames;
-    }
-
     // For queries like: FROM logs* | LIMIT 0 (including cross-cluster LIMIT 0 queries)
     private static void updateShardCountForCoordinatorOnlyQuery(EsqlExecutionInfo execInfo) {
         if (execInfo.isCrossClusterSearch()) {

From 37807b83b7500cbe861817fa1e20aef07d72f6d9 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Wed, 18 Dec 2024 11:45:41 +0100
Subject: [PATCH 062/119] Support flattened label field with downsampling.
 (#118816)

If flattened field is configured as non-dimension and non-metric field, then downsampling fails to execute successfully. Downsampling doesn't know how to use the flattened field or how to serialize it. This change addresses this.

Closes #116319
---
 docs/changelog/118816.yaml                    |   6 +
 .../flattened/FlattenedFieldMapper.java       |   9 +-
 .../FlattenedFieldSyntheticWriterHelper.java  |   8 +-
 .../downsample/70_flattened_field_type.yml    | 307 ++++++++++++++++++
 .../xpack/downsample/FieldValueFetcher.java   |  11 +-
 .../xpack/downsample/LabelFieldProducer.java  |  42 ++-
 .../downsample/LabelFieldProducerTests.java   |  54 +++
 7 files changed, 428 insertions(+), 9 deletions(-)
 create mode 100644 docs/changelog/118816.yaml
 create mode 100644 x-pack/plugin/downsample/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/downsample/70_flattened_field_type.yml

diff --git a/docs/changelog/118816.yaml b/docs/changelog/118816.yaml
new file mode 100644
index 0000000000000..f1c1eac90dbcf
--- /dev/null
+++ b/docs/changelog/118816.yaml
@@ -0,0 +1,6 @@
+pr: 118816
+summary: Support flattened field with downsampling
+area: Downsampling
+type: bug
+issues:
+ - 116319
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldMapper.java
index 93a2157b2338a..de2632165b0cc 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldMapper.java
@@ -52,6 +52,7 @@
 import org.elasticsearch.index.mapper.DocumentParserContext;
 import org.elasticsearch.index.mapper.DynamicFieldType;
 import org.elasticsearch.index.mapper.FieldMapper;
+import org.elasticsearch.index.mapper.KeywordFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.index.mapper.Mapper;
 import org.elasticsearch.index.mapper.MapperBuilderContext;
@@ -670,7 +671,7 @@ public static final class RootFlattenedFieldType extends StringFieldType impleme
         private final boolean isDimension;
         private final int ignoreAbove;
 
-        public RootFlattenedFieldType(
+        RootFlattenedFieldType(
             String name,
             boolean indexed,
             boolean hasDocValues,
@@ -682,7 +683,7 @@ public RootFlattenedFieldType(
             this(name, indexed, hasDocValues, meta, splitQueriesOnWhitespace, eagerGlobalOrdinals, Collections.emptyList(), ignoreAbove);
         }
 
-        public RootFlattenedFieldType(
+        RootFlattenedFieldType(
             String name,
             boolean indexed,
             boolean hasDocValues,
@@ -806,6 +807,10 @@ public MappedFieldType getChildFieldType(String childPath) {
             return new KeyedFlattenedFieldType(name(), childPath, this);
         }
 
+        public MappedFieldType getKeyedFieldType() {
+            return new KeywordFieldMapper.KeywordFieldType(name() + KEYED_FIELD_SUFFIX);
+        }
+
         @Override
         public boolean isDimension() {
             return isDimension;
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldSyntheticWriterHelper.java b/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldSyntheticWriterHelper.java
index 950fef95772fb..53f68fb6edeef 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldSyntheticWriterHelper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/flattened/FlattenedFieldSyntheticWriterHelper.java
@@ -55,7 +55,7 @@
  * }`
  *
  */
-class FlattenedFieldSyntheticWriterHelper {
+public class FlattenedFieldSyntheticWriterHelper {
 
     private record Prefix(List<String> prefix) {
 
@@ -225,17 +225,17 @@ public boolean equals(Object obj) {
         }
     }
 
-    interface SortedKeyedValues {
+    public interface SortedKeyedValues {
         BytesRef next() throws IOException;
     }
 
     private final SortedKeyedValues sortedKeyedValues;
 
-    FlattenedFieldSyntheticWriterHelper(final SortedKeyedValues sortedKeyedValues) {
+    public FlattenedFieldSyntheticWriterHelper(final SortedKeyedValues sortedKeyedValues) {
         this.sortedKeyedValues = sortedKeyedValues;
     }
 
-    void write(final XContentBuilder b) throws IOException {
+    public void write(final XContentBuilder b) throws IOException {
         KeyValue curr = new KeyValue(sortedKeyedValues.next());
         KeyValue prev = KeyValue.EMPTY;
         final List<String> values = new ArrayList<>();
diff --git a/x-pack/plugin/downsample/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/downsample/70_flattened_field_type.yml b/x-pack/plugin/downsample/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/downsample/70_flattened_field_type.yml
new file mode 100644
index 0000000000000..0f586ec0ed669
--- /dev/null
+++ b/x-pack/plugin/downsample/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/downsample/70_flattened_field_type.yml
@@ -0,0 +1,307 @@
+---
+"A flattened label field":
+  - do:
+      indices.create:
+        index: source_index
+        body:
+          settings:
+            number_of_shards: 1
+            index:
+              mode: time_series
+              routing_path: [ metricset, k8s.pod.uid ]
+              time_series:
+                start_time: 2021-04-28T00:00:00Z
+                end_time: 2021-04-29T00:00:00Z
+          mappings:
+            subobjects: false
+            properties:
+              "@timestamp":
+                type: date
+              metricset:
+                type: keyword
+                time_series_dimension: true
+              k8s:
+                properties:
+                  pod:
+                    properties:
+                      uid:
+                        type: keyword
+                        time_series_dimension: true
+                      name:
+                        type: keyword
+                  agent:
+                    type: flattened
+                  value:
+                    type: long
+                    time_series_metric: gauge
+
+  - do:
+      bulk:
+        refresh: true
+        index: source_index
+        body:
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:04.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.4" }, "value": 10 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:24.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.5" }, "value": 20 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T20:50:44.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.6" }, "value": 12 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T20:51:04.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.7" }, "value": 15 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:03.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.7" }, "value": 9 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:23.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.8" }, "value": 16 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T19:50:53.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.9" }, "value": 25 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T19:51:03.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.10" }, "value": 17 }}'
+
+  - do:
+      indices.put_settings:
+        index: source_index
+        body:
+          index.blocks.write: true
+
+  - do:
+      indices.downsample:
+        index: source_index
+        target_index: target_index
+        body: >
+          {
+            "fixed_interval": "1h"
+          }
+  - is_true: acknowledged
+
+  - do:
+      search:
+        index: target_index
+        body:
+          sort: [ "_tsid", "@timestamp" ]
+
+  - length: { hits.hits: 4 }
+  - match: { hits.hits.0._source._doc_count: 2 }
+  - match: { hits.hits.0._source.k8s\.pod\.uid: df3145b3-0563-4d3b-a0f7-897eb2876ea9 }
+  - match: { hits.hits.0._source.@timestamp: 2021-04-28T18:00:00.000Z }
+  - match: { hits.hits.0._source.k8s\.agent: { "id": "second", "version": "2.1.8" } }
+
+  - match: { hits.hits.1._source._doc_count: 2 }
+  - match: { hits.hits.1._source.k8s\.pod\.uid: df3145b3-0563-4d3b-a0f7-897eb2876ea9 }
+  - match: { hits.hits.1._source.@timestamp: 2021-04-28T19:00:00.000Z }
+  - match: { hits.hits.1._source.k8s\.agent: { "id": "second", "version": "2.1.10" } }
+
+  - match: { hits.hits.2._source._doc_count: 2 }
+  - match: { hits.hits.2._source.k8s\.pod\.uid: 947e4ced-1786-4e53-9e0c-5c447e959507 }
+  - match: { hits.hits.2._source.@timestamp: 2021-04-28T18:00:00.000Z }
+  - match: { hits.hits.2._source.k8s\.agent: { "id": "first", "version": "2.0.5" } }
+
+  - match: { hits.hits.3._source._doc_count: 2 }
+  - match: { hits.hits.3._source.k8s\.pod\.uid: 947e4ced-1786-4e53-9e0c-5c447e959507 }
+  - match: { hits.hits.3._source.@timestamp: 2021-04-28T20:00:00.000Z }
+  - match: { hits.hits.3._source.k8s\.agent: { "id": "first", "version": "2.0.7" } }
+
+---
+"A flattened label field with no doc values":
+  - do:
+      indices.create:
+        index: source_index
+        body:
+          settings:
+            number_of_shards: 1
+            index:
+              mode: time_series
+              routing_path: [ metricset, k8s.pod.uid ]
+              time_series:
+                start_time: 2021-04-28T00:00:00Z
+                end_time: 2021-04-29T00:00:00Z
+          mappings:
+            subobjects: false
+            properties:
+              "@timestamp":
+                type: date
+              metricset:
+                type: keyword
+                time_series_dimension: true
+              k8s:
+                properties:
+                  pod:
+                    properties:
+                      uid:
+                        type: keyword
+                        time_series_dimension: true
+                      name:
+                        type: keyword
+                  agent:
+                    type: flattened
+                    doc_values: false
+                  value:
+                    type: long
+                    time_series_metric: gauge
+
+  - do:
+      bulk:
+        refresh: true
+        index: source_index
+        body:
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:04.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.4" }, "value": 10 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:24.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.5" }, "value": 20 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T20:50:44.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.6" }, "value": 12 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T20:51:04.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.7" }, "value": 15 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:03.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.7" }, "value": 9 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:23.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.8" }, "value": 16 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T19:50:53.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.9" }, "value": 25 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T19:51:03.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.10" }, "value": 17 }}'
+
+  - do:
+      indices.put_settings:
+        index: source_index
+        body:
+          index.blocks.write: true
+
+  - do:
+      indices.downsample:
+        index: source_index
+        target_index: target_index
+        body: >
+          {
+            "fixed_interval": "1h"
+          }
+  - is_true: acknowledged
+
+  - do:
+      search:
+        index: target_index
+        body:
+          sort: [ "_tsid", "@timestamp" ]
+
+  - length: { hits.hits: 4 }
+  - match: { hits.hits.0._source._doc_count: 2 }
+  - match: { hits.hits.0._source.k8s\.pod\.uid: df3145b3-0563-4d3b-a0f7-897eb2876ea9 }
+  - match: { hits.hits.0._source.@timestamp: 2021-04-28T18:00:00.000Z }
+  - is_false: hits.hits.0._source.k8s\.agent
+
+  - match: { hits.hits.1._source._doc_count: 2 }
+  - match: { hits.hits.1._source.k8s\.pod\.uid: df3145b3-0563-4d3b-a0f7-897eb2876ea9 }
+  - match: { hits.hits.1._source.@timestamp: 2021-04-28T19:00:00.000Z }
+  - is_false: hits.hits.1._source.k8s\.agent
+
+  - match: { hits.hits.2._source._doc_count: 2 }
+  - match: { hits.hits.2._source.k8s\.pod\.uid: 947e4ced-1786-4e53-9e0c-5c447e959507 }
+  - match: { hits.hits.2._source.@timestamp: 2021-04-28T18:00:00.000Z }
+  - is_false: hits.hits.2._source.k8s\.agent
+
+  - match: { hits.hits.3._source._doc_count: 2 }
+  - match: { hits.hits.3._source.k8s\.pod\.uid: 947e4ced-1786-4e53-9e0c-5c447e959507 }
+  - match: { hits.hits.3._source.@timestamp: 2021-04-28T20:00:00.000Z }
+  - is_false: hits.hits.3._source.k8s\.agent
+
+---
+"A flattened label field with mixed content":
+  - do:
+      indices.create:
+        index: source_index
+        body:
+          settings:
+            number_of_shards: 1
+            index:
+              mode: time_series
+              routing_path: [ metricset, k8s.pod.uid ]
+              time_series:
+                start_time: 2021-04-28T00:00:00Z
+                end_time: 2021-04-29T00:00:00Z
+          mappings:
+            subobjects: false
+            properties:
+              "@timestamp":
+                type: date
+              metricset:
+                type: keyword
+                time_series_dimension: true
+              k8s:
+                properties:
+                  pod:
+                    properties:
+                      uid:
+                        type: keyword
+                        time_series_dimension: true
+                      name:
+                        type: keyword
+                  agent:
+                    type: flattened
+                    null_value: my_null_value
+                  value:
+                    type: long
+                    time_series_metric: gauge
+
+  - do:
+      bulk:
+        refresh: true
+        index: source_index
+        body:
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:04.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.4", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11 }, "value": 10 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:24.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.5", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 20 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T20:50:44.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.6", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 12 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T20:51:04.467Z", "metricset": "pod", "k8s": {"pod": {"name": "cat", "uid":"947e4ced-1786-4e53-9e0c-5c447e959507"}, "agent": { "id": "first", "version": "2.0.7", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 15 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:03.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.7", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 9 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T18:50:23.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.8", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 16 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T19:50:53.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.9", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 25 }}'
+          - '{"index": {}}'
+          - '{"@timestamp": "2021-04-28T19:51:03.142Z", "metricset": "pod", "k8s": {"pod": {"name": "dog", "uid":"df3145b3-0563-4d3b-a0f7-897eb2876ea9"}, "agent": { "id": "second", "version": "2.1.10", "versions": ["1", "2", "3"], "optional_version": null, "dotted.version": "1.1", "numeric_version": 11}, "value": 17 }}'
+
+  - do:
+      indices.put_settings:
+        index: source_index
+        body:
+          index.blocks.write: true
+
+  - do:
+      indices.downsample:
+        index: source_index
+        target_index: target_index
+        body: >
+          {
+            "fixed_interval": "1h"
+          }
+  - is_true: acknowledged
+
+  - do:
+      search:
+        index: target_index
+        body:
+          sort: [ "_tsid", "@timestamp" ]
+
+  - length: { hits.hits: 4 }
+  - match: { hits.hits.0._source._doc_count: 2 }
+  - match: { hits.hits.0._source.k8s\.pod\.uid: df3145b3-0563-4d3b-a0f7-897eb2876ea9 }
+  - match: { hits.hits.0._source.@timestamp: 2021-04-28T18:00:00.000Z }
+  - match: { hits.hits.0._source.k8s\.agent: { "id": "second", "version": "2.1.8", "versions": ["1", "2", "3"], "dotted": {"version": "1.1"}, "numeric_version": "11", optional_version: "my_null_value" } }
+
+  - match: { hits.hits.1._source._doc_count: 2 }
+  - match: { hits.hits.1._source.k8s\.pod\.uid: df3145b3-0563-4d3b-a0f7-897eb2876ea9 }
+  - match: { hits.hits.1._source.@timestamp: 2021-04-28T19:00:00.000Z }
+  - match: { hits.hits.1._source.k8s\.agent: { "id": "second", "version": "2.1.10", "versions": ["1", "2", "3"], "dotted": {"version": "1.1"}, "numeric_version": "11", optional_version: "my_null_value" } }
+
+  - match: { hits.hits.2._source._doc_count: 2 }
+  - match: { hits.hits.2._source.k8s\.pod\.uid: 947e4ced-1786-4e53-9e0c-5c447e959507 }
+  - match: { hits.hits.2._source.@timestamp: 2021-04-28T18:00:00.000Z }
+  - match: { hits.hits.2._source.k8s\.agent: { "id": "first", "version": "2.0.5", "versions": ["1", "2", "3"], "dotted": {"version": "1.1"}, "numeric_version": "11", optional_version: "my_null_value" } }
+
+  - match: { hits.hits.3._source._doc_count: 2 }
+  - match: { hits.hits.3._source.k8s\.pod\.uid: 947e4ced-1786-4e53-9e0c-5c447e959507 }
+  - match: { hits.hits.3._source.@timestamp: 2021-04-28T20:00:00.000Z }
+  - match: { hits.hits.3._source.k8s\.agent: { "id": "first", "version": "2.0.7", "versions": ["1", "2", "3"], "dotted": {"version": "1.1"}, "numeric_version": "11", optional_version: "my_null_value" } }
diff --git a/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/FieldValueFetcher.java b/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/FieldValueFetcher.java
index 74375bbe27939..3657e4989ccbd 100644
--- a/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/FieldValueFetcher.java
+++ b/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/FieldValueFetcher.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.index.fielddata.IndexFieldData;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.index.mapper.NumberFieldMapper;
+import org.elasticsearch.index.mapper.flattened.FlattenedFieldMapper;
 import org.elasticsearch.index.query.SearchExecutionContext;
 import org.elasticsearch.search.DocValueFormat;
 import org.elasticsearch.xpack.aggregatemetric.mapper.AggregateDoubleMetricFieldMapper;
@@ -65,6 +66,8 @@ private AbstractDownsampleFieldProducer createFieldProducer() {
             // If field is not a metric, we downsample it as a label
             if ("histogram".equals(fieldType.typeName())) {
                 return new LabelFieldProducer.HistogramLastLabelFieldProducer(name());
+            } else if ("flattened".equals(fieldType.typeName())) {
+                return new LabelFieldProducer.FlattenedLastValueFieldProducer(name());
             }
             return new LabelFieldProducer.LabelLastValueFieldProducer(name());
         }
@@ -90,7 +93,13 @@ static List<FieldValueFetcher> create(SearchExecutionContext context, String[] f
                 }
             } else {
                 if (context.fieldExistsInIndex(field)) {
-                    final IndexFieldData<?> fieldData = context.getForField(fieldType, MappedFieldType.FielddataOperation.SEARCH);
+                    final IndexFieldData<?> fieldData;
+                    if (fieldType instanceof FlattenedFieldMapper.RootFlattenedFieldType flattenedFieldType) {
+                        var keyedFieldType = flattenedFieldType.getKeyedFieldType();
+                        fieldData = context.getForField(keyedFieldType, MappedFieldType.FielddataOperation.SEARCH);
+                    } else {
+                        fieldData = context.getForField(fieldType, MappedFieldType.FielddataOperation.SEARCH);
+                    }
                     final String fieldName = context.isMultiField(field)
                         ? fieldType.name().substring(0, fieldType.name().lastIndexOf('.'))
                         : fieldType.name();
diff --git a/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/LabelFieldProducer.java b/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/LabelFieldProducer.java
index 05b4852d0dfd3..b211c5bfb0d12 100644
--- a/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/LabelFieldProducer.java
+++ b/x-pack/plugin/downsample/src/main/java/org/elasticsearch/xpack/downsample/LabelFieldProducer.java
@@ -7,8 +7,10 @@
 
 package org.elasticsearch.xpack.downsample;
 
+import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.index.fielddata.FormattedDocValues;
 import org.elasticsearch.index.fielddata.HistogramValue;
+import org.elasticsearch.index.mapper.flattened.FlattenedFieldSyntheticWriterHelper;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xpack.aggregatemetric.mapper.AggregateDoubleMetricFieldMapper.Metric;
 
@@ -141,14 +143,14 @@ public void reset() {
         }
     }
 
-    static class AggregateMetricFieldProducer extends LabelLastValueFieldProducer {
+    static final class AggregateMetricFieldProducer extends LabelLastValueFieldProducer {
 
         AggregateMetricFieldProducer(String name, Metric metric) {
             super(name, new LastValueLabel(metric.name()));
         }
     }
 
-    public static class HistogramLastLabelFieldProducer extends LabelLastValueFieldProducer {
+    static final class HistogramLastLabelFieldProducer extends LabelLastValueFieldProducer {
         HistogramLastLabelFieldProducer(String name) {
             super(name);
         }
@@ -167,4 +169,40 @@ public void write(XContentBuilder builder) throws IOException {
             }
         }
     }
+
+    static final class FlattenedLastValueFieldProducer extends LabelLastValueFieldProducer {
+
+        FlattenedLastValueFieldProducer(String name) {
+            super(name);
+        }
+
+        @Override
+        public void write(XContentBuilder builder) throws IOException {
+            if (isEmpty() == false) {
+                builder.startObject(name());
+
+                var value = label.get();
+                List<BytesRef> list;
+                if (value instanceof Object[] values) {
+                    list = new ArrayList<>(values.length);
+                    for (Object v : values) {
+                        list.add(new BytesRef(v.toString()));
+                    }
+                } else {
+                    list = List.of(new BytesRef(value.toString()));
+                }
+
+                var iterator = list.iterator();
+                var helper = new FlattenedFieldSyntheticWriterHelper(() -> {
+                    if (iterator.hasNext()) {
+                        return iterator.next();
+                    } else {
+                        return null;
+                    }
+                });
+                helper.write(builder);
+                builder.endObject();
+            }
+        }
+    }
 }
diff --git a/x-pack/plugin/downsample/src/test/java/org/elasticsearch/xpack/downsample/LabelFieldProducerTests.java b/x-pack/plugin/downsample/src/test/java/org/elasticsearch/xpack/downsample/LabelFieldProducerTests.java
index 469e00f7af9af..844eb1b8e27d8 100644
--- a/x-pack/plugin/downsample/src/test/java/org/elasticsearch/xpack/downsample/LabelFieldProducerTests.java
+++ b/x-pack/plugin/downsample/src/test/java/org/elasticsearch/xpack/downsample/LabelFieldProducerTests.java
@@ -7,10 +7,18 @@
 
 package org.elasticsearch.xpack.downsample;
 
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.index.fielddata.FormattedDocValues;
 import org.elasticsearch.search.aggregations.AggregatorTestCase;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentType;
 
+import java.io.ByteArrayOutputStream;
 import java.io.IOException;
+import java.util.Iterator;
+import java.util.List;
+
+import static org.hamcrest.Matchers.equalTo;
 
 public class LabelFieldProducerTests extends AggregatorTestCase {
 
@@ -93,4 +101,50 @@ public Object nextValue() {
         assertTrue(producer.isEmpty());
         assertNull(producer.label().get());
     }
+
+    public void testFlattenedLastValueFieldProducer() throws IOException {
+        var producer = new LabelFieldProducer.FlattenedLastValueFieldProducer("dummy");
+        assertTrue(producer.isEmpty());
+        assertEquals("dummy", producer.name());
+        assertEquals("last_value", producer.label().name());
+
+        var bytes = List.of("a\0value_a", "b\0value_b", "c\0value_c", "d\0value_d");
+        var docValues = new FormattedDocValues() {
+
+            Iterator<String> iterator = bytes.iterator();
+
+            @Override
+            public boolean advanceExact(int docId) {
+                return true;
+            }
+
+            @Override
+            public int docValueCount() {
+                return bytes.size();
+            }
+
+            @Override
+            public Object nextValue() {
+                return iterator.next();
+            }
+        };
+
+        producer.collect(docValues, 1);
+        assertFalse(producer.isEmpty());
+        assertEquals("a\0value_a", (((Object[]) producer.label().get())[0]).toString());
+        assertEquals("b\0value_b", (((Object[]) producer.label().get())[1]).toString());
+        assertEquals("c\0value_c", (((Object[]) producer.label().get())[2]).toString());
+        assertEquals("d\0value_d", (((Object[]) producer.label().get())[3]).toString());
+
+        var builder = new XContentBuilder(XContentType.JSON.xContent(), new ByteArrayOutputStream());
+        builder.startObject();
+        producer.write(builder);
+        builder.endObject();
+        var content = Strings.toString(builder);
+        assertThat(content, equalTo("{\"dummy\":{\"a\":\"value_a\",\"b\":\"value_b\",\"c\":\"value_c\",\"d\":\"value_d\"}}"));
+
+        producer.reset();
+        assertTrue(producer.isEmpty());
+        assertNull(producer.label().get());
+    }
 }

From b34867115cee9461f6aaf67aee05fb2c303b6f7d Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Wed, 18 Dec 2024 13:09:33 +0200
Subject: [PATCH 063/119] Lookup join on multiple join fields not yet supported
 (#118858)

---
 docs/changelog/118858.yaml                    |  5 +++
 .../xpack/esql/parser/LogicalPlanBuilder.java |  5 +++
 .../xpack/esql/analysis/ParsingTests.java     | 41 +++++++++++++++++++
 3 files changed, 51 insertions(+)
 create mode 100644 docs/changelog/118858.yaml

diff --git a/docs/changelog/118858.yaml b/docs/changelog/118858.yaml
new file mode 100644
index 0000000000000..a2161df1c84c7
--- /dev/null
+++ b/docs/changelog/118858.yaml
@@ -0,0 +1,5 @@
+pr: 118858
+summary: Lookup join on multiple join fields not yet supported
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/LogicalPlanBuilder.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/LogicalPlanBuilder.java
index 24398afa18010..49d77bc36fb2e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/LogicalPlanBuilder.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/LogicalPlanBuilder.java
@@ -564,6 +564,11 @@ public PlanFactory visitJoinCommand(EsqlBaseParser.JoinCommandContext ctx) {
             }
         }
 
+        var matchFieldsCount = joinFields.size();
+        if (matchFieldsCount > 1) {
+            throw new ParsingException(source, "JOIN ON clause only supports one field at the moment, found [{}]", matchFieldsCount);
+        }
+
         return p -> new LookupJoin(source, p, right, joinFields);
     }
 }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
index 205c8943d4e3c..90a215653f251 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.json.JsonXContent;
 import org.elasticsearch.xpack.esql.LoadMapping;
+import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.type.DataType;
 import org.elasticsearch.xpack.esql.expression.function.EsqlFunctionRegistry;
@@ -111,6 +112,46 @@ public void testTooBigQuery() {
         assertEquals("-1:-1: ESQL statement is too large [1000011 characters > 1000000]", error(query.toString()));
     }
 
+    public void testJoinOnConstant() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assertEquals(
+            "1:55: JOIN ON clause only supports fields at the moment, found [123]",
+            error("row languages = 1, gender = \"f\" | lookup join test on 123")
+        );
+        assertEquals(
+            "1:55: JOIN ON clause only supports fields at the moment, found [\"abc\"]",
+            error("row languages = 1, gender = \"f\" | lookup join test on \"abc\"")
+        );
+        assertEquals(
+            "1:55: JOIN ON clause only supports fields at the moment, found [false]",
+            error("row languages = 1, gender = \"f\" | lookup join test on false")
+        );
+    }
+
+    public void testJoinOnMultipleFields() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assertEquals(
+            "1:35: JOIN ON clause only supports one field at the moment, found [2]",
+            error("row languages = 1, gender = \"f\" | lookup join test on gender, languages")
+        );
+    }
+
+    public void testJoinTwiceOnTheSameField() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assertEquals(
+            "1:35: JOIN ON clause only supports one field at the moment, found [2]",
+            error("row languages = 1, gender = \"f\" | lookup join test on languages, languages")
+        );
+    }
+
+    public void testJoinTwiceOnTheSameField_TwoLookups() {
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assertEquals(
+            "1:80: JOIN ON clause only supports one field at the moment, found [2]",
+            error("row languages = 1, gender = \"f\" | lookup join test on languages | eval x = 1 | lookup join test on gender, gender")
+        );
+    }
+
     private String functionName(EsqlFunctionRegistry registry, Expression functionCall) {
         for (FunctionDefinition def : registry.listFunctions()) {
             if (functionCall.getClass().equals(def.clazz())) {

From 4974336221f3b26678bc31ded4b34083e35523ae Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Wed, 18 Dec 2024 12:25:27 +0100
Subject: [PATCH 064/119] Fix synthetic recovery source version validation.
 (#118924)

The validation didn't work as expected, because created version was always 0 (which is created version default value).

Moving the validation to a place that does have access to the index version.
---
 .../indices.create/20_synthetic_source.yml    | 39 ++++++++++++++
 .../elasticsearch/index/IndexSettings.java    | 38 ++++++-------
 .../index/mapper/MapperFeatures.java          |  3 +-
 .../index/mapper/SourceFieldMapper.java       |  1 +
 .../index/mapper/SourceFieldMapperTests.java  | 54 -------------------
 5 files changed, 61 insertions(+), 74 deletions(-)

diff --git a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml
index af3d88fb35734..fc0bfa144bbc4 100644
--- a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml
+++ b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml
@@ -2012,3 +2012,42 @@ synthetic_source with copy_to pointing inside dynamic object:
       hits.hits.2.fields:
         c.copy.keyword: [ "hello", "zap" ]
 
+---
+create index with use_synthetic_source:
+  - requires:
+      cluster_features: ["mapper.synthetic_recovery_source"]
+      reason: requires synthetic recovery source
+
+  - do:
+      indices.create:
+        index: test
+        body:
+          settings:
+            index:
+              recovery:
+                use_synthetic_source: true
+              mapping:
+                source:
+                  mode: synthetic
+
+  - do:
+      indices.get_settings: {}
+  - match: { test.settings.index.mapping.source.mode: synthetic}
+  - is_true: test.settings.index.recovery.use_synthetic_source
+
+  - do:
+      bulk:
+        index: test
+        refresh: true
+        body:
+          - '{ "create": { } }'
+          - '{ "field": "aaaa" }'
+          - '{ "create": { } }'
+          - '{ "field": "bbbb" }'
+
+  - do:
+      indices.disk_usage:
+        index: test
+        run_expensive_tasks: true
+  - gt: { test.fields.field.total_in_bytes: 0 }
+  - is_false: test.fields.field._recovery_source
diff --git a/server/src/main/java/org/elasticsearch/index/IndexSettings.java b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
index b15828c5594ae..9273888b9ec91 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexSettings.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexSettings.java
@@ -685,29 +685,11 @@ public void validate(Boolean enabled, Map<Setting<?>, Object> settings) {
                         );
                     }
                 }
-
-                // Verify that all nodes can handle this setting
-                var version = (IndexVersion) settings.get(SETTING_INDEX_VERSION_CREATED);
-                if (version.before(IndexVersions.USE_SYNTHETIC_SOURCE_FOR_RECOVERY)
-                    && version.between(
-                        IndexVersions.USE_SYNTHETIC_SOURCE_FOR_RECOVERY_BACKPORT,
-                        IndexVersions.UPGRADE_TO_LUCENE_10_0_0
-                    ) == false) {
-                    throw new IllegalArgumentException(
-                        String.format(
-                            Locale.ROOT,
-                            "The setting [%s] is unavailable on this cluster because some nodes are running older "
-                                + "versions that do not support it. Please upgrade all nodes to the latest version "
-                                + "and try again.",
-                            RECOVERY_USE_SYNTHETIC_SOURCE_SETTING.getKey()
-                        )
-                    );
-                }
             }
 
             @Override
             public Iterator<Setting<?>> settings() {
-                List<Setting<?>> res = List.of(INDEX_MAPPER_SOURCE_MODE_SETTING, SETTING_INDEX_VERSION_CREATED, MODE);
+                List<Setting<?>> res = List.of(INDEX_MAPPER_SOURCE_MODE_SETTING, MODE);
                 return res.iterator();
             }
         },
@@ -1050,6 +1032,24 @@ public IndexSettings(final IndexMetadata indexMetadata, final Settings nodeSetti
         indexMappingSourceMode = scopedSettings.get(INDEX_MAPPER_SOURCE_MODE_SETTING);
         recoverySourceEnabled = RecoverySettings.INDICES_RECOVERY_SOURCE_ENABLED_SETTING.get(nodeSettings);
         recoverySourceSyntheticEnabled = scopedSettings.get(RECOVERY_USE_SYNTHETIC_SOURCE_SETTING);
+        if (recoverySourceSyntheticEnabled) {
+            // Verify that all nodes can handle this setting
+            if (version.before(IndexVersions.USE_SYNTHETIC_SOURCE_FOR_RECOVERY)
+                && version.between(
+                    IndexVersions.USE_SYNTHETIC_SOURCE_FOR_RECOVERY_BACKPORT,
+                    IndexVersions.UPGRADE_TO_LUCENE_10_0_0
+                ) == false) {
+                throw new IllegalArgumentException(
+                    String.format(
+                        Locale.ROOT,
+                        "The setting [%s] is unavailable on this cluster because some nodes are running older "
+                            + "versions that do not support it. Please upgrade all nodes to the latest version "
+                            + "and try again.",
+                        RECOVERY_USE_SYNTHETIC_SOURCE_SETTING.getKey()
+                    )
+                );
+            }
+        }
 
         scopedSettings.addSettingsUpdateConsumer(
             MergePolicyConfig.INDEX_COMPOUND_FORMAT_SETTING,
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java b/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java
index 276d3e151361c..5dbaf0e0f40ad 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java
@@ -77,7 +77,8 @@ public Set<NodeFeature> getTestFeatures() {
             DocumentParser.FIX_PARSING_SUBOBJECTS_FALSE_DYNAMIC_FALSE,
             CONSTANT_KEYWORD_SYNTHETIC_SOURCE_WRITE_FIX,
             META_FETCH_FIELDS_ERROR_CODE_CHANGED,
-            SPARSE_VECTOR_STORE_SUPPORT
+            SPARSE_VECTOR_STORE_SUPPORT,
+            SourceFieldMapper.SYNTHETIC_RECOVERY_SOURCE
         );
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java
index 85f4217811a84..5f1ba6f0ab2a1 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/SourceFieldMapper.java
@@ -56,6 +56,7 @@ public class SourceFieldMapper extends MetadataFieldMapper {
         "mapper.source.remove_synthetic_source_only_validation"
     );
     public static final NodeFeature SOURCE_MODE_FROM_INDEX_SETTING = new NodeFeature("mapper.source.mode_from_index_setting");
+    public static final NodeFeature SYNTHETIC_RECOVERY_SOURCE = new NodeFeature("mapper.synthetic_recovery_source");
 
     public static final String NAME = "_source";
     public static final String RECOVERY_SOURCE_NAME = "_recovery_source";
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
index 378920d0e6db5..b7693513a434d 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/SourceFieldMapperTests.java
@@ -465,60 +465,6 @@ public void testRecoverySourceWitInvalidSettings() {
                 )
             );
         }
-        {
-            Settings settings = Settings.builder()
-                .put(SourceFieldMapper.INDEX_MAPPER_SOURCE_MODE_SETTING.getKey(), SourceFieldMapper.Mode.SYNTHETIC.toString())
-                .put(IndexSettings.RECOVERY_USE_SYNTHETIC_SOURCE_SETTING.getKey(), true)
-                .build();
-            IllegalArgumentException exc = expectThrows(
-                IllegalArgumentException.class,
-                () -> createMapperService(
-                    IndexVersionUtils.randomPreviousCompatibleVersion(random(), IndexVersions.USE_SYNTHETIC_SOURCE_FOR_RECOVERY_BACKPORT),
-                    settings,
-                    () -> false,
-                    topMapping(b -> {})
-                )
-            );
-            assertThat(
-                exc.getMessage(),
-                containsString(
-                    String.format(
-                        Locale.ROOT,
-                        "The setting [%s] is unavailable on this cluster",
-                        IndexSettings.RECOVERY_USE_SYNTHETIC_SOURCE_SETTING.getKey()
-                    )
-                )
-            );
-        }
-        {
-            Settings settings = Settings.builder()
-                .put(SourceFieldMapper.INDEX_MAPPER_SOURCE_MODE_SETTING.getKey(), SourceFieldMapper.Mode.SYNTHETIC.toString())
-                .put(IndexSettings.RECOVERY_USE_SYNTHETIC_SOURCE_SETTING.getKey(), true)
-                .build();
-            IllegalArgumentException exc = expectThrows(
-                IllegalArgumentException.class,
-                () -> createMapperService(
-                    IndexVersionUtils.randomVersionBetween(
-                        random(),
-                        IndexVersions.UPGRADE_TO_LUCENE_10_0_0,
-                        IndexVersions.DEPRECATE_SOURCE_MODE_MAPPER
-                    ),
-                    settings,
-                    () -> false,
-                    topMapping(b -> {})
-                )
-            );
-            assertThat(
-                exc.getMessage(),
-                containsString(
-                    String.format(
-                        Locale.ROOT,
-                        "The setting [%s] is unavailable on this cluster",
-                        IndexSettings.RECOVERY_USE_SYNTHETIC_SOURCE_SETTING.getKey()
-                    )
-                )
-            );
-        }
     }
 
     public void testRecoverySourceWithSyntheticSource() throws IOException {

From 4fbe306a1e0d137ae299dab44659a263a7f9dc46 Mon Sep 17 00:00:00 2001
From: Rene Groeschke <rene@elastic.co>
Date: Wed, 18 Dec 2024 12:57:33 +0100
Subject: [PATCH 065/119] Revert "Support mTLS in Elastic Inference Service
 plugin (#116423)" (#118765) (#118902)

---
 docs/changelog/116423.yaml                    |   5 -
 .../xpack/core/ssl/SSLService.java            |   2 -
 .../core/LocalStateCompositeXPackPlugin.java  |   2 +-
 .../xpack/core/ssl/SSLServiceTests.java       |   3 +-
 .../ShardBulkInferenceActionFilterIT.java     |   3 +-
 .../integration/ModelRegistryIT.java          |   4 +-
 .../inference/src/main/java/module-info.java  |   1 -
 .../xpack/inference/InferencePlugin.java      | 101 +++++-------------
 .../external/http/HttpClientManager.java      |  44 --------
 .../TextSimilarityRankRetrieverBuilder.java   |  11 +-
 .../ElasticInferenceServiceSettings.java      |  24 +----
 .../SemanticTextClusterMetadataTests.java     |   3 +-
 .../xpack/inference/InferencePluginTests.java |  65 -----------
 .../inference/LocalStateInferencePlugin.java  |  71 ------------
 .../elasticsearch/xpack/inference/Utils.java  |  15 +++
 ...emanticTextNonDynamicFieldMapperTests.java |   3 +-
 .../TextSimilarityRankMultiNodeTests.java     |   4 +-
 ...SimilarityRankRetrieverTelemetryTests.java |   5 +-
 .../TextSimilarityRankTests.java              |   4 +-
 .../xpack/ml/LocalStateMachineLearning.java   |   7 --
 .../xpack/ml/support/BaseMlIntegTestCase.java |   4 +-
 .../security/CrossClusterShardTests.java      |   2 +
 22 files changed, 69 insertions(+), 314 deletions(-)
 delete mode 100644 docs/changelog/116423.yaml
 delete mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java
 delete mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java

diff --git a/docs/changelog/116423.yaml b/docs/changelog/116423.yaml
deleted file mode 100644
index d6d10eab410e4..0000000000000
--- a/docs/changelog/116423.yaml
+++ /dev/null
@@ -1,5 +0,0 @@
-pr: 116423
-summary: Support mTLS for the Elastic Inference Service integration inside the inference API
-area: Machine Learning
-type: feature
-issues: []
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
index d0d5e463f9652..9704335776f11 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ssl/SSLService.java
@@ -596,8 +596,6 @@ static Map<String, Settings> getSSLSettingsMap(Settings settings) {
         sslSettingsMap.put(WatcherField.EMAIL_NOTIFICATION_SSL_PREFIX, settings.getByPrefix(WatcherField.EMAIL_NOTIFICATION_SSL_PREFIX));
         sslSettingsMap.put(XPackSettings.TRANSPORT_SSL_PREFIX, settings.getByPrefix(XPackSettings.TRANSPORT_SSL_PREFIX));
         sslSettingsMap.putAll(getTransportProfileSSLSettings(settings));
-        // Mount Elastic Inference Service (part of the Inference plugin) configuration
-        sslSettingsMap.put("xpack.inference.elastic.http.ssl", settings.getByPrefix("xpack.inference.elastic.http.ssl."));
         // Only build remote cluster server SSL if the port is enabled
         if (REMOTE_CLUSTER_SERVER_ENABLED.get(settings)) {
             sslSettingsMap.put(XPackSettings.REMOTE_CLUSTER_SERVER_SSL_PREFIX, getRemoteClusterServerSslSettings(settings));
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
index d50f7bb27a5df..1f2c89c473a62 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/LocalStateCompositeXPackPlugin.java
@@ -623,7 +623,7 @@ public Map<String, IndexStorePlugin.SnapshotCommitSupplier> getSnapshotCommitSup
     }
 
     @SuppressWarnings("unchecked")
-    protected <T> List<T> filterPlugins(Class<T> type) {
+    private <T> List<T> filterPlugins(Class<T> type) {
         return plugins.stream().filter(x -> type.isAssignableFrom(x.getClass())).map(p -> ((T) p)).collect(Collectors.toList());
     }
 
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
index bfac286bc3c35..9663e41a647a8 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ssl/SSLServiceTests.java
@@ -614,8 +614,7 @@ public void testGetConfigurationByContextName() throws Exception {
             "xpack.security.authc.realms.ldap.realm1.ssl",
             "xpack.security.authc.realms.saml.realm2.ssl",
             "xpack.monitoring.exporters.mon1.ssl",
-            "xpack.monitoring.exporters.mon2.ssl",
-            "xpack.inference.elastic.http.ssl" };
+            "xpack.monitoring.exporters.mon2.ssl" };
 
         assumeTrue("Not enough cipher suites are available to support this test", getCipherSuites.length >= contextNames.length);
 
diff --git a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java
index c7b3a9d42f579..3b0fc869c8124 100644
--- a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java
+++ b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/action/filter/ShardBulkInferenceActionFilterIT.java
@@ -22,7 +22,6 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.test.ESIntegTestCase;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
 import org.elasticsearch.xpack.inference.Utils;
 import org.elasticsearch.xpack.inference.mock.TestDenseInferenceServiceExtension;
 import org.elasticsearch.xpack.inference.mock.TestSparseInferenceServiceExtension;
@@ -59,7 +58,7 @@ public void setup() throws Exception {
 
     @Override
     protected Collection<Class<? extends Plugin>> nodePlugins() {
-        return Arrays.asList(LocalStateInferencePlugin.class);
+        return Arrays.asList(Utils.TestInferencePlugin.class);
     }
 
     public void testBulkOperations() throws Exception {
diff --git a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java
index d5c156d1d4f46..be6b3725b0f35 100644
--- a/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java
+++ b/x-pack/plugin/inference/src/internalClusterTest/java/org/elasticsearch/xpack/inference/integration/ModelRegistryIT.java
@@ -31,7 +31,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xcontent.ToXContentObject;
 import org.elasticsearch.xcontent.XContentBuilder;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.inference.chunking.ChunkingSettingsTests;
 import org.elasticsearch.xpack.inference.registry.ModelRegistry;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalModel;
@@ -76,7 +76,7 @@ public void createComponents() {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return pluginList(ReindexPlugin.class, LocalStateInferencePlugin.class);
+        return pluginList(ReindexPlugin.class, InferencePlugin.class);
     }
 
     public void testStoreModel() throws Exception {
diff --git a/x-pack/plugin/inference/src/main/java/module-info.java b/x-pack/plugin/inference/src/main/java/module-info.java
index 1c2240e8c5217..53974657e4e23 100644
--- a/x-pack/plugin/inference/src/main/java/module-info.java
+++ b/x-pack/plugin/inference/src/main/java/module-info.java
@@ -34,7 +34,6 @@
     requires software.amazon.awssdk.retries.api;
     requires org.reactivestreams;
     requires org.elasticsearch.logging;
-    requires org.elasticsearch.sslconfig;
 
     exports org.elasticsearch.xpack.inference.action;
     exports org.elasticsearch.xpack.inference.registry;
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
index 169c8f87043e8..72fa840ad19b0 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.indices.SystemIndexDescriptor;
 import org.elasticsearch.inference.InferenceServiceExtension;
 import org.elasticsearch.inference.InferenceServiceRegistry;
-import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.node.PluginComponentBinding;
 import org.elasticsearch.plugins.ActionPlugin;
 import org.elasticsearch.plugins.ExtensiblePlugin;
@@ -46,7 +45,6 @@
 import org.elasticsearch.threadpool.ScalingExecutorBuilder;
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xpack.core.ClientHelper;
-import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.core.action.XPackUsageFeatureAction;
 import org.elasticsearch.xpack.core.inference.action.DeleteInferenceEndpointAction;
 import org.elasticsearch.xpack.core.inference.action.GetInferenceDiagnosticsAction;
@@ -56,7 +54,6 @@
 import org.elasticsearch.xpack.core.inference.action.PutInferenceModelAction;
 import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
 import org.elasticsearch.xpack.core.inference.action.UpdateInferenceModelAction;
-import org.elasticsearch.xpack.core.ssl.SSLService;
 import org.elasticsearch.xpack.inference.action.TransportDeleteInferenceEndpointAction;
 import org.elasticsearch.xpack.inference.action.TransportGetInferenceDiagnosticsAction;
 import org.elasticsearch.xpack.inference.action.TransportGetInferenceModelAction;
@@ -122,6 +119,7 @@
 import java.util.Map;
 import java.util.function.Predicate;
 import java.util.function.Supplier;
+import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 import static java.util.Collections.singletonList;
@@ -155,7 +153,6 @@ public class InferencePlugin extends Plugin implements ActionPlugin, ExtensibleP
     private final Settings settings;
     private final SetOnce<HttpRequestSender.Factory> httpFactory = new SetOnce<>();
     private final SetOnce<AmazonBedrockRequestSender.Factory> amazonBedrockFactory = new SetOnce<>();
-    private final SetOnce<HttpRequestSender.Factory> elasicInferenceServiceFactory = new SetOnce<>();
     private final SetOnce<ServiceComponents> serviceComponents = new SetOnce<>();
     private final SetOnce<ElasticInferenceServiceComponents> elasticInferenceServiceComponents = new SetOnce<>();
     private final SetOnce<InferenceServiceRegistry> inferenceServiceRegistry = new SetOnce<>();
@@ -238,31 +235,31 @@ public Collection<?> createComponents(PluginServices services) {
         var inferenceServices = new ArrayList<>(inferenceServiceExtensions);
         inferenceServices.add(this::getInferenceServiceFactories);
 
-        if (isElasticInferenceServiceEnabled()) {
-            // Create a separate instance of HTTPClientManager with its own SSL configuration (`xpack.inference.elastic.http.ssl.*`).
-            var elasticInferenceServiceHttpClientManager = HttpClientManager.create(
-                settings,
-                services.threadPool(),
-                services.clusterService(),
-                throttlerManager,
-                getSslService()
-            );
+        // Set elasticInferenceUrl based on feature flags to support transitioning to the new Elastic Inference Service URL without exposing
+        // internal names like "eis" or "gateway".
+        ElasticInferenceServiceSettings inferenceServiceSettings = new ElasticInferenceServiceSettings(settings);
+
+        String elasticInferenceUrl = null;
 
-            var elasticInferenceServiceRequestSenderFactory = new HttpRequestSender.Factory(
-                serviceComponents.get(),
-                elasticInferenceServiceHttpClientManager,
-                services.clusterService()
+        if (ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
+            elasticInferenceUrl = inferenceServiceSettings.getElasticInferenceServiceUrl();
+        } else if (DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
+            log.warn(
+                "Deprecated flag {} detected for enabling {}. Please use {}.",
+                ELASTIC_INFERENCE_SERVICE_IDENTIFIER,
+                DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG,
+                ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG
             );
-            elasicInferenceServiceFactory.set(elasticInferenceServiceRequestSenderFactory);
+            elasticInferenceUrl = inferenceServiceSettings.getEisGatewayUrl();
+        }
 
-            ElasticInferenceServiceSettings inferenceServiceSettings = new ElasticInferenceServiceSettings(settings);
-            String elasticInferenceUrl = this.getElasticInferenceServiceUrl(inferenceServiceSettings);
+        if (elasticInferenceUrl != null) {
             elasticInferenceServiceComponents.set(new ElasticInferenceServiceComponents(elasticInferenceUrl));
 
             inferenceServices.add(
                 () -> List.of(
                     context -> new ElasticInferenceService(
-                        elasicInferenceServiceFactory.get(),
+                        httpFactory.get(),
                         serviceComponents.get(),
                         elasticInferenceServiceComponents.get()
                     )
@@ -385,21 +382,16 @@ public static ExecutorBuilder<?> inferenceUtilityExecutor(Settings settings) {
 
     @Override
     public List<Setting<?>> getSettings() {
-        ArrayList<Setting<?>> settings = new ArrayList<>();
-        settings.addAll(HttpSettings.getSettingsDefinitions());
-        settings.addAll(HttpClientManager.getSettingsDefinitions());
-        settings.addAll(ThrottlerManager.getSettingsDefinitions());
-        settings.addAll(RetrySettings.getSettingsDefinitions());
-        settings.addAll(Truncator.getSettingsDefinitions());
-        settings.addAll(RequestExecutorServiceSettings.getSettingsDefinitions());
-        settings.add(SKIP_VALIDATE_AND_START);
-
-        // Register Elastic Inference Service settings definitions if the corresponding feature flag is enabled.
-        if (isElasticInferenceServiceEnabled()) {
-            settings.addAll(ElasticInferenceServiceSettings.getSettingsDefinitions());
-        }
-
-        return settings;
+        return Stream.of(
+            HttpSettings.getSettingsDefinitions(),
+            HttpClientManager.getSettingsDefinitions(),
+            ThrottlerManager.getSettingsDefinitions(),
+            RetrySettings.getSettingsDefinitions(),
+            ElasticInferenceServiceSettings.getSettingsDefinitions(),
+            Truncator.getSettingsDefinitions(),
+            RequestExecutorServiceSettings.getSettingsDefinitions(),
+            List.of(SKIP_VALIDATE_AND_START)
+        ).flatMap(Collection::stream).collect(Collectors.toList());
     }
 
     @Override
@@ -447,10 +439,7 @@ public List<QueryRewriteInterceptor> getQueryRewriteInterceptors() {
     @Override
     public List<RetrieverSpec<?>> getRetrievers() {
         return List.of(
-            new RetrieverSpec<>(
-                new ParseField(TextSimilarityRankBuilder.NAME),
-                (parser, context) -> TextSimilarityRankRetrieverBuilder.fromXContent(parser, context, getLicenseState())
-            ),
+            new RetrieverSpec<>(new ParseField(TextSimilarityRankBuilder.NAME), TextSimilarityRankRetrieverBuilder::fromXContent),
             new RetrieverSpec<>(new ParseField(RandomRankBuilder.NAME), RandomRankRetrieverBuilder::fromXContent)
         );
     }
@@ -459,36 +448,4 @@ public List<RetrieverSpec<?>> getRetrievers() {
     public Map<String, Highlighter> getHighlighters() {
         return Map.of(SemanticTextHighlighter.NAME, new SemanticTextHighlighter());
     }
-
-    // Get Elastic Inference service URL based on feature flags to support transitioning
-    // to the new Elastic Inference Service URL.
-    private String getElasticInferenceServiceUrl(ElasticInferenceServiceSettings settings) {
-        String elasticInferenceUrl = null;
-
-        if (ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
-            elasticInferenceUrl = settings.getElasticInferenceServiceUrl();
-        } else if (DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled()) {
-            log.warn(
-                "Deprecated flag {} detected for enabling {}. Please use {}.",
-                ELASTIC_INFERENCE_SERVICE_IDENTIFIER,
-                DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG,
-                ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG
-            );
-            elasticInferenceUrl = settings.getEisGatewayUrl();
-        }
-
-        return elasticInferenceUrl;
-    }
-
-    protected Boolean isElasticInferenceServiceEnabled() {
-        return (ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled() || DEPRECATED_ELASTIC_INFERENCE_SERVICE_FEATURE_FLAG.isEnabled());
-    }
-
-    protected SSLService getSslService() {
-        return XPackPlugin.getSharedSslService();
-    }
-
-    protected XPackLicenseState getLicenseState() {
-        return XPackPlugin.getSharedLicenseState();
-    }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java
index 6d09c9e67b363..e5d76b9bb5570 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/HttpClientManager.java
@@ -7,14 +7,9 @@
 
 package org.elasticsearch.xpack.inference.external.http;
 
-import org.apache.http.config.Registry;
-import org.apache.http.config.RegistryBuilder;
 import org.apache.http.impl.nio.conn.PoolingNHttpClientConnectionManager;
 import org.apache.http.impl.nio.reactor.DefaultConnectingIOReactor;
 import org.apache.http.impl.nio.reactor.IOReactorConfig;
-import org.apache.http.nio.conn.NoopIOSessionStrategy;
-import org.apache.http.nio.conn.SchemeIOSessionStrategy;
-import org.apache.http.nio.conn.ssl.SSLIOSessionStrategy;
 import org.apache.http.nio.reactor.ConnectingIOReactor;
 import org.apache.http.nio.reactor.IOReactorException;
 import org.apache.http.pool.PoolStats;
@@ -26,7 +21,6 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.threadpool.ThreadPool;
-import org.elasticsearch.xpack.core.ssl.SSLService;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
 
 import java.io.Closeable;
@@ -34,13 +28,11 @@
 import java.util.List;
 
 import static org.elasticsearch.core.Strings.format;
-import static org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceSettings.ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX;
 
 public class HttpClientManager implements Closeable {
     private static final Logger logger = LogManager.getLogger(HttpClientManager.class);
     /**
      * The maximum number of total connections the connection pool can lease to all routes.
-     * The configuration applies to each instance of HTTPClientManager (max_total_connections=10 and instances=5 leads to 50 connections).
      * From googling around the connection pools maxTotal value should be close to the number of available threads.
      *
      * https://stackoverflow.com/questions/30989637/how-to-decide-optimal-settings-for-setmaxtotal-and-setdefaultmaxperroute
@@ -55,7 +47,6 @@ public class HttpClientManager implements Closeable {
 
     /**
      * The max number of connections a single route can lease.
-     * This configuration applies to each instance of HttpClientManager.
      */
     public static final Setting<Integer> MAX_ROUTE_CONNECTIONS = Setting.intSetting(
         "xpack.inference.http.max_route_connections",
@@ -107,22 +98,6 @@ public static HttpClientManager create(
         return new HttpClientManager(settings, connectionManager, threadPool, clusterService, throttlerManager);
     }
 
-    public static HttpClientManager create(
-        Settings settings,
-        ThreadPool threadPool,
-        ClusterService clusterService,
-        ThrottlerManager throttlerManager,
-        SSLService sslService
-    ) {
-        // Set the sslStrategy to ensure an encrypted connection, as Elastic Inference Service requires it.
-        SSLIOSessionStrategy sslioSessionStrategy = sslService.sslIOSessionStrategy(
-            sslService.getSSLConfiguration(ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX)
-        );
-
-        PoolingNHttpClientConnectionManager connectionManager = createConnectionManager(sslioSessionStrategy);
-        return new HttpClientManager(settings, connectionManager, threadPool, clusterService, throttlerManager);
-    }
-
     // Default for testing
     HttpClientManager(
         Settings settings,
@@ -146,25 +121,6 @@ public static HttpClientManager create(
         this.addSettingsUpdateConsumers(clusterService);
     }
 
-    private static PoolingNHttpClientConnectionManager createConnectionManager(SSLIOSessionStrategy sslStrategy) {
-        ConnectingIOReactor ioReactor;
-        try {
-            var configBuilder = IOReactorConfig.custom().setSoKeepAlive(true);
-            ioReactor = new DefaultConnectingIOReactor(configBuilder.build());
-        } catch (IOReactorException e) {
-            var message = "Failed to initialize HTTP client manager with SSL.";
-            logger.error(message, e);
-            throw new ElasticsearchException(message, e);
-        }
-
-        Registry<SchemeIOSessionStrategy> registry = RegistryBuilder.<SchemeIOSessionStrategy>create()
-            .register("http", NoopIOSessionStrategy.INSTANCE)
-            .register("https", sslStrategy)
-            .build();
-
-        return new PoolingNHttpClientConnectionManager(ioReactor, registry);
-    }
-
     private static PoolingNHttpClientConnectionManager createConnectionManager() {
         ConnectingIOReactor ioReactor;
         try {
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
index f54696895a818..fd2427dc8ac6a 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.license.LicenseUtils;
-import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
 import org.elasticsearch.search.rank.RankDoc;
 import org.elasticsearch.search.retriever.CompoundRetrieverBuilder;
@@ -22,6 +21,7 @@
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xpack.core.XPackPlugin;
 
 import java.io.IOException;
 import java.util.List;
@@ -73,11 +73,8 @@ public class TextSimilarityRankRetrieverBuilder extends CompoundRetrieverBuilder
         RetrieverBuilder.declareBaseParserFields(TextSimilarityRankBuilder.NAME, PARSER);
     }
 
-    public static TextSimilarityRankRetrieverBuilder fromXContent(
-        XContentParser parser,
-        RetrieverParserContext context,
-        XPackLicenseState licenceState
-    ) throws IOException {
+    public static TextSimilarityRankRetrieverBuilder fromXContent(XContentParser parser, RetrieverParserContext context)
+        throws IOException {
         if (context.clusterSupportsFeature(TEXT_SIMILARITY_RERANKER_RETRIEVER_SUPPORTED) == false) {
             throw new ParsingException(parser.getTokenLocation(), "unknown retriever [" + TextSimilarityRankBuilder.NAME + "]");
         }
@@ -86,7 +83,7 @@ public static TextSimilarityRankRetrieverBuilder fromXContent(
                 "[text_similarity_reranker] retriever composition feature is not supported by all nodes in the cluster"
             );
         }
-        if (TextSimilarityRankBuilder.TEXT_SIMILARITY_RERANKER_FEATURE.check(licenceState) == false) {
+        if (TextSimilarityRankBuilder.TEXT_SIMILARITY_RERANKER_FEATURE.check(XPackPlugin.getSharedLicenseState()) == false) {
             throw LicenseUtils.newComplianceException(TextSimilarityRankBuilder.NAME);
         }
         return PARSER.apply(parser, context);
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java
index 431a3647e2879..bc2daddc2a346 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSettings.java
@@ -9,9 +9,7 @@
 
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.xpack.core.ssl.SSLConfigurationSettings;
 
-import java.util.ArrayList;
 import java.util.List;
 
 public class ElasticInferenceServiceSettings {
@@ -19,8 +17,6 @@ public class ElasticInferenceServiceSettings {
     @Deprecated
     static final Setting<String> EIS_GATEWAY_URL = Setting.simpleString("xpack.inference.eis.gateway.url", Setting.Property.NodeScope);
 
-    public static final String ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX = "xpack.inference.elastic.http.ssl.";
-
     static final Setting<String> ELASTIC_INFERENCE_SERVICE_URL = Setting.simpleString(
         "xpack.inference.elastic.url",
         Setting.Property.NodeScope
@@ -35,27 +31,11 @@ public class ElasticInferenceServiceSettings {
     public ElasticInferenceServiceSettings(Settings settings) {
         eisGatewayUrl = EIS_GATEWAY_URL.get(settings);
         elasticInferenceServiceUrl = ELASTIC_INFERENCE_SERVICE_URL.get(settings);
-    }
-
-    public static final SSLConfigurationSettings ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_SETTINGS = SSLConfigurationSettings.withPrefix(
-        ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX,
-        false
-    );
 
-    public static final Setting<Boolean> ELASTIC_INFERENCE_SERVICE_SSL_ENABLED = Setting.boolSetting(
-        ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX + "enabled",
-        true,
-        Setting.Property.NodeScope
-    );
+    }
 
     public static List<Setting<?>> getSettingsDefinitions() {
-        ArrayList<Setting<?>> settings = new ArrayList<>();
-        settings.add(EIS_GATEWAY_URL);
-        settings.add(ELASTIC_INFERENCE_SERVICE_URL);
-        settings.add(ELASTIC_INFERENCE_SERVICE_SSL_ENABLED);
-        settings.addAll(ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_SETTINGS.getEnabledSettings());
-
-        return settings;
+        return List.of(EIS_GATEWAY_URL, ELASTIC_INFERENCE_SERVICE_URL);
     }
 
     @Deprecated
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java
index 61033a0211065..bfec2d5ac3484 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/cluster/metadata/SemanticTextClusterMetadataTests.java
@@ -14,7 +14,6 @@
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.test.ESSingleNodeTestCase;
-import org.elasticsearch.xpack.core.XPackPlugin;
 import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.hamcrest.Matchers;
 
@@ -29,7 +28,7 @@ public class SemanticTextClusterMetadataTests extends ESSingleNodeTestCase {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(XPackPlugin.class, InferencePlugin.class);
+        return List.of(InferencePlugin.class);
     }
 
     public void testCreateIndexWithSemanticTextField() {
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java
deleted file mode 100644
index d1db5b8b12cc6..0000000000000
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/InferencePluginTests.java
+++ /dev/null
@@ -1,65 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.inference;
-
-import org.elasticsearch.common.settings.Setting;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceSettings;
-import org.junit.After;
-import org.junit.Before;
-
-import static org.hamcrest.Matchers.is;
-
-public class InferencePluginTests extends ESTestCase {
-    private InferencePlugin inferencePlugin;
-
-    private Boolean elasticInferenceServiceEnabled = true;
-
-    private void setElasticInferenceServiceEnabled(Boolean elasticInferenceServiceEnabled) {
-        this.elasticInferenceServiceEnabled = elasticInferenceServiceEnabled;
-    }
-
-    @Before
-    public void setUp() throws Exception {
-        super.setUp();
-
-        Settings settings = Settings.builder().build();
-        inferencePlugin = new InferencePlugin(settings) {
-            @Override
-            protected Boolean isElasticInferenceServiceEnabled() {
-                return elasticInferenceServiceEnabled;
-            }
-        };
-    }
-
-    @After
-    public void tearDown() throws Exception {
-        super.tearDown();
-    }
-
-    public void testElasticInferenceServiceSettingsPresent() throws Exception {
-        setElasticInferenceServiceEnabled(true); // enable elastic inference service
-        boolean anyMatch = inferencePlugin.getSettings()
-            .stream()
-            .map(Setting::getKey)
-            .anyMatch(key -> key.startsWith(ElasticInferenceServiceSettings.ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX));
-
-        assertThat("xpack.inference.elastic settings are present", anyMatch, is(true));
-    }
-
-    public void testElasticInferenceServiceSettingsNotPresent() throws Exception {
-        setElasticInferenceServiceEnabled(false); // disable elastic inference service
-        boolean noneMatch = inferencePlugin.getSettings()
-            .stream()
-            .map(Setting::getKey)
-            .noneMatch(key -> key.startsWith(ElasticInferenceServiceSettings.ELASTIC_INFERENCE_SERVICE_SSL_CONFIGURATION_PREFIX));
-
-        assertThat("xpack.inference.elastic settings are not present", noneMatch, is(true));
-    }
-}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java
deleted file mode 100644
index 68ea175bd9870..0000000000000
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/LocalStateInferencePlugin.java
+++ /dev/null
@@ -1,71 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.inference;
-
-import org.elasticsearch.action.support.MappedActionFilter;
-import org.elasticsearch.common.settings.Settings;
-import org.elasticsearch.index.mapper.Mapper;
-import org.elasticsearch.inference.InferenceServiceExtension;
-import org.elasticsearch.license.XPackLicenseState;
-import org.elasticsearch.plugins.SearchPlugin;
-import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
-import org.elasticsearch.xpack.core.ssl.SSLService;
-import org.elasticsearch.xpack.inference.mock.TestDenseInferenceServiceExtension;
-import org.elasticsearch.xpack.inference.mock.TestSparseInferenceServiceExtension;
-
-import java.nio.file.Path;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-import static java.util.stream.Collectors.toList;
-
-public class LocalStateInferencePlugin extends LocalStateCompositeXPackPlugin {
-    private final InferencePlugin inferencePlugin;
-
-    public LocalStateInferencePlugin(final Settings settings, final Path configPath) throws Exception {
-        super(settings, configPath);
-        LocalStateInferencePlugin thisVar = this;
-        this.inferencePlugin = new InferencePlugin(settings) {
-            @Override
-            protected SSLService getSslService() {
-                return thisVar.getSslService();
-            }
-
-            @Override
-            protected XPackLicenseState getLicenseState() {
-                return thisVar.getLicenseState();
-            }
-
-            @Override
-            public List<InferenceServiceExtension.Factory> getInferenceServiceFactories() {
-                return List.of(
-                    TestSparseInferenceServiceExtension.TestInferenceService::new,
-                    TestDenseInferenceServiceExtension.TestInferenceService::new
-                );
-            }
-        };
-        plugins.add(inferencePlugin);
-    }
-
-    @Override
-    public List<RetrieverSpec<?>> getRetrievers() {
-        return this.filterPlugins(SearchPlugin.class).stream().flatMap(p -> p.getRetrievers().stream()).collect(toList());
-    }
-
-    @Override
-    public Map<String, Mapper.TypeParser> getMappers() {
-        return inferencePlugin.getMappers();
-    }
-
-    @Override
-    public Collection<MappedActionFilter> getMappedActionFilters() {
-        return inferencePlugin.getMappedActionFilters();
-    }
-
-}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
index 0f322e64755be..9395ae222e9ba 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.index.mapper.vectors.DenseVectorFieldMapper;
+import org.elasticsearch.inference.InferenceServiceExtension;
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.ModelConfigurations;
 import org.elasticsearch.inference.ModelSecrets;
@@ -142,6 +143,20 @@ private static <T> void blockingCall(
         latch.await();
     }
 
+    public static class TestInferencePlugin extends InferencePlugin {
+        public TestInferencePlugin(Settings settings) {
+            super(settings);
+        }
+
+        @Override
+        public List<InferenceServiceExtension.Factory> getInferenceServiceFactories() {
+            return List.of(
+                TestSparseInferenceServiceExtension.TestInferenceService::new,
+                TestDenseInferenceServiceExtension.TestInferenceService::new
+            );
+        }
+    }
+
     public static Model getInvalidModel(String inferenceEntityId, String serviceName) {
         var mockConfigs = mock(ModelConfigurations.class);
         when(mockConfigs.getInferenceEntityId()).thenReturn(inferenceEntityId);
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java
index 24183b21f73e7..1f58c4165056d 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextNonDynamicFieldMapperTests.java
@@ -9,7 +9,6 @@
 
 import org.elasticsearch.index.mapper.NonDynamicFieldMapperTests;
 import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
 import org.elasticsearch.xpack.inference.Utils;
 import org.elasticsearch.xpack.inference.mock.TestSparseInferenceServiceExtension;
 import org.junit.Before;
@@ -27,7 +26,7 @@ public void setup() throws Exception {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(LocalStateInferencePlugin.class);
+        return List.of(Utils.TestInferencePlugin.class);
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java
index daed03c198e0d..6d6403b69ea11 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankMultiNodeTests.java
@@ -10,7 +10,7 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.search.rank.RankBuilder;
 import org.elasticsearch.search.rank.rerank.AbstractRerankerIT;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 
 import java.util.Collection;
 import java.util.List;
@@ -40,7 +40,7 @@ protected RankBuilder getThrowingRankBuilder(int rankWindowSize, String rankFeat
 
     @Override
     protected Collection<Class<? extends Plugin>> pluginsNeeded() {
-        return List.of(LocalStateInferencePlugin.class, TextSimilarityTestPlugin.class);
+        return List.of(InferencePlugin.class, TextSimilarityTestPlugin.class);
     }
 
     public void testQueryPhaseShardThrowingAllShardsFail() throws Exception {
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java
index ba6924ba0ff3b..084a7f3de4a53 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverTelemetryTests.java
@@ -24,7 +24,8 @@
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentFactory;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.core.XPackPlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.junit.Before;
 
 import java.io.IOException;
@@ -46,7 +47,7 @@ protected boolean addMockHttpTransport() {
 
     @Override
     protected Collection<Class<? extends Plugin>> nodePlugins() {
-        return List.of(LocalStateInferencePlugin.class, TextSimilarityTestPlugin.class);
+        return List.of(InferencePlugin.class, XPackPlugin.class, TextSimilarityTestPlugin.class);
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java
index f81f2965c392e..a042fca44fdb5 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankTests.java
@@ -20,7 +20,7 @@
 import org.elasticsearch.test.ESSingleNodeTestCase;
 import org.elasticsearch.test.hamcrest.ElasticsearchAssertions;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
-import org.elasticsearch.xpack.inference.LocalStateInferencePlugin;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.junit.Before;
 
 import java.util.Collection;
@@ -108,7 +108,7 @@ protected InferenceAction.Request generateRequest(List<String> docFeatures) {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(LocalStateInferencePlugin.class, TextSimilarityTestPlugin.class);
+        return List.of(InferencePlugin.class, TextSimilarityTestPlugin.class);
     }
 
     @Before
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java
index ff1a1d19779df..bab012afc3101 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/LocalStateMachineLearning.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.xpack.core.LocalStateCompositeXPackPlugin;
 import org.elasticsearch.xpack.core.rollup.action.GetRollupIndexCapsAction;
 import org.elasticsearch.xpack.core.ssl.SSLService;
-import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.monitoring.Monitoring;
 import org.elasticsearch.xpack.security.Security;
 
@@ -87,12 +86,6 @@ protected XPackLicenseState getLicenseState() {
             }
         });
         plugins.add(new MockedRollupPlugin());
-        plugins.add(new InferencePlugin(settings) {
-            @Override
-            protected SSLService getSslService() {
-                return thisVar.getSslService();
-            }
-        });
     }
 
     @Override
diff --git a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
index 5cf15454e47f2..aeebfabdce704 100644
--- a/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
+++ b/x-pack/plugin/ml/src/test/java/org/elasticsearch/xpack/ml/support/BaseMlIntegTestCase.java
@@ -82,6 +82,7 @@
 import org.elasticsearch.xpack.core.ml.job.process.autodetect.state.DataCounts;
 import org.elasticsearch.xpack.core.ml.utils.MlTaskState;
 import org.elasticsearch.xpack.ilm.IndexLifecycle;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.ml.LocalStateMachineLearning;
 import org.elasticsearch.xpack.ml.MachineLearning;
 import org.elasticsearch.xpack.ml.MlSingleNodeTestCase;
@@ -160,7 +161,8 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
             DataStreamsPlugin.class,
             // To remove errors from parsing build in templates that contain scaled_float
             MapperExtrasPlugin.class,
-            Wildcard.class
+            Wildcard.class,
+            InferencePlugin.class
         );
     }
 
diff --git a/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java b/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java
index 057ebdece5c61..ab5be0f48f5f3 100644
--- a/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java
+++ b/x-pack/plugin/security/qa/consistency-checks/src/test/java/org/elasticsearch/xpack/security/CrossClusterShardTests.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.xpack.frozen.FrozenIndices;
 import org.elasticsearch.xpack.graph.Graph;
 import org.elasticsearch.xpack.ilm.IndexLifecycle;
+import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.profiling.ProfilingPlugin;
 import org.elasticsearch.xpack.rollup.Rollup;
 import org.elasticsearch.xpack.search.AsyncSearch;
@@ -88,6 +89,7 @@ protected Collection<Class<? extends Plugin>> getPlugins() {
                 FrozenIndices.class,
                 Graph.class,
                 IndexLifecycle.class,
+                InferencePlugin.class,
                 IngestCommonPlugin.class,
                 IngestTestPlugin.class,
                 MustachePlugin.class,

From 724e9bef3b923e64306db68999ffe02a226aa014 Mon Sep 17 00:00:00 2001
From: Jedr Blaszyk <jedrazb@gmail.com>
Date: Wed, 18 Dec 2024 13:05:16 +0100
Subject: [PATCH 066/119] [Connector APIs] Enforce index prefix for managed
 connectors (#117778)

* [Connector APIs] Enforce manage connector index prefix

* Update ConnectorIndexServiceTests to check for prefix

* Update docs/changelog/117778.yaml

* Fix accidental changes to muted tests

* Review feedback

* Review feedback

---------

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
---
 docs/changelog/117778.yaml                    |   5 +
 .../entsearch/connector/10_connector_put.yml  |  13 ++
 .../130_connector_update_index_name.yml       |  15 ++
 .../connector/140_connector_update_native.yml |  40 +++++
 .../entsearch/connector/15_connector_post.yml |  12 ++
 .../connector/ConnectorIndexService.java      | 137 +++++++++++++-----
 .../connector/ConnectorTemplateRegistry.java  |   2 +
 .../action/ConnectorActionRequest.java        |  27 ++++
 .../connector/action/PostConnectorAction.java |   4 +
 .../connector/action/PutConnectorAction.java  |   4 +
 .../connector/ConnectorIndexServiceTests.java |  80 +++++++++-
 .../connector/ConnectorTestUtils.java         |  12 ++
 .../action/PostConnectorActionTests.java      |  20 ++-
 .../action/PutConnectorActionTests.java       |  21 ++-
 14 files changed, 351 insertions(+), 41 deletions(-)
 create mode 100644 docs/changelog/117778.yaml

diff --git a/docs/changelog/117778.yaml b/docs/changelog/117778.yaml
new file mode 100644
index 0000000000000..880d4f831e533
--- /dev/null
+++ b/docs/changelog/117778.yaml
@@ -0,0 +1,5 @@
+pr: 117778
+summary: "[Connector APIs] Enforce index prefix for managed connectors"
+area: Extract&Transform
+type: feature
+issues: []
diff --git a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/10_connector_put.yml b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/10_connector_put.yml
index 094d9cbf43089..4240467ea4ff3 100644
--- a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/10_connector_put.yml
+++ b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/10_connector_put.yml
@@ -152,6 +152,19 @@ setup:
           service_type: super-connector
 
 
+---
+'Create Connector - Invalid Managed Connector Index Prefix':
+  - do:
+      catch: "bad_request"
+      connector.put:
+        connector_id: test-connector-test-managed
+        body:
+          index_name: wrong-prefix-index
+          name: my-connector
+          language: pl
+          is_native: true
+          service_type: super-connector
+
 ---
 'Create Connector - Id returned as part of response':
   - do:
diff --git a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/130_connector_update_index_name.yml b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/130_connector_update_index_name.yml
index f804dc02a9e01..b63bf595af5f4 100644
--- a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/130_connector_update_index_name.yml
+++ b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/130_connector_update_index_name.yml
@@ -151,3 +151,18 @@ setup:
 
   - match: { index_name: content-search-2-test }
 
+---
+"Update Managed Connector Index Name - Bad Prefix":
+  - do:
+      connector.put:
+        connector_id: test-connector-2
+        body:
+          is_native: true
+          service_type: super-connector
+
+  - do:
+      catch: "bad_request"
+      connector.update_index_name:
+        connector_id: test-connector-2
+        body:
+          index_name: wrong-prefix-search-2-test
diff --git a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/140_connector_update_native.yml b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/140_connector_update_native.yml
index f8cd24d175312..6811c3340ce42 100644
--- a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/140_connector_update_native.yml
+++ b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/140_connector_update_native.yml
@@ -73,3 +73,43 @@ setup:
             field_1: test
             field_2: something
 
+---
+"Update Connector Native - changing connector to Elastic-managed wrong index name":
+
+  - do:
+      connector.put:
+        connector_id: test-connector-1
+        body:
+          is_native: false
+          index_name: super-connector
+
+  - do:
+      catch: "bad_request"
+      connector.update_native:
+        connector_id: test-connector-1
+        body:
+          is_native: true
+
+---
+"Update Connector Native - changing connector to Elastic-managed correct index name":
+
+  - do:
+      connector.put:
+        connector_id: test-connector-1
+        body:
+          is_native: false
+          index_name: content-super-connector
+
+  - do:
+      connector.update_native:
+        connector_id: test-connector-1
+        body:
+          is_native: true
+
+  - match: { result: updated }
+
+  - do:
+      connector.get:
+        connector_id: test-connector-1
+
+  - match: { is_native: true }
diff --git a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/15_connector_post.yml b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/15_connector_post.yml
index 634f99cd53fde..4acca493c42c8 100644
--- a/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/15_connector_post.yml
+++ b/x-pack/plugin/ent-search/qa/rest/src/yamlRestTest/resources/rest-api-spec/test/entsearch/connector/15_connector_post.yml
@@ -103,6 +103,18 @@ setup:
           service_type: super-connector
 
 
+---
+'Create Connector - Invalid Managed Connector Index Prefix':
+  - do:
+      catch: "bad_request"
+      connector.post:
+        body:
+          index_name: wrong-prefix-index
+          name: my-connector
+          language: pl
+          is_native: true
+          service_type: super-connector
+
 ---
 'Create Connector - Index name used by another connector':
   - do:
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorIndexService.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorIndexService.java
index 5e1fde0dfb942..d5d2159d8f373 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorIndexService.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorIndexService.java
@@ -76,6 +76,7 @@
 import static org.elasticsearch.xcontent.XContentFactory.jsonBuilder;
 import static org.elasticsearch.xpack.application.connector.ConnectorFiltering.fromXContentBytesConnectorFiltering;
 import static org.elasticsearch.xpack.application.connector.ConnectorFiltering.sortFilteringRulesByOrder;
+import static org.elasticsearch.xpack.application.connector.ConnectorTemplateRegistry.MANAGED_CONNECTOR_INDEX_PREFIX;
 
 /**
  * A service that manages persistent {@link Connector} configurations.
@@ -807,8 +808,8 @@ public void updateConnectorLastSyncStats(UpdateConnectorLastSyncStatsAction.Requ
     }
 
     /**
-     * Updates the is_native property of a {@link Connector}. It always sets the {@link ConnectorStatus} to
-     * CONFIGURED.
+     * Updates the is_native property of a {@link Connector}. It sets the {@link ConnectorStatus} to
+     * CONFIGURED when connector is in CONNECTED state to indicate that connector needs to reconnect.
      *
      * @param request  The request for updating the connector's is_native property.
      * @param listener The listener for handling responses, including successful updates or errors.
@@ -816,29 +817,62 @@ public void updateConnectorLastSyncStats(UpdateConnectorLastSyncStatsAction.Requ
     public void updateConnectorNative(UpdateConnectorNativeAction.Request request, ActionListener<UpdateResponse> listener) {
         try {
             String connectorId = request.getConnectorId();
+            boolean isNative = request.isNative();
 
-            final UpdateRequest updateRequest = new UpdateRequest(CONNECTOR_INDEX_NAME, connectorId).doc(
-                new IndexRequest(CONNECTOR_INDEX_NAME).opType(DocWriteRequest.OpType.INDEX)
-                    .id(connectorId)
-                    .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-                    .source(
-                        Map.of(
-                            Connector.IS_NATIVE_FIELD.getPreferredName(),
-                            request.isNative(),
-                            Connector.STATUS_FIELD.getPreferredName(),
-                            ConnectorStatus.CONFIGURED.toString()
-                        )
-                    )
+            getConnector(connectorId, listener.delegateFailure((l, connector) -> {
 
-            );
-            client.update(updateRequest, new DelegatingIndexNotFoundActionListener<>(connectorId, listener, (l, updateResponse) -> {
-                if (updateResponse.getResult() == UpdateResponse.Result.NOT_FOUND) {
-                    l.onFailure(new ResourceNotFoundException(connectorNotFoundErrorMsg(connectorId)));
+                String indexName = getConnectorIndexNameFromSearchResult(connector);
+
+                boolean doesNotHaveContentPrefix = indexName != null && isValidManagedConnectorIndexName(indexName) == false;
+                // Ensure attached content index is prefixed correctly
+                if (isNative && doesNotHaveContentPrefix) {
+                    l.onFailure(
+                        new ElasticsearchStatusException(
+                            "The index name ["
+                                + indexName
+                                + "] attached to the connector ["
+                                + connectorId
+                                + "] must start with the required prefix: ["
+                                + MANAGED_CONNECTOR_INDEX_PREFIX
+                                + "] to be Elastic-managed. Please update the attached index first to comply with this requirement.",
+                            RestStatus.BAD_REQUEST
+                        )
+                    );
                     return;
                 }
-                l.onResponse(updateResponse);
-            }));
 
+                ConnectorStatus status = getConnectorStatusFromSearchResult(connector);
+
+                // If connector was connected already, change its status to CONFIGURED as we need to re-connect
+                boolean isConnected = status == ConnectorStatus.CONNECTED;
+                boolean isValidTransitionToConfigured = ConnectorStateMachine.isValidTransition(status, ConnectorStatus.CONFIGURED);
+                if (isConnected && isValidTransitionToConfigured) {
+                    status = ConnectorStatus.CONFIGURED;
+                }
+
+                final UpdateRequest updateRequest = new UpdateRequest(CONNECTOR_INDEX_NAME, connectorId).setRefreshPolicy(
+                    WriteRequest.RefreshPolicy.IMMEDIATE
+                )
+                    .doc(
+                        new IndexRequest(CONNECTOR_INDEX_NAME).opType(DocWriteRequest.OpType.INDEX)
+                            .id(connectorId)
+                            .source(
+                                Map.of(
+                                    Connector.IS_NATIVE_FIELD.getPreferredName(),
+                                    isNative,
+                                    Connector.STATUS_FIELD.getPreferredName(),
+                                    status.toString()
+                                )
+                            )
+                    );
+                client.update(updateRequest, new DelegatingIndexNotFoundActionListener<>(connectorId, listener, (ll, updateResponse) -> {
+                    if (updateResponse.getResult() == UpdateResponse.Result.NOT_FOUND) {
+                        ll.onFailure(new ResourceNotFoundException(connectorNotFoundErrorMsg(connectorId)));
+                        return;
+                    }
+                    ll.onResponse(updateResponse);
+                }));
+            }));
         } catch (Exception e) {
             listener.onFailure(e);
         }
@@ -896,22 +930,45 @@ public void updateConnectorIndexName(UpdateConnectorIndexNameAction.Request requ
                     return;
                 }
 
-                final UpdateRequest updateRequest = new UpdateRequest(CONNECTOR_INDEX_NAME, connectorId).doc(
-                    new IndexRequest(CONNECTOR_INDEX_NAME).opType(DocWriteRequest.OpType.INDEX)
-                        .id(connectorId)
-                        .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
-                        .source(new HashMap<>() {
-                            {
-                                put(Connector.INDEX_NAME_FIELD.getPreferredName(), request.getIndexName());
-                            }
-                        })
-                );
-                client.update(updateRequest, new DelegatingIndexNotFoundActionListener<>(connectorId, listener, (ll, updateResponse) -> {
-                    if (updateResponse.getResult() == UpdateResponse.Result.NOT_FOUND) {
-                        ll.onFailure(new ResourceNotFoundException(connectorNotFoundErrorMsg(connectorId)));
+                getConnector(connectorId, l.delegateFailure((ll, connector) -> {
+
+                    Boolean isNativeConnector = getConnectorIsNativeFlagFromSearchResult(connector);
+                    Boolean doesNotHaveContentPrefix = indexName != null && isValidManagedConnectorIndexName(indexName) == false;
+
+                    if (isNativeConnector && doesNotHaveContentPrefix) {
+                        ll.onFailure(
+                            new ElasticsearchStatusException(
+                                "Index attached to an Elastic-managed connector must start with the prefix: ["
+                                    + MANAGED_CONNECTOR_INDEX_PREFIX
+                                    + "]. The index name in the payload ["
+                                    + indexName
+                                    + "] doesn't comply with this requirement.",
+                                RestStatus.BAD_REQUEST
+                            )
+                        );
                         return;
                     }
-                    ll.onResponse(updateResponse);
+
+                    final UpdateRequest updateRequest = new UpdateRequest(CONNECTOR_INDEX_NAME, connectorId).doc(
+                        new IndexRequest(CONNECTOR_INDEX_NAME).opType(DocWriteRequest.OpType.INDEX)
+                            .id(connectorId)
+                            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
+                            .source(new HashMap<>() {
+                                {
+                                    put(Connector.INDEX_NAME_FIELD.getPreferredName(), request.getIndexName());
+                                }
+                            })
+                    );
+                    client.update(
+                        updateRequest,
+                        new DelegatingIndexNotFoundActionListener<>(connectorId, listener, (lll, updateResponse) -> {
+                            if (updateResponse.getResult() == UpdateResponse.Result.NOT_FOUND) {
+                                lll.onFailure(new ResourceNotFoundException(connectorNotFoundErrorMsg(connectorId)));
+                                return;
+                            }
+                            lll.onResponse(updateResponse);
+                        })
+                    );
                 }));
             }));
 
@@ -1064,6 +1121,18 @@ private ConnectorStatus getConnectorStatusFromSearchResult(ConnectorSearchResult
         return ConnectorStatus.connectorStatus((String) searchResult.getResultMap().get(Connector.STATUS_FIELD.getPreferredName()));
     }
 
+    private Boolean getConnectorIsNativeFlagFromSearchResult(ConnectorSearchResult searchResult) {
+        return (Boolean) searchResult.getResultMap().get(Connector.IS_NATIVE_FIELD.getPreferredName());
+    }
+
+    private String getConnectorIndexNameFromSearchResult(ConnectorSearchResult searchResult) {
+        return (String) searchResult.getResultMap().get(Connector.INDEX_NAME_FIELD.getPreferredName());
+    }
+
+    private boolean isValidManagedConnectorIndexName(String indexName) {
+        return indexName.startsWith(MANAGED_CONNECTOR_INDEX_PREFIX);
+    }
+
     @SuppressWarnings("unchecked")
     private Map<String, Object> getConnectorConfigurationFromSearchResult(ConnectorSearchResult searchResult) {
         return (Map<String, Object>) searchResult.getResultMap().get(Connector.CONFIGURATION_FIELD.getPreferredName());
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java
index 9b8cc7cfdbe4f..e630f929bc09b 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java
@@ -45,6 +45,8 @@ public class ConnectorTemplateRegistry extends IndexTemplateRegistry {
     public static final String ACCESS_CONTROL_INDEX_NAME_PATTERN = ".search-acl-filter-*";
     public static final String ACCESS_CONTROL_TEMPLATE_NAME = "search-acl-filter";
 
+    public static final String MANAGED_CONNECTOR_INDEX_PREFIX = "content-";
+
     // Pipeline constants
 
     public static final String ENT_SEARCH_GENERIC_PIPELINE_NAME = "ent-search-generic-ingestion";
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/ConnectorActionRequest.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/ConnectorActionRequest.java
index 1799121505da5..66f347bc4dbb4 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/ConnectorActionRequest.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/ConnectorActionRequest.java
@@ -19,6 +19,7 @@
 import java.io.IOException;
 
 import static org.elasticsearch.action.ValidateActions.addValidationError;
+import static org.elasticsearch.xpack.application.connector.ConnectorTemplateRegistry.MANAGED_CONNECTOR_INDEX_PREFIX;
 
 /**
  * Abstract base class for action requests targeting the connectors index. Implements {@link org.elasticsearch.action.IndicesRequest}
@@ -52,6 +53,32 @@ public ActionRequestValidationException validateIndexName(String indexName, Acti
         return validationException;
     }
 
+    /**
+     * Validates that the given index name starts with the required prefix for Elastic-managed connectors.
+     * If the index name does not start with the required prefix, the validation exception is updated with an error message.
+     *
+     * @param indexName The index name to validate. If null, no validation is performed.
+     * @param validationException The exception to accumulate validation errors.
+     * @return The updated or original {@code validationException} with any new validation errors added,
+     *         if the index name does not start with the required prefix.
+     */
+    public ActionRequestValidationException validateManagedConnectorIndexPrefix(
+        String indexName,
+        ActionRequestValidationException validationException
+    ) {
+        if (indexName != null && indexName.startsWith(MANAGED_CONNECTOR_INDEX_PREFIX) == false) {
+            return addValidationError(
+                "Index ["
+                    + indexName
+                    + "] is invalid. Index attached to an Elastic-managed connector must start with the prefix: ["
+                    + MANAGED_CONNECTOR_INDEX_PREFIX
+                    + "]",
+                validationException
+            );
+        }
+        return validationException;
+    }
+
     @Override
     public String[] indices() {
         return new String[] { ConnectorTemplateRegistry.CONNECTOR_INDEX_NAME_PATTERN };
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PostConnectorAction.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PostConnectorAction.java
index fad349cd31877..b1c38637298c4 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PostConnectorAction.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PostConnectorAction.java
@@ -127,6 +127,10 @@ public ActionRequestValidationException validate() {
 
             validationException = validateIndexName(indexName, validationException);
 
+            if (Boolean.TRUE.equals(isNative)) {
+                validationException = validateManagedConnectorIndexPrefix(indexName, validationException);
+            }
+
             return validationException;
         }
 
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PutConnectorAction.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PutConnectorAction.java
index 687a801ab8fd6..f3e8ed6b6e76d 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PutConnectorAction.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/action/PutConnectorAction.java
@@ -147,6 +147,10 @@ public ActionRequestValidationException validate() {
 
             validationException = validateIndexName(indexName, validationException);
 
+            if (Boolean.TRUE.equals(isNative)) {
+                validationException = validateManagedConnectorIndexPrefix(indexName, validationException);
+            }
+
             return validationException;
         }
 
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIndexServiceTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIndexServiceTests.java
index 12abca3a78591..28d4fe0956d03 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIndexServiceTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIndexServiceTests.java
@@ -56,6 +56,7 @@
 import java.util.stream.Collectors;
 import java.util.stream.IntStream;
 
+import static org.elasticsearch.xpack.application.connector.ConnectorTemplateRegistry.MANAGED_CONNECTOR_INDEX_PREFIX;
 import static org.elasticsearch.xpack.application.connector.ConnectorTestUtils.getRandomConnectorFeatures;
 import static org.elasticsearch.xpack.application.connector.ConnectorTestUtils.getRandomCronExpression;
 import static org.elasticsearch.xpack.application.connector.ConnectorTestUtils.randomConnectorFeatureEnabled;
@@ -648,8 +649,8 @@ public void testUpdateConnectorScheduling_OnlyFullSchedule() throws Exception {
         assertThat(initialScheduling.getIncremental(), equalTo(indexedConnector.getScheduling().getIncremental()));
     }
 
-    public void testUpdateConnectorIndexName() throws Exception {
-        Connector connector = ConnectorTestUtils.getRandomConnector();
+    public void testUpdateConnectorIndexName_ForSelfManagedConnector() throws Exception {
+        Connector connector = ConnectorTestUtils.getRandomSelfManagedConnector();
         String connectorId = randomUUID();
 
         ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
@@ -669,8 +670,8 @@ public void testUpdateConnectorIndexName() throws Exception {
         assertThat(newIndexName, equalTo(indexedConnector.getIndexName()));
     }
 
-    public void testUpdateConnectorIndexName_WithTheSameIndexName() throws Exception {
-        Connector connector = ConnectorTestUtils.getRandomConnector();
+    public void testUpdateConnectorIndexName_ForSelfManagedConnector_WithTheSameIndexName() throws Exception {
+        Connector connector = ConnectorTestUtils.getRandomSelfManagedConnector();
         String connectorId = randomUUID();
 
         ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
@@ -685,6 +686,42 @@ public void testUpdateConnectorIndexName_WithTheSameIndexName() throws Exception
         assertThat(updateResponse.getResult(), equalTo(DocWriteResponse.Result.NOOP));
     }
 
+    public void testUpdateConnectorIndexName_ForManagedConnector_WithIllegalIndexName() throws Exception {
+        Connector connector = ConnectorTestUtils.getRandomElasticManagedConnector();
+        String connectorId = randomUUID();
+
+        ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
+        assertThat(resp.status(), anyOf(equalTo(RestStatus.CREATED), equalTo(RestStatus.OK)));
+
+        UpdateConnectorIndexNameAction.Request updateIndexNameRequest = new UpdateConnectorIndexNameAction.Request(
+            connectorId,
+            "wrong-prefix-" + randomAlphaOfLengthBetween(3, 10)
+        );
+
+        expectThrows(ElasticsearchStatusException.class, () -> awaitUpdateConnectorIndexName(updateIndexNameRequest));
+    }
+
+    public void testUpdateConnectorIndexName_ForManagedConnector_WithPrefixedIndexName() throws Exception {
+        Connector connector = ConnectorTestUtils.getRandomElasticManagedConnector();
+        String connectorId = randomUUID();
+
+        ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
+        assertThat(resp.status(), anyOf(equalTo(RestStatus.CREATED), equalTo(RestStatus.OK)));
+
+        String newIndexName = MANAGED_CONNECTOR_INDEX_PREFIX + randomAlphaOfLengthBetween(3, 10);
+
+        UpdateConnectorIndexNameAction.Request updateIndexNameRequest = new UpdateConnectorIndexNameAction.Request(
+            connectorId,
+            newIndexName
+        );
+
+        DocWriteResponse updateResponse = awaitUpdateConnectorIndexName(updateIndexNameRequest);
+        assertThat(updateResponse.status(), equalTo(RestStatus.OK));
+
+        Connector indexedConnector = awaitGetConnector(connectorId);
+        assertThat(newIndexName, equalTo(indexedConnector.getIndexName()));
+    }
+
     public void testUpdateConnectorServiceType() throws Exception {
         Connector connector = ConnectorTestUtils.getRandomConnector();
         String connectorId = randomUUID();
@@ -756,7 +793,7 @@ public void testUpdateConnectorNameOrDescription() throws Exception {
     }
 
     public void testUpdateConnectorNative() throws Exception {
-        Connector connector = ConnectorTestUtils.getRandomConnector();
+        Connector connector = ConnectorTestUtils.getRandomConnectorWithDetachedIndex();
         String connectorId = randomUUID();
 
         ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
@@ -773,6 +810,39 @@ public void testUpdateConnectorNative() throws Exception {
         assertThat(isNative, equalTo(indexedConnector.isNative()));
     }
 
+    public void testUpdateConnectorNativeTrue_WhenIllegalIndexPrefix() throws Exception {
+        Connector connector = ConnectorTestUtils.getRandomConnectorWithAttachedIndex("wrong-prefix-" + randomAlphaOfLength(10));
+        String connectorId = randomUUID();
+
+        ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
+        assertThat(resp.status(), anyOf(equalTo(RestStatus.CREATED), equalTo(RestStatus.OK)));
+
+        boolean isNative = true;
+
+        UpdateConnectorNativeAction.Request updateNativeRequest = new UpdateConnectorNativeAction.Request(connectorId, isNative);
+
+        expectThrows(ElasticsearchStatusException.class, () -> awaitUpdateConnectorNative(updateNativeRequest));
+    }
+
+    public void testUpdateConnectorNativeTrue_WithCorrectIndexPrefix() throws Exception {
+        Connector connector = ConnectorTestUtils.getRandomConnectorWithAttachedIndex(
+            MANAGED_CONNECTOR_INDEX_PREFIX + randomAlphaOfLength(10)
+        );
+        String connectorId = randomUUID();
+
+        ConnectorCreateActionResponse resp = awaitCreateConnector(connectorId, connector);
+        assertThat(resp.status(), anyOf(equalTo(RestStatus.CREATED), equalTo(RestStatus.OK)));
+
+        boolean isNative = true;
+
+        UpdateConnectorNativeAction.Request updateNativeRequest = new UpdateConnectorNativeAction.Request(connectorId, isNative);
+        DocWriteResponse updateResponse = awaitUpdateConnectorNative(updateNativeRequest);
+        assertThat(updateResponse.status(), equalTo(RestStatus.OK));
+
+        Connector indexedConnector = awaitGetConnector(connectorId);
+        assertThat(isNative, equalTo(indexedConnector.isNative()));
+    }
+
     public void testUpdateConnectorStatus() throws Exception {
         Connector connector = ConnectorTestUtils.getRandomConnector();
         String connectorId = randomUUID();
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTestUtils.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTestUtils.java
index f052ef79d82fb..c563bc0a14ee3 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTestUtils.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTestUtils.java
@@ -343,6 +343,18 @@ public static Connector getRandomConnectorWithDetachedIndex() {
         return getRandomConnectorBuilder().setIndexName(null).build();
     }
 
+    public static Connector getRandomConnectorWithAttachedIndex(String indexName) {
+        return getRandomConnectorBuilder().setIndexName(indexName).build();
+    }
+
+    public static Connector getRandomSelfManagedConnector() {
+        return getRandomConnectorBuilder().setIsNative(false).build();
+    }
+
+    public static Connector getRandomElasticManagedConnector() {
+        return getRandomConnectorBuilder().setIsNative(true).build();
+    }
+
     public static Connector getRandomConnectorWithServiceTypeNotDefined() {
         return getRandomConnectorBuilder().setServiceType(null).build();
     }
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PostConnectorActionTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PostConnectorActionTests.java
index 0f0e83f2b9c51..e482bf3f6bb74 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PostConnectorActionTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PostConnectorActionTests.java
@@ -20,7 +20,7 @@ public void testValidate_WhenConnectorIdAndIndexNamePresent_ExpectNoValidationEr
         PostConnectorAction.Request request = new PostConnectorAction.Request(
             randomAlphaOfLength(10),
             randomAlphaOfLength(10),
-            randomBoolean(),
+            false,
             randomAlphaOfLength(10),
             randomAlphaOfLength(10),
             randomAlphaOfLength(10)
@@ -30,6 +30,24 @@ public void testValidate_WhenConnectorIdAndIndexNamePresent_ExpectNoValidationEr
         assertThat(exception, nullValue());
     }
 
+    public void testValidate_WrongIndexNamePresentForManagedConnector_ExpectValidationError() {
+        PostConnectorAction.Request requestWithIllegalIndexName = new PostConnectorAction.Request(
+            randomAlphaOfLength(10),
+            "wrong-prefix-" + randomAlphaOfLength(10),
+            true,
+            randomAlphaOfLength(10),
+            randomAlphaOfLength(10),
+            randomAlphaOfLength(10)
+        );
+        ActionRequestValidationException exception = requestWithIllegalIndexName.validate();
+
+        assertThat(exception, notNullValue());
+        assertThat(
+            exception.getMessage(),
+            containsString("Index attached to an Elastic-managed connector must start with the prefix: [content-]")
+        );
+    }
+
     public void testValidate_WhenMalformedIndexName_ExpectValidationError() {
         PostConnectorAction.Request requestWithMissingConnectorId = new PostConnectorAction.Request(
             randomAlphaOfLength(10),
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PutConnectorActionTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PutConnectorActionTests.java
index 873e102e40931..10ab049413565 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PutConnectorActionTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/action/PutConnectorActionTests.java
@@ -21,7 +21,7 @@ public void testValidate_WhenConnectorIdAndIndexNamePresent_ExpectNoValidationEr
             randomAlphaOfLength(10),
             randomAlphaOfLength(10),
             randomAlphaOfLength(10),
-            randomBoolean(),
+            false,
             randomAlphaOfLength(10),
             randomAlphaOfLength(10),
             randomAlphaOfLength(10)
@@ -31,6 +31,25 @@ public void testValidate_WhenConnectorIdAndIndexNamePresent_ExpectNoValidationEr
         assertThat(exception, nullValue());
     }
 
+    public void testValidate_WrongIndexNamePresentForManagedConnector_ExpectValidationError() {
+        PutConnectorAction.Request requestWithIllegalIndexName = new PutConnectorAction.Request(
+            randomAlphaOfLength(10),
+            randomAlphaOfLength(10),
+            "wrong-prefix-" + randomAlphaOfLength(10),
+            true,
+            randomAlphaOfLength(10),
+            randomAlphaOfLength(10),
+            randomAlphaOfLength(10)
+        );
+        ActionRequestValidationException exception = requestWithIllegalIndexName.validate();
+
+        assertThat(exception, notNullValue());
+        assertThat(
+            exception.getMessage(),
+            containsString("Index attached to an Elastic-managed connector must start with the prefix: [content-]")
+        );
+    }
+
     public void testValidate_WhenMalformedIndexName_ExpectValidationError() {
         PutConnectorAction.Request requestWithMissingConnectorId = new PutConnectorAction.Request(
             randomAlphaOfLength(10),

From fb6d7db8bdd3db245004c36a608a1df4c5a92933 Mon Sep 17 00:00:00 2001
From: Ioana Tagirta <ioanatia@users.noreply.github.com>
Date: Wed, 18 Dec 2024 13:11:31 +0100
Subject: [PATCH 067/119] Semantic search with query builder rewrite (#118676)

* Semantic search with query builder rewrite

* Address review feedback

* Add feature behind snapshot

* Use after/before instead of afterClass/beforeClass

* Call onFailure instead of throwing exception

* Fix KqlFunctionIT by requiring KqlPlugin

* Update scoring tests now that they are enabled

* Drop the score column for now
---
 .../elasticsearch/action/ResolvedIndices.java |  20 +-
 .../esql/qa/multi_node/SemanticMatchIT.java   |  26 +++
 .../esql/qa/single_node/SemanticMatchIT.java  |  26 +++
 .../esql/qa/rest/SemanticMatchTestCase.java   | 121 ++++++++++++
 .../xpack/esql/EsqlTestUtils.java             |   3 +
 .../xpack/esql/MockQueryBuilderResolver.java  |  30 +++
 .../main/resources/match-function.csv-spec    |  71 +++++++
 .../main/resources/match-operator.csv-spec    |  70 +++++++
 .../src/main/resources/scoring.csv-spec       |  40 ++++
 .../xpack/esql/plugin/KqlFunctionIT.java      |   9 +
 .../xpack/esql/execution/PlanExecutor.java    |   5 +-
 .../expression/function/fulltext/Match.java   |   2 +
 .../esql/plugin/TransportEsqlQueryAction.java |   8 +-
 .../xpack/esql/session/EsqlSession.java       |  16 +-
 .../esql/session/QueryBuilderResolver.java    | 178 ++++++++++++++++++
 .../elasticsearch/xpack/esql/CsvTests.java    |   3 +-
 .../LocalPhysicalPlanOptimizerTests.java      |   6 +
 .../esql/stats/PlanExecutorMetricsTests.java  |   2 +
 18 files changed, 629 insertions(+), 7 deletions(-)
 create mode 100644 x-pack/plugin/esql/qa/server/multi-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/multi_node/SemanticMatchIT.java
 create mode 100644 x-pack/plugin/esql/qa/server/single-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/single_node/SemanticMatchIT.java
 create mode 100644 x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/SemanticMatchTestCase.java
 create mode 100644 x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/MockQueryBuilderResolver.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/QueryBuilderResolver.java

diff --git a/server/src/main/java/org/elasticsearch/action/ResolvedIndices.java b/server/src/main/java/org/elasticsearch/action/ResolvedIndices.java
index f149603f12d8b..16f37c9573a8e 100644
--- a/server/src/main/java/org/elasticsearch/action/ResolvedIndices.java
+++ b/server/src/main/java/org/elasticsearch/action/ResolvedIndices.java
@@ -150,10 +150,26 @@ public static ResolvedIndices resolveWithIndicesRequest(
         RemoteClusterService remoteClusterService,
         long startTimeInMillis
     ) {
-        final Map<String, OriginalIndices> remoteClusterIndices = remoteClusterService.groupIndices(
+        return resolveWithIndexNamesAndOptions(
+            request.indices(),
             request.indicesOptions(),
-            request.indices()
+            clusterState,
+            indexNameExpressionResolver,
+            remoteClusterService,
+            startTimeInMillis
         );
+    }
+
+    public static ResolvedIndices resolveWithIndexNamesAndOptions(
+        String[] indexNames,
+        IndicesOptions indicesOptions,
+        ClusterState clusterState,
+        IndexNameExpressionResolver indexNameExpressionResolver,
+        RemoteClusterService remoteClusterService,
+        long startTimeInMillis
+    ) {
+        final Map<String, OriginalIndices> remoteClusterIndices = remoteClusterService.groupIndices(indicesOptions, indexNames);
+
         final OriginalIndices localIndices = remoteClusterIndices.remove(RemoteClusterAware.LOCAL_CLUSTER_GROUP_KEY);
 
         Index[] concreteLocalIndices = localIndices == null
diff --git a/x-pack/plugin/esql/qa/server/multi-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/multi_node/SemanticMatchIT.java b/x-pack/plugin/esql/qa/server/multi-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/multi_node/SemanticMatchIT.java
new file mode 100644
index 0000000000000..0ce84330b0b01
--- /dev/null
+++ b/x-pack/plugin/esql/qa/server/multi-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/multi_node/SemanticMatchIT.java
@@ -0,0 +1,26 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.qa.multi_node;
+
+import com.carrotsearch.randomizedtesting.annotations.ThreadLeakFilters;
+
+import org.elasticsearch.test.TestClustersThreadFilter;
+import org.elasticsearch.test.cluster.ElasticsearchCluster;
+import org.elasticsearch.xpack.esql.qa.rest.SemanticMatchTestCase;
+import org.junit.ClassRule;
+
+@ThreadLeakFilters(filters = TestClustersThreadFilter.class)
+public class SemanticMatchIT extends SemanticMatchTestCase {
+    @ClassRule
+    public static ElasticsearchCluster cluster = Clusters.testCluster(spec -> spec.plugin("inference-service-test"));
+
+    @Override
+    protected String getTestRestCluster() {
+        return cluster.getHttpAddresses();
+    }
+}
diff --git a/x-pack/plugin/esql/qa/server/single-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/single_node/SemanticMatchIT.java b/x-pack/plugin/esql/qa/server/single-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/single_node/SemanticMatchIT.java
new file mode 100644
index 0000000000000..8edc2dbcf35a2
--- /dev/null
+++ b/x-pack/plugin/esql/qa/server/single-node/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/single_node/SemanticMatchIT.java
@@ -0,0 +1,26 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.qa.single_node;
+
+import com.carrotsearch.randomizedtesting.annotations.ThreadLeakFilters;
+
+import org.elasticsearch.test.TestClustersThreadFilter;
+import org.elasticsearch.test.cluster.ElasticsearchCluster;
+import org.elasticsearch.xpack.esql.qa.rest.SemanticMatchTestCase;
+import org.junit.ClassRule;
+
+@ThreadLeakFilters(filters = TestClustersThreadFilter.class)
+public class SemanticMatchIT extends SemanticMatchTestCase {
+    @ClassRule
+    public static ElasticsearchCluster cluster = Clusters.testCluster(spec -> spec.plugin("inference-service-test"));
+
+    @Override
+    protected String getTestRestCluster() {
+        return cluster.getHttpAddresses();
+    }
+}
diff --git a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/SemanticMatchTestCase.java b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/SemanticMatchTestCase.java
new file mode 100644
index 0000000000000..aafa57e764ae7
--- /dev/null
+++ b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/SemanticMatchTestCase.java
@@ -0,0 +1,121 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.qa.rest;
+
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.ResponseException;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.test.rest.ESRestTestCase;
+import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
+import org.junit.After;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.util.Map;
+
+import static org.hamcrest.core.StringContains.containsString;
+
+public abstract class SemanticMatchTestCase extends ESRestTestCase {
+    public void testWithMultipleInferenceIds() throws IOException {
+        String query = """
+            from test-semantic1,test-semantic2
+            | where match(semantic_text_field, "something")
+            """;
+        ResponseException re = expectThrows(ResponseException.class, () -> runEsqlQuery(query));
+
+        assertThat(re.getMessage(), containsString("Field [semantic_text_field] has multiple inference IDs associated with it"));
+
+        assertEquals(400, re.getResponse().getStatusLine().getStatusCode());
+    }
+
+    public void testWithInferenceNotConfigured() {
+        String query = """
+            from test-semantic3
+            | where match(semantic_text_field, "something")
+            """;
+        ResponseException re = expectThrows(ResponseException.class, () -> runEsqlQuery(query));
+
+        assertThat(re.getMessage(), containsString("Inference endpoint not found"));
+        assertEquals(404, re.getResponse().getStatusLine().getStatusCode());
+    }
+
+    @Before
+    public void setUpIndices() throws IOException {
+        assumeTrue("semantic text capability not available", EsqlCapabilities.Cap.SEMANTIC_TEXT_TYPE.isEnabled());
+
+        var settings = Settings.builder().build();
+
+        String mapping1 = """
+                "properties": {
+                  "semantic_text_field": {
+                   "type": "semantic_text",
+                   "inference_id": "test_sparse_inference"
+                  }
+                }
+            """;
+        createIndex(adminClient(), "test-semantic1", settings, mapping1);
+
+        String mapping2 = """
+                 "properties": {
+                   "semantic_text_field": {
+                    "type": "semantic_text",
+                    "inference_id": "test_dense_inference"
+                   }
+                 }
+            """;
+        createIndex(adminClient(), "test-semantic2", settings, mapping2);
+
+        String mapping3 = """
+                 "properties": {
+                   "semantic_text_field": {
+                    "type": "semantic_text",
+                    "inference_id": "inexistent"
+                   }
+                 }
+            """;
+        createIndex(adminClient(), "test-semantic3", settings, mapping3);
+    }
+
+    @Before
+    public void setUpTextEmbeddingInferenceEndpoint() throws IOException {
+        assumeTrue("semantic text capability not available", EsqlCapabilities.Cap.SEMANTIC_TEXT_TYPE.isEnabled());
+        Request request = new Request("PUT", "_inference/text_embedding/test_dense_inference");
+        request.setJsonEntity("""
+                  {
+                   "service": "test_service",
+                   "service_settings": {
+                     "model": "my_model",
+                     "api_key": "abc64"
+                   },
+                   "task_settings": {
+                   }
+                 }
+            """);
+        adminClient().performRequest(request);
+    }
+
+    @After
+    public void wipeData() throws IOException {
+        assumeTrue("semantic text capability not available", EsqlCapabilities.Cap.SEMANTIC_TEXT_TYPE.isEnabled());
+        adminClient().performRequest(new Request("DELETE", "*"));
+
+        try {
+            adminClient().performRequest(new Request("DELETE", "_inference/test_dense_inference"));
+        } catch (ResponseException e) {
+            // 404 here means the endpoint was not created
+            if (e.getResponse().getStatusLine().getStatusCode() != 404) {
+                throw e;
+            }
+        }
+    }
+
+    private Map<String, Object> runEsqlQuery(String query) throws IOException {
+        RestEsqlTestCase.RequestObjectBuilder builder = RestEsqlTestCase.requestObjectBuilder().query(query);
+        return RestEsqlTestCase.runEsqlSync(builder);
+    }
+}
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
index 18ce9d7e3e057..66fd7d3ee5eb5 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
@@ -70,6 +70,7 @@
 import org.elasticsearch.xpack.esql.plugin.EsqlPlugin;
 import org.elasticsearch.xpack.esql.plugin.QueryPragmas;
 import org.elasticsearch.xpack.esql.session.Configuration;
+import org.elasticsearch.xpack.esql.session.QueryBuilderResolver;
 import org.elasticsearch.xpack.esql.stats.Metrics;
 import org.elasticsearch.xpack.esql.stats.SearchStats;
 import org.elasticsearch.xpack.versionfield.Version;
@@ -351,6 +352,8 @@ public String toString() {
 
     public static final Verifier TEST_VERIFIER = new Verifier(new Metrics(new EsqlFunctionRegistry()), new XPackLicenseState(() -> 0L));
 
+    public static final QueryBuilderResolver MOCK_QUERY_BUILDER_RESOLVER = new MockQueryBuilderResolver();
+
     private EsqlTestUtils() {}
 
     public static Configuration configuration(QueryPragmas pragmas, String query) {
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/MockQueryBuilderResolver.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/MockQueryBuilderResolver.java
new file mode 100644
index 0000000000000..7af3a89108fc0
--- /dev/null
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/MockQueryBuilderResolver.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.xpack.esql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.esql.session.QueryBuilderResolver;
+import org.elasticsearch.xpack.esql.session.Result;
+
+import java.util.function.BiConsumer;
+
+public class MockQueryBuilderResolver extends QueryBuilderResolver {
+    public MockQueryBuilderResolver() {
+        super(null, null, null, null);
+    }
+
+    @Override
+    public void resolveQueryBuilders(
+        LogicalPlan plan,
+        ActionListener<Result> listener,
+        BiConsumer<LogicalPlan, ActionListener<Result>> callback
+    ) {
+        callback.accept(plan, listener);
+    }
+}
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec
index 5ea169e1b110d..6c9a6fed3853c 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-function.csv-spec
@@ -597,3 +597,74 @@ from employees,employees_incompatible
 
 emp_no_bool:boolean
 ;
+
+testMatchWithSemanticText
+required_capability: match_function
+required_capability: semantic_text_type
+
+from semantic_text
+| where match(semantic_text_field, "something")
+| keep semantic_text_field
+| sort semantic_text_field asc
+;
+
+semantic_text_field:semantic_text
+all we have to decide is what to do with the time that is given to us
+be excellent to each other
+live long and prosper
+;
+
+testMatchWithSemanticTextAndKeyword
+required_capability: match_function
+required_capability: semantic_text_type
+
+from semantic_text
+| where match(semantic_text_field, "something") AND match(host, "host1")
+| keep semantic_text_field, host
+;
+
+semantic_text_field:semantic_text | host:keyword
+live long and prosper             | host1
+;
+
+testMatchWithSemanticTextMultiValueField
+required_capability: match_function
+required_capability: semantic_text_type
+
+from semantic_text metadata _id
+| where match(st_multi_value, "something") AND match(host, "host1")
+| keep _id, st_multi_value
+;
+
+_id: keyword | st_multi_value:semantic_text
+1            | ["Hello there!", "This is a random value", "for testing purposes"]
+;
+
+testMatchWithSemanticTextWithEvalsAndOtherFunctionsAndStats
+required_capability: match_function
+required_capability: semantic_text_type
+
+from semantic_text
+| where qstr("description:some*")
+| eval size = mv_count(st_multi_value)
+| where match(semantic_text_field, "something") AND size > 1 AND match(host, "host1")
+| STATS result = count(*)
+;
+
+result:long
+1
+;
+
+testMatchWithSemanticTextAndKql
+required_capability: match_function
+required_capability: semantic_text_type
+required_capability: kql_function
+
+from semantic_text
+| where kql("host:host1") AND match(semantic_text_field, "something")
+| KEEP host, semantic_text_field
+;
+
+host:keyword | semantic_text_field:semantic_text
+"host1"      | live long and prosper
+;
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec
index 7906f8b69162b..721443a70fe20 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/match-operator.csv-spec
@@ -608,3 +608,73 @@ from employees,employees_incompatible
 emp_no_bool:boolean
 ;
 
+testMatchWithSemanticText
+required_capability: match_operator_colon
+required_capability: semantic_text_type
+
+from semantic_text
+| where semantic_text_field:"something"
+| keep semantic_text_field
+| sort semantic_text_field asc
+;
+
+semantic_text_field:semantic_text
+all we have to decide is what to do with the time that is given to us
+be excellent to each other
+live long and prosper
+;
+
+testMatchWithSemanticTextAndKeyword
+required_capability: match_operator_colon
+required_capability: semantic_text_type
+
+from semantic_text
+| where semantic_text_field:"something" AND host:"host1"
+| keep semantic_text_field, host
+;
+
+semantic_text_field:semantic_text | host:keyword
+live long and prosper             | host1
+;
+
+testMatchWithSemanticTextMultiValueField
+required_capability: match_operator_colon
+required_capability: semantic_text_type
+
+from semantic_text metadata _id
+| where st_multi_value:"something" AND match(host, "host1")
+| keep _id, st_multi_value
+;
+
+_id: keyword | st_multi_value:semantic_text
+1            | ["Hello there!", "This is a random value", "for testing purposes"]
+;
+
+testMatchWithSemanticTextWithEvalsAndOtherFunctionsAndStats
+required_capability: match_operator_colon
+required_capability: semantic_text_type
+
+from semantic_text
+| where qstr("description:some*")
+| eval size = mv_count(st_multi_value)
+| where semantic_text_field:"something" AND size > 1 AND match(host, "host1")
+| STATS result = count(*)
+;
+
+result:long
+1
+;
+
+testMatchWithSemanticTextAndKql
+required_capability: match_operator_colon
+required_capability: semantic_text_type
+required_capability: kql_function
+
+from semantic_text
+| where kql("host:host1") AND semantic_text_field:"something"
+| KEEP host, semantic_text_field
+;
+
+host:keyword | semantic_text_field:semantic_text
+"host1"      | live long and prosper
+;
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec
index 72632c62603aa..9d3526982f9ef 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/scoring.csv-spec
@@ -317,3 +317,43 @@ book_no:keyword | title:text
 2924            | A Gentle Creature and Other Stories: White Nights, A Gentle Creature, and The Dream of a Ridiculous Man (The World's Classics) | foobar        
 5948            | That We Are Gentle Creatures                                                                                                   | foobar
 ;
+
+
+semanticTextMatch
+required_capability: metadata_score
+required_capability: semantic_text_type
+required_capability: match_function
+
+from semantic_text metadata _id, _score
+| where match(semantic_text_field, "something")
+| sort _score desc
+| keep _id
+;
+
+_id:keyword
+2
+3
+1
+;
+
+semanticTextMatchWithAllTheTextFunctions
+
+required_capability: metadata_score
+required_capability: semantic_text_type
+required_capability: match_function
+required_capability: kql_function
+required_capability: qstr_function
+
+from semantic_text metadata _id, _score
+| where match(semantic_text_field, "something")
+        AND match(description, "some")
+        AND kql("description:some*")
+        AND NOT qstr("host:host1")
+| sort _score desc
+| keep _id
+;
+
+_id:keyword
+2
+3
+;
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/KqlFunctionIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/KqlFunctionIT.java
index d58637ab52c86..0e84ac7588ad6 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/KqlFunctionIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/KqlFunctionIT.java
@@ -10,13 +10,17 @@
 import org.elasticsearch.action.index.IndexRequest;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.CollectionUtils;
 import org.elasticsearch.index.query.QueryShardException;
+import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.xpack.esql.VerificationException;
 import org.elasticsearch.xpack.esql.action.AbstractEsqlIntegTestCase;
 import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
+import org.elasticsearch.xpack.kql.KqlPlugin;
 import org.junit.Before;
 import org.junit.BeforeClass;
 
+import java.util.Collection;
 import java.util.List;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
@@ -141,4 +145,9 @@ private void createAndPopulateIndex() {
             .get();
         ensureYellow(indexName);
     }
+
+    @Override
+    protected Collection<Class<? extends Plugin>> nodePlugins() {
+        return CollectionUtils.appendToCopy(super.nodePlugins(), KqlPlugin.class);
+    }
 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/execution/PlanExecutor.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/execution/PlanExecutor.java
index c1269009c6a41..dad63d25046d9 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/execution/PlanExecutor.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/execution/PlanExecutor.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.xpack.esql.session.Configuration;
 import org.elasticsearch.xpack.esql.session.EsqlSession;
 import org.elasticsearch.xpack.esql.session.IndexResolver;
+import org.elasticsearch.xpack.esql.session.QueryBuilderResolver;
 import org.elasticsearch.xpack.esql.session.Result;
 import org.elasticsearch.xpack.esql.stats.Metrics;
 import org.elasticsearch.xpack.esql.stats.PlanningMetrics;
@@ -59,6 +60,7 @@ public void esql(
         EsqlExecutionInfo executionInfo,
         IndicesExpressionGrouper indicesExpressionGrouper,
         EsqlSession.PlanRunner planRunner,
+        QueryBuilderResolver queryBuilderResolver,
         ActionListener<Result> listener
     ) {
         final PlanningMetrics planningMetrics = new PlanningMetrics();
@@ -73,7 +75,8 @@ public void esql(
             mapper,
             verifier,
             planningMetrics,
-            indicesExpressionGrouper
+            indicesExpressionGrouper,
+            queryBuilderResolver
         );
         QueryMetric clientId = QueryMetric.fromString("rest");
         metrics.total(clientId);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Match.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Match.java
index 0b2268fe1b022..e695a94198dab 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Match.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Match.java
@@ -51,6 +51,7 @@
 import static org.elasticsearch.xpack.esql.core.type.DataType.IP;
 import static org.elasticsearch.xpack.esql.core.type.DataType.KEYWORD;
 import static org.elasticsearch.xpack.esql.core.type.DataType.LONG;
+import static org.elasticsearch.xpack.esql.core.type.DataType.SEMANTIC_TEXT;
 import static org.elasticsearch.xpack.esql.core.type.DataType.TEXT;
 import static org.elasticsearch.xpack.esql.core.type.DataType.UNSIGNED_LONG;
 import static org.elasticsearch.xpack.esql.core.type.DataType.VERSION;
@@ -70,6 +71,7 @@ public class Match extends FullTextFunction implements Validatable {
     public static final Set<DataType> FIELD_DATA_TYPES = Set.of(
         KEYWORD,
         TEXT,
+        SEMANTIC_TEXT,
         BOOLEAN,
         DATETIME,
         DATE_NANOS,
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/TransportEsqlQueryAction.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/TransportEsqlQueryAction.java
index 76bfb95d07926..50d5819688e46 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/TransportEsqlQueryAction.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/TransportEsqlQueryAction.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
 import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -42,6 +43,7 @@
 import org.elasticsearch.xpack.esql.execution.PlanExecutor;
 import org.elasticsearch.xpack.esql.session.Configuration;
 import org.elasticsearch.xpack.esql.session.EsqlSession.PlanRunner;
+import org.elasticsearch.xpack.esql.session.QueryBuilderResolver;
 import org.elasticsearch.xpack.esql.session.Result;
 
 import java.io.IOException;
@@ -68,6 +70,7 @@ public class TransportEsqlQueryAction extends HandledTransportAction<EsqlQueryRe
     private final LookupFromIndexService lookupFromIndexService;
     private final AsyncTaskManagementService<EsqlQueryRequest, EsqlQueryResponse, EsqlQueryTask> asyncTaskManagementService;
     private final RemoteClusterService remoteClusterService;
+    private final QueryBuilderResolver queryBuilderResolver;
 
     @Inject
     @SuppressWarnings("this-escape")
@@ -82,7 +85,8 @@ public TransportEsqlQueryAction(
         BigArrays bigArrays,
         BlockFactory blockFactory,
         Client client,
-        NamedWriteableRegistry registry
+        NamedWriteableRegistry registry,
+        IndexNameExpressionResolver indexNameExpressionResolver
 
     ) {
         // TODO replace SAME when removing workaround for https://github.com/elastic/elasticsearch/issues/97916
@@ -121,6 +125,7 @@ public TransportEsqlQueryAction(
             bigArrays
         );
         this.remoteClusterService = transportService.getRemoteClusterService();
+        this.queryBuilderResolver = new QueryBuilderResolver(searchService, clusterService, transportService, indexNameExpressionResolver);
     }
 
     @Override
@@ -191,6 +196,7 @@ private void innerExecute(Task task, EsqlQueryRequest request, ActionListener<Es
             executionInfo,
             remoteClusterService,
             planRunner,
+            queryBuilderResolver,
             listener.map(result -> toResponse(task, request, configuration, result))
         );
     }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
index c0290fa2b1d73..bd3b3bdb3483c 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
@@ -113,6 +113,7 @@ public interface PlanRunner {
     private final PhysicalPlanOptimizer physicalPlanOptimizer;
     private final PlanningMetrics planningMetrics;
     private final IndicesExpressionGrouper indicesExpressionGrouper;
+    private final QueryBuilderResolver queryBuilderResolver;
 
     public EsqlSession(
         String sessionId,
@@ -125,7 +126,8 @@ public EsqlSession(
         Mapper mapper,
         Verifier verifier,
         PlanningMetrics planningMetrics,
-        IndicesExpressionGrouper indicesExpressionGrouper
+        IndicesExpressionGrouper indicesExpressionGrouper,
+        QueryBuilderResolver queryBuilderResolver
     ) {
         this.sessionId = sessionId;
         this.configuration = configuration;
@@ -139,6 +141,7 @@ public EsqlSession(
         this.physicalPlanOptimizer = new PhysicalPlanOptimizer(new PhysicalOptimizerContext(configuration));
         this.planningMetrics = planningMetrics;
         this.indicesExpressionGrouper = indicesExpressionGrouper;
+        this.queryBuilderResolver = queryBuilderResolver;
     }
 
     public String sessionId() {
@@ -158,7 +161,16 @@ public void execute(EsqlQueryRequest request, EsqlExecutionInfo executionInfo, P
             new EsqlSessionCCSUtils.CssPartialErrorsActionListener(executionInfo, listener) {
                 @Override
                 public void onResponse(LogicalPlan analyzedPlan) {
-                    executeOptimizedPlan(request, executionInfo, planRunner, optimizedPlan(analyzedPlan), listener);
+                    try {
+                        var optimizedPlan = optimizedPlan(analyzedPlan);
+                        queryBuilderResolver.resolveQueryBuilders(
+                            optimizedPlan,
+                            listener,
+                            (newPlan, next) -> executeOptimizedPlan(request, executionInfo, planRunner, newPlan, next)
+                        );
+                    } catch (Exception e) {
+                        listener.onFailure(e);
+                    }
                 }
             }
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/QueryBuilderResolver.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/QueryBuilderResolver.java
new file mode 100644
index 0000000000000..b6424c5f7fa56
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/QueryBuilderResolver.java
@@ -0,0 +1,178 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.session;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ResolvedIndices;
+import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.query.QueryRewriteContext;
+import org.elasticsearch.index.query.Rewriteable;
+import org.elasticsearch.search.SearchService;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
+import org.elasticsearch.xpack.esql.core.util.Holder;
+import org.elasticsearch.xpack.esql.expression.function.fulltext.FullTextFunction;
+import org.elasticsearch.xpack.esql.plan.logical.EsRelation;
+import org.elasticsearch.xpack.esql.plan.logical.LogicalPlan;
+import org.elasticsearch.xpack.esql.planner.PlannerUtils;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.BiConsumer;
+
+/**
+ * Some {@link FullTextFunction} implementations such as {@link org.elasticsearch.xpack.esql.expression.function.fulltext.Match}
+ * will be translated to a {@link QueryBuilder} that require a rewrite phase on the coordinator.
+ * {@link QueryBuilderResolver#resolveQueryBuilders(LogicalPlan, ActionListener, BiConsumer)} will rewrite the plan by replacing
+ * {@link FullTextFunction} expression with new ones that hold rewritten {@link QueryBuilder}s.
+ */
+public class QueryBuilderResolver {
+    private final SearchService searchService;
+    private final ClusterService clusterService;
+    private final TransportService transportService;
+    private final IndexNameExpressionResolver indexNameExpressionResolver;
+
+    public QueryBuilderResolver(
+        SearchService searchService,
+        ClusterService clusterService,
+        TransportService transportService,
+        IndexNameExpressionResolver indexNameExpressionResolver
+    ) {
+        this.searchService = searchService;
+        this.clusterService = clusterService;
+        this.transportService = transportService;
+        this.indexNameExpressionResolver = indexNameExpressionResolver;
+    }
+
+    public void resolveQueryBuilders(
+        LogicalPlan plan,
+        ActionListener<Result> listener,
+        BiConsumer<LogicalPlan, ActionListener<Result>> callback
+    ) {
+        // TODO: remove once SEMANTIC_TEXT_TYPE is enabled outside of snapshots
+        if (false == EsqlCapabilities.Cap.SEMANTIC_TEXT_TYPE.isEnabled()) {
+            callback.accept(plan, listener);
+            return;
+        }
+
+        if (plan.optimized() == false) {
+            listener.onFailure(new IllegalStateException("Expected optimized plan before query builder rewrite."));
+            return;
+        }
+
+        Set<FullTextFunction> unresolved = fullTextFunctions(plan);
+        Set<String> indexNames = indexNames(plan);
+
+        if (indexNames == null || indexNames.isEmpty() || unresolved.isEmpty()) {
+            callback.accept(plan, listener);
+            return;
+        }
+        QueryRewriteContext ctx = queryRewriteContext(indexNames);
+        FullTextFunctionsRewritable rewritable = new FullTextFunctionsRewritable(unresolved);
+        Rewriteable.rewriteAndFetch(rewritable, ctx, new ActionListener<FullTextFunctionsRewritable>() {
+            @Override
+            public void onResponse(FullTextFunctionsRewritable fullTextFunctionsRewritable) {
+                try {
+                    LogicalPlan newPlan = planWithResolvedQueryBuilders(plan, fullTextFunctionsRewritable.results());
+                    callback.accept(newPlan, listener);
+                } catch (Exception e) {
+                    onFailure(e);
+                }
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                listener.onFailure(e);
+            }
+        });
+    }
+
+    private Set<FullTextFunction> fullTextFunctions(LogicalPlan plan) {
+        Set<FullTextFunction> functions = new HashSet<>();
+        plan.forEachExpressionDown(FullTextFunction.class, func -> functions.add(func));
+        return functions;
+    }
+
+    public Set<String> indexNames(LogicalPlan plan) {
+        Holder<Set<String>> indexNames = new Holder<>();
+
+        plan.forEachDown(EsRelation.class, esRelation -> { indexNames.set(esRelation.index().concreteIndices()); });
+
+        return indexNames.get();
+    }
+
+    public LogicalPlan planWithResolvedQueryBuilders(LogicalPlan plan, Map<FullTextFunction, QueryBuilder> newQueryBuilders) {
+        LogicalPlan newPlan = plan.transformExpressionsDown(FullTextFunction.class, m -> {
+            if (newQueryBuilders.keySet().contains(m)) {
+                return m.replaceQueryBuilder(newQueryBuilders.get(m));
+            }
+            return m;
+        });
+        // The given plan was already analyzed and optimized, so we set the resulted plan to optimized as well.
+        newPlan.setOptimized();
+        return newPlan;
+    }
+
+    private QueryRewriteContext queryRewriteContext(Set<String> indexNames) {
+        ResolvedIndices resolvedIndices = ResolvedIndices.resolveWithIndexNamesAndOptions(
+            indexNames.toArray(String[]::new),
+            IndexResolver.FIELD_CAPS_INDICES_OPTIONS,
+            clusterService.state(),
+            indexNameExpressionResolver,
+            transportService.getRemoteClusterService(),
+            System.currentTimeMillis()
+        );
+
+        return searchService.getRewriteContext(() -> System.currentTimeMillis(), resolvedIndices, null);
+    }
+
+    private class FullTextFunctionsRewritable implements Rewriteable<FullTextFunctionsRewritable> {
+
+        private final Map<FullTextFunction, QueryBuilder> queryBuilderMap;
+
+        FullTextFunctionsRewritable(Map<FullTextFunction, QueryBuilder> queryBuilderMap) {
+            this.queryBuilderMap = queryBuilderMap;
+        }
+
+        FullTextFunctionsRewritable(Set<FullTextFunction> functions) {
+            this.queryBuilderMap = new HashMap<>();
+
+            for (FullTextFunction func : functions) {
+                queryBuilderMap.put(func, func.asQuery(PlannerUtils.TRANSLATOR_HANDLER).asBuilder());
+            }
+        }
+
+        @Override
+        public FullTextFunctionsRewritable rewrite(QueryRewriteContext ctx) throws IOException {
+            Map<FullTextFunction, QueryBuilder> results = new HashMap<>();
+
+            boolean hasChanged = false;
+            for (FullTextFunction func : queryBuilderMap.keySet()) {
+                var initial = queryBuilderMap.get(func);
+                var rewritten = Rewriteable.rewrite(initial, ctx, false);
+
+                if (rewritten.equals(initial) == false) {
+                    hasChanged = true;
+                }
+
+                results.put(func, rewritten);
+            }
+
+            return hasChanged ? new FullTextFunctionsRewritable(results) : this;
+        }
+
+        public Map<FullTextFunction, QueryBuilder> results() {
+            return queryBuilderMap;
+        }
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index 717ac7b5a62a7..70794e4a82130 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -445,7 +445,8 @@ private ActualResults executePlan(BigArrays bigArrays) throws Exception {
             mapper,
             TEST_VERIFIER,
             new PlanningMetrics(),
-            null
+            null,
+            EsqlTestUtils.MOCK_QUERY_BUILDER_RESOLVER
         );
         TestPhysicalOperationProviders physicalOperationProviders = testOperationProviders(testDataset);
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
index 406e27c1517e5..928c849b847d5 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
@@ -1450,6 +1450,11 @@ private void checkMatchFunctionPushDown(
         var analyzer = makeAnalyzer("mapping-all-types.json");
         // Check for every possible query data type
         for (DataType fieldDataType : fieldDataTypes) {
+            // TODO: semantic_text is not present in mapping-all-types.json so we skip it for now
+            if (fieldDataType == DataType.SEMANTIC_TEXT) {
+                continue;
+            }
+
             var queryValue = randomQueryValue(fieldDataType);
 
             String fieldName = fieldDataType == DataType.DATETIME ? "date" : fieldDataType.name().toLowerCase(Locale.ROOT);
@@ -1483,6 +1488,7 @@ private static Object randomQueryValue(DataType dataType) {
             case KEYWORD -> randomAlphaOfLength(5);
             case IP -> NetworkAddress.format(randomIp(randomBoolean()));
             case TEXT -> randomAlphaOfLength(50);
+            case SEMANTIC_TEXT -> randomAlphaOfLength(5);
             case VERSION -> VersionUtils.randomVersion(random()).toString();
             default -> throw new IllegalArgumentException("Unexpected type: " + dataType);
         };
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/stats/PlanExecutorMetricsTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/stats/PlanExecutorMetricsTests.java
index b323efad2b4c3..539cd0314a4d1 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/stats/PlanExecutorMetricsTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/stats/PlanExecutorMetricsTests.java
@@ -123,6 +123,7 @@ public void testFailedMetric() {
             new EsqlExecutionInfo(randomBoolean()),
             groupIndicesByCluster,
             runPhase,
+            EsqlTestUtils.MOCK_QUERY_BUILDER_RESOLVER,
             new ActionListener<>() {
                 @Override
                 public void onResponse(Result result) {
@@ -152,6 +153,7 @@ public void onFailure(Exception e) {
             new EsqlExecutionInfo(randomBoolean()),
             groupIndicesByCluster,
             runPhase,
+            EsqlTestUtils.MOCK_QUERY_BUILDER_RESOLVER,
             new ActionListener<>() {
                 @Override
                 public void onResponse(Result result) {}

From 47d5e87d21dd682539c9da24a4cd321b68a97f05 Mon Sep 17 00:00:00 2001
From: Nikolaj Volgushev <n1v0lg@users.noreply.github.com>
Date: Wed, 18 Dec 2024 13:18:14 +0100
Subject: [PATCH 068/119] Prevent boot if bind DN is set without password
 (#118366)

LDAP/AD authentication realms can be configured to authenticate through
LDAP via a bind user. For this it's necessary to set a bind DN (via
`bind_dn`) together with a bind password (via `bind_password` or
`secure_bind_password`). Setting a bind DN without a bind password will
cause all LDAP/AD realm authentication to fail, leaving the node
non-operational. This PR adds a bootstrap check to prevent a
misconfigured node from starting. This behavior was deprecated in
https://github.com/elastic/elasticsearch/pull/85326.

Closes: ES-9749
---
 docs/changelog/118366.yaml                    | 22 +++++++++++
 .../authc/ldap/PoolingSessionFactory.java     | 37 +++++--------------
 .../LdapUserSearchSessionFactoryTests.java    | 29 +++++++--------
 3 files changed, 46 insertions(+), 42 deletions(-)
 create mode 100644 docs/changelog/118366.yaml

diff --git a/docs/changelog/118366.yaml b/docs/changelog/118366.yaml
new file mode 100644
index 0000000000000..cfeab1937738b
--- /dev/null
+++ b/docs/changelog/118366.yaml
@@ -0,0 +1,22 @@
+pr: 118366
+summary: |-
+  Configuring a bind DN in an LDAP or Active Directory (AD) realm without a corresponding bind password
+  will prevent node from starting
+area: Authentication
+type: breaking
+issues: []
+breaking:
+  title: -|
+    Configuring a bind DN in an LDAP or Active Directory (AD) realm without
+    a corresponding bind password will prevent node from starting
+  area: Cluster and node setting
+  details: -|
+    For LDAP or AD authentication realms, setting a bind DN (via the
+    `xpack.security.authc.realms.ldap.*.bind_dn` or `xpack.security.authc.realms.active_directory.*.bind_dn`
+    realm settings) without a bind password is a misconfiguration that may prevent successful authentication
+    to the node. Nodes will fail to start if a bind DN is specified without a password.
+  impact: -|
+    If you have a bind DN configured for an LDAP or AD authentication
+    realm, set a bind password for {ref}/ldap-realm.html#ldap-realm-configuration[LDAP]
+    or {ref}/active-directory-realm.html#ad-realm-configuration[Active Directory].
+    Configuring a bind DN without a password prevents the misconfigured node from starting.
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/PoolingSessionFactory.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/PoolingSessionFactory.java
index 4f87ac27be141..f31d5647b4cc5 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/PoolingSessionFactory.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ldap/PoolingSessionFactory.java
@@ -16,7 +16,6 @@
 
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.common.logging.DeprecationCategory;
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
@@ -74,7 +73,7 @@ abstract class PoolingSessionFactory extends SessionFactory implements Releasabl
         super(config, sslService, threadPool);
         this.groupResolver = groupResolver;
         this.bindDn = bindDn;
-        this.bindRequest = new AtomicReference<>(buildBindRequest(config.settings(), false));
+        this.bindRequest = new AtomicReference<>(buildBindRequest(config.settings()));
         this.useConnectionPool = config.getSetting(poolingEnabled);
         if (useConnectionPool) {
             this.connectionPool = createConnectionPool(config, serverSet, timeout, logger, bindRequest.get(), healthCheckDNSupplier);
@@ -93,11 +92,9 @@ abstract class PoolingSessionFactory extends SessionFactory implements Releasabl
      * will perform a setting consistency validation and throw {@link SettingsException} in case of violation.
      * Due to legacy reasons and BWC, when {@code reloadRequest} is se to {@code false}, this method will only log a warning message.
      *
-     * @param reloadRequest {@code true} if this method is called during reloading of secure settings,
-     *                      {@code false} if it is called during bootstrapping.
      * @return A new {@link SimpleBindRequest} that contains configured bind DN and password.
      */
-    private SimpleBindRequest buildBindRequest(Settings settings, boolean reloadRequest) {
+    private SimpleBindRequest buildBindRequest(Settings settings) {
         final byte[] bindPassword;
         final Setting<SecureString> legacyPasswordSetting = config.getConcreteSetting(LEGACY_BIND_PASSWORD);
         final Setting<SecureString> securePasswordSetting = config.getConcreteSetting(SECURE_BIND_PASSWORD);
@@ -119,27 +116,13 @@ private SimpleBindRequest buildBindRequest(Settings settings, boolean reloadRequ
             return new SimpleBindRequest();
         } else {
             if (bindPassword == null) {
-                if (reloadRequest) {
-                    throw new SettingsException(
-                        "[{}] is set but no bind password is specified. Without a corresponding bind password, "
-                            + "all {} realm authentication will fail. Specify a bind password via [{}].",
-                        RealmSettings.getFullSettingKey(config, PoolingSessionFactorySettings.BIND_DN),
-                        config.type(),
-                        RealmSettings.getFullSettingKey(config, SECURE_BIND_PASSWORD)
-                    );
-                } else {
-                    deprecationLogger.critical(
-                        DeprecationCategory.SECURITY,
-                        "bind_dn_set_without_password",
-                        "[{}] is set but no bind password is specified. Without a corresponding bind password, "
-                            + "all {} realm authentication will fail. Specify a bind password via [{}] or [{}]. "
-                            + "In the next major release, nodes with incomplete bind credentials will fail to start.",
-                        RealmSettings.getFullSettingKey(config, PoolingSessionFactorySettings.BIND_DN),
-                        config.type(),
-                        RealmSettings.getFullSettingKey(config, SECURE_BIND_PASSWORD),
-                        RealmSettings.getFullSettingKey(config, LEGACY_BIND_PASSWORD)
-                    );
-                }
+                throw new SettingsException(
+                    "[{}] is set but no bind password is specified. Without a corresponding bind password, "
+                        + "all {} realm authentication will fail. Specify a bind password via [{}].",
+                    RealmSettings.getFullSettingKey(config, PoolingSessionFactorySettings.BIND_DN),
+                    config.type(),
+                    RealmSettings.getFullSettingKey(config, SECURE_BIND_PASSWORD)
+                );
             }
             return new SimpleBindRequest(this.bindDn, bindPassword);
         }
@@ -148,7 +131,7 @@ private SimpleBindRequest buildBindRequest(Settings settings, boolean reloadRequ
     @Override
     public void reload(Settings settings) {
         final SimpleBindRequest oldRequest = bindRequest.get();
-        final SimpleBindRequest newRequest = buildBindRequest(settings, true);
+        final SimpleBindRequest newRequest = buildBindRequest(settings);
         if (bindRequestEquals(newRequest, oldRequest) == false) {
             if (bindRequest.compareAndSet(oldRequest, newRequest)) {
                 if (connectionPool != null) {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java
index acb4359b37323..5482d7711031e 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/ldap/LdapUserSearchSessionFactoryTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.settings.SettingsException;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.env.TestEnvironment;
@@ -45,7 +46,6 @@
 import java.util.Locale;
 
 import static org.elasticsearch.xpack.core.security.authc.RealmSettings.getFullSettingKey;
-import static org.elasticsearch.xpack.core.security.authc.ldap.PoolingSessionFactorySettings.BIND_DN;
 import static org.elasticsearch.xpack.core.security.authc.ldap.PoolingSessionFactorySettings.LEGACY_BIND_PASSWORD;
 import static org.elasticsearch.xpack.core.security.authc.ldap.PoolingSessionFactorySettings.SECURE_BIND_PASSWORD;
 import static org.hamcrest.Matchers.containsString;
@@ -199,7 +199,7 @@ public void testUserSearchBaseScopeFailsWithWrongBaseDN() throws Exception {
         assertDeprecationWarnings(config.identifier(), useAttribute, useLegacyBindPassword);
     }
 
-    public void testConstructorLogsErrorIfBindDnSetWithoutPassword() throws Exception {
+    public void testConstructorThrowsIfBindDnSetWithoutPassword() throws Exception {
         String groupSearchBase = "o=sevenSeas";
         String userSearchBase = "cn=William Bush,ou=people,o=sevenSeas";
 
@@ -216,19 +216,18 @@ public void testConstructorLogsErrorIfBindDnSetWithoutPassword() throws Exceptio
             new ThreadContext(globalSettings)
         );
 
-        try (LdapUserSearchSessionFactory ignored = getLdapUserSearchSessionFactory(config, sslService, threadPool)) {
-            assertCriticalWarnings(
-                String.format(
-                    Locale.ROOT,
-                    "[%s] is set but no bind password is specified. Without a corresponding bind password, "
-                        + "all ldap realm authentication will fail. Specify a bind password via [%s] or [%s]. "
-                        + "In the next major release, nodes with incomplete bind credentials will fail to start.",
-                    RealmSettings.getFullSettingKey(config, BIND_DN),
-                    RealmSettings.getFullSettingKey(config, SECURE_BIND_PASSWORD),
-                    RealmSettings.getFullSettingKey(config, LEGACY_BIND_PASSWORD)
-                )
-            );
-        }
+        Exception ex = expectThrows(SettingsException.class, () -> getLdapUserSearchSessionFactory(config, sslService, threadPool));
+        assertEquals(
+            String.format(
+                Locale.ROOT,
+                "[%s] is set but no bind password is specified. Without a corresponding bind password, "
+                    + "all %s realm authentication will fail. Specify a bind password via [%s].",
+                RealmSettings.getFullSettingKey(config, PoolingSessionFactorySettings.BIND_DN),
+                config.type(),
+                RealmSettings.getFullSettingKey(config, SECURE_BIND_PASSWORD)
+            ),
+            ex.getMessage()
+        );
     }
 
     public void testConstructorThrowsIfBothLegacyAndSecureBindPasswordSet() throws Exception {

From ede1a7ab2af7156edd0e3cb6626cb9cbf8e858c4 Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Wed, 18 Dec 2024 13:46:21 +0100
Subject: [PATCH 069/119] Include v7 in IndexVersionUtils#ALL_VERSIONS
 (#118793)

We are going to retain read-only compatibility with v7 index versions upon upgrade to v9. This means that all the v7 index versions and corresponding version conditionals will stay around for another major series.

This PR reflects this decision in the codebase. No need to filter index versions when retrieving ALL_VERSIONS, and we can remove corresponding @UpdateForV9 annotations from the IndexVersions class. At the same time, there are tests that need to randomize version but need to write to an index, hence 7x versions should be filtered out.

The overall goal is to extend testing to v7 index versions when possible, and making randomization across writeable versions an exception that certain tests can rely on as needed.

These are the mechanical steps I made in this PR:

- Rename `getFirstVersion` to `getLowestReadCompatibleVersion`, which returns the lowest supported index version ( which can not be written to)
- Introduce `getLowestWriteCompatibleVersion` to identify the lowest writeable version. This is used by tests that used to call `getFirstVersion` and need to write to the index.
- Remove `randomVersion(Random random)` in favour of `randomVersion()` . It was always called providing `random()` which is equivalent to what `randomVersion()` already does.
- Introduce `randomWriteVersion` for tests that need a random writeable version. Moved tests that need it to use it (from `randomVersion` to `randomWriteVersion`)

There is still work to do in `IndexVersionUtils` to extend testing, especially as some randomized tests have a lower bound of `MINIMUM_COMPATIBLE_VERSION` hence don't include v7 index versions yet. We will address that as a follow-up.
---
 .../common/NGramTokenizerFactoryTests.java    |  2 +-
 .../common/PersianAnalyzerProviderTests.java  |  2 +-
 .../common/RomanianAnalyzerTests.java         |  2 +-
 .../StemmerTokenFilterFactoryTests.java       | 10 +++++-----
 .../admin/indices/create/ShrinkIndexIT.java   |  2 +-
 .../cluster/ClusterStateDiffIT.java           |  7 ++++---
 .../PreBuiltAnalyzerIntegrationIT.java        |  2 +-
 .../indices/recovery/IndexRecoveryIT.java     |  2 +-
 .../elasticsearch/index/IndexVersions.java    | 11 +++++-----
 .../HumanReadableIndexSettingsTests.java      |  2 +-
 .../MetadataCreateIndexServiceTests.java      |  6 +-----
 .../MetadataDeleteIndexServiceTests.java      |  6 +++---
 .../MetadataIndexAliasesServiceTests.java     |  2 +-
 .../MetadataIndexStateServiceTests.java       |  2 +-
 .../elasticsearch/env/NodeMetadataTests.java  |  2 +-
 .../index/IndexVersionTests.java              |  9 ++-------
 .../index/analysis/AnalysisRegistryTests.java | 12 +++++------
 .../index/analysis/PreBuiltAnalyzerTests.java |  6 +++---
 .../PreConfiguredTokenFilterTests.java        |  6 +++---
 .../index/engine/InternalEngineTests.java     |  2 +-
 .../vectors/DenseVectorFieldMapperTests.java  |  8 ++++----
 .../indices/analysis/AnalysisModuleTests.java |  6 +++---
 .../IncorrectSetupStablePluginsTests.java     |  6 +++---
 .../StableAnalysisPluginsNoSettingsTests.java |  2 +-
 ...tableAnalysisPluginsWithSettingsTests.java |  8 ++++----
 .../recovery/RecoverySourceHandlerTests.java  |  2 +-
 .../nodesinfo/NodeInfoStreamingTests.java     |  2 +-
 .../PersistentTasksClusterServiceTests.java   |  4 ++--
 ...SnapshotsInProgressSerializationTests.java |  2 +-
 .../index/KnownIndexVersions.java             |  6 +++++-
 .../test/index/IndexVersionUtils.java         | 20 ++++++++++++-------
 ...eprecationRoleDescriptorConsumerTests.java |  2 +-
 32 files changed, 83 insertions(+), 80 deletions(-)

diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/NGramTokenizerFactoryTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/NGramTokenizerFactoryTests.java
index 8c365a1362f85..35c01b5b9296f 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/NGramTokenizerFactoryTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/NGramTokenizerFactoryTests.java
@@ -161,7 +161,7 @@ public void testBackwardsCompatibilityEdgeNgramTokenFilter() throws Exception {
         for (int i = 0; i < iters; i++) {
             final Index index = new Index("test", "_na_");
             final String name = "ngr";
-            IndexVersion v = IndexVersionUtils.randomVersion(random());
+            IndexVersion v = IndexVersionUtils.randomVersion();
             Builder builder = newAnalysisSettingsBuilder().put("min_gram", 2).put("max_gram", 3);
             boolean reverse = random().nextBoolean();
             if (reverse) {
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PersianAnalyzerProviderTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PersianAnalyzerProviderTests.java
index 7b962538c2a10..153c3e9549285 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PersianAnalyzerProviderTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/PersianAnalyzerProviderTests.java
@@ -56,7 +56,7 @@ public void testPersianAnalyzerPostLucene10() throws IOException {
     public void testPersianAnalyzerPreLucene10() throws IOException {
         IndexVersion preLucene10Version = IndexVersionUtils.randomVersionBetween(
             random(),
-            IndexVersionUtils.getFirstVersion(),
+            IndexVersionUtils.getLowestReadCompatibleVersion(),
             IndexVersionUtils.getPreviousVersion(IndexVersions.UPGRADE_TO_LUCENE_10_0_0)
         );
         Settings settings = ESTestCase.indexSettings(1, 1)
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/RomanianAnalyzerTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/RomanianAnalyzerTests.java
index 1af44bc71f35d..29e27e62e3164 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/RomanianAnalyzerTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/RomanianAnalyzerTests.java
@@ -57,7 +57,7 @@ public void testRomanianAnalyzerPostLucene10() throws IOException {
     public void testRomanianAnalyzerPreLucene10() throws IOException {
         IndexVersion preLucene10Version = IndexVersionUtils.randomVersionBetween(
             random(),
-            IndexVersionUtils.getFirstVersion(),
+            IndexVersionUtils.getLowestReadCompatibleVersion(),
             IndexVersionUtils.getPreviousVersion(IndexVersions.UPGRADE_TO_LUCENE_10_0_0)
         );
         Settings settings = ESTestCase.indexSettings(1, 1)
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/StemmerTokenFilterFactoryTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/StemmerTokenFilterFactoryTests.java
index bb06c221873b5..4e774d92e3d62 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/StemmerTokenFilterFactoryTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/StemmerTokenFilterFactoryTests.java
@@ -39,7 +39,7 @@ public class StemmerTokenFilterFactoryTests extends ESTokenStreamTestCase {
     public void testEnglishFilterFactory() throws IOException {
         int iters = scaledRandomIntBetween(20, 100);
         for (int i = 0; i < iters; i++) {
-            IndexVersion v = IndexVersionUtils.randomVersion(random());
+            IndexVersion v = IndexVersionUtils.randomVersion();
             Settings settings = Settings.builder()
                 .put("index.analysis.filter.my_english.type", "stemmer")
                 .put("index.analysis.filter.my_english.language", "english")
@@ -66,7 +66,7 @@ public void testPorter2FilterFactory() throws IOException {
         int iters = scaledRandomIntBetween(20, 100);
         for (int i = 0; i < iters; i++) {
 
-            IndexVersion v = IndexVersionUtils.randomVersion(random());
+            IndexVersion v = IndexVersionUtils.randomVersion();
             Settings settings = Settings.builder()
                 .put("index.analysis.filter.my_porter2.type", "stemmer")
                 .put("index.analysis.filter.my_porter2.language", "porter2")
@@ -90,7 +90,7 @@ public void testPorter2FilterFactory() throws IOException {
     }
 
     public void testMultipleLanguagesThrowsException() throws IOException {
-        IndexVersion v = IndexVersionUtils.randomVersion(random());
+        IndexVersion v = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder()
             .put("index.analysis.filter.my_english.type", "stemmer")
             .putList("index.analysis.filter.my_english.language", "english", "light_english")
@@ -142,7 +142,7 @@ private static Analyzer createGermanStemmer(String variant, IndexVersion v) thro
     }
 
     public void testKpDeprecation() throws IOException {
-        IndexVersion v = IndexVersionUtils.randomVersion(random());
+        IndexVersion v = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder()
             .put("index.analysis.filter.my_kp.type", "stemmer")
             .put("index.analysis.filter.my_kp.language", "kp")
@@ -155,7 +155,7 @@ public void testKpDeprecation() throws IOException {
     }
 
     public void testLovinsDeprecation() throws IOException {
-        IndexVersion v = IndexVersionUtils.randomVersion(random());
+        IndexVersion v = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder()
             .put("index.analysis.filter.my_lovins.type", "stemmer")
             .put("index.analysis.filter.my_lovins.language", "lovins")
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java
index 4f6d24b419595..ca9fdb27ac389 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/ShrinkIndexIT.java
@@ -236,7 +236,7 @@ private static IndexMetadata indexMetadata(final Client client, final String ind
 
     public void testCreateShrinkIndex() {
         internalCluster().ensureAtLeastNumDataNodes(2);
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomWriteVersion();
         prepareCreate("source").setSettings(
             Settings.builder().put(indexSettings()).put("number_of_shards", randomIntBetween(2, 7)).put("index.version.created", version)
         ).get();
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/cluster/ClusterStateDiffIT.java b/server/src/internalClusterTest/java/org/elasticsearch/cluster/ClusterStateDiffIT.java
index 58b9af7724aaa..e8e4eb7562462 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/cluster/ClusterStateDiffIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/cluster/ClusterStateDiffIT.java
@@ -71,6 +71,7 @@
 import static org.elasticsearch.test.XContentTestUtils.convertToMap;
 import static org.elasticsearch.test.XContentTestUtils.differenceBetweenMapsIgnoringArrayOrder;
 import static org.elasticsearch.test.index.IndexVersionUtils.randomVersion;
+import static org.elasticsearch.test.index.IndexVersionUtils.randomWriteVersion;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 
@@ -218,7 +219,7 @@ private ClusterState.Builder randomCoordinationMetadata(ClusterState clusterStat
 
     private DiscoveryNode randomNode(String nodeId) {
         Version nodeVersion = VersionUtils.randomVersion(random());
-        IndexVersion indexVersion = randomVersion(random());
+        IndexVersion indexVersion = randomVersion();
         return DiscoveryNodeUtils.builder(nodeId)
             .roles(emptySet())
             .version(nodeVersion, IndexVersion.fromId(indexVersion.id() - 1_000_000), indexVersion)
@@ -561,7 +562,7 @@ public IndexMetadata randomCreate(String name) {
                 IndexMetadata.Builder builder = IndexMetadata.builder(name);
                 Settings.Builder settingsBuilder = Settings.builder();
                 setRandomIndexSettings(random(), settingsBuilder);
-                settingsBuilder.put(randomSettings(Settings.EMPTY)).put(IndexMetadata.SETTING_VERSION_CREATED, randomVersion(random()));
+                settingsBuilder.put(randomSettings(Settings.EMPTY)).put(IndexMetadata.SETTING_VERSION_CREATED, randomWriteVersion());
                 builder.settings(settingsBuilder);
                 builder.numberOfShards(randomIntBetween(1, 10)).numberOfReplicas(randomInt(10));
                 builder.eventIngestedRange(IndexLongFieldRange.UNKNOWN, TransportVersion.current());
@@ -736,7 +737,7 @@ public ClusterState.Custom randomCreate(String name) {
                             ImmutableOpenMap.of(),
                             null,
                             SnapshotInfoTestUtils.randomUserMetadata(),
-                            randomVersion(random())
+                            randomVersion()
                         )
                     );
                     case 1 -> new RestoreInProgress.Builder().add(
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java b/server/src/internalClusterTest/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java
index 48aef0d348045..891b0319f880d 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/indices/analysis/PreBuiltAnalyzerIntegrationIT.java
@@ -47,7 +47,7 @@ public void testThatPreBuiltAnalyzersAreNotClosedOnIndexClose() throws Exception
             PreBuiltAnalyzers preBuiltAnalyzer = PreBuiltAnalyzers.values()[randomInt];
             String name = preBuiltAnalyzer.name().toLowerCase(Locale.ROOT);
 
-            IndexVersion randomVersion = IndexVersionUtils.randomVersion(random());
+            IndexVersion randomVersion = IndexVersionUtils.randomWriteVersion();
             if (loadedAnalyzers.containsKey(preBuiltAnalyzer) == false) {
                 loadedAnalyzers.put(preBuiltAnalyzer, new ArrayList<>());
             }
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java b/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
index 7d4269550bb88..fa1348c82d71a 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexRecoveryIT.java
@@ -2050,7 +2050,7 @@ public void testPostRecoveryMergeDisabledOnOlderIndices() throws Exception {
                     IndexMetadata.SETTING_VERSION_CREATED,
                     IndexVersionUtils.randomVersionBetween(
                         random(),
-                        IndexVersionUtils.getFirstVersion(),
+                        IndexVersionUtils.getLowestWriteCompatibleVersion(),
                         IndexVersionUtils.getPreviousVersion(IndexVersions.MERGE_ON_RECOVERY_VERSION)
                     )
                 )
diff --git a/server/src/main/java/org/elasticsearch/index/IndexVersions.java b/server/src/main/java/org/elasticsearch/index/IndexVersions.java
index fd321f6256194..8af10524813cc 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexVersions.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexVersions.java
@@ -12,7 +12,6 @@
 import org.apache.lucene.util.Version;
 import org.elasticsearch.ReleaseVersions;
 import org.elasticsearch.core.Assertions;
-import org.elasticsearch.core.UpdateForV9;
 
 import java.lang.reflect.Field;
 import java.text.ParseException;
@@ -25,6 +24,7 @@
 import java.util.TreeMap;
 import java.util.TreeSet;
 import java.util.function.IntFunction;
+import java.util.stream.Collectors;
 
 @SuppressWarnings("deprecation")
 public class IndexVersions {
@@ -58,7 +58,6 @@ private static Version parseUnchecked(String version) {
         }
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_FOUNDATIONS) // remove the index versions with which v9 will not need to interact
     public static final IndexVersion ZERO = def(0, Version.LATEST);
 
     public static final IndexVersion V_7_0_0 = def(7_00_00_99, parseUnchecked("8.0.0"));
@@ -244,10 +243,12 @@ static NavigableMap<Integer, IndexVersion> getAllVersionIds(Class<?> cls) {
         return Collections.unmodifiableNavigableMap(builder);
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.CORE_INFRA)
-    // We can simplify this once we've removed all references to index versions earlier than MINIMUM_COMPATIBLE
+    static Collection<IndexVersion> getAllWriteVersions() {
+        return VERSION_IDS.values().stream().filter(v -> v.onOrAfter(IndexVersions.MINIMUM_COMPATIBLE)).collect(Collectors.toSet());
+    }
+
     static Collection<IndexVersion> getAllVersions() {
-        return VERSION_IDS.values().stream().filter(v -> v.onOrAfter(MINIMUM_COMPATIBLE)).toList();
+        return VERSION_IDS.values();
     }
 
     static final IntFunction<String> VERSION_LOOKUP = ReleaseVersions.generateVersionsLookup(IndexVersions.class, LATEST_DEFINED.id());
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/HumanReadableIndexSettingsTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/HumanReadableIndexSettingsTests.java
index 476ade8576586..8752e68112bff 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/HumanReadableIndexSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/HumanReadableIndexSettingsTests.java
@@ -22,7 +22,7 @@
 
 public class HumanReadableIndexSettingsTests extends ESTestCase {
     public void testHumanReadableSettings() {
-        IndexVersion versionCreated = randomVersion(random());
+        IndexVersion versionCreated = randomVersion();
         long created = System.currentTimeMillis();
         Settings testSettings = Settings.builder()
             .put(IndexMetadata.SETTING_VERSION_CREATED, versionCreated)
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataCreateIndexServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataCreateIndexServiceTests.java
index c0e397c9fb9c9..d45b2c119d2ae 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataCreateIndexServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataCreateIndexServiceTests.java
@@ -369,11 +369,7 @@ public void testValidateSplitIndex() {
     }
 
     public void testPrepareResizeIndexSettings() {
-        final List<IndexVersion> versions = Stream.of(IndexVersionUtils.randomVersion(random()), IndexVersionUtils.randomVersion(random()))
-            .sorted()
-            .toList();
-        final IndexVersion version = versions.get(0);
-        final IndexVersion upgraded = versions.get(1);
+        final IndexVersion version = IndexVersionUtils.randomWriteVersion();
         final Settings.Builder indexSettingsBuilder = Settings.builder()
             .put("index.version.created", version)
             .put("index.similarity.default.type", "BM25")
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataDeleteIndexServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataDeleteIndexServiceTests.java
index 0354b6f0bcea8..3ada92dbe7ae5 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataDeleteIndexServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataDeleteIndexServiceTests.java
@@ -97,7 +97,7 @@ public void testDeleteSnapshotting() {
                 Map.of(),
                 null,
                 SnapshotInfoTestUtils.randomUserMetadata(),
-                IndexVersionUtils.randomVersion(random())
+                IndexVersionUtils.randomVersion()
             )
         );
         ClusterState state = ClusterState.builder(clusterState(index)).putCustom(SnapshotsInProgress.TYPE, snaps).build();
@@ -153,7 +153,7 @@ public void testDeleteIndexWithAnAlias() {
         String alias = randomAlphaOfLength(5);
 
         IndexMetadata idxMetadata = IndexMetadata.builder(index)
-            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random())))
+            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion()))
             .putAlias(AliasMetadata.builder(alias).writeIndex(true).build())
             .numberOfShards(1)
             .numberOfReplicas(1)
@@ -348,7 +348,7 @@ public void testDeleteCurrentWriteFailureIndexForDataStream() {
 
     private ClusterState clusterState(String index) {
         IndexMetadata indexMetadata = IndexMetadata.builder(index)
-            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random())))
+            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion()))
             .numberOfShards(1)
             .numberOfReplicas(1)
             .build();
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexAliasesServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexAliasesServiceTests.java
index 4f2c84d76b5a4..22ddb5cc2ba35 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexAliasesServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexAliasesServiceTests.java
@@ -744,7 +744,7 @@ private ClusterState applyHiddenAliasMix(ClusterState before, Boolean isHidden1,
 
     private ClusterState createIndex(ClusterState state, String index) {
         IndexMetadata indexMetadata = IndexMetadata.builder(index)
-            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random())))
+            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomWriteVersion()))
             .numberOfShards(1)
             .numberOfReplicas(1)
             .build();
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexStateServiceTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexStateServiceTests.java
index db5a98a4878ca..bd11e636d51c1 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexStateServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/MetadataIndexStateServiceTests.java
@@ -377,7 +377,7 @@ private static ClusterState addSnapshotIndex(final String index, final int numSh
             shardsBuilder,
             null,
             SnapshotInfoTestUtils.randomUserMetadata(),
-            IndexVersionUtils.randomVersion(random())
+            IndexVersionUtils.randomVersion()
         );
         return ClusterState.builder(newState).putCustom(SnapshotsInProgress.TYPE, SnapshotsInProgress.EMPTY.withAddedEntry(entry)).build();
     }
diff --git a/server/src/test/java/org/elasticsearch/env/NodeMetadataTests.java b/server/src/test/java/org/elasticsearch/env/NodeMetadataTests.java
index 22308e15f4845..eccdd1c6ffea7 100644
--- a/server/src/test/java/org/elasticsearch/env/NodeMetadataTests.java
+++ b/server/src/test/java/org/elasticsearch/env/NodeMetadataTests.java
@@ -43,7 +43,7 @@ private BuildVersion randomBuildVersion() {
     }
 
     private IndexVersion randomIndexVersion() {
-        return rarely() ? IndexVersion.fromId(randomInt()) : IndexVersionUtils.randomVersion(random());
+        return rarely() ? IndexVersion.fromId(randomInt()) : IndexVersionUtils.randomVersion();
     }
 
     public void testEqualsHashcodeSerialization() {
diff --git a/server/src/test/java/org/elasticsearch/index/IndexVersionTests.java b/server/src/test/java/org/elasticsearch/index/IndexVersionTests.java
index 2a425c9256c31..8575b87c36799 100644
--- a/server/src/test/java/org/elasticsearch/index/IndexVersionTests.java
+++ b/server/src/test/java/org/elasticsearch/index/IndexVersionTests.java
@@ -11,7 +11,6 @@
 
 import org.apache.lucene.util.Version;
 import org.elasticsearch.common.lucene.Lucene;
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.index.IndexVersionUtils;
 import org.hamcrest.Matchers;
@@ -151,9 +150,7 @@ public void testMax() {
         }
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.CORE_INFRA)
-    @AwaitsFix(bugUrl = "believe this fails because index version has not yet been bumped to 9.0")
-    public void testMinimumCompatibleVersion() {
+    public void testGetMinimumCompatibleIndexVersion() {
         assertThat(IndexVersion.getMinimumCompatibleIndexVersion(7170099), equalTo(IndexVersion.fromId(6000099)));
         assertThat(IndexVersion.getMinimumCompatibleIndexVersion(8000099), equalTo(IndexVersion.fromId(7000099)));
         assertThat(IndexVersion.getMinimumCompatibleIndexVersion(10000000), equalTo(IndexVersion.fromId(9000000)));
@@ -193,8 +190,6 @@ public void testParseLenient() {
         }
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.CORE_INFRA)
-    @AwaitsFix(bugUrl = "can be unmuted once lucene is bumped to version 10")
     public void testLuceneVersionOnUnknownVersions() {
         // between two known versions, should use the lucene version of the previous version
         IndexVersion previousVersion = IndexVersionUtils.getPreviousVersion();
@@ -207,7 +202,7 @@ public void testLuceneVersionOnUnknownVersions() {
 
         // too old version, major should be the oldest supported lucene version minus 1
         IndexVersion oldVersion = IndexVersion.fromId(5020199);
-        assertThat(oldVersion.luceneVersion().major, equalTo(IndexVersionUtils.getFirstVersion().luceneVersion().major - 1));
+        assertThat(oldVersion.luceneVersion().major, equalTo(IndexVersionUtils.getLowestReadCompatibleVersion().luceneVersion().major - 1));
 
         // future version, should be the same version as today
         IndexVersion futureVersion = IndexVersion.fromId(currentVersion.id() + 100);
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java b/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java
index 04170030c1173..db780f0640986 100644
--- a/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java
+++ b/server/src/test/java/org/elasticsearch/index/analysis/AnalysisRegistryTests.java
@@ -106,7 +106,7 @@ public void setUp() throws Exception {
     }
 
     public void testDefaultAnalyzers() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder()
             .put(IndexMetadata.SETTING_VERSION_CREATED, version)
             .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString())
@@ -120,7 +120,7 @@ public void testDefaultAnalyzers() throws IOException {
     }
 
     public void testOverrideDefaultAnalyzer() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         IndexAnalyzers indexAnalyzers = AnalysisRegistry.build(
             IndexCreationContext.CREATE_INDEX,
@@ -137,7 +137,7 @@ public void testOverrideDefaultAnalyzer() throws IOException {
     }
 
     public void testOverrideDefaultAnalyzerWithoutAnalysisModeAll() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("index", settings);
         TokenFilterFactory tokenFilter = new AbstractTokenFilterFactory("my_filter") {
@@ -216,7 +216,7 @@ public void testOverrideDefaultIndexAnalyzerIsUnsupported() {
     }
 
     public void testOverrideDefaultSearchAnalyzer() {
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         IndexAnalyzers indexAnalyzers = AnalysisRegistry.build(
             IndexCreationContext.CREATE_INDEX,
@@ -319,8 +319,8 @@ public void testBuiltInAnalyzersAreCached() throws IOException {
         }
     }
 
-    public void testNoTypeOrTokenizerErrorMessage() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+    public void testNoTypeOrTokenizerErrorMessage() {
+        IndexVersion version = IndexVersionUtils.randomVersion();
         Settings settings = Settings.builder()
             .put(IndexMetadata.SETTING_VERSION_CREATED, version)
             .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString())
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java b/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
index 0a7bd495f2f22..f5b86f422915e 100644
--- a/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
+++ b/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
@@ -63,7 +63,7 @@ public void testThatInstancesAreCachedAndReused() {
             PreBuiltAnalyzers.STANDARD.getAnalyzer(IndexVersion.current())
         );
         // same index version should be cached
-        IndexVersion v = IndexVersionUtils.randomVersion(random());
+        IndexVersion v = IndexVersionUtils.randomVersion();
         assertSame(PreBuiltAnalyzers.STANDARD.getAnalyzer(v), PreBuiltAnalyzers.STANDARD.getAnalyzer(v));
         assertNotSame(
             PreBuiltAnalyzers.STANDARD.getAnalyzer(IndexVersion.current()),
@@ -71,7 +71,7 @@ public void testThatInstancesAreCachedAndReused() {
         );
 
         // Same Lucene version should be cached:
-        IndexVersion v1 = IndexVersionUtils.randomVersion(random());
+        IndexVersion v1 = IndexVersionUtils.randomVersion();
         IndexVersion v2 = new IndexVersion(v1.id() - 1, v1.luceneVersion());
         assertSame(PreBuiltAnalyzers.STOP.getAnalyzer(v1), PreBuiltAnalyzers.STOP.getAnalyzer(v2));
     }
@@ -81,7 +81,7 @@ public void testThatAnalyzersAreUsedInMapping() throws IOException {
         PreBuiltAnalyzers randomPreBuiltAnalyzer = PreBuiltAnalyzers.values()[randomInt];
         String analyzerName = randomPreBuiltAnalyzer.name().toLowerCase(Locale.ROOT);
 
-        IndexVersion randomVersion = IndexVersionUtils.randomVersion(random());
+        IndexVersion randomVersion = IndexVersionUtils.randomWriteVersion();
         Settings indexSettings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, randomVersion).build();
 
         NamedAnalyzer namedAnalyzer = new PreBuiltAnalyzerProvider(
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java b/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java
index 40b37452990c7..a1a91ef2373f3 100644
--- a/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java
+++ b/server/src/test/java/org/elasticsearch/index/analysis/PreConfiguredTokenFilterTests.java
@@ -41,7 +41,7 @@ public boolean incrementToken() {
 
         IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("test", Settings.EMPTY);
 
-        IndexVersion version1 = IndexVersionUtils.randomVersion(random());
+        IndexVersion version1 = IndexVersionUtils.randomVersion();
         Settings settings1 = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version1).build();
         TokenFilterFactory tff_v1_1 = pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "singleton", settings1);
         TokenFilterFactory tff_v1_2 = pctf.get(indexSettings, TestEnvironment.newEnvironment(emptyNodeSettings), "singleton", settings1);
@@ -66,7 +66,7 @@ public boolean incrementToken() {
             }
         );
 
-        IndexVersion version1 = IndexVersionUtils.randomVersion(random());
+        IndexVersion version1 = IndexVersionUtils.randomVersion();
         IndexSettings indexSettings1 = IndexSettingsModule.newIndexSettings(
             "test",
             Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version1).build()
@@ -133,7 +133,7 @@ public boolean incrementToken() {
         );
         assertSame(tff_v1_1, tff_v1_2);
 
-        IndexVersion version2 = IndexVersionUtils.getPreviousMajorVersion(IndexVersionUtils.getFirstVersion());
+        IndexVersion version2 = IndexVersionUtils.getPreviousMajorVersion(IndexVersionUtils.getLowestReadCompatibleVersion());
         IndexSettings indexSettings2 = IndexSettingsModule.newIndexSettings(
             "test",
             Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version2).build()
diff --git a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
index 3e3be6a315af2..d07c775da7e2a 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/InternalEngineTests.java
@@ -6645,7 +6645,7 @@ public void testStoreHonorsLuceneVersion() throws IOException {
         for (IndexVersion createdVersion : List.of(
             IndexVersion.current(),
             lowestCompatiblePreviousVersion,
-            IndexVersionUtils.getFirstVersion()
+            IndexVersionUtils.getLowestWriteCompatibleVersion()
         )) {
             Settings settings = Settings.builder().put(indexSettings()).put(IndexMetadata.SETTING_VERSION_CREATED, createdVersion).build();
             IndexSettings indexSettings = IndexSettingsModule.newIndexSettings("test", settings);
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/vectors/DenseVectorFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/vectors/DenseVectorFieldMapperTests.java
index 342d61b78defd..3f574a29469c2 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/vectors/DenseVectorFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/vectors/DenseVectorFieldMapperTests.java
@@ -1514,19 +1514,19 @@ public void testVectorSimilarity() {
         );
         assertEquals(
             VectorSimilarityFunction.EUCLIDEAN,
-            VectorSimilarity.L2_NORM.vectorSimilarityFunction(IndexVersionUtils.randomVersion(random()), ElementType.BYTE)
+            VectorSimilarity.L2_NORM.vectorSimilarityFunction(IndexVersionUtils.randomVersion(), ElementType.BYTE)
         );
         assertEquals(
             VectorSimilarityFunction.EUCLIDEAN,
-            VectorSimilarity.L2_NORM.vectorSimilarityFunction(IndexVersionUtils.randomVersion(random()), ElementType.FLOAT)
+            VectorSimilarity.L2_NORM.vectorSimilarityFunction(IndexVersionUtils.randomVersion(), ElementType.FLOAT)
         );
         assertEquals(
             VectorSimilarityFunction.DOT_PRODUCT,
-            VectorSimilarity.DOT_PRODUCT.vectorSimilarityFunction(IndexVersionUtils.randomVersion(random()), ElementType.BYTE)
+            VectorSimilarity.DOT_PRODUCT.vectorSimilarityFunction(IndexVersionUtils.randomVersion(), ElementType.BYTE)
         );
         assertEquals(
             VectorSimilarityFunction.DOT_PRODUCT,
-            VectorSimilarity.DOT_PRODUCT.vectorSimilarityFunction(IndexVersionUtils.randomVersion(random()), ElementType.FLOAT)
+            VectorSimilarity.DOT_PRODUCT.vectorSimilarityFunction(IndexVersionUtils.randomVersion(), ElementType.FLOAT)
         );
     }
 
diff --git a/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java b/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java
index cf6941b84b791..1bcd84aadd6cd 100644
--- a/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/analysis/AnalysisModuleTests.java
@@ -233,7 +233,7 @@ public Map<String, AnalysisProvider<TokenizerFactory>> getTokenizers() {
             new StablePluginsRegistry()
         ).getAnalysisRegistry();
 
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         IndexAnalyzers analyzers = getIndexAnalyzers(
             registry,
             Settings.builder()
@@ -302,7 +302,7 @@ public List<PreConfiguredTokenFilter> getPreConfiguredTokenFilters() {
             new StablePluginsRegistry()
         ).getAnalysisRegistry();
 
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         IndexAnalyzers analyzers = getIndexAnalyzers(
             registry,
             Settings.builder()
@@ -389,7 +389,7 @@ public List<PreConfiguredTokenizer> getPreConfiguredTokenizers() {
             new StablePluginsRegistry()
         ).getAnalysisRegistry();
 
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         IndexAnalyzers analyzers = getIndexAnalyzers(
             registry,
             Settings.builder()
diff --git a/server/src/test/java/org/elasticsearch/indices/analysis/IncorrectSetupStablePluginsTests.java b/server/src/test/java/org/elasticsearch/indices/analysis/IncorrectSetupStablePluginsTests.java
index ca9184bca75da..181d3ec44f2b3 100644
--- a/server/src/test/java/org/elasticsearch/indices/analysis/IncorrectSetupStablePluginsTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/analysis/IncorrectSetupStablePluginsTests.java
@@ -63,7 +63,7 @@ public void testIncorrectlyAnnotatedSettingsClass() throws IOException {
                 Settings.builder()
                     .put("index.analysis.analyzer.char_filter_test.tokenizer", "standard")
                     .put("index.analysis.analyzer.char_filter_test.char_filter", "incorrectlyAnnotatedSettings")
-                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                     .build(),
                 Map.of(
                     "incorrectlyAnnotatedSettings",
@@ -90,7 +90,7 @@ public void testIncorrectlyAnnotatedConstructor() throws IOException {
                 Settings.builder()
                     .put("index.analysis.analyzer.char_filter_test.tokenizer", "standard")
                     .put("index.analysis.analyzer.char_filter_test.char_filter", "noInjectCharFilter")
-                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                     .build(),
                 Map.of("noInjectCharFilter", new PluginInfo("noInjectCharFilter", NoInjectCharFilter.class.getName(), classLoader))
             )
@@ -112,7 +112,7 @@ public void testMultiplePublicConstructors() throws IOException {
                 Settings.builder()
                     .put("index.analysis.analyzer.char_filter_test.tokenizer", "standard")
                     .put("index.analysis.analyzer.char_filter_test.char_filter", "multipleConstructors")
-                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                     .build(),
                 Map.of("multipleConstructors", new PluginInfo("multipleConstructors", MultipleConstructors.class.getName(), classLoader))
             )
diff --git a/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsNoSettingsTests.java b/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsNoSettingsTests.java
index 7cbda0e7086cb..6eac3847efa43 100644
--- a/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsNoSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsNoSettingsTests.java
@@ -61,7 +61,7 @@ public IndexAnalyzers getIndexAnalyzers(Settings settings) throws IOException {
     }
 
     public void testStablePlugins() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomVersion(random());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         IndexAnalyzers analyzers = getIndexAnalyzers(
             Settings.builder()
                 .put("index.analysis.analyzer.char_filter_test.tokenizer", "standard")
diff --git a/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsWithSettingsTests.java b/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsWithSettingsTests.java
index acde315b140ab..82f49888e911d 100644
--- a/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsWithSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/analysis/StableAnalysisPluginsWithSettingsTests.java
@@ -72,7 +72,7 @@ public void testCharFilters() throws IOException {
                 .put("index.analysis.analyzer.char_filter_with_defaults_test.tokenizer", "standard")
                 .put("index.analysis.analyzer.char_filter_with_defaults_test.char_filter", "stableCharFilterFactory")
 
-                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                 .build()
         );
         assertTokenStreamContents(analyzers.get("char_filter_test").tokenStream("", "t#st"), new String[] { "t3st" });
@@ -88,7 +88,7 @@ public void testTokenFilters() throws IOException {
 
                 .put("index.analysis.analyzer.token_filter_test.tokenizer", "standard")
                 .put("index.analysis.analyzer.token_filter_test.filter", "my_token_filter")
-                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                 .build()
         );
         assertTokenStreamContents(
@@ -109,7 +109,7 @@ public void testTokenizer() throws IOException {
                 .putList("index.analysis.tokenizer.my_tokenizer.tokenizer_list_of_chars", "_", " ")
 
                 .put("index.analysis.analyzer.tokenizer_test.tokenizer", "my_tokenizer")
-                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                 .build()
         );
         assertTokenStreamContents(analyzers.get("tokenizer_test").tokenStream("", "x_y z"), new String[] { "x", "y", "z" });
@@ -124,7 +124,7 @@ public void testAnalyzer() throws IOException {
                 .put("index.analysis.analyzer.analyzer_provider_test.old_char", "#")
                 .put("index.analysis.analyzer.analyzer_provider_test.new_number", 3)
                 .put("index.analysis.analyzer.analyzer_provider_test.analyzerUseTokenListOfChars", true)
-                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random()))
+                .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion())
                 .build()
         );
         assertTokenStreamContents(analyzers.get("analyzer_provider_test").tokenStream("", "1x_y_#z"), new String[] { "y", "3z" });
diff --git a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
index d039c265c98ae..d9b2936dc30c0 100644
--- a/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/recovery/RecoverySourceHandlerTests.java
@@ -721,7 +721,7 @@ public void testThrowExceptionOnPrimaryRelocatedBeforePhase1Started() throws IOE
 
         final IndexMetadata.Builder indexMetadata = IndexMetadata.builder("test")
             .settings(
-                indexSettings(IndexVersionUtils.randomVersion(random()), between(1, 5), between(0, 5)).put(
+                indexSettings(IndexVersionUtils.randomVersion(), between(1, 5), between(0, 5)).put(
                     IndexMetadata.SETTING_INDEX_UUID,
                     UUIDs.randomBase64UUID(random())
                 )
diff --git a/server/src/test/java/org/elasticsearch/nodesinfo/NodeInfoStreamingTests.java b/server/src/test/java/org/elasticsearch/nodesinfo/NodeInfoStreamingTests.java
index 33801dfb98417..ace8499d8ffd0 100644
--- a/server/src/test/java/org/elasticsearch/nodesinfo/NodeInfoStreamingTests.java
+++ b/server/src/test/java/org/elasticsearch/nodesinfo/NodeInfoStreamingTests.java
@@ -243,7 +243,7 @@ private static NodeInfo createNodeInfo() {
         return new NodeInfo(
             randomAlphaOfLengthBetween(6, 32),
             new CompatibilityVersions(TransportVersionUtils.randomVersion(random()), Map.of()),
-            IndexVersionUtils.randomVersion(random()),
+            IndexVersionUtils.randomVersion(),
             componentVersions,
             build,
             node,
diff --git a/server/src/test/java/org/elasticsearch/persistent/PersistentTasksClusterServiceTests.java b/server/src/test/java/org/elasticsearch/persistent/PersistentTasksClusterServiceTests.java
index c568f6a38a5fb..cd2327d90c5c5 100644
--- a/server/src/test/java/org/elasticsearch/persistent/PersistentTasksClusterServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/persistent/PersistentTasksClusterServiceTests.java
@@ -966,7 +966,7 @@ private ClusterState insignificantChange(ClusterState clusterState) {
         }
         // Just add a random index - that shouldn't change anything
         IndexMetadata indexMetadata = IndexMetadata.builder(randomAlphaOfLength(10))
-            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random())))
+            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion()))
             .numberOfShards(1)
             .numberOfReplicas(1)
             .build();
@@ -1044,7 +1044,7 @@ private ClusterState initialState() {
 
     private void changeRoutingTable(Metadata.Builder metadata, RoutingTable.Builder routingTable) {
         IndexMetadata indexMetadata = IndexMetadata.builder(randomAlphaOfLength(10))
-            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random())))
+            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion()))
             .numberOfShards(1)
             .numberOfReplicas(1)
             .build();
diff --git a/server/src/test/java/org/elasticsearch/snapshots/SnapshotsInProgressSerializationTests.java b/server/src/test/java/org/elasticsearch/snapshots/SnapshotsInProgressSerializationTests.java
index a92d55f6d419c..91ab253b2e1fe 100644
--- a/server/src/test/java/org/elasticsearch/snapshots/SnapshotsInProgressSerializationTests.java
+++ b/server/src/test/java/org/elasticsearch/snapshots/SnapshotsInProgressSerializationTests.java
@@ -133,7 +133,7 @@ private Entry randomSnapshot() {
             shards,
             null,
             SnapshotInfoTestUtils.randomUserMetadata(),
-            IndexVersionUtils.randomVersion(random())
+            IndexVersionUtils.randomVersion()
         );
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java b/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java
index 47d239540814e..5cdb3f1808a38 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java
@@ -16,7 +16,11 @@
  */
 public class KnownIndexVersions {
     /**
-     * A sorted list of all known transport versions
+     * A sorted list of all known index versions
      */
     public static final List<IndexVersion> ALL_VERSIONS = List.copyOf(IndexVersions.getAllVersions());
+    /**
+     * A sorted list of all known index versions that can be written to
+     */
+    public static final List<IndexVersion> ALL_WRITE_VERSIONS = List.copyOf(IndexVersions.getAllWriteVersions());
 }
diff --git a/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java b/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java
index f83e7e17f9aaa..592cffac33552 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java
@@ -24,32 +24,38 @@
 public class IndexVersionUtils {
 
     private static final List<IndexVersion> ALL_VERSIONS = KnownIndexVersions.ALL_VERSIONS;
+    private static final List<IndexVersion> ALL_WRITE_VERSIONS = KnownIndexVersions.ALL_WRITE_VERSIONS;
 
     /** Returns all released versions */
     public static List<IndexVersion> allReleasedVersions() {
         return ALL_VERSIONS;
     }
 
-    /** Returns the oldest known {@link IndexVersion} */
-    public static IndexVersion getFirstVersion() {
+    /** Returns the oldest known {@link IndexVersion}. This version can only be read from and not written to */
+    public static IndexVersion getLowestReadCompatibleVersion() {
         return ALL_VERSIONS.get(0);
     }
 
+    /** Returns the oldest known {@link IndexVersion} that can be written to */
+    public static IndexVersion getLowestWriteCompatibleVersion() {
+        return ALL_WRITE_VERSIONS.get(0);
+    }
+
     /** Returns a random {@link IndexVersion} from all available versions. */
     public static IndexVersion randomVersion() {
         return ESTestCase.randomFrom(ALL_VERSIONS);
     }
 
+    /** Returns a random {@link IndexVersion} from all versions that can be written to. */
+    public static IndexVersion randomWriteVersion() {
+        return ESTestCase.randomFrom(ALL_WRITE_VERSIONS);
+    }
+
     /** Returns a random {@link IndexVersion} from all available versions without the ignore set */
     public static IndexVersion randomVersion(Set<IndexVersion> ignore) {
         return ESTestCase.randomFrom(ALL_VERSIONS.stream().filter(v -> ignore.contains(v) == false).collect(Collectors.toList()));
     }
 
-    /** Returns a random {@link IndexVersion} from all available versions. */
-    public static IndexVersion randomVersion(Random random) {
-        return ALL_VERSIONS.get(random.nextInt(ALL_VERSIONS.size()));
-    }
-
     /** Returns a random {@link IndexVersion} between <code>minVersion</code> and <code>maxVersion</code> (inclusive). */
     public static IndexVersion randomVersionBetween(Random random, @Nullable IndexVersion minVersion, @Nullable IndexVersion maxVersion) {
         if (minVersion != null && maxVersion != null && maxVersion.before(minVersion)) {
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/DeprecationRoleDescriptorConsumerTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/DeprecationRoleDescriptorConsumerTests.java
index ee91b8b65e540..c572b3a35d5a4 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/DeprecationRoleDescriptorConsumerTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authz/store/DeprecationRoleDescriptorConsumerTests.java
@@ -342,7 +342,7 @@ public void testMultipleIndicesSameAlias() throws Exception {
 
     private void addIndex(Metadata.Builder metadataBuilder, String index, String... aliases) {
         final IndexMetadata.Builder indexMetadataBuilder = IndexMetadata.builder(index)
-            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion(random())))
+            .settings(Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomVersion()))
             .numberOfShards(1)
             .numberOfReplicas(1);
         for (final String alias : aliases) {

From 54fa07450a6aeddf5cfc4c210cfe9241cb8e83c0 Mon Sep 17 00:00:00 2001
From: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Date: Wed, 18 Dec 2024 13:54:17 +0100
Subject: [PATCH 070/119] [DOCS] Make Wolfi hardened Docker option more
 prominent (#118755)

---
 docs/reference/setup/install/docker.asciidoc | 21 ++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/docs/reference/setup/install/docker.asciidoc b/docs/reference/setup/install/docker.asciidoc
index 86a0e567f6eec..f3576db0c786c 100644
--- a/docs/reference/setup/install/docker.asciidoc
+++ b/docs/reference/setup/install/docker.asciidoc
@@ -25,6 +25,21 @@ TIP: This setup doesn't run multiple {es} nodes or {kib} by default. To create a
 multi-node cluster with {kib}, use Docker Compose instead. See
 <<docker-compose-file>>.
 
+[[docker-wolfi-hardened-image]]
+===== Hardened Docker images
+
+You can also use the hardened https://wolfi.dev/[Wolfi] image for additional security.
+Using Wolfi images requires Docker version 20.10.10 or higher.
+
+To use the Wolfi image, append `-wolfi` to the image tag in the Docker command.
+
+For example:
+
+[source,sh,subs="attributes"]
+----
+docker pull {docker-wolfi-image}
+----
+
 ===== Start a single-node cluster
 
 . Install Docker. Visit https://docs.docker.com/get-docker/[Get Docker] to
@@ -55,12 +70,6 @@ docker pull {docker-image}
 // REVIEWED[DEC.10.24]
 --
 
-Alternatevely, you can use the Wolfi based image. Using Wolfi based images requires Docker version 20.10.10 or superior.
-[source,sh,subs="attributes"]
-----
-docker pull {docker-wolfi-image}
-----
-
 . Optional: Install
 https://docs.sigstore.dev/cosign/system_config/installation/[Cosign] for your
 environment. Then use Cosign to verify the {es} image's signature.

From dbbcb09244cd65b52c13f78e500deb5fdcd3edd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Iv=C3=A1n=20Cea=20Fontenla?= <ivancea96@outlook.com>
Date: Wed, 18 Dec 2024 14:19:38 +0100
Subject: [PATCH 071/119] ESQL: Verify LOOKUP JOIN index has lookup mode
 (#118660)

Verifies that LOOKUP JOIN indices resolve to a single concrete index with LOOKUP mode.
---
 .../esql/qa/mixed/MixedClusterEsqlSpecIT.java |   4 +-
 .../xpack/esql/ccq/MultiClusterSpecIT.java    |   8 +-
 .../rest/RequestIndexFilteringTestCase.java   |   2 +-
 .../src/main/resources/lookup-join.csv-spec   | 128 +++++++++---------
 .../xpack/esql/action/EsqlCapabilities.java   |   4 +-
 .../xpack/esql/analysis/Analyzer.java         |  31 +++++
 .../xpack/esql/analysis/Verifier.java         |   1 -
 .../elasticsearch/xpack/esql/CsvTests.java    |   2 +-
 .../esql/analysis/AnalyzerTestUtils.java      |  19 ++-
 .../xpack/esql/analysis/AnalyzerTests.java    |  33 ++++-
 .../xpack/esql/analysis/ParsingTests.java     |   8 +-
 .../xpack/esql/analysis/VerifierTests.java    |   8 +-
 .../optimizer/LogicalPlanOptimizerTests.java  |  12 +-
 .../optimizer/PhysicalPlanOptimizerTests.java |   2 +-
 .../session/IndexResolverFieldNamesTests.java |  24 ++--
 .../test/esql/190_lookup_join.yml             |  78 +++++++++++
 16 files changed, 261 insertions(+), 103 deletions(-)
 create mode 100644 x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml

diff --git a/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java b/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
index 004beaafb4009..d4b087277df52 100644
--- a/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
+++ b/x-pack/plugin/esql/qa/server/mixed-cluster/src/javaRestTest/java/org/elasticsearch/xpack/esql/qa/mixed/MixedClusterEsqlSpecIT.java
@@ -21,7 +21,7 @@
 import java.util.List;
 
 import static org.elasticsearch.xpack.esql.CsvTestUtils.isEnabled;
-import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V7;
+import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V8;
 import static org.elasticsearch.xpack.esql.qa.rest.EsqlSpecTestCase.Mode.ASYNC;
 
 public class MixedClusterEsqlSpecIT extends EsqlSpecTestCase {
@@ -96,7 +96,7 @@ protected boolean supportsInferenceTestService() {
 
     @Override
     protected boolean supportsIndexModeLookup() throws IOException {
-        return hasCapabilities(List.of(JOIN_LOOKUP_V7.capabilityName()));
+        return hasCapabilities(List.of(JOIN_LOOKUP_V8.capabilityName()));
     }
 
     @Override
diff --git a/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java b/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
index c75a920e16973..d7c57e23b7147 100644
--- a/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
+++ b/x-pack/plugin/esql/qa/server/multi-clusters/src/javaRestTest/java/org/elasticsearch/xpack/esql/ccq/MultiClusterSpecIT.java
@@ -48,7 +48,7 @@
 import static org.elasticsearch.xpack.esql.EsqlTestUtils.classpathResources;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.INLINESTATS;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.INLINESTATS_V2;
-import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V7;
+import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_LOOKUP_V8;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.JOIN_PLANNING_V1;
 import static org.elasticsearch.xpack.esql.action.EsqlCapabilities.Cap.METADATA_FIELDS_REMOTE_TEST;
 import static org.elasticsearch.xpack.esql.qa.rest.EsqlSpecTestCase.Mode.SYNC;
@@ -124,7 +124,7 @@ protected void shouldSkipTest(String testName) throws IOException {
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(INLINESTATS.capabilityName()));
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(INLINESTATS_V2.capabilityName()));
         assumeFalse("INLINESTATS not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_PLANNING_V1.capabilityName()));
-        assumeFalse("LOOKUP JOIN not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_LOOKUP_V7.capabilityName()));
+        assumeFalse("LOOKUP JOIN not yet supported in CCS", testCase.requiredCapabilities.contains(JOIN_LOOKUP_V8.capabilityName()));
     }
 
     private TestFeatureService remoteFeaturesService() throws IOException {
@@ -283,8 +283,8 @@ protected boolean supportsInferenceTestService() {
 
     @Override
     protected boolean supportsIndexModeLookup() throws IOException {
-        // CCS does not yet support JOIN_LOOKUP_V7 and clusters falsely report they have this capability
-        // return hasCapabilities(List.of(JOIN_LOOKUP_V7.capabilityName()));
+        // CCS does not yet support JOIN_LOOKUP_V8 and clusters falsely report they have this capability
+        // return hasCapabilities(List.of(JOIN_LOOKUP_V8.capabilityName()));
         return false;
     }
 }
diff --git a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
index 40027249670f6..355c403ce2a86 100644
--- a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
+++ b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
@@ -221,7 +221,7 @@ public void testIndicesDontExist() throws IOException {
         assertThat(e.getMessage(), containsString("index_not_found_exception"));
         assertThat(e.getMessage(), containsString("no such index [foo]"));
 
-        if (EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled()) {
+        if (EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled()) {
             e = expectThrows(
                 ResponseException.class,
                 () -> runEsql(timestampFilter("gte", "2020-01-01").query("FROM test1 | LOOKUP JOIN foo ON id1"))
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index e75c68f4a379d..7d4f89ed920a9 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -8,7 +8,7 @@
 ###############################################
 
 basicOnTheDataNode
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | EVAL language_code = languages
@@ -25,7 +25,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 basicRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW language_code = 1
 | LOOKUP JOIN languages_lookup ON language_code
@@ -36,7 +36,7 @@ language_code:integer  | language_name:keyword
 ;
 
 basicOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -53,7 +53,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 subsequentEvalOnTheDataNode
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | EVAL language_code = languages
@@ -71,7 +71,7 @@ emp_no:integer | language_code:integer | language_name:keyword | language_code_x
 ;
 
 subsequentEvalOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -89,7 +89,7 @@ emp_no:integer | language_code:integer | language_name:keyword | language_code_x
 ;
 
 sortEvalBeforeLookup
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -106,7 +106,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 nonUniqueLeftKeyOnTheDataNode
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | WHERE emp_no <= 10030
@@ -130,7 +130,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 nonUniqueRightKeyOnTheDataNode
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | EVAL language_code = emp_no % 10
@@ -150,7 +150,7 @@ emp_no:integer | language_code:integer | language_name:keyword       | country:k
 ;
 
 nonUniqueRightKeyOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -170,7 +170,7 @@ emp_no:integer | language_code:integer | language_name:keyword       | country:k
 ;
 
 nonUniqueRightKeyFromRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW language_code = 2
 | LOOKUP JOIN languages_lookup_non_unique_key ON language_code
@@ -183,7 +183,7 @@ language_code:integer | language_name:keyword       | country:keyword
 ;
 
 repeatedIndexOnFrom
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 required_capability: join_lookup_repeated_index_from
 
 FROM languages_lookup
@@ -203,7 +203,7 @@ language_code:integer | language_name:keyword
 ###############################################
 
 filterOnLeftSide
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | EVAL language_code = languages
@@ -220,7 +220,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 filterOnRightSide
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -236,7 +236,7 @@ FROM sample_data
 ;
 
 filterOnRightSideAfterStats
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -249,7 +249,7 @@ count:long | type:keyword
 ;
 
 filterOnJoinKey
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | EVAL language_code = languages
@@ -264,7 +264,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 filterOnJoinKeyAndRightSide
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | WHERE emp_no < 10006
@@ -281,7 +281,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 filterOnRightSideOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -297,7 +297,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 filterOnJoinKeyOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -313,7 +313,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 filterOnJoinKeyAndRightSideOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | SORT emp_no
@@ -330,7 +330,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 filterOnTheDataNodeThenFilterOnTheCoordinator
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | EVAL language_code = languages
@@ -351,7 +351,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ###########################################################################
 
 nullJoinKeyOnTheDataNode
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | WHERE emp_no < 10004
@@ -368,7 +368,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 mvJoinKeyOnTheDataNode
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM employees
 | WHERE 10003 < emp_no AND emp_no < 10008
@@ -386,7 +386,7 @@ emp_no:integer | language_code:integer | language_name:keyword
 ;
 
 mvJoinKeyFromRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW language_code = [4, 5, 6, 7]
 | LOOKUP JOIN languages_lookup_non_unique_key ON language_code
@@ -399,7 +399,7 @@ language_code:integer | language_name:keyword       | country:keyword
 ;
 
 mvJoinKeyFromRowExpanded
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW language_code = [4, 5, 6, 7, 8]
 | MV_EXPAND language_code
@@ -421,7 +421,7 @@ language_code:integer | language_name:keyword       | country:keyword
 ###############################################
 
 lookupIPFromRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -432,7 +432,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromKeepRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", right = "right"
 | KEEP left, client_ip, right
@@ -444,7 +444,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowing
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -455,7 +455,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowingKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -468,7 +468,7 @@ left         | 172.21.0.5        | right         | Development
 ;
 
 lookupIPFromRowWithShadowingKeepReordered
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -481,7 +481,7 @@ right         | Development | 172.21.0.5
 ;
 
 lookupIPFromIndex
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -500,7 +500,7 @@ ignoreOrder:true
 ;
 
 lookupIPFromIndexKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -520,7 +520,7 @@ ignoreOrder:true
 ;
 
 lookupIPFromIndexKeepKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | KEEP client_ip, event_duration, @timestamp, message
@@ -542,7 +542,7 @@ timestamp:date           | client_ip:keyword | event_duration:long | msg:keyword
 ;
 
 lookupIPFromIndexStats
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -558,7 +558,7 @@ count:long | env:keyword
 ;
 
 lookupIPFromIndexStatsKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -575,7 +575,7 @@ count:long | env:keyword
 ;
 
 statsAndLookupIPFromIndex
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -596,7 +596,7 @@ count:long | client_ip:keyword | env:keyword
 ###############################################
 
 lookupMessageFromRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -607,7 +607,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromKeepRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", message = "Connected to 10.1.0.1", right = "right"
 | KEEP left, message, right
@@ -619,7 +619,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromRowWithShadowing
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", message = "Connected to 10.1.0.1", type = "unknown", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -630,7 +630,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromRowWithShadowingKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", message = "Connected to 10.1.0.1", type = "unknown", right = "right"
 | LOOKUP JOIN message_types_lookup ON message
@@ -642,7 +642,7 @@ left         | Connected to 10.1.0.1 | right         | Success
 ;
 
 lookupMessageFromIndex
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -660,7 +660,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -679,7 +679,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeepKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | KEEP client_ip, event_duration, @timestamp, message
@@ -699,7 +699,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexKeepReordered
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -718,7 +718,7 @@ Success      | 172.21.2.162 | 3450233             | Connected to 10.1.0.3
 ;
 
 lookupMessageFromIndexStats
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -733,7 +733,7 @@ count:long | type:keyword
 ;
 
 lookupMessageFromIndexStatsKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -749,7 +749,7 @@ count:long | type:keyword
 ;
 
 statsAndLookupMessageFromIndex
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | STATS count = count(message) BY message
@@ -767,7 +767,7 @@ count:long | type:keyword | message:keyword
 ;
 
 lookupMessageFromIndexTwice
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -789,7 +789,7 @@ ignoreOrder:true
 ;
 
 lookupMessageFromIndexTwiceKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
@@ -816,7 +816,7 @@ ignoreOrder:true
 ###############################################
 
 lookupIPAndMessageFromRow
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -828,7 +828,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowKeepBefore
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | KEEP left, client_ip, message, right
@@ -841,7 +841,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowKeepBetween
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -854,7 +854,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowKeepAfter
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -867,7 +867,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowing
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", type = "type", right = "right"
 | LOOKUP JOIN clientips_lookup ON client_ip
@@ -879,7 +879,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -893,7 +893,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeepKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -908,7 +908,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeepKeepKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -924,7 +924,7 @@ left         | 172.21.0.5        | Connected to 10.1.0.1 | right         | Devel
 ;
 
 lookupIPAndMessageFromRowWithShadowingKeepReordered
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 ROW left = "left", client_ip = "172.21.0.5", message = "Connected to 10.1.0.1", env = "env", right = "right"
 | EVAL client_ip = client_ip::keyword
@@ -938,7 +938,7 @@ right         | Development  | Success      | 172.21.0.5
 ;
 
 lookupIPAndMessageFromIndex
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -958,7 +958,7 @@ ignoreOrder:true
 ;
 
 lookupIPAndMessageFromIndexKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -979,7 +979,7 @@ ignoreOrder:true
 ;
 
 lookupIPAndMessageFromIndexStats
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -997,7 +997,7 @@ count:long | env:keyword | type:keyword
 ;
 
 lookupIPAndMessageFromIndexStatsKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -1016,7 +1016,7 @@ count:long | env:keyword | type:keyword
 ;
 
 statsAndLookupIPAndMessageFromIndex
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -1035,7 +1035,7 @@ count:long | client_ip:keyword | message:keyword       | env:keyword | type:keyw
 ;
 
 lookupIPAndMessageFromIndexChainedEvalKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
@@ -1057,7 +1057,7 @@ ignoreOrder:true
 ;
 
 lookupIPAndMessageFromIndexChainedRenameKeep
-required_capability: join_lookup_v7
+required_capability: join_lookup_v8
 
 FROM sample_data
 | EVAL client_ip = client_ip::keyword
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index bfc2675d59791..a6e0f1d89c364 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -555,12 +555,12 @@ public enum Cap {
         /**
          * LOOKUP JOIN
          */
-        JOIN_LOOKUP_V7(Build.current().isSnapshot()),
+        JOIN_LOOKUP_V8(Build.current().isSnapshot()),
 
         /**
          * LOOKUP JOIN with the same index as the FROM
          */
-        JOIN_LOOKUP_REPEATED_INDEX_FROM(JOIN_LOOKUP_V7.isEnabled()),
+        JOIN_LOOKUP_REPEATED_INDEX_FROM(JOIN_LOOKUP_V8.isEnabled()),
 
         /**
          * Fix for https://github.com/elastic/elasticsearch/issues/117054
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
index e15731ca79038..ecd0821c626bf 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
@@ -235,6 +235,37 @@ private LogicalPlan resolveIndex(UnresolvedRelation plan, IndexResolution indexR
             }
 
             EsIndex esIndex = indexResolution.get();
+
+            if (plan.indexMode().equals(IndexMode.LOOKUP)) {
+                String indexResolutionMessage = null;
+
+                var indexNameWithModes = esIndex.indexNameWithModes();
+                if (indexNameWithModes.size() != 1) {
+                    indexResolutionMessage = "invalid ["
+                        + table
+                        + "] resolution in lookup mode to ["
+                        + indexNameWithModes.size()
+                        + "] indices";
+                } else if (indexNameWithModes.values().iterator().next() != IndexMode.LOOKUP) {
+                    indexResolutionMessage = "invalid ["
+                        + table
+                        + "] resolution in lookup mode to an index in ["
+                        + indexNameWithModes.values().iterator().next()
+                        + "] mode";
+                }
+
+                if (indexResolutionMessage != null) {
+                    return new UnresolvedRelation(
+                        plan.source(),
+                        plan.table(),
+                        plan.frozen(),
+                        plan.metadataFields(),
+                        plan.indexMode(),
+                        indexResolutionMessage,
+                        plan.commandName()
+                    );
+                }
+            }
             var attributes = mappingAsAttributes(plan.source(), esIndex.mapping());
             attributes.addAll(plan.metadataFields());
             return new EsRelation(plan.source(), esIndex, attributes.isEmpty() ? NO_FIELDS : attributes, plan.indexMode());
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
index 6b98b7d69834f..93e9d59ed8c6e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
@@ -865,7 +865,6 @@ private static void checkJoin(LogicalPlan plan, Set<Failure> failures) {
                     );
                 }
             }
-
         }
     }
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index 70794e4a82130..b81b80a9fdbb4 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -263,7 +263,7 @@ public final void test() throws Throwable {
             );
             assumeFalse(
                 "lookup join disabled for csv tests",
-                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V7.capabilityName())
+                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V8.capabilityName())
             );
             assumeFalse(
                 "can't use TERM function in csv tests",
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
index 85dd36ba0aaa5..d4e786a9d9bb0 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
@@ -46,6 +46,10 @@ public static Analyzer analyzer(IndexResolution indexResolution) {
         return analyzer(indexResolution, TEST_VERIFIER);
     }
 
+    public static Analyzer analyzer(IndexResolution indexResolution, Map<String, IndexResolution> lookupResolution) {
+        return analyzer(indexResolution, lookupResolution, TEST_VERIFIER);
+    }
+
     public static Analyzer analyzer(IndexResolution indexResolution, Verifier verifier) {
         return new Analyzer(
             new AnalyzerContext(
@@ -59,6 +63,19 @@ public static Analyzer analyzer(IndexResolution indexResolution, Verifier verifi
         );
     }
 
+    public static Analyzer analyzer(IndexResolution indexResolution, Map<String, IndexResolution> lookupResolution, Verifier verifier) {
+        return new Analyzer(
+            new AnalyzerContext(
+                EsqlTestUtils.TEST_CFG,
+                new EsqlFunctionRegistry(),
+                indexResolution,
+                lookupResolution,
+                defaultEnrichResolution()
+            ),
+            verifier
+        );
+    }
+
     public static Analyzer analyzer(IndexResolution indexResolution, Verifier verifier, Configuration config) {
         return new Analyzer(
             new AnalyzerContext(config, new EsqlFunctionRegistry(), indexResolution, defaultLookupResolution(), defaultEnrichResolution()),
@@ -111,7 +128,7 @@ public static IndexResolution loadMapping(String resource, String indexName, Ind
     }
 
     public static IndexResolution loadMapping(String resource, String indexName) {
-        EsIndex test = new EsIndex(indexName, EsqlTestUtils.loadMapping(resource));
+        EsIndex test = new EsIndex(indexName, EsqlTestUtils.loadMapping(resource), Map.of(indexName, IndexMode.STANDARD));
         return IndexResolution.valid(test);
     }
 
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
index 9c71f20dcde0e..5d1ff43dfe31b 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
@@ -2139,7 +2139,7 @@ public void testLookupMatchTypeWrong() {
     }
 
     public void testLookupJoinUnknownIndex() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String errorMessage = "Unknown index [foobar]";
         IndexResolution missingLookupIndex = IndexResolution.invalid(errorMessage);
@@ -2168,7 +2168,7 @@ public void testLookupJoinUnknownIndex() {
     }
 
     public void testLookupJoinUnknownField() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String query = "FROM test | LOOKUP JOIN languages_lookup ON last_name";
         String errorMessage = "1:45: Unknown column [last_name] in right side of join";
@@ -2190,6 +2190,35 @@ public void testLookupJoinUnknownField() {
         assertThat(e.getMessage(), containsString(errorMessage3 + "right side of join"));
     }
 
+    public void testLookupJoinIndexMode() {
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
+
+        var indexResolution = AnalyzerTestUtils.expandedDefaultIndexResolution();
+        var lookupResolution = AnalyzerTestUtils.defaultLookupResolution();
+        var indexResolutionAsLookup = Map.of("test", indexResolution);
+        var lookupResolutionAsIndex = lookupResolution.get("languages_lookup");
+
+        analyze("FROM test | EVAL language_code = languages | LOOKUP JOIN languages_lookup ON language_code");
+        analyze(
+            "FROM languages_lookup | LOOKUP JOIN languages_lookup ON language_code",
+            AnalyzerTestUtils.analyzer(lookupResolutionAsIndex, lookupResolution)
+        );
+
+        VerificationException e = expectThrows(
+            VerificationException.class,
+            () -> analyze(
+                "FROM languages_lookup | EVAL languages = language_code | LOOKUP JOIN test ON languages",
+                AnalyzerTestUtils.analyzer(lookupResolutionAsIndex, indexResolutionAsLookup)
+            )
+        );
+        assertThat(e.getMessage(), containsString("1:70: invalid [test] resolution in lookup mode to an index in [standard] mode"));
+        e = expectThrows(
+            VerificationException.class,
+            () -> analyze("FROM test | LOOKUP JOIN test ON languages", AnalyzerTestUtils.analyzer(indexResolution, indexResolutionAsLookup))
+        );
+        assertThat(e.getMessage(), containsString("1:25: invalid [test] resolution in lookup mode to an index in [standard] mode"));
+    }
+
     public void testImplicitCasting() {
         var e = expectThrows(VerificationException.class, () -> analyze("""
              from test | eval x = concat("2024", "-04", "-01") + 1 day
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
index 90a215653f251..549ddce03c206 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
@@ -113,7 +113,7 @@ public void testTooBigQuery() {
     }
 
     public void testJoinOnConstant() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertEquals(
             "1:55: JOIN ON clause only supports fields at the moment, found [123]",
             error("row languages = 1, gender = \"f\" | lookup join test on 123")
@@ -129,7 +129,7 @@ public void testJoinOnConstant() {
     }
 
     public void testJoinOnMultipleFields() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertEquals(
             "1:35: JOIN ON clause only supports one field at the moment, found [2]",
             error("row languages = 1, gender = \"f\" | lookup join test on gender, languages")
@@ -137,7 +137,7 @@ public void testJoinOnMultipleFields() {
     }
 
     public void testJoinTwiceOnTheSameField() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertEquals(
             "1:35: JOIN ON clause only supports one field at the moment, found [2]",
             error("row languages = 1, gender = \"f\" | lookup join test on languages, languages")
@@ -145,7 +145,7 @@ public void testJoinTwiceOnTheSameField() {
     }
 
     public void testJoinTwiceOnTheSameField_TwoLookups() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertEquals(
             "1:80: JOIN ON clause only supports one field at the moment, found [2]",
             error("row languages = 1, gender = \"f\" | lookup join test on languages | eval x = 1 | lookup join test on gender, gender")
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
index a1e29117a25d3..43d764ab2007d 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
@@ -1974,7 +1974,7 @@ public void testSortByAggregate() {
     }
 
     public void testLookupJoinDataTypeMismatch() {
-        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         query("FROM test | EVAL language_code = languages | LOOKUP JOIN languages_lookup ON language_code");
 
@@ -1985,7 +1985,11 @@ public void testLookupJoinDataTypeMismatch() {
     }
 
     private void query(String query) {
-        defaultAnalyzer.analyze(parser.createStatement(query));
+        query(query, defaultAnalyzer);
+    }
+
+    private void query(String query, Analyzer analyzer) {
+        analyzer.analyze(parser.createStatement(query));
     }
 
     private String error(String query) {
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
index cfb993a7dd73d..17e158f088fb3 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
@@ -4906,7 +4906,7 @@ public void testPlanSanityCheck() throws Exception {
     }
 
     public void testPlanSanityCheckWithBinaryPlans() throws Exception {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         var plan = optimizedPlan("""
               FROM test
@@ -5911,7 +5911,7 @@ public void testLookupStats() {
      *     \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownFilterOnJoinKeyWithRename() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String query = """
               FROM test
@@ -5954,7 +5954,7 @@ public void testLookupJoinPushDownFilterOnJoinKeyWithRename() {
      *     \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownFilterOnLeftSideField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String query = """
               FROM test
@@ -5998,7 +5998,7 @@ public void testLookupJoinPushDownFilterOnLeftSideField() {
      *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#18, language_name{f}#19]
      */
     public void testLookupJoinPushDownDisabledForLookupField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String query = """
               FROM test
@@ -6043,7 +6043,7 @@ public void testLookupJoinPushDownDisabledForLookupField() {
      *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#19, language_name{f}#20]
      */
     public void testLookupJoinPushDownSeparatedForConjunctionBetweenLeftAndRightField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String query = """
               FROM test
@@ -6096,7 +6096,7 @@ public void testLookupJoinPushDownSeparatedForConjunctionBetweenLeftAndRightFiel
      *       \_EsRelation[languages_lookup][LOOKUP][language_code{f}#19, language_name{f}#20]
      */
     public void testLookupJoinPushDownDisabledForDisjunctionBetweenLeftAndRightField() {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         String query = """
               FROM test
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
index 964dd4642d7c2..c7bb6e49703ed 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/PhysicalPlanOptimizerTests.java
@@ -2331,7 +2331,7 @@ public void testVerifierOnMissingReferences() {
     }
 
     public void testVerifierOnMissingReferencesWithBinaryPlans() throws Exception {
-        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("Requires LOOKUP JOIN", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 
         // Do not assert serialization:
         // This will have a LookupJoinExec, which is not serializable because it doesn't leave the coordinator.
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
index 31ec4663738f7..60bdf4e7f73d3 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/session/IndexResolverFieldNamesTests.java
@@ -1365,7 +1365,7 @@ public void testMetrics() {
     }
 
     public void testLookupJoin() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             "FROM employees | KEEP languages | RENAME languages AS language_code | LOOKUP JOIN languages_lookup ON language_code",
             Set.of("languages", "languages.*", "language_code", "language_code.*"),
@@ -1374,7 +1374,7 @@ public void testLookupJoin() {
     }
 
     public void testLookupJoinKeep() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM employees
@@ -1388,7 +1388,7 @@ public void testLookupJoinKeep() {
     }
 
     public void testLookupJoinKeepWildcard() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM employees
@@ -1402,7 +1402,7 @@ public void testLookupJoinKeepWildcard() {
     }
 
     public void testMultiLookupJoin() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1415,7 +1415,7 @@ public void testMultiLookupJoin() {
     }
 
     public void testMultiLookupJoinKeepBefore() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1429,7 +1429,7 @@ public void testMultiLookupJoinKeepBefore() {
     }
 
     public void testMultiLookupJoinKeepBetween() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1454,7 +1454,7 @@ public void testMultiLookupJoinKeepBetween() {
     }
 
     public void testMultiLookupJoinKeepAfter() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1481,7 +1481,7 @@ public void testMultiLookupJoinKeepAfter() {
     }
 
     public void testMultiLookupJoinKeepAfterWildcard() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1495,7 +1495,7 @@ public void testMultiLookupJoinKeepAfterWildcard() {
     }
 
     public void testMultiLookupJoinSameIndex() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1509,7 +1509,7 @@ public void testMultiLookupJoinSameIndex() {
     }
 
     public void testMultiLookupJoinSameIndexKeepBefore() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1524,7 +1524,7 @@ public void testMultiLookupJoinSameIndexKeepBefore() {
     }
 
     public void testMultiLookupJoinSameIndexKeepBetween() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
@@ -1550,7 +1550,7 @@ public void testMultiLookupJoinSameIndexKeepBetween() {
     }
 
     public void testMultiLookupJoinSameIndexKeepAfter() {
-        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V7.isEnabled());
+        assumeTrue("LOOKUP JOIN available as snapshot only", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
         assertFieldNames(
             """
                 FROM sample_data
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml
new file mode 100644
index 0000000000000..cbaac4e47fdd4
--- /dev/null
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml
@@ -0,0 +1,78 @@
+---
+setup:
+  - requires:
+      test_runner_features: [capabilities]
+      capabilities:
+        - method: POST
+          path: /_query
+          parameters: []
+          capabilities: [join_lookup_v8]
+      reason: "uses LOOKUP JOIN"
+  - do:
+      indices.create:
+        index: test
+        body:
+          settings:
+            number_of_shards: 5
+          mappings:
+            properties:
+              key:
+                type: long
+              color:
+                type: keyword
+  - do:
+      indices.create:
+        index: test-lookup
+        body:
+          settings:
+            index:
+              mode: lookup
+          mappings:
+            properties:
+              key:
+                type: long
+              color:
+                type: keyword
+  - do:
+      bulk:
+        index: "test"
+        refresh: true
+        body:
+          - { "index": { } }
+          - { "key": 1, "color": "red" }
+          - { "index": { } }
+          - { "key": 2, "color": "blue" }
+  - do:
+      bulk:
+        index: "test-lookup"
+        refresh: true
+        body:
+          - { "index": { } }
+          - { "key": 1, "color": "cyan" }
+          - { "index": { } }
+          - { "key": 2, "color": "yellow" }
+
+---
+basic:
+  - do:
+      esql.query:
+        body:
+          query: 'FROM test | SORT key | LOOKUP JOIN `test-lookup` ON key | LIMIT 3'
+
+  - match: {columns.0.name: "key"}
+  - match: {columns.0.type: "long"}
+  - match: {columns.1.name: "color"}
+  - match: {columns.1.type: "keyword"}
+  - match: {values.0: [1, "cyan"]}
+  - match: {values.1: [2, "yellow"]}
+
+---
+non-lookup index:
+  - do:
+      esql.query:
+        body:
+          query: 'FROM test-lookup | SORT key | LOOKUP JOIN `test` ON key | LIMIT 3'
+      catch: "bad_request"
+
+  - match: { error.type: "verification_exception" }
+  - match: { error.reason: "Found 1 problem\nline 1:43: invalid [test] resolution in lookup mode to an index in [standard] mode" }

From 6e725163dc2f466c4c64d8076d693a3feddf3213 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 00:47:40 +1100
Subject: [PATCH 072/119] Mute
 org.elasticsearch.smoketest.SmokeTestMultiNodeClientYamlTestSuiteIT
 org.elasticsearch.smoketest.SmokeTestMultiNodeClientYamlTestSuiteIT #118955

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 2677b3e75d86e..3a8594acf3bb1 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -290,6 +290,8 @@ tests:
 - class: org.elasticsearch.cluster.service.MasterServiceTests
   method: testThreadContext
   issue: https://github.com/elastic/elasticsearch/issues/118914
+- class: org.elasticsearch.smoketest.SmokeTestMultiNodeClientYamlTestSuiteIT
+  issue: https://github.com/elastic/elasticsearch/issues/118955
 
 # Examples:
 #

From 49f991bd982e3a81276ce0c43ea15eb399c5a322 Mon Sep 17 00:00:00 2001
From: Artem Prigoda <artem.prigoda@elastic.co>
Date: Wed, 18 Dec 2024 14:56:57 +0100
Subject: [PATCH 073/119] [test] Fix
 RecoverySourcePruneMergePolicyTests#testPruneSome (#118944)

The `extra_source_size` field is set to a value between 10 and 10000
inclusive, so the assertion should be `greaterThanOrEqualTo(10)` rather
than `greaterThan(10)`.

See #114618 Resolve #118728
---
 .../index/engine/RecoverySourcePruneMergePolicyTests.java     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/engine/RecoverySourcePruneMergePolicyTests.java b/server/src/test/java/org/elasticsearch/index/engine/RecoverySourcePruneMergePolicyTests.java
index 74d6e83aff266..b8600842effe4 100644
--- a/server/src/test/java/org/elasticsearch/index/engine/RecoverySourcePruneMergePolicyTests.java
+++ b/server/src/test/java/org/elasticsearch/index/engine/RecoverySourcePruneMergePolicyTests.java
@@ -44,7 +44,7 @@
 import java.util.stream.Collectors;
 
 import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.greaterThan;
+import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 
 public class RecoverySourcePruneMergePolicyTests extends ESTestCase {
 
@@ -191,7 +191,7 @@ public void testPruneSome() throws IOException {
                                     }
                                     assertEquals(i, extra_source.docID());
                                     if (syntheticRecoverySource) {
-                                        assertThat(extra_source.longValue(), greaterThan(10L));
+                                        assertThat(extra_source.longValue(), greaterThanOrEqualTo(10L));
                                     } else {
                                         assertThat(extra_source.longValue(), equalTo(1L));
                                     }

From ad9caae09918207f8ac0e8b1a92a95bdb189c507 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Wed, 18 Dec 2024 14:01:05 +0000
Subject: [PATCH 074/119] Improve handling of nested fields in index reader
 wrappers (#118757)

This update enhances the handling of parent filters to ensure proper exclusion of child documents.
---
 docs/changelog/118757.yaml                    |   5 +
 .../test/AbstractBuilderTestCase.java         |   4 +
 .../authz/permission/DocumentPermissions.java |   6 +-
 ...ityIndexReaderWrapperIntegrationTests.java | 180 ++++++++++++++++++
 4 files changed, 193 insertions(+), 2 deletions(-)
 create mode 100644 docs/changelog/118757.yaml

diff --git a/docs/changelog/118757.yaml b/docs/changelog/118757.yaml
new file mode 100644
index 0000000000000..956e220f21aeb
--- /dev/null
+++ b/docs/changelog/118757.yaml
@@ -0,0 +1,5 @@
+pr: 118757
+summary: Improve handling of nested fields in index reader wrappers
+area: Authorization
+type: enhancement
+issues: []
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java
index 20cb66affddee..d239c6453a7fe 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractBuilderTestCase.java
@@ -241,6 +241,10 @@ protected static IndexSettings indexSettings() {
         return serviceHolder.idxSettings;
     }
 
+    protected static MapperService mapperService() {
+        return serviceHolder.mapperService;
+    }
+
     protected static String expectedFieldName(String builderFieldName) {
         return ALIAS_TO_CONCRETE_FIELD_NAME.getOrDefault(builderFieldName, builderFieldName);
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java
index 24f0a52436203..92bb037888495 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java
@@ -159,13 +159,15 @@ private static void buildRoleQuery(
             if (queryBuilder != null) {
                 failIfQueryUsesClient(queryBuilder, context);
                 Query roleQuery = context.toQuery(queryBuilder).query();
-                filter.add(roleQuery, SHOULD);
-                if (context.nestedLookup() != NestedLookup.EMPTY) {
+                if (context.nestedLookup() == NestedLookup.EMPTY) {
+                    filter.add(roleQuery, SHOULD);
+                } else {
                     if (NestedHelper.mightMatchNestedDocs(roleQuery, context)) {
                         roleQuery = new BooleanQuery.Builder().add(roleQuery, FILTER)
                             .add(Queries.newNonNestedFilter(context.indexVersionCreated()), FILTER)
                             .build();
                     }
+                    filter.add(roleQuery, SHOULD);
                     // If access is allowed on root doc then also access is allowed on all nested docs of that root document:
                     BitSetProducer rootDocs = context.bitsetFilter(Queries.newNonNestedFilter(context.indexVersionCreated()));
                     ToChildBlockJoinQuery includeNestedDocs = new ToChildBlockJoinQuery(roleQuery, rootDocs);
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java
index 4751f66cf548e..89b42228d8918 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/accesscontrol/SecurityIndexReaderWrapperIntegrationTests.java
@@ -23,9 +23,12 @@
 import org.apache.lucene.search.TotalHitCountCollectorManager;
 import org.apache.lucene.store.Directory;
 import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.common.lucene.index.ElasticsearchDirectoryReader;
+import org.elasticsearch.common.lucene.search.Queries;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.index.IndexSettings;
@@ -33,9 +36,11 @@
 import org.elasticsearch.index.mapper.KeywordFieldMapper.KeywordFieldType;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.index.mapper.MapperMetrics;
+import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.mapper.Mapping;
 import org.elasticsearch.index.mapper.MappingLookup;
 import org.elasticsearch.index.mapper.MockFieldMapper;
+import org.elasticsearch.index.mapper.SourceToParse;
 import org.elasticsearch.index.query.ParsedQuery;
 import org.elasticsearch.index.query.SearchExecutionContext;
 import org.elasticsearch.index.query.TermsQueryBuilder;
@@ -45,6 +50,9 @@
 import org.elasticsearch.search.internal.ContextIndexSearcher;
 import org.elasticsearch.test.AbstractBuilderTestCase;
 import org.elasticsearch.test.IndexSettingsModule;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.core.security.SecurityContext;
 import org.elasticsearch.xpack.core.security.authc.Authentication;
 import org.elasticsearch.xpack.core.security.authc.AuthenticationTestHelper;
@@ -52,6 +60,8 @@
 import org.elasticsearch.xpack.core.security.authz.permission.DocumentPermissions;
 import org.elasticsearch.xpack.core.security.authz.permission.FieldPermissions;
 
+import java.io.IOException;
+import java.util.Arrays;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
@@ -340,6 +350,176 @@ protected IndicesAccessControl getIndicesAccessControl() {
         directory.close();
     }
 
+    @Override
+    protected void initializeAdditionalMappings(MapperService mapperService) throws IOException {
+        XContentBuilder builder = XContentFactory.jsonBuilder()
+            .startObject()
+            .startObject("properties")
+            .startObject("f1")
+            .field("type", "keyword")
+            .endObject()
+            .startObject("nested1")
+            .field("type", "nested")
+            .startObject("properties")
+            .startObject("field")
+            .field("type", "keyword")
+            .endObject()
+            .endObject()
+            .endObject()
+            .endObject()
+            .endObject();
+        mapperService.merge(
+            MapperService.SINGLE_MAPPING_NAME,
+            new CompressedXContent(Strings.toString(builder)),
+            MapperService.MergeReason.MAPPING_UPDATE
+        );
+    }
+
+    public void testDLSWithNestedDocs() throws Exception {
+        Directory directory = newDirectory();
+        try (
+            IndexWriter iw = new IndexWriter(
+                directory,
+                new IndexWriterConfig(new StandardAnalyzer()).setMergePolicy(NoMergePolicy.INSTANCE)
+            )
+        ) {
+            var parser = mapperService().documentParser();
+            String doc = """
+                        {
+                            "f1": "value",
+                            "nested1": [
+                                {
+                                    "field": "0"
+                                },
+                                {
+                                    "field": "1"
+                                },
+                                {}
+                            ]
+                        }
+                """;
+            var parsedDoc = parser.parseDocument(
+                new SourceToParse("0", new BytesArray(doc), XContentType.JSON),
+                mapperService().mappingLookup()
+            );
+            iw.addDocuments(parsedDoc.docs());
+
+            doc = """
+                        {
+                            "nested1": [
+                                {
+                                    "field": "12"
+                                },
+                                {
+                                    "field": "13"
+                                },
+                                {}
+                            ]
+                        }
+                """;
+            parsedDoc = parser.parseDocument(
+                new SourceToParse("1", new BytesArray(doc), XContentType.JSON),
+                mapperService().mappingLookup()
+            );
+            iw.addDocuments(parsedDoc.docs());
+
+            doc = """
+                       {
+                            "f1": "value",
+                            "nested1": [
+                                {
+                                    "field": "12"
+                                },
+                                {}
+                            ]
+                       }
+                """;
+            parsedDoc = parser.parseDocument(
+                new SourceToParse("2", new BytesArray(doc), XContentType.JSON),
+                mapperService().mappingLookup()
+            );
+            iw.addDocuments(parsedDoc.docs());
+
+            doc = """
+                        {
+                            "nested1": [
+                                {
+                                    "field": "12"
+                                },
+                                {}
+                            ]
+                        }
+                """;
+            parsedDoc = parser.parseDocument(
+                new SourceToParse("3", new BytesArray(doc), XContentType.JSON),
+                mapperService().mappingLookup()
+            );
+            iw.addDocuments(parsedDoc.docs());
+
+            iw.commit();
+        }
+
+        DirectoryReader directoryReader = ElasticsearchDirectoryReader.wrap(
+            DirectoryReader.open(directory),
+            new ShardId(indexSettings().getIndex(), 0)
+        );
+        SearchExecutionContext context = createSearchExecutionContext(new IndexSearcher(directoryReader));
+
+        final ThreadContext threadContext = new ThreadContext(Settings.EMPTY);
+        final SecurityContext securityContext = new SecurityContext(Settings.EMPTY, threadContext);
+        final Authentication authentication = AuthenticationTestHelper.builder().build();
+        new AuthenticationContextSerializer().writeToContext(authentication, threadContext);
+
+        Set<BytesReference> queries = new HashSet<>();
+        queries.add(new BytesArray("{\"bool\": { \"must_not\": { \"exists\": { \"field\": \"f1\" } } } }"));
+        IndicesAccessControl.IndexAccessControl indexAccessControl = new IndicesAccessControl.IndexAccessControl(
+            FieldPermissions.DEFAULT,
+            DocumentPermissions.filteredBy(queries)
+        );
+
+        DocumentSubsetBitsetCache bitsetCache = new DocumentSubsetBitsetCache(Settings.EMPTY, Executors.newSingleThreadExecutor());
+
+        final MockLicenseState licenseState = mock(MockLicenseState.class);
+        when(licenseState.isAllowed(DOCUMENT_LEVEL_SECURITY_FEATURE)).thenReturn(true);
+        ScriptService scriptService = mock(ScriptService.class);
+        SecurityIndexReaderWrapper wrapper = new SecurityIndexReaderWrapper(
+            s -> context,
+            bitsetCache,
+            securityContext,
+            licenseState,
+            scriptService
+        ) {
+
+            @Override
+            protected IndicesAccessControl getIndicesAccessControl() {
+                IndicesAccessControl indicesAccessControl = new IndicesAccessControl(
+                    true,
+                    singletonMap(indexSettings().getIndex().getName(), indexAccessControl)
+                );
+                return indicesAccessControl;
+            }
+        };
+
+        DirectoryReader wrappedDirectoryReader = wrapper.apply(directoryReader);
+        IndexSearcher indexSearcher = new ContextIndexSearcher(
+            wrappedDirectoryReader,
+            IndexSearcher.getDefaultSimilarity(),
+            IndexSearcher.getDefaultQueryCache(),
+            IndexSearcher.getDefaultQueryCachingPolicy(),
+            true
+        );
+
+        ScoreDoc[] hits = indexSearcher.search(new MatchAllDocsQuery(), 1000).scoreDocs;
+        assertThat(Arrays.stream(hits).map(h -> h.doc).collect(Collectors.toSet()), containsInAnyOrder(4, 5, 6, 7, 11, 12, 13));
+
+        hits = indexSearcher.search(Queries.newNonNestedFilter(context.indexVersionCreated()), 1000).scoreDocs;
+        assertThat(Arrays.stream(hits).map(h -> h.doc).collect(Collectors.toSet()), containsInAnyOrder(7, 13));
+
+        bitsetCache.close();
+        directoryReader.close();
+        directory.close();
+    }
+
     private static MappingLookup createMappingLookup(List<MappedFieldType> concreteFields) {
         List<FieldMapper> mappers = concreteFields.stream().map(MockFieldMapper::new).collect(Collectors.toList());
         return MappingLookup.fromMappers(Mapping.EMPTY, mappers, emptyList());

From 5255bfb6fb2f18afaebaf5f9951619a77a58667d Mon Sep 17 00:00:00 2001
From: Sean Story <sean.story@elastic.co>
Date: Wed, 18 Dec 2024 08:03:08 -0600
Subject: [PATCH 075/119] Replace 'ent-search-generic' with 'search-default'
 pipeline (#118899)

* Replace 'ent-search-generic' with 'search-default' pipeline

* missed one

* [CI] Auto commit changes from spotless

---------

Co-authored-by: elasticsearchmachine <infra-root+elasticsearchmachine@elastic.co>
---
 .java-version                                 |   1 +
 .../connectors-content-extraction.asciidoc    |   2 +-
 ...nnectors-filter-extract-transform.asciidoc |   4 +-
 .../search-inference-processing.asciidoc      |   2 +-
 .../ingest/search-ingest-pipelines.asciidoc   |  33 +++--
 .../ingest/search-nlp-tutorial.asciidoc       |   4 +-
 .../elastic-connectors-mappings.json          |   2 +-
 .../entsearch/generic_ingestion_pipeline.json | 130 ------------------
 .../connector/ConnectorTemplateRegistry.java  |  10 --
 .../ConnectorIngestPipelineTests.java         |   2 +-
 .../ConnectorTemplateRegistryTests.java       |  15 +-
 .../application/connector/ConnectorTests.java |   6 +-
 .../syncjob/ConnectorSyncJobTests.java        |   8 +-
 13 files changed, 37 insertions(+), 182 deletions(-)
 create mode 100644 .java-version
 delete mode 100644 x-pack/plugin/core/template-resources/src/main/resources/entsearch/generic_ingestion_pipeline.json

diff --git a/.java-version b/.java-version
new file mode 100644
index 0000000000000..aabe6ec3909c9
--- /dev/null
+++ b/.java-version
@@ -0,0 +1 @@
+21
diff --git a/docs/reference/connector/docs/connectors-content-extraction.asciidoc b/docs/reference/connector/docs/connectors-content-extraction.asciidoc
index a87d38c9bf531..744fe1d87cb45 100644
--- a/docs/reference/connector/docs/connectors-content-extraction.asciidoc
+++ b/docs/reference/connector/docs/connectors-content-extraction.asciidoc
@@ -8,7 +8,7 @@ The logic for content extraction is defined in {connectors-python}/connectors/ut
 While intended primarily for PDF and Microsoft Office formats, you can use any of the <<es-connectors-content-extraction-supported-file-types, supported formats>>.
 
 Enterprise Search uses an {ref}/ingest.html[Elasticsearch ingest pipeline^] to power the web crawler's binary content extraction.
-The default pipeline, `ent-search-generic-ingestion`, is automatically created when Enterprise Search first starts.
+The default pipeline, `search-default-ingestion`, is automatically created when Enterprise Search first starts.
 
 You can {ref}/ingest.html#create-manage-ingest-pipelines[view^] this pipeline in Kibana.
 Customizing your pipeline usage is also an option.
diff --git a/docs/reference/connector/docs/connectors-filter-extract-transform.asciidoc b/docs/reference/connector/docs/connectors-filter-extract-transform.asciidoc
index 278478c908bf0..62a99928bfb46 100644
--- a/docs/reference/connector/docs/connectors-filter-extract-transform.asciidoc
+++ b/docs/reference/connector/docs/connectors-filter-extract-transform.asciidoc
@@ -13,7 +13,7 @@ The following diagram provides an overview of how content extraction, sync rules
 [.screenshot]
 image::images/pipelines-extraction-sync-rules.png[Architecture diagram of data pipeline with content extraction, sync rules, and ingest pipelines]
 
-By default, only the connector specific logic (2) and the default `ent-search-generic-ingestion` pipeline (6) extract and transform your data, as configured in your deployment.
+By default, only the connector specific logic (2) and the default `search-default-ingestion` pipeline (6) extract and transform your data, as configured in your deployment.
 
 The following tools are available for more advanced use cases:
 
@@ -50,4 +50,4 @@ Use ingest pipelines for data enrichment, normalization, and more.
 
 Elastic connectors use a default ingest pipeline, which you can copy and customize to meet your needs.
 
-Refer to {ref}/ingest-pipeline-search.html[ingest pipelines in Search] in the {es} documentation.
\ No newline at end of file
+Refer to {ref}/ingest-pipeline-search.html[ingest pipelines in Search] in the {es} documentation.
diff --git a/docs/reference/ingest/search-inference-processing.asciidoc b/docs/reference/ingest/search-inference-processing.asciidoc
index 006cc96294477..73642b3bb3447 100644
--- a/docs/reference/ingest/search-inference-processing.asciidoc
+++ b/docs/reference/ingest/search-inference-processing.asciidoc
@@ -88,7 +88,7 @@ The `monitor_ml` <<security-privileges, Elasticsearch cluster privilege>> is req
 
 To create the index-specific ML inference pipeline, go to *Search -> Content -> Indices -> <your index> -> Pipelines* in the Kibana UI.
 
-If you only see the `ent-search-generic-ingestion` pipeline, you will need to click *Copy and customize* to create index-specific pipelines.
+If you only see the `search-default-ingestion` pipeline, you will need to click *Copy and customize* to create index-specific pipelines.
 This will create the `{index_name}@ml-inference` pipeline.
 
 Once your index-specific ML inference pipeline is ready, you can add inference processors that use your ML trained models.
diff --git a/docs/reference/ingest/search-ingest-pipelines.asciidoc b/docs/reference/ingest/search-ingest-pipelines.asciidoc
index e414dacaab964..272c6ba2884b9 100644
--- a/docs/reference/ingest/search-ingest-pipelines.asciidoc
+++ b/docs/reference/ingest/search-ingest-pipelines.asciidoc
@@ -40,7 +40,7 @@ Considerations such as error handling, conditional execution, sequencing, versio
 To this end, when you create indices for search use cases, (including {enterprise-search-ref}/crawler.html[Elastic web crawler], <<es-connectors,connectors>>.
 , and API indices), each index already has a pipeline set up with several processors that optimize your content for search.
 
-This pipeline is called `ent-search-generic-ingestion`.
+This pipeline is called `search-default-ingestion`.
 While it is a "managed" pipeline (meaning it should not be tampered with), you can view its details via the Kibana UI or the Elasticsearch API.
 You can also <<ingest-pipeline-search-details-generic-reference,read more about its contents below>>.
 
@@ -56,14 +56,14 @@ This will not effect existing indices.
 
 Each index also provides the capability to easily create index-specific ingest pipelines with customizable processing.
 If you need that extra flexibility, you can create a custom pipeline by going to your pipeline settings and choosing to "copy and customize".
-This will replace the index's use of `ent-search-generic-ingestion` with 3 newly generated pipelines:
+This will replace the index's use of `search-default-ingestion` with 3 newly generated pipelines:
 
 1. `<index-name>`
 2. `<index-name>@custom`
 3. `<index-name>@ml-inference`
 
-Like `ent-search-generic-ingestion`, the first of these is "managed", but the other two can and should be modified to fit your needs.
-You can view these pipelines using the platform tools (Kibana UI, Elasticsearch API), and can also 
+Like `search-default-ingestion`, the first of these is "managed", but the other two can and should be modified to fit your needs.
+You can view these pipelines using the platform tools (Kibana UI, Elasticsearch API), and can also
 <<ingest-pipeline-search-details-specific,read more about their content below>>.
 
 [discrete#ingest-pipeline-search-pipeline-settings]
@@ -123,7 +123,7 @@ If the pipeline is not specified, the underscore-prefixed fields will actually b
 === Details
 
 [discrete#ingest-pipeline-search-details-generic-reference]
-==== `ent-search-generic-ingestion` Reference
+==== `search-default-ingestion` Reference
 
 You can access this pipeline with the <<get-pipeline-api, Elasticsearch Ingest Pipelines API>> or via Kibana's <<create-manage-ingest-pipelines,Stack Management > Ingest Pipelines>> UI.
 
@@ -149,7 +149,7 @@ If you want to make customizations, we recommend you utilize index-specific pipe
 [discrete#ingest-pipeline-search-details-generic-reference-params]
 ===== Control flow parameters
 
-The `ent-search-generic-ingestion` pipeline does not always run all processors.
+The `search-default-ingestion` pipeline does not always run all processors.
 It utilizes a feature of ingest pipelines to <<conditionally-run-processor,conditionally run processors>> based on the contents of each individual document.
 
 * `_extract_binary_content` - if this field is present and has a value of `true` on a source document, the pipeline will attempt to run the `attachment`, `set_body`, and `remove_replacement_chars` processors.
@@ -167,8 +167,8 @@ See <<ingest-pipeline-search-pipeline-settings>>.
 ==== Index-specific ingest pipelines
 
 In the Kibana UI for your index, by clicking on the Pipelines tab, then *Settings > Copy and customize*, you can quickly generate 3 pipelines which are specific to your index.
-These 3 pipelines replace `ent-search-generic-ingestion` for the index.
-There is nothing lost in this action, as the `<index-name>` pipeline is a superset of functionality over the `ent-search-generic-ingestion` pipeline.
+These 3 pipelines replace `search-default-ingestion` for the index.
+There is nothing lost in this action, as the `<index-name>` pipeline is a superset of functionality over the `search-default-ingestion` pipeline.
 
 [IMPORTANT]
 ====
@@ -179,7 +179,7 @@ Refer to the Elastic subscriptions pages for https://www.elastic.co/subscription
 [discrete#ingest-pipeline-search-details-specific-reference]
 ===== `<index-name>` Reference
 
-This pipeline looks and behaves a lot like the <<ingest-pipeline-search-details-generic-reference,`ent-search-generic-ingestion` pipeline>>, but with <<ingest-pipeline-search-details-specific-reference-processors,two additional processors>>.
+This pipeline looks and behaves a lot like the <<ingest-pipeline-search-details-generic-reference,`search-default-ingestion` pipeline>>, but with <<ingest-pipeline-search-details-specific-reference-processors,two additional processors>>.
 
 [WARNING]
 =========================
@@ -197,7 +197,7 @@ If you want to make customizations, we recommend you utilize <<ingest-pipeline-s
 [discrete#ingest-pipeline-search-details-specific-reference-processors]
 ====== Processors
 
-In addition to the processors inherited from the <<ingest-pipeline-search-details-generic-reference,`ent-search-generic-ingestion` pipeline>>, the index-specific pipeline also defines:
+In addition to the processors inherited from the <<ingest-pipeline-search-details-generic-reference,`search-default-ingestion` pipeline>>, the index-specific pipeline also defines:
 
 * `index_ml_inference_pipeline` - this uses the <<pipeline-processor, Pipeline>> processor to run the `<index-name>@ml-inference` pipeline.
   This processor will only be run if the source document includes a `_run_ml_inference` field with the value `true`.
@@ -206,7 +206,7 @@ In addition to the processors inherited from the <<ingest-pipeline-search-detail
 [discrete#ingest-pipeline-search-details-specific-reference-params]
 ====== Control flow parameters
 
-Like the `ent-search-generic-ingestion` pipeline, the `<index-name>` pipeline does not always run all processors.
+Like the `search-default-ingestion` pipeline, the `<index-name>` pipeline does not always run all processors.
 In addition to the `_extract_binary_content` and `_reduce_whitespace` control flow parameters, the `<index-name>` pipeline also supports:
 
 * `_run_ml_inference` - if this field is present and has a value of `true` on a source document, the pipeline will attempt to run the `index_ml_inference_pipeline` processor.
@@ -220,7 +220,7 @@ See <<ingest-pipeline-search-pipeline-settings>>.
 ===== `<index-name>@ml-inference` Reference
 
 This pipeline is empty to start (no processors), but can be added to via the Kibana UI either through the Pipelines tab of your index, or from the *Stack Management > Ingest Pipelines* page.
-Unlike the `ent-search-generic-ingestion` pipeline and the `<index-name>` pipeline, this pipeline is NOT "managed".
+Unlike the `search-default-ingestion` pipeline and the `<index-name>` pipeline, this pipeline is NOT "managed".
 
 It's possible to add one or more ML inference pipelines to an index in the *Content* UI.
 This pipeline will serve as a container for all of the ML inference pipelines configured for the index.
@@ -241,7 +241,7 @@ The `monitor_ml` Elasticsearch cluster permission is required in order to manage
 
 This pipeline is empty to start (no processors), but can be added to via the Kibana UI either through the Pipelines
 tab of your index, or from the *Stack Management > Ingest Pipelines* page.
-Unlike the `ent-search-generic-ingestion` pipeline and the `<index-name>` pipeline, this pipeline is NOT "managed".
+Unlike the `search-default-ingestion` pipeline and the `<index-name>` pipeline, this pipeline is NOT "managed".
 
 You are encouraged to make additions and edits to this pipeline, provided its name remains the same.
 This provides a convenient hook from which to add custom processing and transformations for your data.
@@ -272,9 +272,12 @@ extraction.
 These changes should be re-applied to each index's `<index-name>@custom` pipeline in order to ensure a consistent data processing experience.
   In 8.5+, the <<ingest-pipeline-search-pipeline-settings, index setting to enable binary content>> is required *in addition* to the configurations mentioned in the {enterprise-search-ref}/crawler-managing.html#crawler-managing-binary-content[Elastic web crawler Guide].
 
-* `ent-search-generic-ingestion` - Since 8.5, Native Connectors, Connector Clients, and new (>8.4) Elastic web crawler indices will all make use of this pipeline by default.
+* `ent-search-generic-ingestion` - Since 8.5, Native Connectors, Connector Clients, and new (>8.4) Elastic web crawler indices all made use of this pipeline by default.
+  This pipeline evolved into the `search-default-ingestion` pipeline.
+
+* `search-default-ingestion` - Since 9.0, Connectors have made use of this pipeline by default.
   You can <<ingest-pipeline-search-details-generic-reference, read more about this pipeline>> above.
-  As this pipeline is "managed", any modifications that were made to `app_search_crawler` and/or `ent_search_crawler` should NOT be made to `ent-search-generic-ingestion`.
+  As this pipeline is "managed", any modifications that were made to `app_search_crawler` and/or `ent_search_crawler` should NOT be made to `search-default-ingestion`.
   Instead, if such customizations are desired, you should utilize <<ingest-pipeline-search-details-specific>>, placing all modifications in the `<index-name>@custom` pipeline(s).
 =============
 
diff --git a/docs/reference/ingest/search-nlp-tutorial.asciidoc b/docs/reference/ingest/search-nlp-tutorial.asciidoc
index afdceeeb8bac2..b23a15c96b1a2 100644
--- a/docs/reference/ingest/search-nlp-tutorial.asciidoc
+++ b/docs/reference/ingest/search-nlp-tutorial.asciidoc
@@ -164,8 +164,8 @@ Now it's time to create an inference pipeline.
 
 1. From the overview page for your `search-photo-comments` index in "Search", click the *Pipelines* tab.
 By default, Elasticsearch does not create any index-specific ingest pipelines.
-2. Because we want to customize these pipelines, we need to *Copy and customize* the `ent-search-generic-ingestion` ingest pipeline.
-Find this option above the settings for the `ent-search-generic-ingestion` ingest pipeline.
+2. Because we want to customize these pipelines, we need to *Copy and customize* the `search-default-ingestion` ingest pipeline.
+Find this option above the settings for the `search-default-ingestion` ingest pipeline.
 This will create two new index-specific ingest pipelines.
 
 Next, we'll add an inference pipeline.
diff --git a/x-pack/plugin/core/template-resources/src/main/resources/entsearch/connector/elastic-connectors-mappings.json b/x-pack/plugin/core/template-resources/src/main/resources/entsearch/connector/elastic-connectors-mappings.json
index 651e1c84da73a..5afa557e1405e 100644
--- a/x-pack/plugin/core/template-resources/src/main/resources/entsearch/connector/elastic-connectors-mappings.json
+++ b/x-pack/plugin/core/template-resources/src/main/resources/entsearch/connector/elastic-connectors-mappings.json
@@ -7,7 +7,7 @@
       "dynamic": "false",
       "_meta": {
         "pipeline": {
-          "default_name": "ent-search-generic-ingestion",
+          "default_name": "search-default-ingestion",
           "default_extract_binary_content": true,
           "default_run_ml_inference": true,
           "default_reduce_whitespace": true
diff --git a/x-pack/plugin/core/template-resources/src/main/resources/entsearch/generic_ingestion_pipeline.json b/x-pack/plugin/core/template-resources/src/main/resources/entsearch/generic_ingestion_pipeline.json
deleted file mode 100644
index e2a2cbd460117..0000000000000
--- a/x-pack/plugin/core/template-resources/src/main/resources/entsearch/generic_ingestion_pipeline.json
+++ /dev/null
@@ -1,130 +0,0 @@
-{
-  "version": ${xpack.application.connector.template.version},
-  "description": "Generic Enterprise Search ingest pipeline",
-  "_meta": {
-    "managed_by": "Enterprise Search",
-    "managed": true
-  },
-  "processors": [
-    {
-      "attachment": {
-        "description": "Extract text from binary attachments",
-        "field": "_attachment",
-        "target_field": "_extracted_attachment",
-        "ignore_missing": true,
-        "indexed_chars_field": "_attachment_indexed_chars",
-        "if": "ctx?._extract_binary_content == true",
-        "on_failure": [
-          {
-            "append": {
-              "description": "Record error information",
-              "field": "_ingestion_errors",
-              "value": "Processor 'attachment' in pipeline '{{ _ingest.on_failure_pipeline }}' failed with message '{{ _ingest.on_failure_message }}'"
-            }
-          }
-        ],
-        "remove_binary": false
-      }
-    },
-    {
-      "set": {
-        "tag": "set_body",
-        "description": "Set any extracted text on the 'body' field",
-        "field": "body",
-        "copy_from": "_extracted_attachment.content",
-        "ignore_empty_value": true,
-        "if": "ctx?._extract_binary_content == true",
-        "on_failure": [
-          {
-            "append": {
-              "description": "Record error information",
-              "field": "_ingestion_errors",
-              "value": "Processor 'set' with tag 'set_body' in pipeline '{{ _ingest.on_failure_pipeline }}' failed with message '{{ _ingest.on_failure_message }}'"
-            }
-          }
-        ]
-      }
-    },
-    {
-      "gsub": {
-        "tag": "remove_replacement_chars",
-        "description": "Remove unicode 'replacement' characters",
-        "field": "body",
-        "pattern": "�",
-        "replacement": "",
-        "ignore_missing": true,
-        "if": "ctx?._extract_binary_content == true",
-        "on_failure": [
-          {
-            "append": {
-              "description": "Record error information",
-              "field": "_ingestion_errors",
-              "value": "Processor 'gsub' with tag 'remove_replacement_chars' in pipeline '{{ _ingest.on_failure_pipeline }}' failed with message '{{ _ingest.on_failure_message }}'"
-            }
-          }
-        ]
-      }
-    },
-    {
-      "gsub": {
-        "tag": "remove_extra_whitespace",
-        "description": "Squish whitespace",
-        "field": "body",
-        "pattern": "\\s+",
-        "replacement": " ",
-        "ignore_missing": true,
-        "if": "ctx?._reduce_whitespace == true",
-        "on_failure": [
-          {
-            "append": {
-              "description": "Record error information",
-              "field": "_ingestion_errors",
-              "value": "Processor 'gsub' with tag 'remove_extra_whitespace' in pipeline '{{ _ingest.on_failure_pipeline }}' failed with message '{{ _ingest.on_failure_message }}'"
-            }
-          }
-        ]
-      }
-    },
-    {
-      "trim" : {
-        "description": "Trim leading and trailing whitespace",
-        "field": "body",
-        "ignore_missing": true,
-        "if": "ctx?._reduce_whitespace == true",
-        "on_failure": [
-          {
-            "append": {
-              "description": "Record error information",
-              "field": "_ingestion_errors",
-              "value": "Processor 'trim' in pipeline '{{ _ingest.on_failure_pipeline }}' failed with message '{{ _ingest.on_failure_message }}'"
-            }
-          }
-        ]
-      }
-    },
-    {
-      "remove": {
-        "tag": "remove_meta_fields",
-        "description": "Remove meta fields",
-        "field": [
-          "_attachment",
-          "_attachment_indexed_chars",
-          "_extracted_attachment",
-          "_extract_binary_content",
-          "_reduce_whitespace",
-          "_run_ml_inference"
-        ],
-        "ignore_missing": true,
-        "on_failure": [
-          {
-            "append": {
-              "description": "Record error information",
-              "field": "_ingestion_errors",
-              "value": "Processor 'remove' with tag 'remove_meta_fields' in pipeline '{{ _ingest.on_failure_pipeline }}' failed with message '{{ _ingest.on_failure_message }}'"
-            }
-          }
-        ]
-      }
-    }
-  ]
-}
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java
index e630f929bc09b..fd35acc89db5c 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistry.java
@@ -48,10 +48,6 @@ public class ConnectorTemplateRegistry extends IndexTemplateRegistry {
     public static final String MANAGED_CONNECTOR_INDEX_PREFIX = "content-";
 
     // Pipeline constants
-
-    public static final String ENT_SEARCH_GENERIC_PIPELINE_NAME = "ent-search-generic-ingestion";
-    public static final String ENT_SEARCH_GENERIC_PIPELINE_FILE = "generic_ingestion_pipeline";
-
     public static final String SEARCH_DEFAULT_PIPELINE_NAME = "search-default-ingestion";
     public static final String SEARCH_DEFAULT_PIPELINE_FILE = "search_default_pipeline";
 
@@ -111,12 +107,6 @@ public class ConnectorTemplateRegistry extends IndexTemplateRegistry {
     @Override
     protected List<IngestPipelineConfig> getIngestPipelines() {
         return List.of(
-            new JsonIngestPipelineConfig(
-                ENT_SEARCH_GENERIC_PIPELINE_NAME,
-                ROOT_RESOURCE_PATH + ENT_SEARCH_GENERIC_PIPELINE_FILE + ".json",
-                REGISTRY_VERSION,
-                TEMPLATE_VERSION_VARIABLE
-            ),
             new JsonIngestPipelineConfig(
                 SEARCH_DEFAULT_PIPELINE_NAME,
                 ROOT_RESOURCE_PATH + SEARCH_DEFAULT_PIPELINE_FILE + ".json",
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIngestPipelineTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIngestPipelineTests.java
index f4a92e51e8c6a..c3d4bf8b72ff5 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIngestPipelineTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorIngestPipelineTests.java
@@ -50,7 +50,7 @@ public void testToXContent() throws IOException {
         String content = XContentHelper.stripWhitespace("""
                 {
                     "extract_binary_content": true,
-                    "name": "ent-search-generic-ingestion",
+                    "name": "search-default-ingestion",
                     "reduce_whitespace": true,
                     "run_ml_inference": false
                 }
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistryTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistryTests.java
index a4c7015afafcb..068b99626af9d 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistryTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTemplateRegistryTests.java
@@ -132,10 +132,7 @@ public void testThatNonExistingComponentTemplatesAreAddedImmediately() throws Ex
         ClusterChangedEvent event = createClusterChangedEvent(
             Collections.emptyMap(),
             Collections.emptyMap(),
-            Collections.singletonMap(
-                ConnectorTemplateRegistry.ENT_SEARCH_GENERIC_PIPELINE_NAME,
-                ConnectorTemplateRegistry.REGISTRY_VERSION
-            ),
+            Collections.singletonMap(ConnectorTemplateRegistry.SEARCH_DEFAULT_PIPELINE_NAME, ConnectorTemplateRegistry.REGISTRY_VERSION),
             Collections.emptyMap(),
             nodes
         );
@@ -169,10 +166,7 @@ public void testThatVersionedOldComponentTemplatesAreUpgraded() throws Exception
                 ConnectorTemplateRegistry.CONNECTOR_TEMPLATE_NAME + "-settings",
                 ConnectorTemplateRegistry.REGISTRY_VERSION - 1
             ),
-            Collections.singletonMap(
-                ConnectorTemplateRegistry.ENT_SEARCH_GENERIC_PIPELINE_NAME,
-                ConnectorTemplateRegistry.REGISTRY_VERSION
-            ),
+            Collections.singletonMap(ConnectorTemplateRegistry.SEARCH_DEFAULT_PIPELINE_NAME, ConnectorTemplateRegistry.REGISTRY_VERSION),
             Collections.emptyMap(),
             nodes
         );
@@ -189,10 +183,7 @@ public void testThatUnversionedOldComponentTemplatesAreUpgraded() throws Excepti
         ClusterChangedEvent event = createClusterChangedEvent(
             Collections.emptyMap(),
             Collections.singletonMap(ConnectorTemplateRegistry.CONNECTOR_TEMPLATE_NAME + "-mappings", null),
-            Collections.singletonMap(
-                ConnectorTemplateRegistry.ENT_SEARCH_GENERIC_PIPELINE_NAME,
-                ConnectorTemplateRegistry.REGISTRY_VERSION
-            ),
+            Collections.singletonMap(ConnectorTemplateRegistry.SEARCH_DEFAULT_PIPELINE_NAME, ConnectorTemplateRegistry.REGISTRY_VERSION),
             Collections.emptyMap(),
             nodes
         );
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTests.java
index 734c6eaf86965..bcb647d978abb 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/ConnectorTests.java
@@ -225,7 +225,7 @@ public void testToXContent() throws IOException {
                "name":"test-name",
                "pipeline":{
                   "extract_binary_content":true,
-                  "name":"ent-search-generic-ingestion",
+                  "name":"search-default-ingestion",
                   "reduce_whitespace":true,
                   "run_ml_inference":false
                },
@@ -286,7 +286,7 @@ public void testToContent_WithNullValues() throws IOException {
                "name": null,
                "pipeline":{
                   "extract_binary_content":true,
-                  "name":"ent-search-generic-ingestion",
+                  "name":"search-default-ingestion",
                   "reduce_whitespace":true,
                   "run_ml_inference":false
                },
@@ -350,7 +350,7 @@ public void testToXContent_withOptionalFieldsMissing() throws IOException {
                "name": null,
                "pipeline":{
                   "extract_binary_content":true,
-                  "name":"ent-search-generic-ingestion",
+                  "name":"search-default-ingestion",
                   "reduce_whitespace":true,
                   "run_ml_inference":false
                },
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/syncjob/ConnectorSyncJobTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/syncjob/ConnectorSyncJobTests.java
index 81b05ce25e177..ed3338c715bdf 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/syncjob/ConnectorSyncJobTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/connector/syncjob/ConnectorSyncJobTests.java
@@ -77,7 +77,7 @@ public void testFromXContent_WithAllFields_AllSet() throws IOException {
                     "language": "english",
                     "pipeline": {
                         "extract_binary_content": true,
-                        "name": "ent-search-generic-ingestion",
+                        "name": "search-default-ingestion",
                         "reduce_whitespace": true,
                         "run_ml_inference": false
                     },
@@ -160,7 +160,7 @@ public void testFromXContent_WithOnlyNonNullableFieldsSet_DoesNotThrow() throws
                     "language": "english",
                     "pipeline": {
                         "extract_binary_content": true,
-                        "name": "ent-search-generic-ingestion",
+                        "name": "search-default-ingestion",
                         "reduce_whitespace": true,
                         "run_ml_inference": false
                     },
@@ -218,7 +218,7 @@ public void testFromXContent_WithAllNullableFieldsSetToNull_DoesNotThrow() throw
                     "language": "english",
                     "pipeline": {
                         "extract_binary_content": true,
-                        "name": "ent-search-generic-ingestion",
+                        "name": "search-default-ingestion",
                         "reduce_whitespace": true,
                         "run_ml_inference": false
                     },
@@ -275,7 +275,7 @@ public void testSyncJobConnectorFromXContent_WithAllFieldsSet() throws IOExcepti
                 "language": "english",
                 "pipeline": {
                     "extract_binary_content": true,
-                    "name": "ent-search-generic-ingestion",
+                    "name": "search-default-ingestion",
                     "reduce_whitespace": true,
                     "run_ml_inference": false
                 },

From a2360d18b434b89f0aae9dbc264a16a5e75d1475 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 01:20:54 +1100
Subject: [PATCH 076/119] Mute
 org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatusTests
 testEqualsAndHashcode #118965

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 3a8594acf3bb1..b35a70391f195 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -292,6 +292,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118914
 - class: org.elasticsearch.smoketest.SmokeTestMultiNodeClientYamlTestSuiteIT
   issue: https://github.com/elastic/elasticsearch/issues/118955
+- class: org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatusTests
+  method: testEqualsAndHashcode
+  issue: https://github.com/elastic/elasticsearch/issues/118965
 
 # Examples:
 #

From 97bc2919ffb5d9e90f809a18233c49a52cf58faa Mon Sep 17 00:00:00 2001
From: Matteo Piergiovanni <134913285+piergm@users.noreply.github.com>
Date: Wed, 18 Dec 2024 15:29:35 +0100
Subject: [PATCH 077/119] Prevent data nodes from sending stack traces to
 coordinator when `error_trace=false` (#118266)

* first iterations

* added tests

* Update docs/changelog/118266.yaml

* constant for error_trace and typos

* centralized putHeader

* moved threadContext to parent class

* uses NodeClient.threadpool

* updated async tests to retrieve final result

* moved test to avoid starting up a node

* added transport version to avoid sending useless bytes

* more async tests
---
 docs/changelog/118266.yaml                    |   5 +
 .../bucket/SearchCancellationIT.java          |   2 +
 .../http/SearchErrorTraceIT.java              | 175 ++++++++++++++
 .../org/elasticsearch/TransportVersions.java  |   1 +
 .../action/search/SearchTransportService.java |   6 +-
 .../common/util/concurrent/ThreadContext.java |  21 ++
 .../elasticsearch/rest/BaseRestHandler.java   |   1 -
 .../elasticsearch/rest/RestController.java    |   3 +-
 .../org/elasticsearch/rest/RestResponse.java  |   3 +-
 .../action/search/RestMultiSearchAction.java  |   3 +
 .../rest/action/search/RestSearchAction.java  |   4 +-
 .../elasticsearch/search/SearchService.java   |  56 ++++-
 .../elasticsearch/rest/RestResponseTests.java |   3 +-
 .../search/SearchServiceSingleNodeTests.java  |   3 +-
 .../search/SearchServiceTests.java            |  34 +++
 .../xpack/search/AsyncSearchErrorTraceIT.java | 222 ++++++++++++++++++
 .../search/RestSubmitAsyncSearchAction.java   |   3 +
 .../ServerSentEventsRestActionListener.java   |   3 +-
 18 files changed, 535 insertions(+), 13 deletions(-)
 create mode 100644 docs/changelog/118266.yaml
 create mode 100644 qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/SearchErrorTraceIT.java
 create mode 100644 x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/AsyncSearchErrorTraceIT.java

diff --git a/docs/changelog/118266.yaml b/docs/changelog/118266.yaml
new file mode 100644
index 0000000000000..1b14b12b973c5
--- /dev/null
+++ b/docs/changelog/118266.yaml
@@ -0,0 +1,5 @@
+pr: 118266
+summary: Prevent data nodes from sending stack traces to coordinator when `error_trace=false`
+area: Search
+type: enhancement
+issues: []
diff --git a/modules/aggregations/src/internalClusterTest/java/org/elasticsearch/aggregations/bucket/SearchCancellationIT.java b/modules/aggregations/src/internalClusterTest/java/org/elasticsearch/aggregations/bucket/SearchCancellationIT.java
index 5249077bdfdbb..7adf6a09e9a19 100644
--- a/modules/aggregations/src/internalClusterTest/java/org/elasticsearch/aggregations/bucket/SearchCancellationIT.java
+++ b/modules/aggregations/src/internalClusterTest/java/org/elasticsearch/aggregations/bucket/SearchCancellationIT.java
@@ -96,6 +96,8 @@ public void testCancellationDuringTimeSeriesAggregation() throws Exception {
         }
 
         logger.info("Executing search");
+        // we have to explicitly set error_trace=true for the later exception check for `TimeSeriesIndexSearcher`
+        client().threadPool().getThreadContext().putHeader("error_trace", "true");
         TimeSeriesAggregationBuilder timeSeriesAggregationBuilder = new TimeSeriesAggregationBuilder("test_agg");
         ActionFuture<SearchResponse> searchResponse = prepareSearch("test").setQuery(matchAllQuery())
             .addAggregation(
diff --git a/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/SearchErrorTraceIT.java b/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/SearchErrorTraceIT.java
new file mode 100644
index 0000000000000..6f9ab8ccdfdec
--- /dev/null
+++ b/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/SearchErrorTraceIT.java
@@ -0,0 +1,175 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.http;
+
+import org.apache.http.entity.ContentType;
+import org.apache.http.nio.entity.NByteArrayEntity;
+import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.action.search.MultiSearchRequest;
+import org.elasticsearch.action.search.SearchRequest;
+import org.elasticsearch.client.Request;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.transport.TransportMessageListener;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xcontent.XContentType;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.util.Optional;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+import static org.elasticsearch.index.query.QueryBuilders.simpleQueryStringQuery;
+
+public class SearchErrorTraceIT extends HttpSmokeTestCase {
+    private AtomicBoolean hasStackTrace;
+
+    @Before
+    private void setupMessageListener() {
+        internalCluster().getDataNodeInstances(TransportService.class).forEach(ts -> {
+            ts.addMessageListener(new TransportMessageListener() {
+                @Override
+                public void onResponseSent(long requestId, String action, Exception error) {
+                    TransportMessageListener.super.onResponseSent(requestId, action, error);
+                    if (action.startsWith("indices:data/read/search")) {
+                        Optional<Throwable> throwable = ExceptionsHelper.unwrapCausesAndSuppressed(
+                            error,
+                            t -> t.getStackTrace().length > 0
+                        );
+                        hasStackTrace.set(throwable.isPresent());
+                    }
+                }
+            });
+        });
+    }
+
+    private void setupIndexWithDocs() {
+        createIndex("test1", "test2");
+        indexRandom(
+            true,
+            prepareIndex("test1").setId("1").setSource("field", "foo"),
+            prepareIndex("test2").setId("10").setSource("field", 5)
+        );
+        refresh();
+    }
+
+    public void testSearchFailingQueryErrorTraceDefault() throws IOException {
+        hasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        getRestClient().performRequest(searchRequest);
+        assertFalse(hasStackTrace.get());
+    }
+
+    public void testSearchFailingQueryErrorTraceTrue() throws IOException {
+        hasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("error_trace", "true");
+        getRestClient().performRequest(searchRequest);
+        assertTrue(hasStackTrace.get());
+    }
+
+    public void testSearchFailingQueryErrorTraceFalse() throws IOException {
+        hasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("error_trace", "false");
+        getRestClient().performRequest(searchRequest);
+        assertFalse(hasStackTrace.get());
+    }
+
+    public void testMultiSearchFailingQueryErrorTraceDefault() throws IOException {
+        hasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        XContentType contentType = XContentType.JSON;
+        MultiSearchRequest multiSearchRequest = new MultiSearchRequest().add(
+            new SearchRequest("test*").source(new SearchSourceBuilder().query(simpleQueryStringQuery("foo").field("field")))
+        );
+        Request searchRequest = new Request("POST", "/_msearch");
+        byte[] requestBody = MultiSearchRequest.writeMultiLineFormat(multiSearchRequest, contentType.xContent());
+        searchRequest.setEntity(
+            new NByteArrayEntity(requestBody, ContentType.create(contentType.mediaTypeWithoutParameters(), (Charset) null))
+        );
+        getRestClient().performRequest(searchRequest);
+        assertFalse(hasStackTrace.get());
+    }
+
+    public void testMultiSearchFailingQueryErrorTraceTrue() throws IOException {
+        hasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        XContentType contentType = XContentType.JSON;
+        MultiSearchRequest multiSearchRequest = new MultiSearchRequest().add(
+            new SearchRequest("test*").source(new SearchSourceBuilder().query(simpleQueryStringQuery("foo").field("field")))
+        );
+        Request searchRequest = new Request("POST", "/_msearch");
+        byte[] requestBody = MultiSearchRequest.writeMultiLineFormat(multiSearchRequest, contentType.xContent());
+        searchRequest.setEntity(
+            new NByteArrayEntity(requestBody, ContentType.create(contentType.mediaTypeWithoutParameters(), (Charset) null))
+        );
+        searchRequest.addParameter("error_trace", "true");
+        getRestClient().performRequest(searchRequest);
+        assertTrue(hasStackTrace.get());
+    }
+
+    public void testMultiSearchFailingQueryErrorTraceFalse() throws IOException {
+        hasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        XContentType contentType = XContentType.JSON;
+        MultiSearchRequest multiSearchRequest = new MultiSearchRequest().add(
+            new SearchRequest("test*").source(new SearchSourceBuilder().query(simpleQueryStringQuery("foo").field("field")))
+        );
+        Request searchRequest = new Request("POST", "/_msearch");
+        byte[] requestBody = MultiSearchRequest.writeMultiLineFormat(multiSearchRequest, contentType.xContent());
+        searchRequest.setEntity(
+            new NByteArrayEntity(requestBody, ContentType.create(contentType.mediaTypeWithoutParameters(), (Charset) null))
+        );
+        searchRequest.addParameter("error_trace", "false");
+        getRestClient().performRequest(searchRequest);
+
+        assertFalse(hasStackTrace.get());
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/TransportVersions.java b/server/src/main/java/org/elasticsearch/TransportVersions.java
index d3e235f1cd82a..bda66d6a2c8cd 100644
--- a/server/src/main/java/org/elasticsearch/TransportVersions.java
+++ b/server/src/main/java/org/elasticsearch/TransportVersions.java
@@ -140,6 +140,7 @@ static TransportVersion def(int id) {
     public static final TransportVersion ESQL_QUERY_BUILDER_IN_SEARCH_FUNCTIONS = def(8_808_00_0);
     public static final TransportVersion EQL_ALLOW_PARTIAL_SEARCH_RESULTS = def(8_809_00_0);
     public static final TransportVersion NODE_VERSION_INFORMATION_WITH_MIN_READ_ONLY_INDEX_VERSION = def(8_810_00_0);
+    public static final TransportVersion ERROR_TRACE_IN_TRANSPORT_HEADER = def(8_811_00_0);
 
     /*
      * STOP! READ THIS FIRST! No, really,
diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchTransportService.java b/server/src/main/java/org/elasticsearch/action/search/SearchTransportService.java
index cfc2e1bcdaf2b..2041754bc2bcc 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchTransportService.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchTransportService.java
@@ -456,7 +456,8 @@ public static void registerRequestHandler(TransportService transportService, Sea
             (request, channel, task) -> searchService.executeQueryPhase(
                 request,
                 (SearchShardTask) task,
-                new ChannelActionListener<>(channel)
+                new ChannelActionListener<>(channel),
+                channel.getVersion()
             )
         );
         TransportActionProxy.registerProxyAction(transportService, QUERY_ID_ACTION_NAME, true, QuerySearchResult::new);
@@ -468,7 +469,8 @@ public static void registerRequestHandler(TransportService transportService, Sea
             (request, channel, task) -> searchService.executeQueryPhase(
                 request,
                 (SearchShardTask) task,
-                new ChannelActionListener<>(channel)
+                new ChannelActionListener<>(channel),
+                channel.getVersion()
             )
         );
         TransportActionProxy.registerProxyAction(transportService, QUERY_SCROLL_ACTION_NAME, true, ScrollQuerySearchResult::new);
diff --git a/server/src/main/java/org/elasticsearch/common/util/concurrent/ThreadContext.java b/server/src/main/java/org/elasticsearch/common/util/concurrent/ThreadContext.java
index a9e13b86a5159..6841cb5bead0a 100644
--- a/server/src/main/java/org/elasticsearch/common/util/concurrent/ThreadContext.java
+++ b/server/src/main/java/org/elasticsearch/common/util/concurrent/ThreadContext.java
@@ -24,6 +24,8 @@
 import org.elasticsearch.core.Releasable;
 import org.elasticsearch.core.Tuple;
 import org.elasticsearch.http.HttpTransportSettings;
+import org.elasticsearch.rest.RestController;
+import org.elasticsearch.rest.RestRequest;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.telemetry.tracing.TraceContext;
 
@@ -530,6 +532,17 @@ public String getHeader(String key) {
         return value;
     }
 
+    /**
+     * Returns the header for the given key or defaultValue if not present
+     */
+    public String getHeaderOrDefault(String key, String defaultValue) {
+        String value = getHeader(key);
+        if (value == null) {
+            return defaultValue;
+        }
+        return value;
+    }
+
     /**
      * Returns all of the request headers from the thread's context.<br>
      * <b>Be advised, headers might contain credentials.</b>
@@ -589,6 +602,14 @@ public void putHeader(Map<String, String> header) {
         threadLocal.set(threadLocal.get().putHeaders(header));
     }
 
+    public void setErrorTraceTransportHeader(RestRequest r) {
+        // set whether data nodes should send back stack trace based on the `error_trace` query parameter
+        if (r.paramAsBoolean("error_trace", RestController.ERROR_TRACE_DEFAULT)) {
+            // We only set it if error_trace is true (defaults to false) to avoid sending useless bytes
+            putHeader("error_trace", "true");
+        }
+    }
+
     /**
      * Puts a transient header object into this context
      */
diff --git a/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java b/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java
index 4564a37dacf4a..509086b982319 100644
--- a/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java
+++ b/server/src/main/java/org/elasticsearch/rest/BaseRestHandler.java
@@ -269,5 +269,4 @@ protected Set<String> responseParams() {
     protected Set<String> responseParams(RestApiVersion restApiVersion) {
         return responseParams();
     }
-
 }
diff --git a/server/src/main/java/org/elasticsearch/rest/RestController.java b/server/src/main/java/org/elasticsearch/rest/RestController.java
index 49fe794bbe615..49801499ea991 100644
--- a/server/src/main/java/org/elasticsearch/rest/RestController.java
+++ b/server/src/main/java/org/elasticsearch/rest/RestController.java
@@ -93,6 +93,7 @@ public class RestController implements HttpServerTransport.Dispatcher {
     public static final String STATUS_CODE_KEY = "es_rest_status_code";
     public static final String HANDLER_NAME_KEY = "es_rest_handler_name";
     public static final String REQUEST_METHOD_KEY = "es_rest_request_method";
+    public static final boolean ERROR_TRACE_DEFAULT = false;
 
     static {
         try (InputStream stream = RestController.class.getResourceAsStream("/config/favicon.ico")) {
@@ -638,7 +639,7 @@ private void tryAllHandlers(final RestRequest request, final RestChannel channel
     private static void validateErrorTrace(RestRequest request, RestChannel channel) {
         // error_trace cannot be used when we disable detailed errors
         // we consume the error_trace parameter first to ensure that it is always consumed
-        if (request.paramAsBoolean("error_trace", false) && channel.detailedErrorsEnabled() == false) {
+        if (request.paramAsBoolean("error_trace", ERROR_TRACE_DEFAULT) && channel.detailedErrorsEnabled() == false) {
             throw new IllegalArgumentException("error traces in responses are disabled.");
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/rest/RestResponse.java b/server/src/main/java/org/elasticsearch/rest/RestResponse.java
index d043974055667..0c359e0a4a053 100644
--- a/server/src/main/java/org/elasticsearch/rest/RestResponse.java
+++ b/server/src/main/java/org/elasticsearch/rest/RestResponse.java
@@ -37,6 +37,7 @@
 import static java.util.Collections.singletonMap;
 import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_STACK_TRACE;
 import static org.elasticsearch.rest.RestController.ELASTIC_PRODUCT_HTTP_HEADER;
+import static org.elasticsearch.rest.RestController.ERROR_TRACE_DEFAULT;
 
 public final class RestResponse implements Releasable {
 
@@ -143,7 +144,7 @@ public RestResponse(RestChannel channel, RestStatus status, Exception e) throws
         // switched in the xcontent rendering parameters.
         // For authorization problems (RestStatus.UNAUTHORIZED) we don't want to do this since this could
         // leak information to the caller who is unauthorized to make this call
-        if (params.paramAsBoolean("error_trace", false) && status != RestStatus.UNAUTHORIZED) {
+        if (params.paramAsBoolean("error_trace", ERROR_TRACE_DEFAULT) && status != RestStatus.UNAUTHORIZED) {
             params = new ToXContent.DelegatingMapParams(singletonMap(REST_EXCEPTION_SKIP_STACK_TRACE, "false"), params);
         }
 
diff --git a/server/src/main/java/org/elasticsearch/rest/action/search/RestMultiSearchAction.java b/server/src/main/java/org/elasticsearch/rest/action/search/RestMultiSearchAction.java
index 24fab92ced392..87b1a6b9c2fa8 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/search/RestMultiSearchAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/search/RestMultiSearchAction.java
@@ -72,6 +72,9 @@ public String getName() {
 
     @Override
     public RestChannelConsumer prepareRequest(final RestRequest request, final NodeClient client) throws IOException {
+        if (client.threadPool() != null && client.threadPool().getThreadContext() != null) {
+            client.threadPool().getThreadContext().setErrorTraceTransportHeader(request);
+        }
         final MultiSearchRequest multiSearchRequest = parseRequest(request, allowExplicitIndex, searchUsageHolder, clusterSupportsFeature);
         return channel -> {
             final RestCancellableNodeClient cancellableClient = new RestCancellableNodeClient(client, request.getHttpChannel());
diff --git a/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java b/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
index a9c2ff7576b05..99c11bb60b8f0 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
@@ -95,7 +95,9 @@ public Set<String> supportedCapabilities() {
 
     @Override
     public RestChannelConsumer prepareRequest(final RestRequest request, final NodeClient client) throws IOException {
-
+        if (client.threadPool() != null && client.threadPool().getThreadContext() != null) {
+            client.threadPool().getThreadContext().setErrorTraceTransportHeader(request);
+        }
         SearchRequest searchRequest = new SearchRequest();
         // access the BwC param, but just drop it
         // this might be set by old clients
diff --git a/server/src/main/java/org/elasticsearch/search/SearchService.java b/server/src/main/java/org/elasticsearch/search/SearchService.java
index b9bd398500c71..4557ccb3d2220 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchService.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchService.java
@@ -17,6 +17,8 @@
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.TopDocs;
 import org.elasticsearch.ElasticsearchException;
+import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.TransportVersion;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.ResolvedIndices;
@@ -152,6 +154,7 @@
 import java.util.function.LongSupplier;
 import java.util.function.Supplier;
 
+import static org.elasticsearch.TransportVersions.ERROR_TRACE_IN_TRANSPORT_HEADER;
 import static org.elasticsearch.core.TimeValue.timeValueHours;
 import static org.elasticsearch.core.TimeValue.timeValueMillis;
 import static org.elasticsearch.core.TimeValue.timeValueMinutes;
@@ -272,6 +275,7 @@ public class SearchService extends AbstractLifecycleComponent implements IndexEv
 
     public static final int DEFAULT_SIZE = 10;
     public static final int DEFAULT_FROM = 0;
+    private static final StackTraceElement[] EMPTY_STACK_TRACE_ARRAY = new StackTraceElement[0];
 
     private final ThreadPool threadPool;
 
@@ -506,7 +510,41 @@ protected void doClose() {
         keepAliveReaper.cancel();
     }
 
+    /**
+     * Wraps the listener to avoid sending StackTraces back to the coordinating
+     * node if the `error_trace` header is set to {@code false}. Upon reading we
+     * default to {@code true} to maintain the same behavior as before the change,
+     * due to older nodes not being able to specify whether it needs stack traces.
+     *
+     * @param <T>            the type of the response
+     * @param listener       the action listener to be wrapped
+     * @param version        channel version of the request
+     * @param threadPool     with context where to write the new header
+     * @return the wrapped action listener
+     */
+    static <T> ActionListener<T> maybeWrapListenerForStackTrace(
+        ActionListener<T> listener,
+        TransportVersion version,
+        ThreadPool threadPool
+    ) {
+        boolean header = true;
+        if (version.onOrAfter(ERROR_TRACE_IN_TRANSPORT_HEADER) && threadPool.getThreadContext() != null) {
+            header = Boolean.parseBoolean(threadPool.getThreadContext().getHeaderOrDefault("error_trace", "false"));
+        }
+        if (header == false) {
+            return listener.delegateResponse((l, e) -> {
+                ExceptionsHelper.unwrapCausesAndSuppressed(e, err -> {
+                    err.setStackTrace(EMPTY_STACK_TRACE_ARRAY);
+                    return false;
+                });
+                l.onFailure(e);
+            });
+        }
+        return listener;
+    }
+
     public void executeDfsPhase(ShardSearchRequest request, SearchShardTask task, ActionListener<SearchPhaseResult> listener) {
+        listener = maybeWrapListenerForStackTrace(listener, request.getChannelVersion(), threadPool);
         final IndexShard shard = getShard(request);
         rewriteAndFetchShardRequest(shard, request, listener.delegateFailure((l, rewritten) -> {
             // fork the execution in the search thread pool
@@ -544,10 +582,11 @@ private void loadOrExecuteQueryPhase(final ShardSearchRequest request, final Sea
     }
 
     public void executeQueryPhase(ShardSearchRequest request, SearchShardTask task, ActionListener<SearchPhaseResult> listener) {
+        ActionListener<SearchPhaseResult> finalListener = maybeWrapListenerForStackTrace(listener, request.getChannelVersion(), threadPool);
         assert request.canReturnNullResponseIfMatchNoDocs() == false || request.numberOfShards() > 1
             : "empty responses require more than one shard";
         final IndexShard shard = getShard(request);
-        rewriteAndFetchShardRequest(shard, request, listener.delegateFailure((l, orig) -> {
+        rewriteAndFetchShardRequest(shard, request, finalListener.delegateFailure((l, orig) -> {
             // check if we can shortcut the query phase entirely.
             if (orig.canReturnNullResponseIfMatchNoDocs()) {
                 assert orig.scroll() == null;
@@ -561,7 +600,7 @@ public void executeQueryPhase(ShardSearchRequest request, SearchShardTask task,
                 );
                 CanMatchShardResponse canMatchResp = canMatch(canMatchContext, false);
                 if (canMatchResp.canMatch() == false) {
-                    listener.onResponse(QuerySearchResult.nullInstance());
+                    finalListener.onResponse(QuerySearchResult.nullInstance());
                     return;
                 }
             }
@@ -736,6 +775,7 @@ private SearchPhaseResult executeQueryPhase(ShardSearchRequest request, SearchSh
     }
 
     public void executeRankFeaturePhase(RankFeatureShardRequest request, SearchShardTask task, ActionListener<RankFeatureResult> listener) {
+        listener = maybeWrapListenerForStackTrace(listener, request.getShardSearchRequest().getChannelVersion(), threadPool);
         final ReaderContext readerContext = findReaderContext(request.contextId(), request);
         final ShardSearchRequest shardSearchRequest = readerContext.getShardSearchRequest(request.getShardSearchRequest());
         final Releasable markAsUsed = readerContext.markAsUsed(getKeepAlive(shardSearchRequest));
@@ -779,8 +819,10 @@ private QueryFetchSearchResult executeFetchPhase(ReaderContext reader, SearchCon
     public void executeQueryPhase(
         InternalScrollSearchRequest request,
         SearchShardTask task,
-        ActionListener<ScrollQuerySearchResult> listener
+        ActionListener<ScrollQuerySearchResult> listener,
+        TransportVersion version
     ) {
+        listener = maybeWrapListenerForStackTrace(listener, version, threadPool);
         final LegacyReaderContext readerContext = (LegacyReaderContext) findReaderContext(request.contextId(), request);
         final Releasable markAsUsed;
         try {
@@ -816,7 +858,13 @@ public void executeQueryPhase(
      * It is the responsibility of the caller to ensure that the ref count is correctly decremented
      * when the object is no longer needed.
      */
-    public void executeQueryPhase(QuerySearchRequest request, SearchShardTask task, ActionListener<QuerySearchResult> listener) {
+    public void executeQueryPhase(
+        QuerySearchRequest request,
+        SearchShardTask task,
+        ActionListener<QuerySearchResult> listener,
+        TransportVersion version
+    ) {
+        listener = maybeWrapListenerForStackTrace(listener, version, threadPool);
         final ReaderContext readerContext = findReaderContext(request.contextId(), request.shardSearchRequest());
         final ShardSearchRequest shardSearchRequest = readerContext.getShardSearchRequest(request.shardSearchRequest());
         final Releasable markAsUsed = readerContext.markAsUsed(getKeepAlive(shardSearchRequest));
diff --git a/server/src/test/java/org/elasticsearch/rest/RestResponseTests.java b/server/src/test/java/org/elasticsearch/rest/RestResponseTests.java
index b85ad31288c8c..bd810cea216fc 100644
--- a/server/src/test/java/org/elasticsearch/rest/RestResponseTests.java
+++ b/server/src/test/java/org/elasticsearch/rest/RestResponseTests.java
@@ -51,6 +51,7 @@
 import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_STACK_TRACE;
 import static org.elasticsearch.ElasticsearchExceptionTests.assertDeepEquals;
 import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
+import static org.elasticsearch.rest.RestController.ERROR_TRACE_DEFAULT;
 import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
@@ -180,7 +181,7 @@ public void testStackTrace() throws IOException {
                     } else {
                         assertThat(response.status(), is(RestStatus.BAD_REQUEST));
                     }
-                    boolean traceExists = request.paramAsBoolean("error_trace", false) && channel.detailedErrorsEnabled();
+                    boolean traceExists = request.paramAsBoolean("error_trace", ERROR_TRACE_DEFAULT) && channel.detailedErrorsEnabled();
                     if (traceExists) {
                         assertThat(response.content().utf8ToString(), containsString(ElasticsearchException.STACK_TRACE));
                     } else {
diff --git a/server/src/test/java/org/elasticsearch/search/SearchServiceSingleNodeTests.java b/server/src/test/java/org/elasticsearch/search/SearchServiceSingleNodeTests.java
index 02593e41f5d84..0fc1694d39926 100644
--- a/server/src/test/java/org/elasticsearch/search/SearchServiceSingleNodeTests.java
+++ b/server/src/test/java/org/elasticsearch/search/SearchServiceSingleNodeTests.java
@@ -2684,7 +2684,8 @@ public void testDfsQueryPhaseRewrite() {
         service.executeQueryPhase(
             new QuerySearchRequest(null, context.id(), request, new AggregatedDfs(Map.of(), Map.of(), 10)),
             new SearchShardTask(42L, "", "", "", null, emptyMap()),
-            plainActionFuture
+            plainActionFuture,
+            TransportVersion.current()
         );
 
         plainActionFuture.actionGet();
diff --git a/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java b/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java
index 31bcab31ca8a7..d041121b8a96b 100644
--- a/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java
@@ -13,6 +13,8 @@
 import org.apache.lucene.search.IndexSearcher;
 import org.apache.lucene.search.SortField;
 import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.TransportVersion;
+import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.OriginalIndices;
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.cluster.metadata.IndexMetadata;
@@ -53,9 +55,14 @@
 
 import java.io.IOException;
 import java.util.Collections;
+import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.BiFunction;
 import java.util.function.Predicate;
 
+import static org.elasticsearch.search.SearchService.maybeWrapListenerForStackTrace;
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.Matchers.not;
+
 public class SearchServiceTests extends IndexShardTestCase {
 
     public void testCanMatchMatchAll() throws IOException {
@@ -117,6 +124,33 @@ public Type getType() {
         doTestCanMatch(searchRequest, sortField, true, null, false);
     }
 
+    public void testMaybeWrapListenerForStackTrace() {
+        // Tests that the same listener has stack trace if is not wrapped or does not have stack trace if it is wrapped.
+        AtomicBoolean isWrapped = new AtomicBoolean(false);
+        ActionListener<SearchPhaseResult> listener = new ActionListener<>() {
+            @Override
+            public void onResponse(SearchPhaseResult searchPhaseResult) {
+                // noop - we only care about failure scenarios
+            }
+
+            @Override
+            public void onFailure(Exception e) {
+                if (isWrapped.get()) {
+                    assertThat(e.getStackTrace().length, is(0));
+                } else {
+                    assertThat(e.getStackTrace().length, is(not(0)));
+                }
+            }
+        };
+        Exception e = new Exception();
+        e.fillInStackTrace();
+        assertThat(e.getStackTrace().length, is(not(0)));
+        listener.onFailure(e);
+        listener = maybeWrapListenerForStackTrace(listener, TransportVersion.current(), threadPool);
+        isWrapped.set(true);
+        listener.onFailure(e);
+    }
+
     private void doTestCanMatch(
         SearchRequest searchRequest,
         SortField sortField,
diff --git a/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/AsyncSearchErrorTraceIT.java b/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/AsyncSearchErrorTraceIT.java
new file mode 100644
index 0000000000000..39a6fa1e4b34f
--- /dev/null
+++ b/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/AsyncSearchErrorTraceIT.java
@@ -0,0 +1,222 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.search;
+
+import org.elasticsearch.ExceptionsHelper;
+import org.elasticsearch.client.Request;
+import org.elasticsearch.client.Response;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.test.ESIntegTestCase;
+import org.elasticsearch.transport.TransportMessageListener;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xcontent.XContentType;
+import org.junit.Before;
+
+import java.io.IOException;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+public class AsyncSearchErrorTraceIT extends ESIntegTestCase {
+
+    @Override
+    protected boolean addMockHttpTransport() {
+        return false; // enable http
+    }
+
+    @Override
+    protected Collection<Class<? extends Plugin>> nodePlugins() {
+        return List.of(AsyncSearch.class);
+    }
+
+    private AtomicBoolean transportMessageHasStackTrace;
+
+    @Before
+    private void setupMessageListener() {
+        internalCluster().getDataNodeInstances(TransportService.class).forEach(ts -> {
+            ts.addMessageListener(new TransportMessageListener() {
+                @Override
+                public void onResponseSent(long requestId, String action, Exception error) {
+                    TransportMessageListener.super.onResponseSent(requestId, action, error);
+                    if (action.startsWith("indices:data/read/search")) {
+                        Optional<Throwable> throwable = ExceptionsHelper.unwrapCausesAndSuppressed(
+                            error,
+                            t -> t.getStackTrace().length > 0
+                        );
+                        transportMessageHasStackTrace.set(throwable.isPresent());
+                    }
+                }
+            });
+        });
+    }
+
+    private void setupIndexWithDocs() {
+        createIndex("test1", "test2");
+        indexRandom(
+            true,
+            prepareIndex("test1").setId("1").setSource("field", "foo"),
+            prepareIndex("test2").setId("10").setSource("field", 5)
+        );
+        refresh();
+    }
+
+    public void testAsyncSearchFailingQueryErrorTraceDefault() throws IOException, InterruptedException {
+        transportMessageHasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_async_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("keep_on_completion", "true");
+        searchRequest.addParameter("wait_for_completion_timeout", "0ms");
+        Map<String, Object> responseEntity = performRequestAndGetResponseEntityAfterDelay(searchRequest, TimeValue.ZERO);
+        String asyncExecutionId = (String) responseEntity.get("id");
+        Request request = new Request("GET", "/_async_search/" + asyncExecutionId);
+        while (responseEntity.get("is_running") instanceof Boolean isRunning && isRunning) {
+            responseEntity = performRequestAndGetResponseEntityAfterDelay(request, TimeValue.timeValueSeconds(1L));
+        }
+        // check that the stack trace was not sent from the data node to the coordinating node
+        assertFalse(transportMessageHasStackTrace.get());
+    }
+
+    public void testAsyncSearchFailingQueryErrorTraceTrue() throws IOException, InterruptedException {
+        transportMessageHasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_async_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("error_trace", "true");
+        searchRequest.addParameter("keep_on_completion", "true");
+        searchRequest.addParameter("wait_for_completion_timeout", "0ms");
+        Map<String, Object> responseEntity = performRequestAndGetResponseEntityAfterDelay(searchRequest, TimeValue.ZERO);
+        String asyncExecutionId = (String) responseEntity.get("id");
+        Request request = new Request("GET", "/_async_search/" + asyncExecutionId);
+        request.addParameter("error_trace", "true");
+        while (responseEntity.get("is_running") instanceof Boolean isRunning && isRunning) {
+            responseEntity = performRequestAndGetResponseEntityAfterDelay(request, TimeValue.timeValueSeconds(1L));
+        }
+        // check that the stack trace was sent from the data node to the coordinating node
+        assertTrue(transportMessageHasStackTrace.get());
+    }
+
+    public void testAsyncSearchFailingQueryErrorTraceFalse() throws IOException, InterruptedException {
+        transportMessageHasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_async_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("error_trace", "false");
+        searchRequest.addParameter("keep_on_completion", "true");
+        searchRequest.addParameter("wait_for_completion_timeout", "0ms");
+        Map<String, Object> responseEntity = performRequestAndGetResponseEntityAfterDelay(searchRequest, TimeValue.ZERO);
+        String asyncExecutionId = (String) responseEntity.get("id");
+        Request request = new Request("GET", "/_async_search/" + asyncExecutionId);
+        request.addParameter("error_trace", "false");
+        while (responseEntity.get("is_running") instanceof Boolean isRunning && isRunning) {
+            responseEntity = performRequestAndGetResponseEntityAfterDelay(request, TimeValue.timeValueSeconds(1L));
+        }
+        // check that the stack trace was not sent from the data node to the coordinating node
+        assertFalse(transportMessageHasStackTrace.get());
+    }
+
+    public void testAsyncSearchFailingQueryErrorTraceFalseOnSubmitAndTrueOnGet() throws IOException, InterruptedException {
+        transportMessageHasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_async_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("error_trace", "false");
+        searchRequest.addParameter("keep_on_completion", "true");
+        searchRequest.addParameter("wait_for_completion_timeout", "0ms");
+        Map<String, Object> responseEntity = performRequestAndGetResponseEntityAfterDelay(searchRequest, TimeValue.ZERO);
+        String asyncExecutionId = (String) responseEntity.get("id");
+        Request request = new Request("GET", "/_async_search/" + asyncExecutionId);
+        request.addParameter("error_trace", "true");
+        while (responseEntity.get("is_running") instanceof Boolean isRunning && isRunning) {
+            responseEntity = performRequestAndGetResponseEntityAfterDelay(request, TimeValue.timeValueSeconds(1L));
+        }
+        // check that the stack trace was not sent from the data node to the coordinating node
+        assertFalse(transportMessageHasStackTrace.get());
+    }
+
+    public void testAsyncSearchFailingQueryErrorTraceTrueOnSubmitAndFalseOnGet() throws IOException, InterruptedException {
+        transportMessageHasStackTrace = new AtomicBoolean();
+        setupIndexWithDocs();
+
+        Request searchRequest = new Request("POST", "/_async_search");
+        searchRequest.setJsonEntity("""
+            {
+                "query": {
+                    "simple_query_string" : {
+                        "query": "foo",
+                        "fields": ["field"]
+                    }
+                }
+            }
+            """);
+        searchRequest.addParameter("error_trace", "true");
+        searchRequest.addParameter("keep_on_completion", "true");
+        searchRequest.addParameter("wait_for_completion_timeout", "0ms");
+        Map<String, Object> responseEntity = performRequestAndGetResponseEntityAfterDelay(searchRequest, TimeValue.ZERO);
+        String asyncExecutionId = (String) responseEntity.get("id");
+        Request request = new Request("GET", "/_async_search/" + asyncExecutionId);
+        request.addParameter("error_trace", "false");
+        while (responseEntity.get("is_running") instanceof Boolean isRunning && isRunning) {
+            responseEntity = performRequestAndGetResponseEntityAfterDelay(request, TimeValue.timeValueSeconds(1L));
+        }
+        // check that the stack trace was sent from the data node to the coordinating node
+        assertTrue(transportMessageHasStackTrace.get());
+    }
+
+    private Map<String, Object> performRequestAndGetResponseEntityAfterDelay(Request r, TimeValue sleep) throws IOException,
+        InterruptedException {
+        Thread.sleep(sleep.millis());
+        Response response = getRestClient().performRequest(r);
+        XContentType entityContentType = XContentType.fromMediaType(response.getEntity().getContentType().getValue());
+        return XContentHelper.convertToMap(entityContentType.xContent(), response.getEntity().getContent(), false);
+    }
+}
diff --git a/x-pack/plugin/async-search/src/main/java/org/elasticsearch/xpack/search/RestSubmitAsyncSearchAction.java b/x-pack/plugin/async-search/src/main/java/org/elasticsearch/xpack/search/RestSubmitAsyncSearchAction.java
index bd09d8f7740a1..952febd46c34c 100644
--- a/x-pack/plugin/async-search/src/main/java/org/elasticsearch/xpack/search/RestSubmitAsyncSearchAction.java
+++ b/x-pack/plugin/async-search/src/main/java/org/elasticsearch/xpack/search/RestSubmitAsyncSearchAction.java
@@ -55,6 +55,9 @@ public String getName() {
 
     @Override
     protected RestChannelConsumer prepareRequest(RestRequest request, NodeClient client) throws IOException {
+        if (client.threadPool() != null && client.threadPool().getThreadContext() != null) {
+            client.threadPool().getThreadContext().setErrorTraceTransportHeader(request);
+        }
         SubmitAsyncSearchRequest submit = new SubmitAsyncSearchRequest();
         IntConsumer setSize = size -> submit.getSearchRequest().source().size(size);
         // for simplicity, we share parsing with ordinary search. That means a couple of unsupported parameters, like scroll
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/ServerSentEventsRestActionListener.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/ServerSentEventsRestActionListener.java
index 3177474ea8ca6..bf94f072b6e04 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/ServerSentEventsRestActionListener.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/ServerSentEventsRestActionListener.java
@@ -43,6 +43,7 @@
 
 import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_CAUSE;
 import static org.elasticsearch.ElasticsearchException.REST_EXCEPTION_SKIP_STACK_TRACE;
+import static org.elasticsearch.rest.RestController.ERROR_TRACE_DEFAULT;
 
 /**
  * A version of {@link org.elasticsearch.rest.action.RestChunkedToXContentListener} that reads from a {@link Flow.Publisher} and encodes
@@ -161,7 +162,7 @@ private ChunkedToXContent errorChunk(Throwable t) {
             }
 
             var errorParams = p;
-            if (errorParams.paramAsBoolean("error_trace", false) && status != RestStatus.UNAUTHORIZED) {
+            if (errorParams.paramAsBoolean("error_trace", ERROR_TRACE_DEFAULT) && status != RestStatus.UNAUTHORIZED) {
                 errorParams = new ToXContent.DelegatingMapParams(
                     Map.of(REST_EXCEPTION_SKIP_STACK_TRACE, "false", REST_EXCEPTION_SKIP_CAUSE, "true"),
                     params

From 4e5b94ae033c10921a4a3ebb7274d89420d11d6b Mon Sep 17 00:00:00 2001
From: Salvatore Campagna
 <93581129+salvatore-campagna@users.noreply.github.com>
Date: Wed, 18 Dec 2024 15:38:42 +0100
Subject: [PATCH 078/119] feature: extend shard chanbes api to support data
 streams and aliases (#118937)

Extends the `/{index}/ccr/shard_changes` API to accept data stream and alias names in addition to index names.
This allows users to retrieve shard changes for data streams and indices accessed through aliases.
When a data stream is provided, the API targets the **first backing index** for retrieving shard changes.
Similarly, for an alias, the API targets the **first index** associated with the alias.
---
 .../xpack/ccr/rest/ShardChangesRestIT.java    | 140 ++++++++++++++++--
 .../ccr/rest/RestShardChangesAction.java      | 112 ++++++++++----
 2 files changed, 214 insertions(+), 38 deletions(-)

diff --git a/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java b/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java
index e5dfea7b772f2..4c61904475093 100644
--- a/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java
+++ b/x-pack/plugin/ccr/src/javaRestTest/java/org/elasticsearch/xpack/ccr/rest/ShardChangesRestIT.java
@@ -26,6 +26,9 @@
 import org.junit.ClassRule;
 
 import java.io.IOException;
+import java.time.Instant;
+import java.time.ZoneOffset;
+import java.time.format.DateTimeFormatter;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -33,11 +36,14 @@
 public class ShardChangesRestIT extends ESRestTestCase {
     private static final String CCR_SHARD_CHANGES_ENDPOINT = "/%s/ccr/shard_changes";
     private static final String BULK_INDEX_ENDPOINT = "/%s/_bulk";
+    private static final String DATA_STREAM_ENDPOINT = "/_data_stream/%s";
+    private static final String INDEX_TEMPLATE_ENDPOINT = "/_index_template/%s";
 
     private static final String[] SHARD_RESPONSE_FIELDS = new String[] {
         "took_in_millis",
         "operations",
         "shard_id",
+        "index_abstraction",
         "index",
         "settings_version",
         "max_seq_no_of_updates_or_deletes",
@@ -46,6 +52,11 @@ public class ShardChangesRestIT extends ESRestTestCase {
         "aliases_version",
         "max_seq_no",
         "global_checkpoint" };
+
+    private static final String BULK_INDEX_TEMPLATE = """
+        { "index": { "op_type": "create" } }
+        { "@timestamp": "%s", "name": "%s" }
+        """;;
     private static final String[] NAMES = { "skywalker", "leia", "obi-wan", "yoda", "chewbacca", "r2-d2", "c-3po", "darth-vader" };
     @ClassRule
     public static ElasticsearchCluster cluster = ElasticsearchCluster.local()
@@ -99,13 +110,86 @@ public void testShardChangesDefaultParams() throws IOException {
         createIndex(indexName, settings, mappings);
         assertTrue(indexExists(indexName));
 
-        assertOK(client().performRequest(bulkRequest(indexName, randomIntBetween(10, 20))));
+        assertOK(bulkIndex(indexName, randomIntBetween(10, 20)));
 
         final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
         final Response response = client().performRequest(shardChangesRequest);
         assertOK(response);
         assertShardChangesResponse(
-            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false)
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false),
+            indexName
+        );
+    }
+
+    public void testDataStreamShardChangesDefaultParams() throws IOException {
+        final String templateName = randomAlphanumericOfLength(8).toLowerCase(Locale.ROOT);
+        assertOK(createIndexTemplate(templateName, """
+            {
+              "index_patterns": [ "test-*-*" ],
+              "data_stream": {},
+              "priority": 100,
+              "template": {
+                "mappings": {
+                  "properties": {
+                    "@timestamp": {
+                      "type": "date"
+                    },
+                    "name": {
+                      "type": "keyword"
+                    }
+                  }
+                }
+              }
+            }"""));
+
+        final String dataStreamName = "test-"
+            + randomAlphanumericOfLength(5).toLowerCase(Locale.ROOT)
+            + "-"
+            + randomAlphaOfLength(5).toLowerCase(Locale.ROOT);
+        assertOK(createDataStream(dataStreamName));
+
+        assertOK(bulkIndex(dataStreamName, randomIntBetween(10, 20)));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(dataStreamName));
+        final Response response = client().performRequest(shardChangesRequest);
+        assertOK(response);
+        assertShardChangesResponse(
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false),
+            dataStreamName
+        );
+    }
+
+    public void testIndexAliasShardChangesDefaultParams() throws IOException {
+        final String indexName = randomAlphanumericOfLength(10).toLowerCase(Locale.ROOT);
+        final String aliasName = randomAlphanumericOfLength(8).toLowerCase(Locale.ROOT);
+        final Settings settings = Settings.builder()
+            .put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, 1)
+            .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
+            .put(IndexSettings.INDEX_TRANSLOG_SYNC_INTERVAL_SETTING.getKey(), "1s")
+            .build();
+        final String mappings = """
+               {
+                 "properties": {
+                   "name": {
+                     "type": "keyword"
+                   }
+                 }
+               }
+            """;
+        createIndex(indexName, settings, mappings);
+        assertTrue(indexExists(indexName));
+
+        final Request putAliasRequest = new Request("PUT", "/" + indexName + "/_alias/" + aliasName);
+        assertOK(client().performRequest(putAliasRequest));
+
+        assertOK(bulkIndex(aliasName, randomIntBetween(10, 20)));
+
+        final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(aliasName));
+        final Response response = client().performRequest(shardChangesRequest);
+        assertOK(response);
+        assertShardChangesResponse(
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false),
+            aliasName
         );
     }
 
@@ -121,7 +205,7 @@ public void testShardChangesWithAllParameters() throws IOException {
         );
         assertTrue(indexExists(indexName));
 
-        assertOK(client().performRequest(bulkRequest(indexName, randomIntBetween(100, 200))));
+        assertOK(bulkIndex(indexName, randomIntBetween(100, 200)));
 
         final Request shardChangesRequest = new Request("GET", shardChangesEndpoint(indexName));
         shardChangesRequest.addParameter("from_seq_no", "0");
@@ -132,7 +216,8 @@ public void testShardChangesWithAllParameters() throws IOException {
         final Response response = client().performRequest(shardChangesRequest);
         assertOK(response);
         assertShardChangesResponse(
-            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false)
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(response.getEntity()), false),
+            indexName
         );
     }
 
@@ -148,7 +233,7 @@ public void testShardChangesMultipleRequests() throws IOException {
         );
         assertTrue(indexExists(indexName));
 
-        assertOK(client().performRequest(bulkRequest(indexName, randomIntBetween(100, 200))));
+        assertOK(bulkIndex(indexName, randomIntBetween(100, 200)));
 
         final Request firstRequest = new Request("GET", shardChangesEndpoint(indexName));
         firstRequest.addParameter("from_seq_no", "0");
@@ -159,7 +244,8 @@ public void testShardChangesMultipleRequests() throws IOException {
         final Response firstResponse = client().performRequest(firstRequest);
         assertOK(firstResponse);
         assertShardChangesResponse(
-            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(firstResponse.getEntity()), false)
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(firstResponse.getEntity()), false),
+            indexName
         );
 
         final Request secondRequest = new Request("GET", shardChangesEndpoint(indexName));
@@ -171,7 +257,8 @@ public void testShardChangesMultipleRequests() throws IOException {
         final Response secondResponse = client().performRequest(secondRequest);
         assertOK(secondResponse);
         assertShardChangesResponse(
-            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(secondResponse.getEntity()), false)
+            XContentHelper.convertToMap(JsonXContent.jsonXContent, EntityUtils.toString(secondResponse.getEntity()), false),
+            indexName
         );
     }
 
@@ -231,17 +318,36 @@ public void testShardChangesMissingIndex() throws IOException {
         assertResponseException(ex, RestStatus.BAD_REQUEST, "Failed to process shard changes for index [" + indexName + "]");
     }
 
-    private static Request bulkRequest(final String indexName, int numberOfDocuments) {
+    private static Response bulkIndex(final String indexName, int numberOfDocuments) throws IOException {
         final StringBuilder sb = new StringBuilder();
 
+        long timestamp = System.currentTimeMillis();
         for (int i = 0; i < numberOfDocuments; i++) {
-            sb.append(String.format(Locale.ROOT, "{ \"index\": { \"_id\": \"%d\" } }\n{ \"name\": \"%s\" }\n", i + 1, randomFrom(NAMES)));
+            sb.append(
+                String.format(
+                    Locale.ROOT,
+                    BULK_INDEX_TEMPLATE,
+                    Instant.ofEpochMilli(timestamp).atOffset(ZoneOffset.UTC).format(DateTimeFormatter.ISO_OFFSET_DATE_TIME),
+                    randomFrom(NAMES)
+                )
+            );
+            timestamp += 1000; // 1 second
         }
 
         final Request request = new Request("POST", bulkEndpoint(indexName));
         request.setJsonEntity(sb.toString());
         request.addParameter("refresh", "true");
-        return request;
+        return client().performRequest(request);
+    }
+
+    private Response createDataStream(final String dataStreamName) throws IOException {
+        return client().performRequest(new Request("PUT", dataStreamEndpoint(dataStreamName)));
+    }
+
+    private static Response createIndexTemplate(final String templateName, final String mappings) throws IOException {
+        final Request request = new Request("PUT", indexTemplateEndpoint(templateName));
+        request.setJsonEntity(mappings);
+        return client().performRequest(request);
     }
 
     private static String shardChangesEndpoint(final String indexName) {
@@ -252,16 +358,28 @@ private static String bulkEndpoint(final String indexName) {
         return String.format(Locale.ROOT, BULK_INDEX_ENDPOINT, indexName);
     }
 
+    private static String dataStreamEndpoint(final String dataStreamName) {
+        return String.format(Locale.ROOT, DATA_STREAM_ENDPOINT, dataStreamName);
+    }
+
+    private static String indexTemplateEndpoint(final String templateName) {
+        return String.format(Locale.ROOT, INDEX_TEMPLATE_ENDPOINT, templateName);
+    }
+
     private void assertResponseException(final ResponseException ex, final RestStatus restStatus, final String error) {
         assertEquals(restStatus.getStatus(), ex.getResponse().getStatusLine().getStatusCode());
         assertThat(ex.getMessage(), Matchers.containsString(error));
     }
 
-    private void assertShardChangesResponse(final Map<String, Object> shardChangesResponseBody) {
+    private void assertShardChangesResponse(final Map<String, Object> shardChangesResponseBody, final String indexAbstractionName) {
         for (final String fieldName : SHARD_RESPONSE_FIELDS) {
             final Object fieldValue = shardChangesResponseBody.get(fieldName);
             assertNotNull("Field " + fieldName + " is missing or has a null value.", fieldValue);
 
+            if ("index_abstraction".equals(fieldName)) {
+                assertEquals(indexAbstractionName, fieldValue);
+            }
+
             if ("operations".equals(fieldName)) {
                 if (fieldValue instanceof List<?> operationsList) {
                     assertFalse("Field 'operations' is empty.", operationsList.isEmpty());
diff --git a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java
index 84171ebce162f..4a1d26d05a980 100644
--- a/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java
+++ b/x-pack/plugin/ccr/src/main/java/org/elasticsearch/xpack/ccr/rest/RestShardChangesAction.java
@@ -10,6 +10,8 @@
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.admin.indices.stats.ShardStats;
 import org.elasticsearch.client.internal.node.NodeClient;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.metadata.IndexAbstraction;
 import org.elasticsearch.cluster.metadata.IndexMetadata;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
@@ -32,6 +34,7 @@
 import java.util.Arrays;
 import java.util.Comparator;
 import java.util.List;
+import java.util.Locale;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.ExecutorService;
@@ -42,10 +45,14 @@
 import static org.elasticsearch.rest.RestRequest.Method.GET;
 
 /**
- * A REST handler that retrieves shard changes in a specific index whose name is provided as a parameter.
- * It handles GET requests to the "/{index}/ccr/shard_changes" endpoint retrieving shard-level changes,
- * such as translog operations, mapping version, settings version, aliases version, the global checkpoint,
- * maximum sequence number and maximum sequence number of updates or deletes.
+ * A REST handler that retrieves shard changes in a specific index, data stream or alias whose name is
+ * provided as a parameter. It handles GET requests to the "/{index}/ccr/shard_changes" endpoint retrieving
+ * shard-level changes, such as Translog operations, mapping version, settings version, aliases version,
+ * the global checkpoint, maximum sequence number and maximum sequence number of updates or deletes.
+ * <p>
+ * In the case of a data stream, the first backing index is considered the target for retrieving shard changes.
+ * In the case of an alias, the first index that the alias points to is considered the target for retrieving
+ * shard changes.
  * <p>
  * Note: This handler is only available for snapshot builds.
  */
@@ -84,32 +91,36 @@ public List<Route> routes() {
     */
     @Override
     protected RestChannelConsumer prepareRequest(final RestRequest restRequest, final NodeClient client) throws IOException {
-        final var indexName = restRequest.param(INDEX_PARAM_NAME);
+        final var indexAbstractionName = restRequest.param(INDEX_PARAM_NAME);
         final var fromSeqNo = restRequest.paramAsLong(FROM_SEQ_NO_PARAM_NAME, DEFAULT_FROM_SEQ_NO);
         final var maxBatchSize = restRequest.paramAsSize(MAX_BATCH_SIZE_PARAM_NAME, DEFAULT_MAX_BATCH_SIZE);
         final var pollTimeout = restRequest.paramAsTime(POLL_TIMEOUT_PARAM_NAME, DEFAULT_POLL_TIMEOUT);
         final var maxOperationsCount = restRequest.paramAsInt(MAX_OPERATIONS_COUNT_PARAM_NAME, DEFAULT_MAX_OPERATIONS_COUNT);
 
-        final CompletableFuture<String> indexUUIDCompletableFuture = asyncGetIndexUUID(
+        // NOTE: we first retrieve the concrete index name in case we are dealing with an alias or data stream.
+        // Then we use the concrete index name to retrieve the index UUID and shard stats.
+        final CompletableFuture<String> indexNameCompletableFuture = asyncGetIndexName(
             client,
-            indexName,
+            indexAbstractionName,
             client.threadPool().executor(Ccr.CCR_THREAD_POOL_NAME)
         );
-        final CompletableFuture<ShardStats> shardStatsCompletableFuture = asyncShardStats(
-            client,
-            indexName,
-            client.threadPool().executor(Ccr.CCR_THREAD_POOL_NAME)
+        final CompletableFuture<String> indexUUIDCompletableFuture = indexNameCompletableFuture.thenCompose(
+            concreteIndexName -> asyncGetIndexUUID(client, concreteIndexName, client.threadPool().executor(Ccr.CCR_THREAD_POOL_NAME))
+        );
+        final CompletableFuture<ShardStats> shardStatsCompletableFuture = indexNameCompletableFuture.thenCompose(
+            concreteIndexName -> asyncShardStats(client, concreteIndexName, client.threadPool().executor(Ccr.CCR_THREAD_POOL_NAME))
         );
 
         return channel -> CompletableFuture.allOf(indexUUIDCompletableFuture, shardStatsCompletableFuture).thenRun(() -> {
             try {
+                final String concreteIndexName = indexNameCompletableFuture.get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
                 final String indexUUID = indexUUIDCompletableFuture.get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
                 final ShardStats shardStats = shardStatsCompletableFuture.get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
                 final ShardId shardId = shardStats.getShardRouting().shardId();
                 final String expectedHistoryUUID = shardStats.getCommitStats().getUserData().get(Engine.HISTORY_UUID_KEY);
 
                 final ShardChangesAction.Request shardChangesRequest = shardChangesRequest(
-                    indexName,
+                    concreteIndexName,
                     indexUUID,
                     shardId,
                     expectedHistoryUUID,
@@ -121,7 +132,12 @@ protected RestChannelConsumer prepareRequest(final RestRequest restRequest, fina
                 client.execute(ShardChangesAction.INSTANCE, shardChangesRequest, new RestActionListener<>(channel) {
                     @Override
                     protected void processResponse(final ShardChangesAction.Response response) {
-                        channel.sendResponse(new RestResponse(RestStatus.OK, shardChangesResponseToXContent(response, indexName, shardId)));
+                        channel.sendResponse(
+                            new RestResponse(
+                                RestStatus.OK,
+                                shardChangesResponseToXContent(response, indexAbstractionName, concreteIndexName, shardId)
+                            )
+                        );
                     }
                 });
 
@@ -132,7 +148,12 @@ protected void processResponse(final ShardChangesAction.Response response) {
                 throw new IllegalStateException("Timeout while waiting for shard stats or index UUID", te);
             }
         }).exceptionally(ex -> {
-            channel.sendResponse(new RestResponse(RestStatus.BAD_REQUEST, "Failed to process shard changes for index [" + indexName + "]"));
+            channel.sendResponse(
+                new RestResponse(
+                    RestStatus.BAD_REQUEST,
+                    "Failed to process shard changes for index [" + indexAbstractionName + "] " + ex.getMessage()
+                )
+            );
             return null;
         });
     }
@@ -175,17 +196,20 @@ private static ShardChangesAction.Request shardChangesRequest(
      * Converts the response to XContent JSOn format.
      *
      * @param response The ShardChangesAction response.
-     * @param indexName The name of the index.
+     * @param indexAbstractionName The name of the index abstraction.
+     * @param concreteIndexName The name of the index.
      * @param shardId The ShardId.
      */
     private static XContentBuilder shardChangesResponseToXContent(
         final ShardChangesAction.Response response,
-        final String indexName,
+        final String indexAbstractionName,
+        final String concreteIndexName,
         final ShardId shardId
     ) {
         try (XContentBuilder builder = XContentFactory.jsonBuilder()) {
             builder.startObject();
-            builder.field("index", indexName);
+            builder.field("index_abstraction", indexAbstractionName);
+            builder.field("index", concreteIndexName);
             builder.field("shard_id", shardId);
             builder.field("mapping_version", response.getMappingVersion());
             builder.field("settings_version", response.getSettingsVersion());
@@ -249,26 +273,60 @@ private static <T> CompletableFuture<T> supplyAsyncTask(
         }, executorService);
     }
 
+    /**
+     * Asynchronously retrieves the index name for a given index, alias or data stream.
+     * If the name represents a data stream, the name of the first backing index is returned.
+     * If the name represents an alias, the name of the first index that the alias points to is returned.
+     *
+     * @param client The NodeClient for executing the asynchronous request.
+     * @param indexAbstractionName The name of the index, alias or data stream.
+     * @return A CompletableFuture that completes with the retrieved index name.
+     */
+    private static CompletableFuture<String> asyncGetIndexName(
+        final NodeClient client,
+        final String indexAbstractionName,
+        final ExecutorService executorService
+    ) {
+        return supplyAsyncTask(() -> {
+            final ClusterState clusterState = client.admin()
+                .cluster()
+                .prepareState(new TimeValue(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS))
+                .get(GET_INDEX_UUID_TIMEOUT)
+                .getState();
+            final IndexAbstraction indexAbstraction = clusterState.metadata().getIndicesLookup().get(indexAbstractionName);
+            if (indexAbstraction == null) {
+                throw new IllegalArgumentException(
+                    String.format(Locale.ROOT, "Invalid index or data stream name [%s]", indexAbstractionName)
+                );
+            }
+            if (indexAbstraction.getType() == IndexAbstraction.Type.DATA_STREAM
+                || indexAbstraction.getType() == IndexAbstraction.Type.ALIAS) {
+                return indexAbstraction.getIndices().getFirst().getName();
+            }
+            return indexAbstractionName;
+        }, executorService, "Error while retrieving index name for index or data stream [" + indexAbstractionName + "]");
+    }
+
     /**
      * Asynchronously retrieves the shard stats for a given index using an executor service.
      *
      * @param client The NodeClient for executing the asynchronous request.
-     * @param indexName The name of the index for which to retrieve shard statistics.
+     * @param concreteIndexName The name of the index for which to retrieve shard statistics.
      * @param executorService The executorService service for executing the asynchronous task.
      * @return A CompletableFuture that completes with the retrieved ShardStats.
      * @throws ElasticsearchException If an error occurs while retrieving shard statistics.
      */
     private static CompletableFuture<ShardStats> asyncShardStats(
         final NodeClient client,
-        final String indexName,
+        final String concreteIndexName,
         final ExecutorService executorService
     ) {
         return supplyAsyncTask(
-            () -> Arrays.stream(client.admin().indices().prepareStats(indexName).clear().get(SHARD_STATS_TIMEOUT).getShards())
+            () -> Arrays.stream(client.admin().indices().prepareStats(concreteIndexName).clear().get(SHARD_STATS_TIMEOUT).getShards())
                 .max(Comparator.comparingLong(shardStats -> shardStats.getCommitStats().getGeneration()))
-                .orElseThrow(() -> new ElasticsearchException("Unable to retrieve shard stats for index: " + indexName)),
+                .orElseThrow(() -> new ElasticsearchException("Unable to retrieve shard stats for index: " + concreteIndexName)),
             executorService,
-            "Error while retrieving shard stats for index [" + indexName + "]"
+            "Error while retrieving shard stats for index [" + concreteIndexName + "]"
         );
     }
 
@@ -276,25 +334,25 @@ private static CompletableFuture<ShardStats> asyncShardStats(
      * Asynchronously retrieves the index UUID for a given index using an executor service.
      *
      * @param client The NodeClient for executing the asynchronous request.
-     * @param indexName The name of the index for which to retrieve the index UUID.
+     * @param concreteIndexName The name of the index for which to retrieve the index UUID.
      * @param executorService The executorService service for executing the asynchronous task.
      * @return A CompletableFuture that completes with the retrieved index UUID.
      * @throws ElasticsearchException If an error occurs while retrieving the index UUID.
      */
     private static CompletableFuture<String> asyncGetIndexUUID(
         final NodeClient client,
-        final String indexName,
+        final String concreteIndexName,
         final ExecutorService executorService
     ) {
         return supplyAsyncTask(
             () -> client.admin()
                 .indices()
                 .prepareGetIndex()
-                .setIndices(indexName)
+                .setIndices(concreteIndexName)
                 .get(GET_INDEX_UUID_TIMEOUT)
-                .getSetting(indexName, IndexMetadata.SETTING_INDEX_UUID),
+                .getSetting(concreteIndexName, IndexMetadata.SETTING_INDEX_UUID),
             executorService,
-            "Error while retrieving index UUID for index [" + indexName + "]"
+            "Error while retrieving index UUID for index [" + concreteIndexName + "]"
         );
     }
 }

From 31578be7502c267e11bed31af064b857bbd2d490 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 01:43:17 +1100
Subject: [PATCH 079/119] Mute
 org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
 org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
 #118970

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index b35a70391f195..6b433f232defd 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -295,6 +295,8 @@ tests:
 - class: org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatusTests
   method: testEqualsAndHashcode
   issue: https://github.com/elastic/elasticsearch/issues/118965
+- class: org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
+  issue: https://github.com/elastic/elasticsearch/issues/118970
 
 # Examples:
 #

From 1141edee4797f772a542528a296df2d802b50122 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Wed, 18 Dec 2024 15:49:53 +0100
Subject: [PATCH 080/119] Fix "create index with use_synthetic_source" yaml
 test. (#118946)

The `flush` param defaults to `true` and some environments don't support that.
Setting `flush` param to `false` to fix this.

```
[2024-12-18T19:51:01,213][INFO ][c.e.e.q.r.ServerlessClientYamlTestSuiteIT] [test] Stash dump on test failure [{
  "stash" : {
    "body" : {
      "_shards" : {
        "total" : 3,
        "successful" : 0,
        "failed" : 3,
        "failures" : [
          {
            "shard" : 0,
            "index" : "test",
            "status" : "BAD_REQUEST",
            "reason" : {
              "type" : "illegal_argument_exception",
              "reason" : "Search engine does not support acquiring last index commit with flush_first"
            }
          }
        ]
      }
    }
  }
}]
```
---
 .../test/indices.create/20_synthetic_source.yml              | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml
index fc0bfa144bbc4..edb684168278b 100644
--- a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml
+++ b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/indices.create/20_synthetic_source.yml
@@ -2049,5 +2049,6 @@ create index with use_synthetic_source:
       indices.disk_usage:
         index: test
         run_expensive_tasks: true
-  - gt: { test.fields.field.total_in_bytes: 0 }
-  - is_false: test.fields.field._recovery_source
+        flush: false
+  - gt: { test.store_size_in_bytes: 0 }
+  - is_false: test.fields._recovery_source

From e0f4b01fb8655c82e1b62dcb07973016ed411297 Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Wed, 18 Dec 2024 08:56:39 -0600
Subject: [PATCH 081/119] Fixing ReindexDataStreamStatusTests so that the in
 progress set max size is not less than min size (#118957)

It is currently possible when we mutate a status object that we ask for
a random set for the inProgress field where the max size of the set is
less than the min size. This fixes that.
---
 .../migrate/task/ReindexDataStreamEnrichedStatusTests.java      | 2 +-
 .../xpack/migrate/task/ReindexDataStreamStatusTests.java        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java
index acd8cd1a6add2..993db1096aac2 100644
--- a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamEnrichedStatusTests.java
@@ -74,7 +74,7 @@ private List<String> randomList(int minSize) {
     }
 
     private Set<String> randomSet(int minSize) {
-        return randomSet(minSize, 100, () -> randomAlphaOfLength(50));
+        return randomSet(minSize, Math.max(minSize, 100), () -> randomAlphaOfLength(50));
     }
 
     private List<Tuple<String, Exception>> randomErrorList() {
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java
index 47e2d02bee3b0..ad47eb6a23cd7 100644
--- a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamStatusTests.java
@@ -70,7 +70,7 @@ private List<String> randomList(int minSize) {
     }
 
     private Set<String> randomSet(int minSize) {
-        return randomSet(minSize, 100, () -> randomAlphaOfLength(50));
+        return randomSet(minSize, Math.max(minSize, 100), () -> randomAlphaOfLength(50));
     }
 
     private List<Tuple<String, Exception>> randomErrorList() {

From 8a8dfe8f688ea0d1291f1bc5b82a3d1fe12c7c59 Mon Sep 17 00:00:00 2001
From: Sean Story <sean.story@elastic.co>
Date: Wed, 18 Dec 2024 09:44:52 -0600
Subject: [PATCH 082/119] Delete accidentally added file, and gitignore
 (#118971)

---
 .gitignore    | 3 +++
 .java-version | 1 -
 2 files changed, 3 insertions(+), 1 deletion(-)
 delete mode 100644 .java-version

diff --git a/.gitignore b/.gitignore
index d1af97cbaea3b..8b2da4dc0832a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -69,3 +69,6 @@ testfixtures_shared/
 # Generated
 checkstyle_ide.xml
 x-pack/plugin/esql/src/main/generated-src/generated/
+
+# JEnv
+.java-version
diff --git a/.java-version b/.java-version
deleted file mode 100644
index aabe6ec3909c9..0000000000000
--- a/.java-version
+++ /dev/null
@@ -1 +0,0 @@
-21

From cf73860b583e14c11eab28197b15b247236e4021 Mon Sep 17 00:00:00 2001
From: Simon Cooper <simon.cooper@elastic.co>
Date: Wed, 18 Dec 2024 15:57:12 +0000
Subject: [PATCH 083/119] Revert "Remove pre-7.2 token serialization support
 (#118057)" (#118967)

* Revert "Remove pre-7.2 token serialization support (#118057)"

This reverts commit ec66857ca13e2f5e7f9088a30aa48ea5ddab17fa.
* Add missing constant
---
 .../org/elasticsearch/TransportVersions.java  |   3 +
 .../security/SecurityFeatureSetUsage.java     |  12 +-
 .../support/TokensInvalidationResult.java     |   6 +
 .../security/authc/TokenAuthIntegTests.java   |  37 +--
 .../xpack/security/authc/TokenService.java    | 236 ++++++++++++-----
 .../security/authc/TokenServiceTests.java     | 241 +++++++++++++++++-
 6 files changed, 447 insertions(+), 88 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/TransportVersions.java b/server/src/main/java/org/elasticsearch/TransportVersions.java
index 388123e86c882..fd8a3987cf4d3 100644
--- a/server/src/main/java/org/elasticsearch/TransportVersions.java
+++ b/server/src/main/java/org/elasticsearch/TransportVersions.java
@@ -52,7 +52,10 @@ static TransportVersion def(int id) {
     @UpdateForV9(owner = UpdateForV9.Owner.CORE_INFRA) // remove the transport versions with which v9 will not need to interact
     public static final TransportVersion ZERO = def(0);
     public static final TransportVersion V_7_0_0 = def(7_00_00_99);
+    public static final TransportVersion V_7_1_0 = def(7_01_00_99);
+    public static final TransportVersion V_7_2_0 = def(7_02_00_99);
     public static final TransportVersion V_7_3_0 = def(7_03_00_99);
+    public static final TransportVersion V_7_3_2 = def(7_03_02_99);
     public static final TransportVersion V_7_4_0 = def(7_04_00_99);
     public static final TransportVersion V_7_6_0 = def(7_06_00_99);
     public static final TransportVersion V_7_7_0 = def(7_07_00_99);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java
index f44409daa37f8..3ebfad04a0f13 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java
@@ -55,8 +55,10 @@ public SecurityFeatureSetUsage(StreamInput in) throws IOException {
         realmsUsage = in.readGenericMap();
         rolesStoreUsage = in.readGenericMap();
         sslUsage = in.readGenericMap();
-        tokenServiceUsage = in.readGenericMap();
-        apiKeyServiceUsage = in.readGenericMap();
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_7_2_0)) {
+            tokenServiceUsage = in.readGenericMap();
+            apiKeyServiceUsage = in.readGenericMap();
+        }
         auditUsage = in.readGenericMap();
         ipFilterUsage = in.readGenericMap();
         anonymousUsage = in.readGenericMap();
@@ -121,8 +123,10 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeGenericMap(realmsUsage);
         out.writeGenericMap(rolesStoreUsage);
         out.writeGenericMap(sslUsage);
-        out.writeGenericMap(tokenServiceUsage);
-        out.writeGenericMap(apiKeyServiceUsage);
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_7_2_0)) {
+            out.writeGenericMap(tokenServiceUsage);
+            out.writeGenericMap(apiKeyServiceUsage);
+        }
         out.writeGenericMap(auditUsage);
         out.writeGenericMap(ipFilterUsage);
         out.writeGenericMap(anonymousUsage);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java
index 59c16fc8a7a72..8fe018a825468 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java
@@ -59,6 +59,9 @@ public TokensInvalidationResult(StreamInput in) throws IOException {
         this.invalidatedTokens = in.readStringCollectionAsList();
         this.previouslyInvalidatedTokens = in.readStringCollectionAsList();
         this.errors = in.readCollectionAsList(StreamInput::readException);
+        if (in.getTransportVersion().before(TransportVersions.V_7_2_0)) {
+            in.readVInt();
+        }
         if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_0_0)) {
             this.restStatus = RestStatus.readFrom(in);
         }
@@ -108,6 +111,9 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeStringCollection(invalidatedTokens);
         out.writeStringCollection(previouslyInvalidatedTokens);
         out.writeCollection(errors, StreamOutput::writeException);
+        if (out.getTransportVersion().before(TransportVersions.V_7_2_0)) {
+            out.writeVInt(5);
+        }
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_0_0)) {
             RestStatus.writeTo(out, restStatus);
         }
diff --git a/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java b/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
index b56ea7ae3e456..fef1a98ca67e9 100644
--- a/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
+++ b/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
@@ -327,8 +327,8 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
             ResponseException.class,
             () -> invalidateAccessToken(
                 tokenService.prependVersionAndEncodeAccessToken(
-                    TransportVersions.MINIMUM_COMPATIBLE,
-                    tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, randomBoolean()).v1()
+                    TransportVersions.V_7_3_2,
+                    tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, randomBoolean()).v1()
                 )
             )
         );
@@ -347,7 +347,7 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
         byte[] longerAccessToken = new byte[randomIntBetween(17, 24)];
         random().nextBytes(longerAccessToken);
         invalidateResponse = invalidateAccessToken(
-            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.MINIMUM_COMPATIBLE, longerAccessToken)
+            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.V_7_3_2, longerAccessToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -365,7 +365,7 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
         byte[] shorterAccessToken = new byte[randomIntBetween(12, 15)];
         random().nextBytes(shorterAccessToken);
         invalidateResponse = invalidateAccessToken(
-            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.MINIMUM_COMPATIBLE, shorterAccessToken)
+            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.V_7_3_2, shorterAccessToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -394,8 +394,8 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
 
         invalidateResponse = invalidateAccessToken(
             tokenService.prependVersionAndEncodeAccessToken(
-                TransportVersions.MINIMUM_COMPATIBLE,
-                tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, randomBoolean()).v1()
+                TransportVersions.V_7_3_2,
+                tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, randomBoolean()).v1()
             )
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
@@ -420,8 +420,8 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
             ResponseException.class,
             () -> invalidateRefreshToken(
                 TokenService.prependVersionAndEncodeRefreshToken(
-                    TransportVersions.MINIMUM_COMPATIBLE,
-                    tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, true).v2()
+                    TransportVersions.V_7_3_2,
+                    tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, true).v2()
                 )
             )
         );
@@ -441,7 +441,7 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
         byte[] longerRefreshToken = new byte[randomIntBetween(17, 24)];
         random().nextBytes(longerRefreshToken);
         invalidateResponse = invalidateRefreshToken(
-            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.MINIMUM_COMPATIBLE, longerRefreshToken)
+            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.V_7_3_2, longerRefreshToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -459,7 +459,7 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
         byte[] shorterRefreshToken = new byte[randomIntBetween(12, 15)];
         random().nextBytes(shorterRefreshToken);
         invalidateResponse = invalidateRefreshToken(
-            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.MINIMUM_COMPATIBLE, shorterRefreshToken)
+            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.V_7_3_2, shorterRefreshToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -488,8 +488,8 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
 
         invalidateResponse = invalidateRefreshToken(
             TokenService.prependVersionAndEncodeRefreshToken(
-                TransportVersions.MINIMUM_COMPATIBLE,
-                tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, true).v2()
+                TransportVersions.V_7_3_2,
+                tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, true).v2()
             )
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
@@ -758,11 +758,18 @@ public void testAuthenticateWithWrongToken() throws Exception {
         assertAuthenticateWithToken(response.accessToken(), TEST_USER_NAME);
         // Now attempt to authenticate with an invalid access token string
         assertUnauthorizedToken(randomAlphaOfLengthBetween(0, 128));
-        // Now attempt to authenticate with an invalid access token with valid structure (after 8.0 pre 8.10)
+        // Now attempt to authenticate with an invalid access token with valid structure (pre 7.2)
         assertUnauthorizedToken(
             tokenService.prependVersionAndEncodeAccessToken(
-                TransportVersions.V_8_0_0,
-                tokenService.getRandomTokenBytes(TransportVersions.V_8_0_0, randomBoolean()).v1()
+                TransportVersions.V_7_1_0,
+                tokenService.getRandomTokenBytes(TransportVersions.V_7_1_0, randomBoolean()).v1()
+            )
+        );
+        // Now attempt to authenticate with an invalid access token with valid structure (after 7.2 pre 8.10)
+        assertUnauthorizedToken(
+            tokenService.prependVersionAndEncodeAccessToken(
+                TransportVersions.V_7_4_0,
+                tokenService.getRandomTokenBytes(TransportVersions.V_7_4_0, randomBoolean()).v1()
             )
         );
         // Now attempt to authenticate with an invalid access token with valid structure (current version)
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
index 900436a1fd874..4f7ba7808b823 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
@@ -48,7 +48,9 @@
 import org.elasticsearch.common.cache.CacheBuilder;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.io.stream.InputStreamStreamInput;
+import org.elasticsearch.common.io.stream.OutputStreamStreamOutput;
 import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Setting.Property;
@@ -57,6 +59,7 @@
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.core.Nullable;
+import org.elasticsearch.core.Streams;
 import org.elasticsearch.core.SuppressForbidden;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.core.Tuple;
@@ -90,8 +93,10 @@
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 
 import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
 import java.io.Closeable;
 import java.io.IOException;
+import java.io.OutputStream;
 import java.io.UncheckedIOException;
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
@@ -127,6 +132,7 @@
 
 import javax.crypto.Cipher;
 import javax.crypto.CipherInputStream;
+import javax.crypto.CipherOutputStream;
 import javax.crypto.NoSuchPaddingException;
 import javax.crypto.SecretKey;
 import javax.crypto.SecretKeyFactory;
@@ -195,8 +201,14 @@ public class TokenService {
     // UUIDs are 16 bytes encoded base64 without padding, therefore the length is (16 / 3) * 4 + ((16 % 3) * 8 + 5) / 6 chars
     private static final int TOKEN_LENGTH = 22;
     private static final String TOKEN_DOC_ID_PREFIX = TOKEN_DOC_TYPE + "_";
+    static final int LEGACY_MINIMUM_BYTES = VERSION_BYTES + SALT_BYTES + IV_BYTES + 1;
     static final int MINIMUM_BYTES = VERSION_BYTES + TOKEN_LENGTH + 1;
+    static final int LEGACY_MINIMUM_BASE64_BYTES = Double.valueOf(Math.ceil((4 * LEGACY_MINIMUM_BYTES) / 3)).intValue();
     public static final int MINIMUM_BASE64_BYTES = Double.valueOf(Math.ceil((4 * MINIMUM_BYTES) / 3)).intValue();
+    static final TransportVersion VERSION_HASHED_TOKENS = TransportVersions.V_7_2_0;
+    static final TransportVersion VERSION_TOKENS_INDEX_INTRODUCED = TransportVersions.V_7_2_0;
+    static final TransportVersion VERSION_ACCESS_TOKENS_AS_UUIDS = TransportVersions.V_7_2_0;
+    static final TransportVersion VERSION_MULTIPLE_CONCURRENT_REFRESHES = TransportVersions.V_7_2_0;
     static final TransportVersion VERSION_CLIENT_AUTH_FOR_REFRESH = TransportVersions.V_8_2_0;
     static final TransportVersion VERSION_GET_TOKEN_DOC_FOR_REFRESH = TransportVersions.V_8_10_X;
 
@@ -261,7 +273,8 @@ public TokenService(
 
     /**
      * Creates an access token and optionally a refresh token as well, based on the provided authentication and metadata with
-     * auto-generated values. The created tokens are stored a specific security tokens index.
+     * auto-generated values. The created tokens are stored in the security index for versions up to
+     * {@link #VERSION_TOKENS_INDEX_INTRODUCED} and to a specific security tokens index for later versions.
      */
     public void createOAuth2Tokens(
         Authentication authentication,
@@ -278,7 +291,8 @@ public void createOAuth2Tokens(
 
     /**
      * Creates an access token and optionally a refresh token as well from predefined values, based on the provided authentication and
-     * metadata. The created tokens are stored in a specific security tokens index.
+     * metadata. The created tokens are stored in the security index for versions up to {@link #VERSION_TOKENS_INDEX_INTRODUCED} and to a
+     * specific security tokens index for later versions.
      */
     // public for testing
     public void createOAuth2Tokens(
@@ -300,15 +314,21 @@ public void createOAuth2Tokens(
      *
      * @param accessTokenBytes      The predefined seed value for the access token. This will then be
      *                              <ul>
-     *                                <li> Hashed before stored </li>
-     *                                <li> Stored in a specific security tokens index </li>
+     *                                <li> Encrypted before stored for versions before {@link #VERSION_TOKENS_INDEX_INTRODUCED} </li>
+     *                                <li> Hashed before stored for versions after {@link #VERSION_TOKENS_INDEX_INTRODUCED} </li>
+     *                                <li> Stored in the security index for versions up to {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
+     *                                <li> Stored in a specific security tokens index for versions after
+     *                                {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
      *                                <li> Prepended with a version ID and Base64 encoded before returned to the caller of the APIs</li>
      *                              </ul>
      * @param refreshTokenBytes     The predefined seed value for the access token. This will then be
      *                              <ul>
-     *                                <li> Hashed before stored </li>
-     *                                <li> Stored in a specific security tokens index </li>
-     *                                <li> Prepended with a version ID and Base64 encoded before returned to the caller of the APIs </li>
+     *                                <li> Hashed before stored for versions after {@link #VERSION_TOKENS_INDEX_INTRODUCED} </li>
+     *                                <li> Stored in the security index for versions up to {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
+     *                                <li> Stored in a specific security tokens index for versions after
+     *                                {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
+     *                                <li> Prepended with a version ID and encoded with Base64 before returned to the caller of the APIs
+     *                                for versions after {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
      *                              </ul>
      * @param tokenVersion          The version of the nodes with which these tokens will be compatible.
      * @param authentication        The authentication object representing the user for which the tokens are created
@@ -364,7 +384,7 @@ private void createOAuth2Tokens(
                     } else {
                         refreshTokenToStore = refreshTokenToReturn = null;
                     }
-                } else {
+                } else if (tokenVersion.onOrAfter(VERSION_HASHED_TOKENS)) {
                     assert accessTokenBytes.length == RAW_TOKEN_BYTES_LENGTH;
                     userTokenId = hashTokenString(Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes));
                     accessTokenToStore = null;
@@ -375,6 +395,18 @@ private void createOAuth2Tokens(
                     } else {
                         refreshTokenToStore = refreshTokenToReturn = null;
                     }
+                } else {
+                    assert accessTokenBytes.length == RAW_TOKEN_BYTES_LENGTH;
+                    userTokenId = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes);
+                    accessTokenToStore = null;
+                    if (refreshTokenBytes != null) {
+                        assert refreshTokenBytes.length == RAW_TOKEN_BYTES_LENGTH;
+                        refreshTokenToStore = refreshTokenToReturn = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(
+                            refreshTokenBytes
+                        );
+                    } else {
+                        refreshTokenToStore = refreshTokenToReturn = null;
+                    }
                 }
                 UserToken userToken = new UserToken(userTokenId, tokenVersion, tokenAuth, getExpirationTime(), metadata);
                 tokenDocument = createTokenDocument(userToken, accessTokenToStore, refreshTokenToStore, originatingClientAuth);
@@ -387,22 +419,23 @@ private void createOAuth2Tokens(
             final RefreshPolicy tokenCreationRefreshPolicy = tokenVersion.onOrAfter(VERSION_GET_TOKEN_DOC_FOR_REFRESH)
                 ? RefreshPolicy.NONE
                 : RefreshPolicy.WAIT_UNTIL;
+            final SecurityIndexManager tokensIndex = getTokensIndexForVersion(tokenVersion);
             logger.debug(
                 () -> format(
                     "Using refresh policy [%s] when creating token doc [%s] in the security index [%s]",
                     tokenCreationRefreshPolicy,
                     documentId,
-                    securityTokensIndex.aliasName()
+                    tokensIndex.aliasName()
                 )
             );
-            final IndexRequest indexTokenRequest = client.prepareIndex(securityTokensIndex.aliasName())
+            final IndexRequest indexTokenRequest = client.prepareIndex(tokensIndex.aliasName())
                 .setId(documentId)
                 .setOpType(OpType.CREATE)
                 .setSource(tokenDocument, XContentType.JSON)
                 .setRefreshPolicy(tokenCreationRefreshPolicy)
                 .request();
-            securityTokensIndex.prepareIndexIfNeededThenExecute(
-                ex -> listener.onFailure(traceLog("prepare tokens index [" + securityTokensIndex.aliasName() + "]", documentId, ex)),
+            tokensIndex.prepareIndexIfNeededThenExecute(
+                ex -> listener.onFailure(traceLog("prepare tokens index [" + tokensIndex.aliasName() + "]", documentId, ex)),
                 () -> executeAsyncWithOrigin(
                     client,
                     SECURITY_ORIGIN,
@@ -521,16 +554,17 @@ private void getTokenDocById(
         @Nullable String storedRefreshToken,
         ActionListener<Doc> listener
     ) {
-        final SecurityIndexManager frozenTokensIndex = securityTokensIndex.defensiveCopy();
+        final SecurityIndexManager tokensIndex = getTokensIndexForVersion(tokenVersion);
+        final SecurityIndexManager frozenTokensIndex = tokensIndex.defensiveCopy();
         if (frozenTokensIndex.isAvailable(PRIMARY_SHARDS) == false) {
-            logger.warn("failed to get access token [{}] because index [{}] is not available", tokenId, securityTokensIndex.aliasName());
+            logger.warn("failed to get access token [{}] because index [{}] is not available", tokenId, tokensIndex.aliasName());
             listener.onFailure(frozenTokensIndex.getUnavailableReason(PRIMARY_SHARDS));
             return;
         }
-        final GetRequest getRequest = client.prepareGet(securityTokensIndex.aliasName(), getTokenDocumentId(tokenId)).request();
+        final GetRequest getRequest = client.prepareGet(tokensIndex.aliasName(), getTokenDocumentId(tokenId)).request();
         final Consumer<Exception> onFailure = ex -> listener.onFailure(traceLog("get token from id", tokenId, ex));
-        securityTokensIndex.checkIndexVersionThenExecute(
-            ex -> listener.onFailure(traceLog("prepare tokens index [" + securityTokensIndex.aliasName() + "]", tokenId, ex)),
+        tokensIndex.checkIndexVersionThenExecute(
+            ex -> listener.onFailure(traceLog("prepare tokens index [" + tokensIndex.aliasName() + "]", tokenId, ex)),
             () -> executeAsyncWithOrigin(
                 client.threadPool().getThreadContext(),
                 SECURITY_ORIGIN,
@@ -576,11 +610,7 @@ private void getTokenDocById(
                     // if the index or the shard is not there / available we assume that
                     // the token is not valid
                     if (isShardNotAvailableException(e)) {
-                        logger.warn(
-                            "failed to get token doc [{}] because index [{}] is not available",
-                            tokenId,
-                            securityTokensIndex.aliasName()
-                        );
+                        logger.warn("failed to get token doc [{}] because index [{}] is not available", tokenId, tokensIndex.aliasName());
                     } else {
                         logger.error(() -> "failed to get token doc [" + tokenId + "]", e);
                     }
@@ -620,7 +650,7 @@ void decodeToken(String token, boolean validateUserToken, ActionListener<UserTok
                 final String userTokenId = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(userTokenIdDigest.digest());
                 final String storedAccessToken = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(sha256().digest(accessTokenBytes));
                 getAndValidateUserToken(userTokenId, version, storedAccessToken, validateUserToken, listener);
-            } else {
+            } else if (version.onOrAfter(VERSION_ACCESS_TOKENS_AS_UUIDS)) {
                 // The token was created in a > VERSION_ACCESS_TOKENS_UUIDS cluster
                 if (in.available() < MINIMUM_BYTES) {
                     logger.debug("invalid token, smaller than [{}] bytes", MINIMUM_BYTES);
@@ -630,6 +660,41 @@ void decodeToken(String token, boolean validateUserToken, ActionListener<UserTok
                 final String accessToken = in.readString();
                 final String userTokenId = hashTokenString(accessToken);
                 getAndValidateUserToken(userTokenId, version, null, validateUserToken, listener);
+            } else {
+                // The token was created in a < VERSION_ACCESS_TOKENS_UUIDS cluster so we need to decrypt it to get the tokenId
+                if (in.available() < LEGACY_MINIMUM_BYTES) {
+                    logger.debug("invalid token, smaller than [{}] bytes", LEGACY_MINIMUM_BYTES);
+                    listener.onResponse(null);
+                    return;
+                }
+                final BytesKey decodedSalt = new BytesKey(in.readByteArray());
+                final BytesKey passphraseHash = new BytesKey(in.readByteArray());
+                final byte[] iv = in.readByteArray();
+                final BytesStreamOutput out = new BytesStreamOutput();
+                Streams.copy(in, out);
+                final byte[] encryptedTokenId = BytesReference.toBytes(out.bytes());
+                final KeyAndCache keyAndCache = keyCache.get(passphraseHash);
+                if (keyAndCache != null) {
+                    getKeyAsync(decodedSalt, keyAndCache, ActionListener.wrap(decodeKey -> {
+                        if (decodeKey != null) {
+                            try {
+                                final Cipher cipher = getDecryptionCipher(iv, decodeKey, version, decodedSalt);
+                                final String tokenId = decryptTokenId(encryptedTokenId, cipher, version);
+                                getAndValidateUserToken(tokenId, version, null, validateUserToken, listener);
+                            } catch (IOException | GeneralSecurityException e) {
+                                // could happen with a token that is not ours
+                                logger.warn("invalid token", e);
+                                listener.onResponse(null);
+                            }
+                        } else {
+                            // could happen with a token that is not ours
+                            listener.onResponse(null);
+                        }
+                    }, listener::onFailure));
+                } else {
+                    logger.debug(() -> format("invalid key %s key: %s", passphraseHash, keyCache.cache.keySet()));
+                    listener.onResponse(null);
+                }
             }
         } catch (Exception e) {
             // could happen with a token that is not ours
@@ -787,7 +852,11 @@ private void indexInvalidation(
         final Set<String> idsOfOlderTokens = new HashSet<>();
         boolean anyOlderTokensBeforeRefreshViaGet = false;
         for (UserToken userToken : userTokens) {
-            idsOfRecentTokens.add(userToken.getId());
+            if (userToken.getTransportVersion().onOrAfter(VERSION_TOKENS_INDEX_INTRODUCED)) {
+                idsOfRecentTokens.add(userToken.getId());
+            } else {
+                idsOfOlderTokens.add(userToken.getId());
+            }
             anyOlderTokensBeforeRefreshViaGet |= userToken.getTransportVersion().before(VERSION_GET_TOKEN_DOC_FOR_REFRESH);
         }
         final RefreshPolicy tokensInvalidationRefreshPolicy = anyOlderTokensBeforeRefreshViaGet
@@ -1055,7 +1124,7 @@ private void findTokenFromRefreshToken(String refreshToken, Iterator<TimeValue>
                         );
                         getTokenDocById(userTokenId, version, null, storedRefreshToken, listener);
                     }
-                } else {
+                } else if (version.onOrAfter(VERSION_HASHED_TOKENS)) {
                     final String unencodedRefreshToken = in.readString();
                     if (unencodedRefreshToken.length() != TOKEN_LENGTH) {
                         logger.debug("Decoded refresh token [{}] with version [{}] is invalid.", unencodedRefreshToken, version);
@@ -1064,6 +1133,9 @@ private void findTokenFromRefreshToken(String refreshToken, Iterator<TimeValue>
                         final String hashedRefreshToken = hashTokenString(unencodedRefreshToken);
                         findTokenFromRefreshToken(hashedRefreshToken, securityTokensIndex, backoff, listener);
                     }
+                } else {
+                    logger.debug("Unrecognized refresh token version [{}].", version);
+                    listener.onResponse(null);
                 }
             } catch (IOException e) {
                 logger.debug(() -> "Could not decode refresh token [" + refreshToken + "].", e);
@@ -1178,6 +1250,7 @@ private void innerRefresh(
             return;
         }
         final RefreshTokenStatus refreshTokenStatus = checkRefreshResult.v1();
+        final SecurityIndexManager refreshedTokenIndex = getTokensIndexForVersion(refreshTokenStatus.getTransportVersion());
         if (refreshTokenStatus.isRefreshed()) {
             logger.debug(
                 "Token document [{}] was recently refreshed, when a new token document was generated. Reusing that result.",
@@ -1185,29 +1258,31 @@ private void innerRefresh(
             );
             final Tuple<UserToken, String> parsedTokens = parseTokensFromDocument(tokenDoc.sourceAsMap(), null);
             Authentication authentication = parsedTokens.v1().getAuthentication();
-            decryptAndReturnSupersedingTokens(refreshToken, refreshTokenStatus, securityTokensIndex, authentication, listener);
+            decryptAndReturnSupersedingTokens(refreshToken, refreshTokenStatus, refreshedTokenIndex, authentication, listener);
         } else {
             final TransportVersion newTokenVersion = getTokenVersionCompatibility();
             final Tuple<byte[], byte[]> newTokenBytes = getRandomTokenBytes(newTokenVersion, true);
             final Map<String, Object> updateMap = new HashMap<>();
             updateMap.put("refreshed", true);
-            updateMap.put("refresh_time", clock.instant().toEpochMilli());
-            try {
-                final byte[] iv = getRandomBytes(IV_BYTES);
-                final byte[] salt = getRandomBytes(SALT_BYTES);
-                String encryptedAccessAndRefreshToken = encryptSupersedingTokens(
-                    newTokenBytes.v1(),
-                    newTokenBytes.v2(),
-                    refreshToken,
-                    iv,
-                    salt
-                );
-                updateMap.put("superseding.encrypted_tokens", encryptedAccessAndRefreshToken);
-                updateMap.put("superseding.encryption_iv", Base64.getEncoder().encodeToString(iv));
-                updateMap.put("superseding.encryption_salt", Base64.getEncoder().encodeToString(salt));
-            } catch (GeneralSecurityException e) {
-                logger.warn("could not encrypt access token and refresh token string", e);
-                onFailure.accept(invalidGrantException("could not refresh the requested token"));
+            if (newTokenVersion.onOrAfter(VERSION_MULTIPLE_CONCURRENT_REFRESHES)) {
+                updateMap.put("refresh_time", clock.instant().toEpochMilli());
+                try {
+                    final byte[] iv = getRandomBytes(IV_BYTES);
+                    final byte[] salt = getRandomBytes(SALT_BYTES);
+                    String encryptedAccessAndRefreshToken = encryptSupersedingTokens(
+                        newTokenBytes.v1(),
+                        newTokenBytes.v2(),
+                        refreshToken,
+                        iv,
+                        salt
+                    );
+                    updateMap.put("superseding.encrypted_tokens", encryptedAccessAndRefreshToken);
+                    updateMap.put("superseding.encryption_iv", Base64.getEncoder().encodeToString(iv));
+                    updateMap.put("superseding.encryption_salt", Base64.getEncoder().encodeToString(salt));
+                } catch (GeneralSecurityException e) {
+                    logger.warn("could not encrypt access token and refresh token string", e);
+                    onFailure.accept(invalidGrantException("could not refresh the requested token"));
+                }
             }
             assert tokenDoc.seqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO : "expected an assigned sequence number";
             assert tokenDoc.primaryTerm() != SequenceNumbers.UNASSIGNED_PRIMARY_TERM : "expected an assigned primary term";
@@ -1218,17 +1293,17 @@ private void innerRefresh(
                     "Using refresh policy [%s] when updating token doc [%s] for refresh in the security index [%s]",
                     tokenRefreshUpdateRefreshPolicy,
                     tokenDoc.id(),
-                    securityTokensIndex.aliasName()
+                    refreshedTokenIndex.aliasName()
                 )
             );
-            final UpdateRequestBuilder updateRequest = client.prepareUpdate(securityTokensIndex.aliasName(), tokenDoc.id())
+            final UpdateRequestBuilder updateRequest = client.prepareUpdate(refreshedTokenIndex.aliasName(), tokenDoc.id())
                 .setDoc("refresh_token", updateMap)
                 .setFetchSource(logger.isDebugEnabled())
                 .setRefreshPolicy(tokenRefreshUpdateRefreshPolicy)
                 .setIfSeqNo(tokenDoc.seqNo())
                 .setIfPrimaryTerm(tokenDoc.primaryTerm());
-            securityTokensIndex.prepareIndexIfNeededThenExecute(
-                ex -> listener.onFailure(traceLog("prepare index [" + securityTokensIndex.aliasName() + "]", ex)),
+            refreshedTokenIndex.prepareIndexIfNeededThenExecute(
+                ex -> listener.onFailure(traceLog("prepare index [" + refreshedTokenIndex.aliasName() + "]", ex)),
                 () -> executeAsyncWithOrigin(
                     client.threadPool().getThreadContext(),
                     SECURITY_ORIGIN,
@@ -1274,7 +1349,7 @@ private void innerRefresh(
                         if (cause instanceof VersionConflictEngineException) {
                             // The document has been updated by another thread, get it again.
                             logger.debug("version conflict while updating document [{}], attempting to get it again", tokenDoc.id());
-                            getTokenDocAsync(tokenDoc.id(), securityTokensIndex, true, new ActionListener<>() {
+                            getTokenDocAsync(tokenDoc.id(), refreshedTokenIndex, true, new ActionListener<>() {
                                 @Override
                                 public void onResponse(GetResponse response) {
                                     if (response.isExists()) {
@@ -1293,7 +1368,7 @@ public void onFailure(Exception e) {
                                             logger.info("could not get token document [{}] for refresh, retrying", tokenDoc.id());
                                             client.threadPool()
                                                 .schedule(
-                                                    () -> getTokenDocAsync(tokenDoc.id(), securityTokensIndex, true, this),
+                                                    () -> getTokenDocAsync(tokenDoc.id(), refreshedTokenIndex, true, this),
                                                     backoff.next(),
                                                     client.threadPool().generic()
                                                 );
@@ -1614,13 +1689,17 @@ private static Optional<ElasticsearchSecurityException> checkMultipleRefreshes(
         RefreshTokenStatus refreshTokenStatus
     ) {
         if (refreshTokenStatus.isRefreshed()) {
-            if (refreshRequested.isAfter(refreshTokenStatus.getRefreshInstant().plus(30L, ChronoUnit.SECONDS))) {
-                return Optional.of(invalidGrantException("token has already been refreshed more than 30 seconds in the past"));
-            }
-            if (refreshRequested.isBefore(refreshTokenStatus.getRefreshInstant().minus(30L, ChronoUnit.SECONDS))) {
-                return Optional.of(
-                    invalidGrantException("token has been refreshed more than 30 seconds in the future, clock skew too great")
-                );
+            if (refreshTokenStatus.getTransportVersion().onOrAfter(VERSION_MULTIPLE_CONCURRENT_REFRESHES)) {
+                if (refreshRequested.isAfter(refreshTokenStatus.getRefreshInstant().plus(30L, ChronoUnit.SECONDS))) {
+                    return Optional.of(invalidGrantException("token has already been refreshed more than 30 seconds in the past"));
+                }
+                if (refreshRequested.isBefore(refreshTokenStatus.getRefreshInstant().minus(30L, ChronoUnit.SECONDS))) {
+                    return Optional.of(
+                        invalidGrantException("token has been refreshed more than 30 seconds in the future, clock skew too great")
+                    );
+                }
+            } else {
+                return Optional.of(invalidGrantException("token has already been refreshed"));
             }
         }
         return Optional.empty();
@@ -1900,6 +1979,21 @@ private void ensureEnabled() {
         }
     }
 
+    /**
+     * In version {@code #VERSION_TOKENS_INDEX_INTRODUCED} security tokens were moved into a separate index, away from the other entities in
+     * the main security index, due to their ephemeral nature. They moved "seamlessly" - without manual user intervention. In this way, new
+     * tokens are created in the new index, while the existing ones were left in place - to be accessed from the old index - and due to be
+     * removed automatically by the {@code ExpiredTokenRemover} periodic job. Therefore, in general, when searching for a token we need to
+     * consider both the new and the old indices.
+     */
+    private SecurityIndexManager getTokensIndexForVersion(TransportVersion version) {
+        if (version.onOrAfter(VERSION_TOKENS_INDEX_INTRODUCED)) {
+            return securityTokensIndex;
+        } else {
+            return securityMainIndex;
+        }
+    }
+
     public TimeValue getExpirationDelay() {
         return expirationDelay;
     }
@@ -1928,13 +2022,41 @@ public String prependVersionAndEncodeAccessToken(TransportVersion version, byte[
                 out.writeByteArray(accessTokenBytes);
                 return Base64.getEncoder().encodeToString(out.bytes().toBytesRef().bytes);
             }
-        } else {
+        } else if (version.onOrAfter(VERSION_ACCESS_TOKENS_AS_UUIDS)) {
             try (BytesStreamOutput out = new BytesStreamOutput(MINIMUM_BASE64_BYTES)) {
                 out.setTransportVersion(version);
                 TransportVersion.writeVersion(version, out);
                 out.writeString(Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes));
                 return Base64.getEncoder().encodeToString(out.bytes().toBytesRef().bytes);
             }
+        } else {
+            // we know that the minimum length is larger than the default of the ByteArrayOutputStream so set the size to this explicitly
+            try (
+                ByteArrayOutputStream os = new ByteArrayOutputStream(LEGACY_MINIMUM_BASE64_BYTES);
+                OutputStream base64 = Base64.getEncoder().wrap(os);
+                StreamOutput out = new OutputStreamStreamOutput(base64)
+            ) {
+                out.setTransportVersion(version);
+                KeyAndCache keyAndCache = keyCache.activeKeyCache;
+                TransportVersion.writeVersion(version, out);
+                out.writeByteArray(keyAndCache.getSalt().bytes);
+                out.writeByteArray(keyAndCache.getKeyHash().bytes);
+                final byte[] initializationVector = getRandomBytes(IV_BYTES);
+                out.writeByteArray(initializationVector);
+                try (
+                    CipherOutputStream encryptedOutput = new CipherOutputStream(
+                        out,
+                        getEncryptionCipher(initializationVector, keyAndCache, version)
+                    );
+                    StreamOutput encryptedStreamOutput = new OutputStreamStreamOutput(encryptedOutput)
+                ) {
+                    encryptedStreamOutput.setTransportVersion(version);
+                    encryptedStreamOutput.writeString(Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes));
+                    // StreamOutput needs to be closed explicitly because it wraps CipherOutputStream
+                    encryptedStreamOutput.close();
+                    return new String(os.toByteArray(), StandardCharsets.UTF_8);
+                }
+            }
         }
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
index 702af75141093..75c2507a1dc5f 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
@@ -126,6 +126,7 @@
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
 import static org.mockito.ArgumentMatchers.any;
 import static org.mockito.ArgumentMatchers.anyString;
@@ -147,6 +148,7 @@ public class TokenServiceTests extends ESTestCase {
     private SecurityIndexManager securityMainIndex;
     private SecurityIndexManager securityTokensIndex;
     private ClusterService clusterService;
+    private DiscoveryNode pre72OldNode;
     private DiscoveryNode pre8500040OldNode;
     private Settings tokenServiceEnabledSettings = Settings.builder()
         .put(XPackSettings.TOKEN_SERVICE_ENABLED_SETTING.getKey(), true)
@@ -226,12 +228,31 @@ public void setupClient() {
         licenseState = mock(MockLicenseState.class);
         when(licenseState.isAllowed(Security.TOKEN_SERVICE_FEATURE)).thenReturn(true);
 
+        if (randomBoolean()) {
+            // version 7.2 was an "inflection" point in the Token Service development (access_tokens as UUIDS, multiple concurrent
+            // refreshes,
+            // tokens docs on a separate index)
+            pre72OldNode = addAnother7071DataNode(this.clusterService);
+        }
         if (randomBoolean()) {
             // before refresh tokens used GET, i.e. TokenService#VERSION_GET_TOKEN_DOC_FOR_REFRESH
             pre8500040OldNode = addAnotherPre8500DataNode(this.clusterService);
         }
     }
 
+    private static DiscoveryNode addAnother7071DataNode(ClusterService clusterService) {
+        Version version;
+        TransportVersion transportVersion;
+        if (randomBoolean()) {
+            version = Version.V_7_0_0;
+            transportVersion = TransportVersions.V_7_0_0;
+        } else {
+            version = Version.V_7_1_0;
+            transportVersion = TransportVersions.V_7_1_0;
+        }
+        return addAnotherDataNodeWithVersion(clusterService, version, transportVersion);
+    }
+
     private static DiscoveryNode addAnotherPre8500DataNode(ClusterService clusterService) {
         Version version;
         TransportVersion transportVersion;
@@ -280,6 +301,53 @@ public static void shutdownThreadpool() {
         threadPool = null;
     }
 
+    public void testAttachAndGetToken() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // This test only makes sense in mixed clusters with pre v7.2.0 nodes where the Token Service Key is used (to encrypt tokens)
+        if (null == pre72OldNode) {
+            pre72OldNode = addAnother7071DataNode(this.clusterService);
+        }
+        Authentication authentication = AuthenticationTestHelper.builder()
+            .user(new User("joe", "admin"))
+            .realmRef(new RealmRef("native_realm", "native", "node1"))
+            .build(false);
+        PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
+        Tuple<byte[], byte[]> newTokenBytes = tokenService.getRandomTokenBytes(randomBoolean());
+        tokenService.createOAuth2Tokens(
+            newTokenBytes.v1(),
+            newTokenBytes.v2(),
+            authentication,
+            authentication,
+            Collections.emptyMap(),
+            tokenFuture
+        );
+        final String accessToken = tokenFuture.get().getAccessToken();
+        assertNotNull(accessToken);
+        mockGetTokenFromAccessTokenBytes(tokenService, newTokenBytes.v1(), authentication, false, null);
+
+        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
+        requestContext.putHeader("Authorization", randomFrom("Bearer ", "BEARER ", "bearer ") + accessToken);
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
+            tokenService.tryAuthenticateToken(bearerToken, future);
+            UserToken serialized = future.get();
+            assertAuthentication(authentication, serialized.getAuthentication());
+        }
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
+            // verify a second separate token service with its own salt can also verify
+            TokenService anotherService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+            anotherService.refreshMetadata(tokenService.getTokenMetadata());
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
+            anotherService.tryAuthenticateToken(bearerToken, future);
+            UserToken fromOtherService = future.get();
+            assertAuthentication(authentication, fromOtherService.getAuthentication());
+        }
+    }
+
     public void testInvalidAuthorizationHeader() throws Exception {
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
         ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
@@ -296,6 +364,89 @@ public void testInvalidAuthorizationHeader() throws Exception {
         }
     }
 
+    public void testPassphraseWorks() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // This test only makes sense in mixed clusters with pre v7.1.0 nodes where the Key is actually used
+        if (null == pre72OldNode) {
+            pre72OldNode = addAnother7071DataNode(this.clusterService);
+        }
+        Authentication authentication = AuthenticationTestHelper.builder()
+            .user(new User("joe", "admin"))
+            .realmRef(new RealmRef("native_realm", "native", "node1"))
+            .build(false);
+        PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
+        Tuple<byte[], byte[]> newTokenBytes = tokenService.getRandomTokenBytes(randomBoolean());
+        tokenService.createOAuth2Tokens(
+            newTokenBytes.v1(),
+            newTokenBytes.v2(),
+            authentication,
+            authentication,
+            Collections.emptyMap(),
+            tokenFuture
+        );
+        final String accessToken = tokenFuture.get().getAccessToken();
+        assertNotNull(accessToken);
+        mockGetTokenFromAccessTokenBytes(tokenService, newTokenBytes.v1(), authentication, false, null);
+
+        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
+        storeTokenHeader(requestContext, accessToken);
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
+            tokenService.tryAuthenticateToken(bearerToken, future);
+            UserToken serialized = future.get();
+            assertAuthentication(authentication, serialized.getAuthentication());
+        }
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
+            // verify a second separate token service with its own passphrase cannot verify
+            TokenService anotherService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
+            anotherService.tryAuthenticateToken(bearerToken, future);
+            assertNull(future.get());
+        }
+    }
+
+    public void testGetTokenWhenKeyCacheHasExpired() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // This test only makes sense in mixed clusters with pre v7.1.0 nodes where the Key is actually used
+        if (null == pre72OldNode) {
+            pre72OldNode = addAnother7071DataNode(this.clusterService);
+        }
+        Authentication authentication = AuthenticationTestHelper.builder()
+            .user(new User("joe", "admin"))
+            .realmRef(new RealmRef("native_realm", "native", "node1"))
+            .build(false);
+
+        PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
+        Tuple<byte[], byte[]> newTokenBytes = tokenService.getRandomTokenBytes(randomBoolean());
+        tokenService.createOAuth2Tokens(
+            newTokenBytes.v1(),
+            newTokenBytes.v2(),
+            authentication,
+            authentication,
+            Collections.emptyMap(),
+            tokenFuture
+        );
+        String accessToken = tokenFuture.get().getAccessToken();
+        assertThat(accessToken, notNullValue());
+
+        tokenService.clearActiveKeyCache();
+
+        tokenService.createOAuth2Tokens(
+            newTokenBytes.v1(),
+            newTokenBytes.v2(),
+            authentication,
+            authentication,
+            Collections.emptyMap(),
+            tokenFuture
+        );
+        accessToken = tokenFuture.get().getAccessToken();
+        assertThat(accessToken, notNullValue());
+    }
+
     public void testAuthnWithInvalidatedToken() throws Exception {
         when(securityMainIndex.indexExists()).thenReturn(true);
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
@@ -669,6 +820,57 @@ public void testMalformedRefreshTokens() throws Exception {
         }
     }
 
+    public void testNonExistingPre72Token() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
+        Authentication authentication = AuthenticationTestHelper.builder()
+            .user(new User("joe", "admin"))
+            .realmRef(new RealmRef("native_realm", "native", "node1"))
+            .build(false);
+        mockGetTokenFromAccessTokenBytes(tokenService, tokenService.getRandomTokenBytes(randomBoolean()).v1(), authentication, false, null);
+        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
+        storeTokenHeader(
+            requestContext,
+            tokenService.prependVersionAndEncodeAccessToken(
+                TransportVersions.V_7_1_0,
+                tokenService.getRandomTokenBytes(TransportVersions.V_7_1_0, randomBoolean()).v1()
+            )
+        );
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
+            tokenService.tryAuthenticateToken(bearerToken, future);
+            assertNull(future.get());
+        }
+    }
+
+    public void testNonExistingUUIDToken() throws Exception {
+        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
+        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
+        Authentication authentication = AuthenticationTestHelper.builder()
+            .user(new User("joe", "admin"))
+            .realmRef(new RealmRef("native_realm", "native", "node1"))
+            .build(false);
+        mockGetTokenFromAccessTokenBytes(tokenService, tokenService.getRandomTokenBytes(randomBoolean()).v1(), authentication, false, null);
+        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
+        TransportVersion uuidTokenVersion = randomFrom(TransportVersions.V_7_2_0, TransportVersions.V_7_3_2);
+        storeTokenHeader(
+            requestContext,
+            tokenService.prependVersionAndEncodeAccessToken(
+                uuidTokenVersion,
+                tokenService.getRandomTokenBytes(uuidTokenVersion, randomBoolean()).v1()
+            )
+        );
+
+        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
+            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
+            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
+            tokenService.tryAuthenticateToken(bearerToken, future);
+            assertNull(future.get());
+        }
+    }
+
     public void testNonExistingLatestTokenVersion() throws Exception {
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
         // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
@@ -723,11 +925,18 @@ public void testIndexNotAvailable() throws Exception {
             return Void.TYPE;
         }).when(client).get(any(GetRequest.class), anyActionListener());
 
-        final SecurityIndexManager tokensIndex = securityTokensIndex;
-        when(securityMainIndex.isAvailable(SecurityIndexManager.Availability.PRIMARY_SHARDS)).thenReturn(false);
-        when(securityMainIndex.indexExists()).thenReturn(false);
-        when(securityMainIndex.defensiveCopy()).thenReturn(securityMainIndex);
-
+        final SecurityIndexManager tokensIndex;
+        if (pre72OldNode != null) {
+            tokensIndex = securityMainIndex;
+            when(securityTokensIndex.isAvailable(SecurityIndexManager.Availability.PRIMARY_SHARDS)).thenReturn(false);
+            when(securityTokensIndex.indexExists()).thenReturn(false);
+            when(securityTokensIndex.defensiveCopy()).thenReturn(securityTokensIndex);
+        } else {
+            tokensIndex = securityTokensIndex;
+            when(securityMainIndex.isAvailable(SecurityIndexManager.Availability.PRIMARY_SHARDS)).thenReturn(false);
+            when(securityMainIndex.indexExists()).thenReturn(false);
+            when(securityMainIndex.defensiveCopy()).thenReturn(securityMainIndex);
+        }
         try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
             PlainActionFuture<UserToken> future = new PlainActionFuture<>();
             final SecureString bearerToken3 = Authenticator.extractBearerTokenFromHeader(requestContext);
@@ -779,6 +988,7 @@ public void testGetAuthenticationWorksWithExpiredUserToken() throws Exception {
     }
 
     public void testSupersedingTokenEncryption() throws Exception {
+        assumeTrue("Superseding tokens are only created in post 7.2 clusters", pre72OldNode == null);
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, Clock.systemUTC());
         Authentication authentication = AuthenticationTests.randomAuthentication(null, null);
         PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
@@ -813,11 +1023,13 @@ public void testSupersedingTokenEncryption() throws Exception {
             authentication,
             tokenFuture
         );
-
-        assertThat(
-            tokenService.prependVersionAndEncodeAccessToken(version, newTokenBytes.v1()),
-            equalTo(tokenFuture.get().getAccessToken())
-        );
+        if (version.onOrAfter(TokenService.VERSION_ACCESS_TOKENS_AS_UUIDS)) {
+            // previous versions serialized the access token encrypted and the cipher text was different each time (due to different IVs)
+            assertThat(
+                tokenService.prependVersionAndEncodeAccessToken(version, newTokenBytes.v1()),
+                equalTo(tokenFuture.get().getAccessToken())
+            );
+        }
         assertThat(
             TokenService.prependVersionAndEncodeRefreshToken(version, newTokenBytes.v2()),
             equalTo(tokenFuture.get().getRefreshToken())
@@ -946,8 +1158,10 @@ public static String tokenDocIdFromAccessTokenBytes(byte[] accessTokenBytes, Tra
             MessageDigest userTokenIdDigest = sha256();
             userTokenIdDigest.update(accessTokenBytes, RAW_TOKEN_BYTES_LENGTH, RAW_TOKEN_DOC_ID_BYTES_LENGTH);
             return Base64.getUrlEncoder().withoutPadding().encodeToString(userTokenIdDigest.digest());
-        } else {
+        } else if (tokenVersion.onOrAfter(TokenService.VERSION_ACCESS_TOKENS_AS_UUIDS)) {
             return TokenService.hashTokenString(Base64.getUrlEncoder().withoutPadding().encodeToString(accessTokenBytes));
+        } else {
+            return Base64.getUrlEncoder().withoutPadding().encodeToString(accessTokenBytes);
         }
     }
 
@@ -964,9 +1178,12 @@ private void mockTokenForRefreshToken(
         if (userToken.getTransportVersion().onOrAfter(VERSION_GET_TOKEN_DOC_FOR_REFRESH)) {
             storedAccessToken = Base64.getUrlEncoder().withoutPadding().encodeToString(sha256().digest(accessTokenBytes));
             storedRefreshToken = Base64.getUrlEncoder().withoutPadding().encodeToString(sha256().digest(refreshTokenBytes));
-        } else {
+        } else if (userToken.getTransportVersion().onOrAfter(TokenService.VERSION_HASHED_TOKENS)) {
             storedAccessToken = null;
             storedRefreshToken = TokenService.hashTokenString(Base64.getUrlEncoder().withoutPadding().encodeToString(refreshTokenBytes));
+        } else {
+            storedAccessToken = null;
+            storedRefreshToken = Base64.getUrlEncoder().withoutPadding().encodeToString(refreshTokenBytes);
         }
         final RealmRef realmRef = new RealmRef(
             refreshTokenStatus == null ? randomAlphaOfLength(6) : refreshTokenStatus.getAssociatedRealm(),

From bc3b629d8d7010a61f5179279446346ffd45263b Mon Sep 17 00:00:00 2001
From: Bogdan Pintea <bogdan.pintea@elastic.co>
Date: Wed, 18 Dec 2024 17:12:14 +0100
Subject: [PATCH 084/119] ESQL: Docs: add example of date bucketing with offset
 (#116680)

Add an example of how to create date histograms with an offset.

Fixes #114167
---
 .../esql/functions/examples/bucket.asciidoc    | 14 ++++++++++++++
 .../functions/kibana/definition/bucket.json    |  3 ++-
 .../elasticsearch/xpack/esql/CsvTestUtils.java |  2 +-
 .../src/main/resources/bucket.csv-spec         | 18 ++++++++++++++++++
 .../expression/function/grouping/Bucket.java   | 11 +++++++++++
 .../org/elasticsearch/xpack/esql/CsvTests.java |  5 +++--
 6 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/docs/reference/esql/functions/examples/bucket.asciidoc b/docs/reference/esql/functions/examples/bucket.asciidoc
index 4afea30660339..264efc191748f 100644
--- a/docs/reference/esql/functions/examples/bucket.asciidoc
+++ b/docs/reference/esql/functions/examples/bucket.asciidoc
@@ -116,4 +116,18 @@ include::{esql-specs}/bucket.csv-spec[tag=reuseGroupingFunctionWithExpression]
 |===
 include::{esql-specs}/bucket.csv-spec[tag=reuseGroupingFunctionWithExpression-result]
 |===
+Sometimes you need to change the start value of each bucket by a given duration (similar to date histogram
+aggregation's <<search-aggregations-bucket-histogram-aggregation,`offset`>> parameter). To do so, you will need to
+take into account how the language handles expressions within the `STATS` command: if these contain functions or
+arithmetic operators, a virtual `EVAL` is inserted before and/or after the `STATS` command. Consequently, a double
+compensation is needed to adjust the bucketed date value before the aggregation and then again after. For instance,
+inserting a negative offset of `1 hour` to buckets of `1 year` looks like this:
+[source.merge.styled,esql]
+----
+include::{esql-specs}/bucket.csv-spec[tag=bucketWithOffset]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/bucket.csv-spec[tag=bucketWithOffset-result]
+|===
 
diff --git a/docs/reference/esql/functions/kibana/definition/bucket.json b/docs/reference/esql/functions/kibana/definition/bucket.json
index 18802f5ff8fef..3d96de05c8407 100644
--- a/docs/reference/esql/functions/kibana/definition/bucket.json
+++ b/docs/reference/esql/functions/kibana/definition/bucket.json
@@ -1598,7 +1598,8 @@
     "FROM employees\n| WHERE hire_date >= \"1985-01-01T00:00:00Z\" AND hire_date < \"1986-01-01T00:00:00Z\"\n| STATS c = COUNT(1) BY b = BUCKET(salary, 5000.)\n| SORT b",
     "FROM sample_data \n| WHERE @timestamp >= NOW() - 1 day and @timestamp < NOW()\n| STATS COUNT(*) BY bucket = BUCKET(@timestamp, 25, NOW() - 1 day, NOW())",
     "FROM employees\n| WHERE hire_date >= \"1985-01-01T00:00:00Z\" AND hire_date < \"1986-01-01T00:00:00Z\"\n| STATS AVG(salary) BY bucket = BUCKET(hire_date, 20, \"1985-01-01T00:00:00Z\", \"1986-01-01T00:00:00Z\")\n| SORT bucket",
-    "FROM employees\n| STATS s1 = b1 + 1, s2 = BUCKET(salary / 1000 + 999, 50.) + 2 BY b1 = BUCKET(salary / 100 + 99, 50.), b2 = BUCKET(salary / 1000 + 999, 50.)\n| SORT b1, b2\n| KEEP s1, b1, s2, b2"
+    "FROM employees\n| STATS s1 = b1 + 1, s2 = BUCKET(salary / 1000 + 999, 50.) + 2 BY b1 = BUCKET(salary / 100 + 99, 50.), b2 = BUCKET(salary / 1000 + 999, 50.)\n| SORT b1, b2\n| KEEP s1, b1, s2, b2",
+    "FROM employees \n| STATS dates = VALUES(birth_date) BY b = BUCKET(birth_date + 1 HOUR, 1 YEAR) - 1 HOUR\n| EVAL d_count = MV_COUNT(dates)\n| SORT d_count\n| LIMIT 3"
   ],
   "preview" : false,
   "snapshot_only" : false
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestUtils.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestUtils.java
index 7adafa908ce4f..f0bdf089f69d1 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestUtils.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestUtils.java
@@ -63,7 +63,7 @@
 import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.GEO;
 
 public final class CsvTestUtils {
-    private static final int MAX_WIDTH = 20;
+    private static final int MAX_WIDTH = 80;
     private static final CsvPreference CSV_SPEC_PREFERENCES = new CsvPreference.Builder('"', '|', "\r\n").build();
     private static final String NULL_VALUE = "null";
     private static final char ESCAPE_CHAR = '\\';
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/bucket.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/bucket.csv-spec
index b29c489910f65..8cfde2bb9bde7 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/bucket.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/bucket.csv-spec
@@ -145,6 +145,24 @@ AVG(salary):double | bucket:date
 // end::bucket_in_agg-result[]
 ;
 
+bucketWithOffset#[skip:-8.13.99, reason:BUCKET renamed in 8.14]
+// tag::bucketWithOffset[]
+FROM employees
+| STATS dates = MV_SORT(VALUES(birth_date)) BY b = BUCKET(birth_date + 1 HOUR, 1 YEAR) - 1 HOUR
+| EVAL d_count = MV_COUNT(dates)
+| SORT d_count, b
+| LIMIT 3
+// end::bucketWithOffset[]
+;
+
+// tag::bucketWithOffset-result[]
+dates:date                                                                                              |b:date                  |d_count:integer
+1965-01-03T00:00:00.000Z                                                                                |1964-12-31T23:00:00.000Z|1
+[1955-01-21T00:00:00.000Z, 1955-08-20T00:00:00.000Z, 1955-08-28T00:00:00.000Z, 1955-10-04T00:00:00.000Z]|1954-12-31T23:00:00.000Z|4
+[1957-04-04T00:00:00.000Z, 1957-05-23T00:00:00.000Z, 1957-05-25T00:00:00.000Z, 1957-12-03T00:00:00.000Z]|1956-12-31T23:00:00.000Z|4
+// end::bucketWithOffset-result[]
+;
+
 docsBucketMonth#[skip:-8.13.99, reason:BUCKET renamed in 8.14]
 //tag::docsBucketMonth[]
 FROM employees
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/grouping/Bucket.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/grouping/Bucket.java
index 347d542f5212d..12932ba8d6e11 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/grouping/Bucket.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/grouping/Bucket.java
@@ -163,6 +163,17 @@ another in which the bucket size is provided directly (two parameters).
                     grouping part, or that it is invoked with the exact same expression:""",
                 file = "bucket",
                 tag = "reuseGroupingFunctionWithExpression"
+            ),
+            @Example(
+                description = """
+                    Sometimes you need to change the start value of each bucket by a given duration (similar to date histogram
+                    aggregation's <<search-aggregations-bucket-histogram-aggregation,`offset`>> parameter). To do so, you will need to
+                    take into account how the language handles expressions within the `STATS` command: if these contain functions or
+                    arithmetic operators, a virtual `EVAL` is inserted before and/or after the `STATS` command. Consequently, a double
+                    compensation is needed to adjust the bucketed date value before the aggregation and then again after. For instance,
+                    inserting a negative offset of `1 hour` to buckets of `1 year` looks like this:""",
+                file = "bucket",
+                tag = "bucketWithOffset"
             ) }
     )
     public Bucket(
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index b81b80a9fdbb4..e627f99322f08 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -322,13 +322,14 @@ private void doTest() throws Exception {
     }
 
     protected void assertResults(ExpectedResults expected, ActualResults actual, boolean ignoreOrder, Logger logger) {
-        CsvAssert.assertResults(expected, actual, ignoreOrder, logger);
         /*
-         * Comment the assertion above and enable the next two lines to see the results returned by ES without any assertions being done.
+         * Enable the next two lines to see the results returned by ES.
          * This is useful when creating a new test or trying to figure out what are the actual results.
          */
         // CsvTestUtils.logMetaData(actual.columnNames(), actual.columnTypes(), LOGGER);
         // CsvTestUtils.logData(actual.values(), LOGGER);
+
+        CsvAssert.assertResults(expected, actual, ignoreOrder, logger);
     }
 
     private static IndexResolution loadIndexResolution(String mappingName, String indexName, Map<String, String> typeMapping) {

From a5ced2c48612b003dbbca3238526b29bfc6501d3 Mon Sep 17 00:00:00 2001
From: Lee Hinman <dakrone@users.noreply.github.com>
Date: Wed, 18 Dec 2024 09:19:29 -0700
Subject: [PATCH 085/119] Unmute DotPrefixClientYamlTestSuiteIT (#118898)

This failed due to an unrelated failure that appears to have affected more than just this suite.

Resolves #118224
---
 muted-tests.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 6b433f232defd..0442c2305c6f8 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -238,8 +238,6 @@ tests:
 - class: org.elasticsearch.datastreams.DataStreamsClientYamlTestSuiteIT
   method: test {p0=data_stream/120_data_streams_stats/Multiple data stream}
   issue: https://github.com/elastic/elasticsearch/issues/118217
-- class: org.elasticsearch.validation.DotPrefixClientYamlTestSuiteIT
-  issue: https://github.com/elastic/elasticsearch/issues/118224
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test60StartAndStop
   issue: https://github.com/elastic/elasticsearch/issues/118216

From be769ab1226d928b2428b4b784a18dbcb62a8b9c Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Wed, 18 Dec 2024 10:19:44 -0600
Subject: [PATCH 086/119] Unmuting
 ReindexDataStreamStatusTests.testEqualsAndHashcode (#118974)

This was fixed by #118957. Closes #118965
---
 muted-tests.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 0442c2305c6f8..f534f24718f52 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -290,9 +290,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118914
 - class: org.elasticsearch.smoketest.SmokeTestMultiNodeClientYamlTestSuiteIT
   issue: https://github.com/elastic/elasticsearch/issues/118955
-- class: org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatusTests
-  method: testEqualsAndHashcode
-  issue: https://github.com/elastic/elasticsearch/issues/118965
 - class: org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
   issue: https://github.com/elastic/elasticsearch/issues/118970
 

From 1147c9da0ca1adeeacc1cad2a7b9957296070c10 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Iv=C3=A1n=20Cea=20Fontenla?= <ivancea96@outlook.com>
Date: Wed, 18 Dec 2024 17:24:47 +0100
Subject: [PATCH 087/119] ESQL: Fix match in LOOKUP JOIN YAML test (#118975)

CI is broken, as sometimes the error comes with a "verification_error: " at the beginning, and the match assertion fails.
Changing it to a contains.
---
 .../resources/rest-api-spec/test/esql/190_lookup_join.yml     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml
index cbaac4e47fdd4..fdb6746bbeed8 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/190_lookup_join.yml
@@ -1,7 +1,7 @@
 ---
 setup:
   - requires:
-      test_runner_features: [capabilities]
+      test_runner_features: [capabilities, contains]
       capabilities:
         - method: POST
           path: /_query
@@ -75,4 +75,4 @@ non-lookup index:
       catch: "bad_request"
 
   - match: { error.type: "verification_exception" }
-  - match: { error.reason: "Found 1 problem\nline 1:43: invalid [test] resolution in lookup mode to an index in [standard] mode" }
+  - contains: { error.reason: "Found 1 problem\nline 1:43: invalid [test] resolution in lookup mode to an index in [standard] mode" }

From 1004da29821471eea99afd64da0d151682f46595 Mon Sep 17 00:00:00 2001
From: Parker Timmins <parker.timmins@elastic.co>
Date: Wed, 18 Dec 2024 10:35:19 -0600
Subject: [PATCH 088/119] Add action to create index from a source index
 (#118890)

Add new action that creates an index from a source
index, copying settings and mappings from the source index.
This was refactored out of ReindexDataStreamIndexAction.
---
 docs/changelog/118890.yaml                    |   5 +
 .../action/CreateIndexFromSourceActionIT.java | 250 ++++++++++++++++++
 ...ndexDatastreamIndexTransportActionIT.java} |   8 +-
 .../xpack/migrate/MigratePlugin.java          |   3 +
 .../action/CreateIndexFromSourceAction.java   | 117 ++++++++
 .../CreateIndexFromSourceTransportAction.java | 126 +++++++++
 .../action/ReindexDataStreamIndexAction.java  |   4 -
 ...ReindexDataStreamIndexTransportAction.java | 104 ++++----
 .../xpack/security/operator/Constants.java    |   1 +
 9 files changed, 552 insertions(+), 66 deletions(-)
 create mode 100644 docs/changelog/118890.yaml
 create mode 100644 x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceActionIT.java
 rename x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/{ReindexDatastreamIndexIT.java => ReindexDatastreamIndexTransportActionIT.java} (98%)
 create mode 100644 x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceAction.java
 create mode 100644 x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceTransportAction.java

diff --git a/docs/changelog/118890.yaml b/docs/changelog/118890.yaml
new file mode 100644
index 0000000000000..d3fc17157f130
--- /dev/null
+++ b/docs/changelog/118890.yaml
@@ -0,0 +1,5 @@
+pr: 118890
+summary: Add action to create index from a source index
+area: Data streams
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceActionIT.java b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceActionIT.java
new file mode 100644
index 0000000000000..b460c6abfeee4
--- /dev/null
+++ b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceActionIT.java
@@ -0,0 +1,250 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.migrate.action;
+
+import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
+import org.elasticsearch.action.admin.indices.get.GetIndexRequest;
+import org.elasticsearch.action.admin.indices.mapping.get.GetMappingsRequest;
+import org.elasticsearch.action.admin.indices.settings.get.GetSettingsRequest;
+import org.elasticsearch.action.admin.indices.settings.put.UpdateSettingsRequest;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.MappingMetadata;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.datastreams.DataStreamsPlugin;
+import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.reindex.ReindexPlugin;
+import org.elasticsearch.test.ESIntegTestCase;
+import org.elasticsearch.test.transport.MockTransportService;
+import org.elasticsearch.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.migrate.MigratePlugin;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.REINDEX_DATA_STREAM_FEATURE_FLAG;
+
+public class CreateIndexFromSourceActionIT extends ESIntegTestCase {
+
+    @Override
+    protected Collection<Class<? extends Plugin>> nodePlugins() {
+        return List.of(MigratePlugin.class, ReindexPlugin.class, MockTransportService.TestPlugin.class, DataStreamsPlugin.class);
+    }
+
+    public void testDestIndexCreated() throws Exception {
+        assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
+
+        var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex)).get();
+
+        // create from source
+        var destIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        assertAcked(
+            client().execute(CreateIndexFromSourceAction.INSTANCE, new CreateIndexFromSourceAction.Request(sourceIndex, destIndex))
+        );
+
+        try {
+            indicesAdmin().getIndex(new GetIndexRequest().indices(destIndex)).actionGet();
+        } catch (IndexNotFoundException e) {
+            fail();
+        }
+    }
+
+    public void testSettingsCopiedFromSource() throws Exception {
+        assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
+
+        // start with a static setting
+        var numShards = randomIntBetween(1, 10);
+        var staticSettings = Settings.builder().put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, numShards).build();
+        var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex, staticSettings)).get();
+
+        // update with a dynamic setting
+        var numReplicas = randomIntBetween(0, 10);
+        var dynamicSettings = Settings.builder().put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, numReplicas).build();
+        indicesAdmin().updateSettings(new UpdateSettingsRequest(dynamicSettings, sourceIndex)).actionGet();
+
+        // create from source
+        var destIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        assertAcked(
+            client().execute(CreateIndexFromSourceAction.INSTANCE, new CreateIndexFromSourceAction.Request(sourceIndex, destIndex))
+        );
+
+        // assert both static and dynamic settings set on dest index
+        var settingsResponse = indicesAdmin().getSettings(new GetSettingsRequest().indices(destIndex)).actionGet();
+        assertEquals(numReplicas, Integer.parseInt(settingsResponse.getSetting(destIndex, IndexMetadata.SETTING_NUMBER_OF_REPLICAS)));
+        assertEquals(numShards, Integer.parseInt(settingsResponse.getSetting(destIndex, IndexMetadata.SETTING_NUMBER_OF_SHARDS)));
+    }
+
+    public void testMappingsCopiedFromSource() {
+        assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
+
+        var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        String mapping = """
+            {
+              "_doc":{
+                "dynamic":"strict",
+                "properties":{
+                  "foo1":{
+                    "type":"text"
+                  }
+                }
+              }
+            }
+            """;
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex).mapping(mapping)).actionGet();
+
+        // create from source
+        var destIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        assertAcked(
+            client().execute(CreateIndexFromSourceAction.INSTANCE, new CreateIndexFromSourceAction.Request(sourceIndex, destIndex))
+        );
+
+        var mappingsResponse = indicesAdmin().getMappings(new GetMappingsRequest().indices(sourceIndex, destIndex)).actionGet();
+        Map<String, MappingMetadata> mappings = mappingsResponse.mappings();
+        var destMappings = mappings.get(destIndex).sourceAsMap();
+        var sourceMappings = mappings.get(sourceIndex).sourceAsMap();
+
+        assertEquals(sourceMappings, destMappings);
+        // sanity check specific value from dest mapping
+        assertEquals("text", XContentMapValues.extractValue("properties.foo1.type", destMappings));
+    }
+
+    public void testSettingsOverridden() throws Exception {
+        assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
+
+        var numShardsSource = randomIntBetween(1, 10);
+        var numReplicasSource = randomIntBetween(0, 10);
+        var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        var sourceSettings = Settings.builder()
+            .put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, numShardsSource)
+            .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, numReplicasSource)
+            .build();
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex, sourceSettings)).get();
+
+        boolean overrideNumShards = randomBoolean();
+        Settings settingsOverride = overrideNumShards
+            ? Settings.builder().put(IndexMetadata.SETTING_NUMBER_OF_SHARDS, numShardsSource + 1).build()
+            : Settings.builder().put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, numReplicasSource + 1).build();
+
+        // create from source
+        var destIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        assertAcked(
+            client().execute(
+                CreateIndexFromSourceAction.INSTANCE,
+                new CreateIndexFromSourceAction.Request(sourceIndex, destIndex, settingsOverride, Map.of())
+            )
+        );
+
+        // assert settings overridden
+        int expectedShards = overrideNumShards ? numShardsSource + 1 : numShardsSource;
+        int expectedReplicas = overrideNumShards ? numReplicasSource : numReplicasSource + 1;
+        var settingsResponse = indicesAdmin().getSettings(new GetSettingsRequest().indices(destIndex)).actionGet();
+        assertEquals(expectedShards, Integer.parseInt(settingsResponse.getSetting(destIndex, IndexMetadata.SETTING_NUMBER_OF_SHARDS)));
+        assertEquals(expectedReplicas, Integer.parseInt(settingsResponse.getSetting(destIndex, IndexMetadata.SETTING_NUMBER_OF_REPLICAS)));
+    }
+
+    public void testSettingsNullOverride() throws Exception {
+        assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
+
+        var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        var sourceSettings = Settings.builder().put(IndexMetadata.SETTING_BLOCKS_WRITE, true).build();
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex, sourceSettings)).get();
+
+        Settings settingsOverride = Settings.builder().putNull(IndexMetadata.SETTING_BLOCKS_WRITE).build();
+
+        // create from source
+        var destIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        assertAcked(
+            client().execute(
+                CreateIndexFromSourceAction.INSTANCE,
+                new CreateIndexFromSourceAction.Request(sourceIndex, destIndex, settingsOverride, Map.of())
+            )
+        );
+
+        // assert settings overridden
+        var settingsResponse = indicesAdmin().getSettings(new GetSettingsRequest().indices(destIndex)).actionGet();
+        assertNull(settingsResponse.getSetting(destIndex, IndexMetadata.SETTING_BLOCKS_WRITE));
+    }
+
+    public void testMappingsOverridden() {
+        assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
+
+        var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        String sourceMapping = """
+            {
+              "_doc":{
+                "dynamic":"strict",
+                "properties":{
+                  "foo1":{
+                    "type":"text"
+                  },
+                  "foo2":{
+                    "type":"boolean"
+                  }
+                }
+              }
+            }
+            """;
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex).mapping(sourceMapping)).actionGet();
+
+        String mappingOverrideStr = """
+            {
+              "_doc":{
+                "dynamic":"strict",
+                "properties":{
+                  "foo1":{
+                    "type":"integer"
+                  },
+                  "foo3": {
+                    "type":"keyword"
+                  }
+                }
+              }
+            }
+            """;
+        var mappingOverride = XContentHelper.convertToMap(JsonXContent.jsonXContent, mappingOverrideStr, false);
+
+        // create from source
+        var destIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
+        assertAcked(
+            client().execute(
+                CreateIndexFromSourceAction.INSTANCE,
+                new CreateIndexFromSourceAction.Request(sourceIndex, destIndex, Settings.EMPTY, mappingOverride)
+            )
+        );
+
+        var mappingsResponse = indicesAdmin().getMappings(new GetMappingsRequest().indices(destIndex)).actionGet();
+        Map<String, MappingMetadata> mappings = mappingsResponse.mappings();
+        var destMappings = mappings.get(destIndex).sourceAsMap();
+
+        String expectedMappingStr = """
+            {
+                "dynamic":"strict",
+                "properties":{
+                  "foo1":{
+                    "type":"integer"
+                  },
+                  "foo2": {
+                    "type":"boolean"
+                  },
+                  "foo3": {
+                    "type":"keyword"
+                  }
+                }
+            }
+            """;
+        var expectedMapping = XContentHelper.convertToMap(JsonXContent.jsonXContent, expectedMappingStr, false);
+        assertEquals(expectedMapping, destMappings);
+    }
+}
diff --git a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDatastreamIndexIT.java b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDatastreamIndexTransportActionIT.java
similarity index 98%
rename from x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDatastreamIndexIT.java
rename to x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDatastreamIndexTransportActionIT.java
index e492f035da866..0ca58ecf0f0d5 100644
--- a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDatastreamIndexIT.java
+++ b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDatastreamIndexTransportActionIT.java
@@ -53,7 +53,7 @@
 import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.REINDEX_DATA_STREAM_FEATURE_FLAG;
 import static org.hamcrest.Matchers.equalTo;
 
-public class ReindexDatastreamIndexIT extends ESIntegTestCase {
+public class ReindexDatastreamIndexTransportActionIT extends ESIntegTestCase {
 
     private static final String MAPPING = """
         {
@@ -126,12 +126,14 @@ public void testDestIndexContainsDocs() throws Exception {
         assertHitCount(prepareSearch(response.getDestIndex()).setSize(0), numDocs);
     }
 
-    public void testSetSourceToReadOnly() throws Exception {
+    public void testSetSourceToBlockWrites() throws Exception {
         assumeTrue("requires the migration reindex feature flag", REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled());
 
+        var settings = randomBoolean() ? Settings.builder().put(IndexMetadata.SETTING_BLOCKS_WRITE, true).build() : Settings.EMPTY;
+
         // empty source index
         var sourceIndex = randomAlphaOfLength(20).toLowerCase(Locale.ROOT);
-        indicesAdmin().create(new CreateIndexRequest(sourceIndex)).get();
+        indicesAdmin().create(new CreateIndexRequest(sourceIndex, settings)).get();
 
         // call reindex
         client().execute(ReindexDataStreamIndexAction.INSTANCE, new ReindexDataStreamIndexAction.Request(sourceIndex)).actionGet();
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java
index f42d05727b9fd..d9dffdefafa2c 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java
@@ -34,6 +34,8 @@
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xpack.migrate.action.CancelReindexDataStreamAction;
 import org.elasticsearch.xpack.migrate.action.CancelReindexDataStreamTransportAction;
+import org.elasticsearch.xpack.migrate.action.CreateIndexFromSourceAction;
+import org.elasticsearch.xpack.migrate.action.CreateIndexFromSourceTransportAction;
 import org.elasticsearch.xpack.migrate.action.GetMigrationReindexStatusAction;
 import org.elasticsearch.xpack.migrate.action.GetMigrationReindexStatusTransportAction;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction;
@@ -87,6 +89,7 @@ public List<RestHandler> getRestHandlers(
             actions.add(new ActionHandler<>(GetMigrationReindexStatusAction.INSTANCE, GetMigrationReindexStatusTransportAction.class));
             actions.add(new ActionHandler<>(CancelReindexDataStreamAction.INSTANCE, CancelReindexDataStreamTransportAction.class));
             actions.add(new ActionHandler<>(ReindexDataStreamIndexAction.INSTANCE, ReindexDataStreamIndexTransportAction.class));
+            actions.add(new ActionHandler<>(CreateIndexFromSourceAction.INSTANCE, CreateIndexFromSourceTransportAction.class));
         }
         return actions;
     }
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceAction.java
new file mode 100644
index 0000000000000..d67eaee3d251f
--- /dev/null
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceAction.java
@@ -0,0 +1,117 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+package org.elasticsearch.xpack.migrate.action;
+
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.action.ActionType;
+import org.elasticsearch.action.IndicesRequest;
+import org.elasticsearch.action.support.IndicesOptions;
+import org.elasticsearch.action.support.master.AcknowledgedResponse;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.settings.Settings;
+
+import java.io.IOException;
+import java.util.Map;
+import java.util.Objects;
+
+public class CreateIndexFromSourceAction extends ActionType<AcknowledgedResponse> {
+
+    public static final String NAME = "indices:admin/index/create_from_source";
+
+    public static final ActionType<AcknowledgedResponse> INSTANCE = new CreateIndexFromSourceAction();
+
+    private CreateIndexFromSourceAction() {
+        super(NAME);
+    }
+
+    public static class Request extends ActionRequest implements IndicesRequest {
+
+        private final String sourceIndex;
+        private final String destIndex;
+        private final Settings settingsOverride;
+        private final Map<String, Object> mappingsOverride;
+
+        public Request(String sourceIndex, String destIndex) {
+            this(sourceIndex, destIndex, Settings.EMPTY, Map.of());
+        }
+
+        public Request(String sourceIndex, String destIndex, Settings settingsOverride, Map<String, Object> mappingsOverride) {
+            Objects.requireNonNull(mappingsOverride);
+            this.sourceIndex = sourceIndex;
+            this.destIndex = destIndex;
+            this.settingsOverride = settingsOverride;
+            this.mappingsOverride = mappingsOverride;
+        }
+
+        @SuppressWarnings("unchecked")
+        public Request(StreamInput in) throws IOException {
+            super(in);
+            this.sourceIndex = in.readString();
+            this.destIndex = in.readString();
+            this.settingsOverride = Settings.readSettingsFromStream(in);
+            this.mappingsOverride = (Map<String, Object>) in.readGenericValue();
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            super.writeTo(out);
+            out.writeString(sourceIndex);
+            out.writeString(destIndex);
+            settingsOverride.writeTo(out);
+            out.writeGenericValue(mappingsOverride);
+        }
+
+        @Override
+        public ActionRequestValidationException validate() {
+            return null;
+        }
+
+        public String getSourceIndex() {
+            return sourceIndex;
+        }
+
+        public String getDestIndex() {
+            return destIndex;
+        }
+
+        public Settings getSettingsOverride() {
+            return settingsOverride;
+        }
+
+        public Map<String, Object> getMappingsOverride() {
+            return mappingsOverride;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+            Request request = (Request) o;
+            return Objects.equals(sourceIndex, request.sourceIndex)
+                && Objects.equals(destIndex, request.destIndex)
+                && Objects.equals(settingsOverride, request.settingsOverride)
+                && Objects.equals(mappingsOverride, request.mappingsOverride);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(sourceIndex, destIndex, settingsOverride, mappingsOverride);
+        }
+
+        @Override
+        public String[] indices() {
+            return new String[] { sourceIndex };
+        }
+
+        @Override
+        public IndicesOptions indicesOptions() {
+            return IndicesOptions.strictSingleIndexNoExpandForbidClosed();
+        }
+    }
+}
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceTransportAction.java
new file mode 100644
index 0000000000000..968b2220628a9
--- /dev/null
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/CreateIndexFromSourceTransportAction.java
@@ -0,0 +1,126 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+package org.elasticsearch.xpack.migrate.action;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.action.support.HandledTransportAction;
+import org.elasticsearch.action.support.master.AcknowledgedResponse;
+import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.MappingMetadata;
+import org.elasticsearch.cluster.metadata.MetadataCreateIndexService;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.compress.CompressedXContent;
+import org.elasticsearch.common.settings.IndexScopedSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.core.Nullable;
+import org.elasticsearch.index.IndexNotFoundException;
+import org.elasticsearch.injection.guice.Inject;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xcontent.XContentType;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+
+public class CreateIndexFromSourceTransportAction extends HandledTransportAction<
+    CreateIndexFromSourceAction.Request,
+    AcknowledgedResponse> {
+    private static final Logger logger = LogManager.getLogger(CreateIndexFromSourceTransportAction.class);
+
+    private final ClusterService clusterService;
+    private final Client client;
+    private final IndexScopedSettings indexScopedSettings;
+
+    @Inject
+    public CreateIndexFromSourceTransportAction(
+        TransportService transportService,
+        ClusterService clusterService,
+        ActionFilters actionFilters,
+        Client client,
+        IndexScopedSettings indexScopedSettings
+    ) {
+        super(
+            CreateIndexFromSourceAction.NAME,
+            false,
+            transportService,
+            actionFilters,
+            CreateIndexFromSourceAction.Request::new,
+            transportService.getThreadPool().executor(ThreadPool.Names.GENERIC)
+        );
+        this.clusterService = clusterService;
+        this.client = client;
+        this.indexScopedSettings = indexScopedSettings;
+    }
+
+    @Override
+    protected void doExecute(Task task, CreateIndexFromSourceAction.Request request, ActionListener<AcknowledgedResponse> listener) {
+
+        IndexMetadata sourceIndex = clusterService.state().getMetadata().index(request.getSourceIndex());
+
+        if (sourceIndex == null) {
+            listener.onFailure(new IndexNotFoundException(request.getSourceIndex()));
+            return;
+        }
+
+        logger.debug("Creating destination index [{}] for source index [{}]", request.getDestIndex(), request.getSourceIndex());
+
+        Settings settings = Settings.builder()
+            // add source settings
+            .put(filterSettings(sourceIndex))
+            // add override settings from request
+            .put(request.getSettingsOverride())
+            .build();
+
+        Map<String, Object> mergeMappings;
+        try {
+            mergeMappings = mergeMappings(sourceIndex.mapping(), request.getMappingsOverride());
+        } catch (IOException e) {
+            listener.onFailure(e);
+            return;
+        }
+
+        var createIndexRequest = new CreateIndexRequest(request.getDestIndex()).settings(settings);
+        if (mergeMappings.isEmpty() == false) {
+            createIndexRequest.mapping(mergeMappings);
+        }
+
+        client.admin().indices().create(createIndexRequest, listener.map(response -> response));
+    }
+
+    private static Map<String, Object> toMap(@Nullable MappingMetadata sourceMapping) {
+        return Optional.ofNullable(sourceMapping)
+            .map(MappingMetadata::source)
+            .map(CompressedXContent::uncompressed)
+            .map(s -> XContentHelper.convertToMap(s, true, XContentType.JSON).v2())
+            .orElse(Map.of());
+    }
+
+    private static Map<String, Object> mergeMappings(@Nullable MappingMetadata sourceMapping, Map<String, Object> mappingAddition)
+        throws IOException {
+        Map<String, Object> combinedMappingMap = new HashMap<>(toMap(sourceMapping));
+        XContentHelper.update(combinedMappingMap, mappingAddition, true);
+        return combinedMappingMap;
+    }
+
+    // Filter source index settings to subset of settings that can be included during reindex.
+    // Similar to the settings filtering done when reindexing for upgrade in Kibana
+    // https://github.com/elastic/kibana/blob/8a8363f02cc990732eb9cbb60cd388643a336bed/x-pack
+    // /plugins/upgrade_assistant/server/lib/reindexing/index_settings.ts#L155
+    private Settings filterSettings(IndexMetadata sourceIndex) {
+        return MetadataCreateIndexService.copySettingsFromSource(false, sourceIndex.getSettings(), indexScopedSettings, Settings.builder())
+            .build();
+    }
+}
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexAction.java
index 00c81fdc9fbc6..2e3fd1b76ed32 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexAction.java
@@ -41,10 +41,6 @@ public Request(StreamInput in) throws IOException {
             this.sourceIndex = in.readString();
         }
 
-        public static Request readFrom(StreamInput in) throws IOException {
-            return new Request(in);
-        }
-
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
index 8863c45691c92..165fd61ae6599 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
@@ -10,10 +10,10 @@
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.admin.indices.create.CreateIndexRequest;
-import org.elasticsearch.action.admin.indices.create.CreateIndexResponse;
 import org.elasticsearch.action.admin.indices.delete.DeleteIndexRequest;
-import org.elasticsearch.action.admin.indices.settings.put.UpdateSettingsRequest;
+import org.elasticsearch.action.admin.indices.readonly.AddIndexBlockRequest;
+import org.elasticsearch.action.admin.indices.readonly.AddIndexBlockResponse;
+import org.elasticsearch.action.admin.indices.readonly.TransportAddIndexBlockAction;
 import org.elasticsearch.action.support.ActionFilters;
 import org.elasticsearch.action.support.HandledTransportAction;
 import org.elasticsearch.action.support.IndicesOptions;
@@ -22,9 +22,7 @@
 import org.elasticsearch.client.internal.Client;
 import org.elasticsearch.cluster.block.ClusterBlockException;
 import org.elasticsearch.cluster.metadata.IndexMetadata;
-import org.elasticsearch.cluster.metadata.MetadataCreateIndexService;
 import org.elasticsearch.cluster.service.ClusterService;
-import org.elasticsearch.common.settings.IndexScopedSettings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.index.reindex.BulkByScrollResponse;
@@ -37,28 +35,25 @@
 
 import java.util.Locale;
 import java.util.Map;
-import java.util.Set;
+
+import static org.elasticsearch.cluster.metadata.IndexMetadata.APIBlock.READ_ONLY;
+import static org.elasticsearch.cluster.metadata.IndexMetadata.APIBlock.WRITE;
 
 public class ReindexDataStreamIndexTransportAction extends HandledTransportAction<
     ReindexDataStreamIndexAction.Request,
     ReindexDataStreamIndexAction.Response> {
 
     private static final Logger logger = LogManager.getLogger(ReindexDataStreamIndexTransportAction.class);
-
-    private static final Set<String> SETTINGS_TO_ADD_BACK = Set.of(IndexMetadata.SETTING_BLOCKS_WRITE, IndexMetadata.SETTING_READ_ONLY);
-
     private static final IndicesOptions IGNORE_MISSING_OPTIONS = IndicesOptions.fromOptions(true, true, false, false);
     private final ClusterService clusterService;
     private final Client client;
-    private final IndexScopedSettings indexScopedSettings;
 
     @Inject
     public ReindexDataStreamIndexTransportAction(
         TransportService transportService,
         ClusterService clusterService,
         ActionFilters actionFilters,
-        Client client,
-        IndexScopedSettings indexScopedSettings
+        Client client
     ) {
         super(
             ReindexDataStreamIndexAction.NAME,
@@ -70,7 +65,6 @@ public ReindexDataStreamIndexTransportAction(
         );
         this.clusterService = clusterService;
         this.client = client;
-        this.indexScopedSettings = indexScopedSettings;
     }
 
     @Override
@@ -96,20 +90,19 @@ protected void doExecute(
 
         SubscribableListener.<AcknowledgedResponse>newForked(l -> setBlockWrites(sourceIndexName, l))
             .<AcknowledgedResponse>andThen(l -> deleteDestIfExists(destIndexName, l))
-            .<CreateIndexResponse>andThen(l -> createIndex(sourceIndex, destIndexName, l))
+            .<AcknowledgedResponse>andThen(l -> createIndex(sourceIndex, destIndexName, l))
             .<BulkByScrollResponse>andThen(l -> reindex(sourceIndexName, destIndexName, l))
-            .<AcknowledgedResponse>andThen(l -> updateSettings(settingsBefore, destIndexName, l))
+            .<AddIndexBlockResponse>andThen(l -> addBlockIfFromSource(READ_ONLY, settingsBefore, destIndexName, l))
+            .<AddIndexBlockResponse>andThen(l -> addBlockIfFromSource(WRITE, settingsBefore, destIndexName, l))
             .andThenApply(ignored -> new ReindexDataStreamIndexAction.Response(destIndexName))
             .addListener(listener);
     }
 
     private void setBlockWrites(String sourceIndexName, ActionListener<AcknowledgedResponse> listener) {
         logger.debug("Setting write block on source index [{}]", sourceIndexName);
-        final Settings readOnlySettings = Settings.builder().put(IndexMetadata.INDEX_BLOCKS_WRITE_SETTING.getKey(), true).build();
-        var updateSettingsRequest = new UpdateSettingsRequest(readOnlySettings, sourceIndexName);
-        client.admin().indices().updateSettings(updateSettingsRequest, new ActionListener<>() {
+        addBlockToIndex(WRITE, sourceIndexName, new ActionListener<>() {
             @Override
-            public void onResponse(AcknowledgedResponse response) {
+            public void onResponse(AddIndexBlockResponse response) {
                 if (response.isAcknowledged()) {
                     listener.onResponse(null);
                 } else {
@@ -121,7 +114,7 @@ public void onResponse(AcknowledgedResponse response) {
             @Override
             public void onFailure(Exception e) {
                 if (e instanceof ClusterBlockException || e.getCause() instanceof ClusterBlockException) {
-                    // It's fine if read-only is already set
+                    // It's fine if block-writes is already set
                     listener.onResponse(null);
                 } else {
                     listener.onFailure(e);
@@ -138,18 +131,23 @@ private void deleteDestIfExists(String destIndexName, ActionListener<Acknowledge
         client.admin().indices().delete(deleteIndexRequest, failIfNotAcknowledged(listener, errorMessage));
     }
 
-    private void createIndex(IndexMetadata sourceIndex, String destIndexName, ActionListener<CreateIndexResponse> listener) {
+    private void createIndex(IndexMetadata sourceIndex, String destIndexName, ActionListener<AcknowledgedResponse> listener) {
         logger.debug("Creating destination index [{}] for source index [{}]", destIndexName, sourceIndex.getIndex().getName());
 
-        // Create destination with subset of source index settings that can be added before reindex
-        var settings = getPreSettings(sourceIndex);
-
-        var sourceMapping = sourceIndex.mapping();
-        Map<String, Object> mapping = sourceMapping != null ? sourceMapping.rawSourceAsMap() : Map.of();
-        var createIndexRequest = new CreateIndexRequest(destIndexName).settings(settings).mapping(mapping);
-
-        var errorMessage = String.format(Locale.ROOT, "Could not create index [%s]", destIndexName);
-        client.admin().indices().create(createIndexRequest, failIfNotAcknowledged(listener, errorMessage));
+        // override read-only settings if they exist
+        var removeReadOnlyOverride = Settings.builder()
+            .putNull(IndexMetadata.SETTING_READ_ONLY)
+            .putNull(IndexMetadata.SETTING_BLOCKS_WRITE)
+            .build();
+
+        var request = new CreateIndexFromSourceAction.Request(
+            sourceIndex.getIndex().getName(),
+            destIndexName,
+            removeReadOnlyOverride,
+            Map.of()
+        );
+        var errorMessage = String.format(Locale.ROOT, "Could not create index [%s]", request.getDestIndex());
+        client.execute(CreateIndexFromSourceAction.INSTANCE, request, failIfNotAcknowledged(listener, errorMessage));
     }
 
     private void reindex(String sourceIndexName, String destIndexName, ActionListener<BulkByScrollResponse> listener) {
@@ -162,35 +160,18 @@ private void reindex(String sourceIndexName, String destIndexName, ActionListene
         client.execute(ReindexAction.INSTANCE, reindexRequest, listener);
     }
 
-    private void updateSettings(Settings settingsBefore, String destIndexName, ActionListener<AcknowledgedResponse> listener) {
-        logger.debug("Adding settings from source index that could not be added before reindex");
-
-        Settings postSettings = getPostSettings(settingsBefore);
-        if (postSettings.isEmpty()) {
+    private void addBlockIfFromSource(
+        IndexMetadata.APIBlock block,
+        Settings settingsBefore,
+        String destIndexName,
+        ActionListener<AddIndexBlockResponse> listener
+    ) {
+        if (settingsBefore.getAsBoolean(block.settingName(), false)) {
+            var errorMessage = String.format(Locale.ROOT, "Add [%s] block to index [%s] was not acknowledged", block.name(), destIndexName);
+            addBlockToIndex(block, destIndexName, failIfNotAcknowledged(listener, errorMessage));
+        } else {
             listener.onResponse(null);
-            return;
         }
-
-        var updateSettingsRequest = new UpdateSettingsRequest(postSettings, destIndexName);
-        var errorMessage = String.format(Locale.ROOT, "Could not update settings on index [%s]", destIndexName);
-        client.admin().indices().updateSettings(updateSettingsRequest, failIfNotAcknowledged(listener, errorMessage));
-    }
-
-    // Filter source index settings to subset of settings that can be included during reindex.
-    // Similar to the settings filtering done when reindexing for upgrade in Kibana
-    // https://github.com/elastic/kibana/blob/8a8363f02cc990732eb9cbb60cd388643a336bed/x-pack
-    // /plugins/upgrade_assistant/server/lib/reindexing/index_settings.ts#L155
-    private Settings getPreSettings(IndexMetadata sourceIndex) {
-        // filter settings that will be added back later
-        var filtered = sourceIndex.getSettings().filter(settingName -> SETTINGS_TO_ADD_BACK.contains(settingName) == false);
-
-        // filter private and non-copyable settings
-        var builder = MetadataCreateIndexService.copySettingsFromSource(false, filtered, indexScopedSettings, Settings.builder());
-        return builder.build();
-    }
-
-    private Settings getPostSettings(Settings settingsBefore) {
-        return settingsBefore.filter(SETTINGS_TO_ADD_BACK::contains);
     }
 
     public static String generateDestIndexName(String sourceIndex) {
@@ -201,11 +182,16 @@ private static <U extends AcknowledgedResponse> ActionListener<U> failIfNotAckno
         ActionListener<U> listener,
         String errorMessage
     ) {
-        return listener.delegateFailureAndWrap((delegate, response) -> {
+        return listener.delegateFailure((delegate, response) -> {
             if (response.isAcknowledged()) {
                 delegate.onResponse(null);
+            } else {
+                delegate.onFailure(new ElasticsearchException(errorMessage));
             }
-            throw new ElasticsearchException(errorMessage);
         });
     }
+
+    private void addBlockToIndex(IndexMetadata.APIBlock block, String index, ActionListener<AddIndexBlockResponse> listener) {
+        client.admin().indices().execute(TransportAddIndexBlockAction.TYPE, new AddIndexBlockRequest(block, index), listener);
+    }
 }
diff --git a/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java b/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java
index c07e4b2c541a2..1cb73de4646cc 100644
--- a/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java
+++ b/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java
@@ -641,6 +641,7 @@ public class Constants {
         new FeatureFlag("reindex_data_stream").isEnabled() ? "indices:admin/data_stream/index/reindex" : null,
         new FeatureFlag("reindex_data_stream").isEnabled() ? "indices:admin/data_stream/reindex" : null,
         new FeatureFlag("reindex_data_stream").isEnabled() ? "indices:admin/data_stream/reindex_cancel" : null,
+        new FeatureFlag("reindex_data_stream").isEnabled() ? "indices:admin/index/create_from_source" : null,
         "internal:admin/repository/verify",
         "internal:admin/repository/verify/coordinate"
     ).filter(Objects::nonNull).collect(Collectors.toUnmodifiableSet());

From dadf875bdf2267e50b12cc6455b3ee1fa3365023 Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Wed, 18 Dec 2024 18:11:14 +0100
Subject: [PATCH 089/119] Push removal of search workers pool setting to v10
 (#118877)

The search workers thread pool has been removed in 8.16. We still support
parsing its size and queue size settings, to prevent issues upon upgrade
for users that may have customized them. We will provide such compatibility
for the entire 9.x series.
---
 .../main/java/org/elasticsearch/node/NodeConstruction.java | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/node/NodeConstruction.java b/server/src/main/java/org/elasticsearch/node/NodeConstruction.java
index 17e56a392daff..5cfe1c104d45e 100644
--- a/server/src/main/java/org/elasticsearch/node/NodeConstruction.java
+++ b/server/src/main/java/org/elasticsearch/node/NodeConstruction.java
@@ -83,7 +83,7 @@
 import org.elasticsearch.core.SuppressForbidden;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.core.Tuple;
-import org.elasticsearch.core.UpdateForV9;
+import org.elasticsearch.core.UpdateForV10;
 import org.elasticsearch.discovery.DiscoveryModule;
 import org.elasticsearch.env.Environment;
 import org.elasticsearch.env.NodeEnvironment;
@@ -553,9 +553,10 @@ private SettingsModule validateSettings(Settings envSettings, Settings settings,
         return settingsModule;
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_FOUNDATIONS)
+    @UpdateForV10(owner = UpdateForV10.Owner.SEARCH_FOUNDATIONS)
     private static void addBwcSearchWorkerSettings(List<Setting<?>> additionalSettings) {
-        // TODO remove the below settings, they are unused and only here to enable BwC for deployments that still use them
+        // Search workers thread pool has been removed in Elasticsearch 8.16.0. These settings are deprecated and take no effect.
+        // They are here only to enable BwC for deployments that still use them
         additionalSettings.add(
             Setting.intSetting("thread_pool.search_worker.queue_size", 0, Setting.Property.NodeScope, Setting.Property.DeprecatedWarning)
         );

From 76b2968360dc4e71309e3b43dc18e6f41a142651 Mon Sep 17 00:00:00 2001
From: Niels Bauman <33722607+nielsbauman@users.noreply.github.com>
Date: Wed, 18 Dec 2024 18:30:58 +0100
Subject: [PATCH 090/119] Disable SLM history in docs tests (#118979)

The SLM history data stream was causing issues in the docs tests because
its presence was flaky and could result in the inability to remove
its index template, which in turn resulted in failing tests.
---
 docs/build.gradle | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/build.gradle b/docs/build.gradle
index dec0de8ffa844..93b7277327280 100644
--- a/docs/build.gradle
+++ b/docs/build.gradle
@@ -130,8 +130,9 @@ testClusters.matching { it.name == "yamlRestTest"}.configureEach {
   setting 'xpack.security.enabled', 'true'
   setting 'xpack.security.authc.api_key.enabled', 'true'
   setting 'xpack.security.authc.token.enabled', 'true'
-  // disable the ILM history for doc tests to avoid potential lingering tasks that'd cause test flakiness
+  // disable the ILM and SLM history for doc tests to avoid potential lingering tasks that'd cause test flakiness
   setting 'indices.lifecycle.history_index_enabled', 'false'
+  setting 'slm.history_index_enabled', 'false'
   setting 'xpack.license.self_generated.type', 'trial'
   setting 'xpack.security.authc.realms.file.file.order', '0'
   setting 'xpack.security.authc.realms.native.native.order', '1'

From 5663efa5e344397d423eefd52d6a06e4fda9b70e Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Wed, 18 Dec 2024 18:38:54 +0100
Subject: [PATCH 091/119] Just mute the bad apple (#118989)

---
 muted-tests.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index f534f24718f52..a06334146ed7b 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -289,6 +289,7 @@ tests:
   method: testThreadContext
   issue: https://github.com/elastic/elasticsearch/issues/118914
 - class: org.elasticsearch.smoketest.SmokeTestMultiNodeClientYamlTestSuiteIT
+  method: test {yaml=indices.create/20_synthetic_source/create index with use_synthetic_source}
   issue: https://github.com/elastic/elasticsearch/issues/118955
 - class: org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
   issue: https://github.com/elastic/elasticsearch/issues/118970

From e741fd62cd70016bc70c49b87def3397a4c48ed1 Mon Sep 17 00:00:00 2001
From: Rene Groeschke <rene@elastic.co>
Date: Wed, 18 Dec 2024 19:30:36 +0100
Subject: [PATCH 092/119] [Build] Build hdfs fixture faster and less (#118801)

The building of the shadowed hdfs2 and hdfs3 fixtures takes quite long time due to being 51 and 80mb in size.
By removing non used dependencies from the shadow jar creation we can speed up this significantly.
Also we avoid building hdfs fixture jars now for compile only (resulting in no shadow jar creation for precommit checks)
---
 test/fixtures/hdfs-fixture/build.gradle       | 81 ++++++++++++++-----
 .../searchable-snapshots/qa/hdfs/build.gradle |  3 +-
 .../qa/hdfs/build.gradle                      |  3 +-
 3 files changed, 66 insertions(+), 21 deletions(-)

diff --git a/test/fixtures/hdfs-fixture/build.gradle b/test/fixtures/hdfs-fixture/build.gradle
index 9dc0263f49aee..8296bc14fd665 100644
--- a/test/fixtures/hdfs-fixture/build.gradle
+++ b/test/fixtures/hdfs-fixture/build.gradle
@@ -10,12 +10,10 @@
 apply plugin: 'elasticsearch.java'
 apply plugin: 'com.gradleup.shadow'
 
+
 import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
 
 configurations {
-//  all {
-//    transitive = true
-//  }
   hdfs2
   hdfs3
   consumable("shadowedHdfs2")
@@ -27,20 +25,76 @@ dependencies {
     transitive false
   }
   compileOnly "junit:junit:${versions.junit}"
-  hdfs2 "org.apache.hadoop:hadoop-minicluster:2.8.5"
-  hdfs3 "org.apache.hadoop:hadoop-minicluster:3.3.1"
 
+  def commonExcludes = [
+    [group: "org.apache.commons", module: "commons-compress"],
+    [group: "org.apache.hadoop", module: "hadoop-mapreduce-client-app"],
+    [group: "org.apache.hadoop", module: "hadoop-mapreduce-client-core"],
+    [group: "org.apache.hadoop", module: "hadoop-mapreduce-client-hs"],
+    [group: "org.apache.hadoop", module: "hadoop-mapreduce-client-jobclient"],
+    [group: "org.apache.hadoop", module: "hadoop-yarn-server-tests"],
+    [group: "org.apache.httpcomponents", module: "httpclient"],
+    [group: "org.apache.zookeeper", module: "zookeeper"],
+    [group: "org.apache.curator", module: "curator-recipes"],
+    [group: "org.apache.curator", module: "curator-client"],
+    [group: "org.apache.curator", module: "curator-framework"],
+    [group: "org.apache.avro", module: "avro"],
+    [group: "log4j", module: "log4j"],
+    [group: "io.netty", module: "netty-all"],
+    [group: "io.netty", module: "netty"],
+    [group: "com.squareup.okhttp", module: "okhttp"],
+    [group: "com.google.guava", module: "guava"],
+    [group: "com.google.code.gson", module: "gson"],
+    [group: "javax.servlet.jsp", module: "jsp-api"],
+    [group: "org.fusesource.leveldbjni", module: "leveldbjni-all"],
+    [group: "commons-cli", module: "commons-cli"],
+    [group: "org.mortbay.jetty", module: "servlet-api"],
+    [group: "commons-logging", module: "commons-logging"],
+    [group: "org.slf4j", module: "slf4j-log4j12"],
+    [group: "commons-codec", module: "commons-codec"],
+    [group: "com.sun.jersey", module: "jersey-core"],
+    [group: "com.sun.jersey", module: "jersey-json"],
+    [group: "com.google.code.findbugs", module: "jsr305"],
+    [group: "com.sun.jersey", module: "jersey-json"],
+    [group: "com.nimbusds", module: "nimbus-jose-jwt"],
+    [group: "com.jcraft", module: "jsch"],
+    [group: "org.slf4j", module: "slf4j-api"],
+  ]
+
+  hdfs2("org.apache.hadoop:hadoop-minicluster:2.8.5") {
+    commonExcludes.each { exclude it }
+    exclude group: "org.apache.commons", module: "commons-math3"
+    exclude group: "xmlenc", module: "xmlenc"
+    exclude group: "net.java.dev.jets3t", module: "jets3t"
+    exclude group: "org.apache.directory.server", module: "apacheds-i18n"
+    exclude group: "xerces", module: "xercesImpl"
+  }
+
+  hdfs3("org.apache.hadoop:hadoop-minicluster:3.3.1") {
+    commonExcludes.each { exclude it }
+    exclude group: "dnsjava", module: "dnsjava"
+    exclude group: "com.google.inject.extensions", module: "guice-servlet"
+    exclude group: "com.google.inject", module: "guice"
+    exclude group: "com.microsoft.sqlserver", module: "mssql-jdbc"
+    exclude group: "com.sun.jersey.contribs", module: "jersey-guice"
+    exclude group: "com.zaxxer", module: "HikariCP-java7"
+    exclude group: "com.sun.jersey", module: "jersey-server"
+    exclude group: "org.bouncycastle", module: "bcpkix-jdk15on"
+    exclude group: "org.bouncycastle", module: "bcprov-jdk15on"
+    exclude group: "org.ehcache", module: "ehcache"
+    exclude group: "org.apache.geronimo.specs", module: "geronimo-jcache_1.0_spec"
+    exclude group: "org.xerial.snappy", module: "snappy-java"
+  }
 }
 
 tasks.named("shadowJar").configure {
   archiveClassifier.set("hdfs3")
   // fix issues with signed jars
-
   relocate("org.apache.hadoop", "fixture.hdfs3.org.apache.hadoop") {
     exclude "org.apache.hadoop.hdfs.protocol.ClientProtocol"
     exclude "org.apache.hadoop.ipc.StandbyException"
   }
-  configurations << project.configurations.hdfs3
+  configurations.add(project.configurations.hdfs3)
 }
 
 def hdfs2Jar = tasks.register("hdfs2jar", ShadowJar) {
@@ -50,26 +104,15 @@ def hdfs2Jar = tasks.register("hdfs2jar", ShadowJar) {
   }
   archiveClassifier.set("hdfs2")
   from sourceSets.main.output
-  configurations << project.configurations.hdfs2
+  configurations.add(project.configurations.hdfs2)
 }
 
 tasks.withType(ShadowJar).configureEach {
   dependencies {
-//    exclude(dependency('commons-io:commons-io:2.8.0'))
     exclude(dependency("com.carrotsearch.randomizedtesting:randomizedtesting-runner:.*"))
     exclude(dependency("junit:junit:.*"))
-    exclude(dependency("org.slf4j:slf4j-api:.*"))
-    exclude(dependency("com.google.guava:guava:.*"))
-    exclude(dependency("org.apache.commons:commons-compress:.*"))
-    exclude(dependency("commons-logging:commons-logging:.*"))
-    exclude(dependency("commons-codec:commons-codec:.*"))
-    exclude(dependency("org.apache.httpcomponents:httpclient:.*"))
     exclude(dependency("org.apache.httpcomponents:httpcore:.*"))
     exclude(dependency("org.apache.logging.log4j:log4j-1.2-api:.*"))
-    exclude(dependency("log4j:log4j:.*"))
-    exclude(dependency("io.netty:.*:.*"))
-    exclude(dependency("com.nimbusds:nimbus-jose-jwt:.*"))
-    exclude(dependency("commons-cli:commons-cli:1.2"))
     exclude(dependency("net.java.dev.jna:jna:.*"))
     exclude(dependency("org.objenesis:objenesis:.*"))
     exclude(dependency('com.fasterxml.jackson.core:.*:.*'))
diff --git a/x-pack/plugin/searchable-snapshots/qa/hdfs/build.gradle b/x-pack/plugin/searchable-snapshots/qa/hdfs/build.gradle
index b41e0f8dcc1cf..4577935e4e08d 100644
--- a/x-pack/plugin/searchable-snapshots/qa/hdfs/build.gradle
+++ b/x-pack/plugin/searchable-snapshots/qa/hdfs/build.gradle
@@ -12,7 +12,8 @@ apply plugin: 'elasticsearch.internal-available-ports'
 dependencies {
   clusterPlugins project(':plugins:repository-hdfs')
   javaRestTestImplementation(testArtifact(project(xpackModule('searchable-snapshots'))))
-  javaRestTestImplementation project(path: ':test:fixtures:hdfs-fixture', configuration:"shadowedHdfs2")
+  javaRestTestCompileOnly project(path: ':test:fixtures:hdfs-fixture')
+  javaRestTestRuntimeOnly project(path: ':test:fixtures:hdfs-fixture', configuration:"shadowedHdfs2")
   javaRestTestImplementation project(':test:fixtures:krb5kdc-fixture')
   javaRestTestRuntimeOnly "com.google.guava:guava:16.0.1"
   javaRestTestRuntimeOnly "commons-cli:commons-cli:1.2"
diff --git a/x-pack/plugin/snapshot-repo-test-kit/qa/hdfs/build.gradle b/x-pack/plugin/snapshot-repo-test-kit/qa/hdfs/build.gradle
index 81eb82a522389..d4615260952d1 100644
--- a/x-pack/plugin/snapshot-repo-test-kit/qa/hdfs/build.gradle
+++ b/x-pack/plugin/snapshot-repo-test-kit/qa/hdfs/build.gradle
@@ -10,7 +10,8 @@ apply plugin: 'elasticsearch.rest-resources'
 
 dependencies {
   javaRestTestImplementation testArtifact(project(xpackModule('snapshot-repo-test-kit')))
-  javaRestTestImplementation project(path: ':test:fixtures:hdfs-fixture', configuration:"shadow")
+  javaRestTestCompileOnly project(path: ':test:fixtures:hdfs-fixture')
+  javaRestTestRuntimeOnly project(path: ':test:fixtures:hdfs-fixture', configuration:"shadow")
   javaRestTestImplementation project(':test:fixtures:krb5kdc-fixture')
   javaRestTestImplementation "org.slf4j:slf4j-api:${versions.slf4j}"
   javaRestTestImplementation "org.slf4j:slf4j-simple:${versions.slf4j}"

From 3a15d0b0840c911654d7affb779fc3c814e0b646 Mon Sep 17 00:00:00 2001
From: Parker Timmins <parker.timmins@elastic.co>
Date: Wed, 18 Dec 2024 12:45:40 -0600
Subject: [PATCH 093/119] Mute test

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index a06334146ed7b..81480e89d1e8b 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -293,6 +293,8 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118955
 - class: org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
   issue: https://github.com/elastic/elasticsearch/issues/118970
+- class:  org.elasticsearch.xpack.migrate.action.ReindexDatastreamIndexTransportActionIT
+  issue: https://github.com/elastic/elasticsearch/issues/119002
 
 # Examples:
 #

From fab3bff84fb3648cee59e1f5ac8a21dbb1532a66 Mon Sep 17 00:00:00 2001
From: Blake Niemyjski <bniemyjski@gmail.com>
Date: Wed, 18 Dec 2024 12:47:45 -0600
Subject: [PATCH 094/119] Update jvm.options (#118716)

---
 distribution/src/config/jvm.options | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/distribution/src/config/jvm.options b/distribution/src/config/jvm.options
index f55d90933ed61..94fc6f2cb9025 100644
--- a/distribution/src/config/jvm.options
+++ b/distribution/src/config/jvm.options
@@ -9,7 +9,7 @@
 ## should create one or more files in the jvm.options.d
 ## directory containing your adjustments.
 ##
-## See https://www.elastic.co/guide/en/elasticsearch/reference/@project.minor.version@/jvm-options.html
+## See https://www.elastic.co/guide/en/elasticsearch/reference/@project.minor.version@/advanced-configuration.html#set-jvm-options
 ## for more information.
 ##
 ################################################################

From 65faabd08d79043d10a0351e57f1b0c6239862da Mon Sep 17 00:00:00 2001
From: Stanislav Malyshev <smalyshev@users.noreply.github.com>
Date: Wed, 18 Dec 2024 11:50:18 -0700
Subject: [PATCH 095/119] Refactor pausable field plugin to have common
 codebase (#118909)

---
 .../action/AbstractPausableIntegTestCase.java | 62 +------------
 .../esql/action/AbstractPauseFieldPlugin.java | 86 +++++++++++++++++++
 .../esql/action/CrossClusterAsyncQueryIT.java | 72 +---------------
 .../action/CrossClustersCancellationIT.java   | 80 ++---------------
 .../esql/action/SimplePauseFieldPlugin.java   | 36 ++++++++
 5 files changed, 136 insertions(+), 200 deletions(-)
 create mode 100644 x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPauseFieldPlugin.java
 create mode 100644 x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/SimplePauseFieldPlugin.java

diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPausableIntegTestCase.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPausableIntegTestCase.java
index 8de65847c3f85..8054b260f0060 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPausableIntegTestCase.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPausableIntegTestCase.java
@@ -10,26 +10,15 @@
 import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.CollectionUtils;
 import org.elasticsearch.index.engine.SegmentsStats;
-import org.elasticsearch.index.mapper.OnScriptError;
-import org.elasticsearch.logging.LogManager;
-import org.elasticsearch.logging.Logger;
 import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.plugins.ScriptPlugin;
-import org.elasticsearch.script.LongFieldScript;
-import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptEngine;
-import org.elasticsearch.search.lookup.SearchLookup;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.json.JsonXContent;
 import org.junit.Before;
 
 import java.io.IOException;
 import java.util.Collection;
-import java.util.Map;
-import java.util.Set;
 import java.util.concurrent.Semaphore;
 import java.util.concurrent.TimeUnit;
 
@@ -40,8 +29,6 @@
  */
 public abstract class AbstractPausableIntegTestCase extends AbstractEsqlIntegTestCase {
 
-    private static final Logger LOGGER = LogManager.getLogger(AbstractPausableIntegTestCase.class);
-
     protected static final Semaphore scriptPermits = new Semaphore(0);
 
     protected int pageSize = -1;
@@ -108,53 +95,10 @@ public void setupIndex() throws IOException {
         }
     }
 
-    public static class PausableFieldPlugin extends Plugin implements ScriptPlugin {
-
+    public static class PausableFieldPlugin extends AbstractPauseFieldPlugin {
         @Override
-        public ScriptEngine getScriptEngine(Settings settings, Collection<ScriptContext<?>> contexts) {
-            return new ScriptEngine() {
-                @Override
-                public String getType() {
-                    return "pause";
-                }
-
-                @Override
-                @SuppressWarnings("unchecked")
-                public <FactoryType> FactoryType compile(
-                    String name,
-                    String code,
-                    ScriptContext<FactoryType> context,
-                    Map<String, String> params
-                ) {
-                    return (FactoryType) new LongFieldScript.Factory() {
-                        @Override
-                        public LongFieldScript.LeafFactory newFactory(
-                            String fieldName,
-                            Map<String, Object> params,
-                            SearchLookup searchLookup,
-                            OnScriptError onScriptError
-                        ) {
-                            return ctx -> new LongFieldScript(fieldName, params, searchLookup, onScriptError, ctx) {
-                                @Override
-                                public void execute() {
-                                    try {
-                                        assertTrue(scriptPermits.tryAcquire(1, TimeUnit.MINUTES));
-                                    } catch (Exception e) {
-                                        throw new AssertionError(e);
-                                    }
-                                    LOGGER.debug("--> emitting value");
-                                    emit(1);
-                                }
-                            };
-                        }
-                    };
-                }
-
-                @Override
-                public Set<ScriptContext<?>> getSupportedContexts() {
-                    return Set.of(LongFieldScript.CONTEXT);
-                }
-            };
+        protected boolean onWait() throws InterruptedException {
+            return scriptPermits.tryAcquire(1, TimeUnit.MINUTES);
         }
     }
 }
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPauseFieldPlugin.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPauseFieldPlugin.java
new file mode 100644
index 0000000000000..5554f7e571dfb
--- /dev/null
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/AbstractPauseFieldPlugin.java
@@ -0,0 +1,86 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.action;
+
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.mapper.OnScriptError;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.plugins.ScriptPlugin;
+import org.elasticsearch.script.LongFieldScript;
+import org.elasticsearch.script.ScriptContext;
+import org.elasticsearch.script.ScriptEngine;
+import org.elasticsearch.search.lookup.SearchLookup;
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.Set;
+
+import static org.junit.Assert.assertTrue;
+
+/**
+ * A plugin that provides a script language "pause" that can be used to simulate slow running queries.
+ * See also {@link AbstractPausableIntegTestCase}.
+ */
+public abstract class AbstractPauseFieldPlugin extends Plugin implements ScriptPlugin {
+
+    // Called when the engine enters the execute() method.
+    protected void onStartExecute() {}
+
+    // Called when the engine needs to wait for further execution to be allowed.
+    protected abstract boolean onWait() throws InterruptedException;
+
+    @Override
+    public ScriptEngine getScriptEngine(Settings settings, Collection<ScriptContext<?>> contexts) {
+        return new ScriptEngine() {
+            @Override
+            public String getType() {
+                return "pause";
+            }
+
+            @Override
+            @SuppressWarnings("unchecked")
+            public <FactoryType> FactoryType compile(
+                String name,
+                String code,
+                ScriptContext<FactoryType> context,
+                Map<String, String> params
+            ) {
+                if (context == LongFieldScript.CONTEXT) {
+                    return (FactoryType) new LongFieldScript.Factory() {
+                        @Override
+                        public LongFieldScript.LeafFactory newFactory(
+                            String fieldName,
+                            Map<String, Object> params,
+                            SearchLookup searchLookup,
+                            OnScriptError onScriptError
+                        ) {
+                            return ctx -> new LongFieldScript(fieldName, params, searchLookup, onScriptError, ctx) {
+                                @Override
+                                public void execute() {
+                                    onStartExecute();
+                                    try {
+                                        assertTrue(onWait());
+                                    } catch (InterruptedException e) {
+                                        throw new AssertionError(e);
+                                    }
+                                    emit(1);
+                                }
+                            };
+                        }
+                    };
+                }
+                throw new IllegalStateException("unsupported type " + context);
+            }
+
+            @Override
+            public Set<ScriptContext<?>> getSupportedContexts() {
+                return Set.of(LongFieldScript.CONTEXT);
+            }
+        };
+    }
+}
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java
index a2bba19db50fc..3926ea4c27a3d 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java
@@ -19,14 +19,8 @@
 import org.elasticsearch.compute.operator.exchange.ExchangeService;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.core.Tuple;
-import org.elasticsearch.index.mapper.OnScriptError;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.plugins.ScriptPlugin;
-import org.elasticsearch.script.LongFieldScript;
-import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptEngine;
-import org.elasticsearch.search.lookup.SearchLookup;
 import org.elasticsearch.test.AbstractMultiClustersTestCase;
 import org.elasticsearch.test.XContentTestUtils;
 import org.elasticsearch.transport.RemoteClusterAware;
@@ -44,7 +38,6 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
-import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicReference;
 
@@ -80,7 +73,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins(String clusterAlias) {
         plugins.add(EsqlPluginWithEnterpriseOrTrialLicense.class);
         plugins.add(EsqlAsyncActionIT.LocalStateEsqlAsync.class); // allows the async_search DELETE action
         plugins.add(InternalExchangePlugin.class);
-        plugins.add(PauseFieldPlugin.class);
+        plugins.add(SimplePauseFieldPlugin.class);
         return plugins;
     }
 
@@ -99,64 +92,7 @@ public List<Setting<?>> getSettings() {
 
     @Before
     public void resetPlugin() {
-        PauseFieldPlugin.allowEmitting = new CountDownLatch(1);
-        PauseFieldPlugin.startEmitting = new CountDownLatch(1);
-    }
-
-    public static class PauseFieldPlugin extends Plugin implements ScriptPlugin {
-        public static CountDownLatch startEmitting = new CountDownLatch(1);
-        public static CountDownLatch allowEmitting = new CountDownLatch(1);
-
-        @Override
-        public ScriptEngine getScriptEngine(Settings settings, Collection<ScriptContext<?>> contexts) {
-            return new ScriptEngine() {
-                @Override
-
-                public String getType() {
-                    return "pause";
-                }
-
-                @Override
-                @SuppressWarnings("unchecked")
-                public <FactoryType> FactoryType compile(
-                    String name,
-                    String code,
-                    ScriptContext<FactoryType> context,
-                    Map<String, String> params
-                ) {
-                    if (context == LongFieldScript.CONTEXT) {
-                        return (FactoryType) new LongFieldScript.Factory() {
-                            @Override
-                            public LongFieldScript.LeafFactory newFactory(
-                                String fieldName,
-                                Map<String, Object> params,
-                                SearchLookup searchLookup,
-                                OnScriptError onScriptError
-                            ) {
-                                return ctx -> new LongFieldScript(fieldName, params, searchLookup, onScriptError, ctx) {
-                                    @Override
-                                    public void execute() {
-                                        startEmitting.countDown();
-                                        try {
-                                            assertTrue(allowEmitting.await(30, TimeUnit.SECONDS));
-                                        } catch (InterruptedException e) {
-                                            throw new AssertionError(e);
-                                        }
-                                        emit(1);
-                                    }
-                                };
-                            }
-                        };
-                    }
-                    throw new IllegalStateException("unsupported type " + context);
-                }
-
-                @Override
-                public Set<ScriptContext<?>> getSupportedContexts() {
-                    return Set.of(LongFieldScript.CONTEXT);
-                }
-            };
-        }
+        SimplePauseFieldPlugin.resetPlugin();
     }
 
     /**
@@ -184,7 +120,7 @@ public void testSuccessfulPathways() throws Exception {
         }
 
         // wait until we know that the query against 'remote-b:blocking' has started
-        PauseFieldPlugin.startEmitting.await(30, TimeUnit.SECONDS);
+        SimplePauseFieldPlugin.startEmitting.await(30, TimeUnit.SECONDS);
 
         // wait until the query of 'cluster-a:logs-*' has finished (it is not blocked since we are not searching the 'blocking' index on it)
         assertBusy(() -> {
@@ -234,7 +170,7 @@ public void testSuccessfulPathways() throws Exception {
         }
 
         // allow remoteB query to proceed
-        PauseFieldPlugin.allowEmitting.countDown();
+        SimplePauseFieldPlugin.allowEmitting.countDown();
 
         // wait until both remoteB and local queries have finished
         assertBusy(() -> {
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java
index 17f5f81486651..cfe6fdeccb190 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java
@@ -15,18 +15,11 @@
 import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.common.settings.Setting;
-import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.transport.TransportAddress;
 import org.elasticsearch.compute.operator.DriverTaskRunner;
 import org.elasticsearch.compute.operator.exchange.ExchangeService;
 import org.elasticsearch.core.TimeValue;
-import org.elasticsearch.index.mapper.OnScriptError;
 import org.elasticsearch.plugins.Plugin;
-import org.elasticsearch.plugins.ScriptPlugin;
-import org.elasticsearch.script.LongFieldScript;
-import org.elasticsearch.script.ScriptContext;
-import org.elasticsearch.script.ScriptEngine;
-import org.elasticsearch.search.lookup.SearchLookup;
 import org.elasticsearch.tasks.TaskInfo;
 import org.elasticsearch.test.AbstractMultiClustersTestCase;
 import org.elasticsearch.transport.TransportService;
@@ -38,9 +31,6 @@
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.List;
-import java.util.Map;
-import java.util.Set;
-import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 
 import static org.elasticsearch.xpack.esql.EsqlTestUtils.getValuesList;
@@ -63,7 +53,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins(String clusterAlias) {
         List<Class<? extends Plugin>> plugins = new ArrayList<>(super.nodePlugins(clusterAlias));
         plugins.add(EsqlPluginWithEnterpriseOrTrialLicense.class);
         plugins.add(InternalExchangePlugin.class);
-        plugins.add(PauseFieldPlugin.class);
+        plugins.add(SimplePauseFieldPlugin.class);
         return plugins;
     }
 
@@ -82,63 +72,7 @@ public List<Setting<?>> getSettings() {
 
     @Before
     public void resetPlugin() {
-        PauseFieldPlugin.allowEmitting = new CountDownLatch(1);
-        PauseFieldPlugin.startEmitting = new CountDownLatch(1);
-    }
-
-    public static class PauseFieldPlugin extends Plugin implements ScriptPlugin {
-        public static CountDownLatch startEmitting = new CountDownLatch(1);
-        public static CountDownLatch allowEmitting = new CountDownLatch(1);
-
-        @Override
-        public ScriptEngine getScriptEngine(Settings settings, Collection<ScriptContext<?>> contexts) {
-            return new ScriptEngine() {
-                @Override
-                public String getType() {
-                    return "pause";
-                }
-
-                @Override
-                @SuppressWarnings("unchecked")
-                public <FactoryType> FactoryType compile(
-                    String name,
-                    String code,
-                    ScriptContext<FactoryType> context,
-                    Map<String, String> params
-                ) {
-                    if (context == LongFieldScript.CONTEXT) {
-                        return (FactoryType) new LongFieldScript.Factory() {
-                            @Override
-                            public LongFieldScript.LeafFactory newFactory(
-                                String fieldName,
-                                Map<String, Object> params,
-                                SearchLookup searchLookup,
-                                OnScriptError onScriptError
-                            ) {
-                                return ctx -> new LongFieldScript(fieldName, params, searchLookup, onScriptError, ctx) {
-                                    @Override
-                                    public void execute() {
-                                        startEmitting.countDown();
-                                        try {
-                                            assertTrue(allowEmitting.await(30, TimeUnit.SECONDS));
-                                        } catch (InterruptedException e) {
-                                            throw new AssertionError(e);
-                                        }
-                                        emit(1);
-                                    }
-                                };
-                            }
-                        };
-                    }
-                    throw new IllegalStateException("unsupported type " + context);
-                }
-
-                @Override
-                public Set<ScriptContext<?>> getSupportedContexts() {
-                    return Set.of(LongFieldScript.CONTEXT);
-                }
-            };
-        }
+        SimplePauseFieldPlugin.resetPlugin();
     }
 
     private void createRemoteIndex(int numDocs) throws Exception {
@@ -169,7 +103,7 @@ public void testCancel() throws Exception {
         request.pragmas(randomPragmas());
         PlainActionFuture<EsqlQueryResponse> requestFuture = new PlainActionFuture<>();
         client().execute(EsqlQueryAction.INSTANCE, request, requestFuture);
-        assertTrue(PauseFieldPlugin.startEmitting.await(30, TimeUnit.SECONDS));
+        assertTrue(SimplePauseFieldPlugin.startEmitting.await(30, TimeUnit.SECONDS));
         List<TaskInfo> rootTasks = new ArrayList<>();
         assertBusy(() -> {
             List<TaskInfo> tasks = client().admin().cluster().prepareListTasks().setActions(EsqlQueryAction.NAME).get().getTasks();
@@ -192,7 +126,7 @@ public void testCancel() throws Exception {
                 }
             });
         } finally {
-            PauseFieldPlugin.allowEmitting.countDown();
+            SimplePauseFieldPlugin.allowEmitting.countDown();
         }
         Exception error = expectThrows(Exception.class, requestFuture::actionGet);
         assertThat(error.getMessage(), containsString("proxy timeout"));
@@ -223,7 +157,7 @@ public void testSameRemoteClusters() throws Exception {
                     assertThat(tasks, hasSize(moreClusters + 1));
                 });
             } finally {
-                PauseFieldPlugin.allowEmitting.countDown();
+                SimplePauseFieldPlugin.allowEmitting.countDown();
             }
             try (EsqlQueryResponse resp = future.actionGet(30, TimeUnit.SECONDS)) {
                 // TODO: This produces incorrect results because data on the remote cluster is processed multiple times.
@@ -244,7 +178,7 @@ public void testTasks() throws Exception {
         request.query("FROM *:test | STATS total=sum(const) | LIMIT 1");
         request.pragmas(randomPragmas());
         ActionFuture<EsqlQueryResponse> requestFuture = client().execute(EsqlQueryAction.INSTANCE, request);
-        assertTrue(PauseFieldPlugin.startEmitting.await(30, TimeUnit.SECONDS));
+        assertTrue(SimplePauseFieldPlugin.startEmitting.await(30, TimeUnit.SECONDS));
         try {
             assertBusy(() -> {
                 List<TaskInfo> clusterTasks = client(REMOTE_CLUSTER).admin()
@@ -270,7 +204,7 @@ public void testTasks() throws Exception {
                     \\_ExchangeSinkOperator"""));
             });
         } finally {
-            PauseFieldPlugin.allowEmitting.countDown();
+            SimplePauseFieldPlugin.allowEmitting.countDown();
         }
         requestFuture.actionGet(30, TimeUnit.SECONDS).close();
     }
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/SimplePauseFieldPlugin.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/SimplePauseFieldPlugin.java
new file mode 100644
index 0000000000000..3ba73dd9a402e
--- /dev/null
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/SimplePauseFieldPlugin.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.action;
+
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * A plugin that provides a script language "pause" that can be used to simulate slow running queries.
+ * This implementation allows to know when it arrives at execute() via startEmitting and to allow the execution to proceed
+ * via allowEmitting.
+ */
+public class SimplePauseFieldPlugin extends AbstractPauseFieldPlugin {
+    public static CountDownLatch startEmitting = new CountDownLatch(1);
+    public static CountDownLatch allowEmitting = new CountDownLatch(1);
+
+    public static void resetPlugin() {
+        allowEmitting = new CountDownLatch(1);
+        startEmitting = new CountDownLatch(1);
+    }
+
+    @Override
+    public void onStartExecute() {
+        startEmitting.countDown();
+    }
+
+    @Override
+    public boolean onWait() throws InterruptedException {
+        return allowEmitting.await(30, TimeUnit.SECONDS);
+    }
+}

From 9cc362b9667f0903b1f124968cfb817cb56c86aa Mon Sep 17 00:00:00 2001
From: Patrick Doyle <810052+prdoyle@users.noreply.github.com>
Date: Wed, 18 Dec 2024 14:08:51 -0500
Subject: [PATCH 096/119] Entitlements: More robust frame skipping (#118983)

* More robust frame skipping

* Cosmetic improvements for clarity

* Explicit set of runtime classes

* Pass entitlements runtime module to PolicyManager ctor

* Use the term "entitlements module" and filter instead of dropWhile

* [CI] Auto commit changes from spotless

---------

Co-authored-by: elasticsearchmachine <infra-root+elasticsearchmachine@elastic.co>
---
 .../EntitlementInitialization.java            |  3 +-
 .../runtime/policy/PolicyManager.java         | 71 ++++++++++----
 .../runtime/policy/PolicyManagerTests.java    | 94 +++++++++++++++++--
 3 files changed, 140 insertions(+), 28 deletions(-)

diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java
index 9118f67cdc145..8e4cddc4d63ee 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java
@@ -53,6 +53,7 @@
 public class EntitlementInitialization {
 
     private static final String POLICY_FILE_NAME = "entitlement-policy.yaml";
+    private static final Module ENTITLEMENTS_MODULE = PolicyManager.class.getModule();
 
     private static ElasticsearchEntitlementChecker manager;
 
@@ -92,7 +93,7 @@ private static PolicyManager createPolicyManager() throws IOException {
             "server",
             List.of(new Scope("org.elasticsearch.server", List.of(new ExitVMEntitlement(), new CreateClassLoaderEntitlement())))
         );
-        return new PolicyManager(serverPolicy, pluginPolicies, EntitlementBootstrap.bootstrapArgs().pluginResolver());
+        return new PolicyManager(serverPolicy, pluginPolicies, EntitlementBootstrap.bootstrapArgs().pluginResolver(), ENTITLEMENTS_MODULE);
     }
 
     private static Map<String, Policy> createPluginPolicies(Collection<EntitlementBootstrap.PluginData> pluginData) throws IOException {
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
index 8d3efe4eb98e6..74ba986041dac 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.logging.LogManager;
 import org.elasticsearch.logging.Logger;
 
+import java.lang.StackWalker.StackFrame;
 import java.lang.module.ModuleFinder;
 import java.lang.module.ModuleReference;
 import java.util.ArrayList;
@@ -29,6 +30,10 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
+import static java.lang.StackWalker.Option.RETAIN_CLASS_REFERENCE;
+import static java.util.Objects.requireNonNull;
+import static java.util.function.Predicate.not;
+
 public class PolicyManager {
     private static final Logger logger = LogManager.getLogger(ElasticsearchEntitlementChecker.class);
 
@@ -63,6 +68,11 @@ public <E extends Entitlement> Stream<E> getEntitlements(Class<E> entitlementCla
 
     private static final Set<Module> systemModules = findSystemModules();
 
+    /**
+     * Frames originating from this module are ignored in the permission logic.
+     */
+    private final Module entitlementsModule;
+
     private static Set<Module> findSystemModules() {
         var systemModulesDescriptors = ModuleFinder.ofSystem()
             .findAll()
@@ -77,13 +87,18 @@ private static Set<Module> findSystemModules() {
             .collect(Collectors.toUnmodifiableSet());
     }
 
-    public PolicyManager(Policy defaultPolicy, Map<String, Policy> pluginPolicies, Function<Class<?>, String> pluginResolver) {
-        this.serverEntitlements = buildScopeEntitlementsMap(Objects.requireNonNull(defaultPolicy));
-        this.pluginsEntitlements = Objects.requireNonNull(pluginPolicies)
-            .entrySet()
+    public PolicyManager(
+        Policy defaultPolicy,
+        Map<String, Policy> pluginPolicies,
+        Function<Class<?>, String> pluginResolver,
+        Module entitlementsModule
+    ) {
+        this.serverEntitlements = buildScopeEntitlementsMap(requireNonNull(defaultPolicy));
+        this.pluginsEntitlements = requireNonNull(pluginPolicies).entrySet()
             .stream()
             .collect(Collectors.toUnmodifiableMap(Map.Entry::getKey, e -> buildScopeEntitlementsMap(e.getValue())));
         this.pluginResolver = pluginResolver;
+        this.entitlementsModule = entitlementsModule;
     }
 
     private static Map<String, List<Entitlement>> buildScopeEntitlementsMap(Policy policy) {
@@ -185,7 +200,16 @@ private static boolean isServerModule(Module requestingModule) {
         return requestingModule.isNamed() && requestingModule.getLayer() == ModuleLayer.boot();
     }
 
-    private static Module requestingModule(Class<?> callerClass) {
+    /**
+     * Walks the stack to determine which module's entitlements should be checked.
+     *
+     * @param callerClass when non-null will be used if its module is suitable;
+     *                    this is a fast-path check that can avoid the stack walk
+     *                    in cases where the caller class is available.
+     * @return the requesting module, or {@code null} if the entire call stack
+     * comes from modules that are trusted.
+     */
+    Module requestingModule(Class<?> callerClass) {
         if (callerClass != null) {
             Module callerModule = callerClass.getModule();
             if (systemModules.contains(callerModule) == false) {
@@ -193,21 +217,34 @@ private static Module requestingModule(Class<?> callerClass) {
                 return callerModule;
             }
         }
-        int framesToSkip = 1  // getCallingClass (this method)
-            + 1  // the checkXxx method
-            + 1  // the runtime config method
-            + 1  // the instrumented method
-        ;
-        Optional<Module> module = StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE)
-            .walk(
-                s -> s.skip(framesToSkip)
-                    .map(f -> f.getDeclaringClass().getModule())
-                    .filter(m -> systemModules.contains(m) == false)
-                    .findFirst()
-            );
+        Optional<Module> module = StackWalker.getInstance(RETAIN_CLASS_REFERENCE)
+            .walk(frames -> findRequestingModule(frames.map(StackFrame::getDeclaringClass)));
         return module.orElse(null);
     }
 
+    /**
+     * Given a stream of classes corresponding to the frames from a {@link StackWalker},
+     * returns the module whose entitlements should be checked.
+     *
+     * @throws NullPointerException if the requesting module is {@code null}
+     */
+    Optional<Module> findRequestingModule(Stream<Class<?>> classes) {
+        return classes.map(Objects::requireNonNull)
+            .map(PolicyManager::moduleOf)
+            .filter(m -> m != entitlementsModule)  // Ignore the entitlements library itself
+            .filter(not(systemModules::contains))  // Skip trusted JDK modules
+            .findFirst();
+    }
+
+    private static Module moduleOf(Class<?> c) {
+        var result = c.getModule();
+        if (result == null) {
+            throw new NullPointerException("Entitlements system does not support non-modular class [" + c.getName() + "]");
+        } else {
+            return result;
+        }
+    }
+
     private static boolean isTriviallyAllowed(Module requestingModule) {
         if (requestingModule == null) {
             logger.debug("Entitlement trivially allowed: entire call stack is in composed of classes in system modules");
diff --git a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java
index 45bdf2e457824..0789fcc8dc770 100644
--- a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java
+++ b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java
@@ -22,6 +22,7 @@
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.stream.Stream;
 
 import static java.util.Map.entry;
 import static org.elasticsearch.entitlement.runtime.policy.PolicyManager.ALL_UNNAMED;
@@ -37,11 +38,14 @@
 @ESTestCase.WithoutSecurityManager
 public class PolicyManagerTests extends ESTestCase {
 
+    private static final Module NO_ENTITLEMENTS_MODULE = null;
+
     public void testGetEntitlementsThrowsOnMissingPluginUnnamedModule() {
         var policyManager = new PolicyManager(
             createEmptyTestServerPolicy(),
             Map.of("plugin1", createPluginPolicy("plugin.module")),
-            c -> "plugin1"
+            c -> "plugin1",
+            NO_ENTITLEMENTS_MODULE
         );
 
         // Any class from the current module (unnamed) will do
@@ -62,7 +66,7 @@ public void testGetEntitlementsThrowsOnMissingPluginUnnamedModule() {
     }
 
     public void testGetEntitlementsThrowsOnMissingPolicyForPlugin() {
-        var policyManager = new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "plugin1");
+        var policyManager = new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "plugin1", NO_ENTITLEMENTS_MODULE);
 
         // Any class from the current module (unnamed) will do
         var callerClass = this.getClass();
@@ -82,7 +86,7 @@ public void testGetEntitlementsThrowsOnMissingPolicyForPlugin() {
     }
 
     public void testGetEntitlementsFailureIsCached() {
-        var policyManager = new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "plugin1");
+        var policyManager = new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "plugin1", NO_ENTITLEMENTS_MODULE);
 
         // Any class from the current module (unnamed) will do
         var callerClass = this.getClass();
@@ -103,7 +107,8 @@ public void testGetEntitlementsReturnsEntitlementsForPluginUnnamedModule() {
         var policyManager = new PolicyManager(
             createEmptyTestServerPolicy(),
             Map.ofEntries(entry("plugin2", createPluginPolicy(ALL_UNNAMED))),
-            c -> "plugin2"
+            c -> "plugin2",
+            NO_ENTITLEMENTS_MODULE
         );
 
         // Any class from the current module (unnamed) will do
@@ -115,7 +120,7 @@ public void testGetEntitlementsReturnsEntitlementsForPluginUnnamedModule() {
     }
 
     public void testGetEntitlementsThrowsOnMissingPolicyForServer() throws ClassNotFoundException {
-        var policyManager = new PolicyManager(createTestServerPolicy("example"), Map.of(), c -> null);
+        var policyManager = new PolicyManager(createTestServerPolicy("example"), Map.of(), c -> null, NO_ENTITLEMENTS_MODULE);
 
         // Tests do not run modular, so we cannot use a server class.
         // But we know that in production code the server module and its classes are in the boot layer.
@@ -138,7 +143,7 @@ public void testGetEntitlementsThrowsOnMissingPolicyForServer() throws ClassNotF
     }
 
     public void testGetEntitlementsReturnsEntitlementsForServerModule() throws ClassNotFoundException {
-        var policyManager = new PolicyManager(createTestServerPolicy("jdk.httpserver"), Map.of(), c -> null);
+        var policyManager = new PolicyManager(createTestServerPolicy("jdk.httpserver"), Map.of(), c -> null, NO_ENTITLEMENTS_MODULE);
 
         // Tests do not run modular, so we cannot use a server class.
         // But we know that in production code the server module and its classes are in the boot layer.
@@ -155,12 +160,13 @@ public void testGetEntitlementsReturnsEntitlementsForServerModule() throws Class
     public void testGetEntitlementsReturnsEntitlementsForPluginModule() throws IOException, ClassNotFoundException {
         final Path home = createTempDir();
 
-        Path jar = creteMockPluginJar(home);
+        Path jar = createMockPluginJar(home);
 
         var policyManager = new PolicyManager(
             createEmptyTestServerPolicy(),
             Map.of("mock-plugin", createPluginPolicy("org.example.plugin")),
-            c -> "mock-plugin"
+            c -> "mock-plugin",
+            NO_ENTITLEMENTS_MODULE
         );
 
         var layer = createLayerForJar(jar, "org.example.plugin");
@@ -179,7 +185,8 @@ public void testGetEntitlementsResultIsCached() {
         var policyManager = new PolicyManager(
             createEmptyTestServerPolicy(),
             Map.ofEntries(entry("plugin2", createPluginPolicy(ALL_UNNAMED))),
-            c -> "plugin2"
+            c -> "plugin2",
+            NO_ENTITLEMENTS_MODULE
         );
 
         // Any class from the current module (unnamed) will do
@@ -197,6 +204,73 @@ public void testGetEntitlementsResultIsCached() {
         assertThat(entitlementsAgain, sameInstance(cachedResult));
     }
 
+    public void testRequestingModuleFastPath() throws IOException, ClassNotFoundException {
+        var callerClass = makeClassInItsOwnModule();
+        assertEquals(callerClass.getModule(), policyManagerWithEntitlementsModule(NO_ENTITLEMENTS_MODULE).requestingModule(callerClass));
+    }
+
+    public void testRequestingModuleWithStackWalk() throws IOException, ClassNotFoundException {
+        var requestingClass = makeClassInItsOwnModule();
+        var runtimeClass = makeClassInItsOwnModule(); // A class in the entitlements library itself
+        var ignorableClass = makeClassInItsOwnModule();
+        var systemClass = Object.class;
+
+        var policyManager = policyManagerWithEntitlementsModule(runtimeClass.getModule());
+
+        var requestingModule = requestingClass.getModule();
+
+        assertEquals(
+            "Skip one system frame",
+            requestingModule,
+            policyManager.findRequestingModule(Stream.of(systemClass, requestingClass, ignorableClass)).orElse(null)
+        );
+        assertEquals(
+            "Skip multiple system frames",
+            requestingModule,
+            policyManager.findRequestingModule(Stream.of(systemClass, systemClass, systemClass, requestingClass, ignorableClass))
+                .orElse(null)
+        );
+        assertEquals(
+            "Skip system frame between runtime frames",
+            requestingModule,
+            policyManager.findRequestingModule(Stream.of(runtimeClass, systemClass, runtimeClass, requestingClass, ignorableClass))
+                .orElse(null)
+        );
+        assertEquals(
+            "Skip runtime frame between system frames",
+            requestingModule,
+            policyManager.findRequestingModule(Stream.of(systemClass, runtimeClass, systemClass, requestingClass, ignorableClass))
+                .orElse(null)
+        );
+        assertEquals(
+            "No system frames",
+            requestingModule,
+            policyManager.findRequestingModule(Stream.of(requestingClass, ignorableClass)).orElse(null)
+        );
+        assertEquals(
+            "Skip runtime frames up to the first system frame",
+            requestingModule,
+            policyManager.findRequestingModule(Stream.of(runtimeClass, runtimeClass, systemClass, requestingClass, ignorableClass))
+                .orElse(null)
+        );
+        assertThrows(
+            "Non-modular caller frames are not supported",
+            NullPointerException.class,
+            () -> policyManager.findRequestingModule(Stream.of(systemClass, null))
+        );
+    }
+
+    private static Class<?> makeClassInItsOwnModule() throws IOException, ClassNotFoundException {
+        final Path home = createTempDir();
+        Path jar = createMockPluginJar(home);
+        var layer = createLayerForJar(jar, "org.example.plugin");
+        return layer.findLoader("org.example.plugin").loadClass("q.B");
+    }
+
+    private static PolicyManager policyManagerWithEntitlementsModule(Module entitlementsModule) {
+        return new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "test", entitlementsModule);
+    }
+
     private static Policy createEmptyTestServerPolicy() {
         return new Policy("server", List.of());
     }
@@ -219,7 +293,7 @@ private static Policy createPluginPolicy(String... pluginModules) {
         );
     }
 
-    private static Path creteMockPluginJar(Path home) throws IOException {
+    private static Path createMockPluginJar(Path home) throws IOException {
         Path jar = home.resolve("mock-plugin.jar");
 
         Map<String, CharSequence> sources = Map.ofEntries(

From 7d301185bf1a650db09bb87033be70141353a5a5 Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Wed, 18 Dec 2024 20:40:11 +0100
Subject: [PATCH 097/119] Don't throw VerificationException on illegal state
 (#118826)

If we end up here, we need to know this - and we won't know it if we
return a 400 to the user. This should be a 500.
---
 .../elasticsearch/xpack/esql/analysis/Analyzer.java  | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
index ecd0821c626bf..3d1bfdfd0ef42 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
@@ -691,15 +691,9 @@ private List<Attribute> resolveUsingColumns(List<Attribute> cols, List<Attribute
                         resolvedCol = ucol.withUnresolvedMessage(message.replace(match, match + " in " + side + " side of join"));
                     }
                     resolved.add(resolvedCol);
-                }
-                // columns are expected to be unresolved - if that's not the case return an error
-                else {
-                    return singletonList(
-                        new UnresolvedAttribute(
-                            col.source(),
-                            col.name(),
-                            "Surprised to discover column [ " + col.name() + "] already resolved"
-                        )
+                } else {
+                    throw new IllegalStateException(
+                        "Surprised to discover column [ " + col.name() + "] already resolved when resolving JOIN keys"
                     );
                 }
             }

From 6f261067f215c0eb95b714796382d6a035d24e41 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Wed, 18 Dec 2024 19:47:12 +0000
Subject: [PATCH 098/119] Add a generic `rescorer` retriever based on the
 search request's rescore functionality   (#118585)

This pull request introduces a new retriever called `rescorer`, which leverages the `rescore` functionality of the search request.
The `rescorer` retriever re-scores only the top documents retrieved by its child retriever, offering fine-tuned scoring capabilities.

All rescorers supported in the `rescore` section of a search request are available in this retriever, and the same format is used to define the rescore configuration.

<details>
<summary>Example:</summary>

```yaml
  - do:
      search:
        index: test
        body:
          retriever:
            rescorer:
              rescore:
                window_size: 10
                query:
                  rescore_query:
                    rank_feature:
                      field: "features.second_stage"
                      linear: { }
                  query_weight: 0
              retriever:
                standard:
                  query:
                    rank_feature:
                      field: "features.first_stage"
                      linear: { }
          size: 2
```

</details>

Closes #118327

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
---
 docs/changelog/118585.yaml                    |   7 +
 docs/reference/search/retriever.asciidoc      | 121 +++++-
 rest-api-spec/build.gradle                    |   1 +
 .../30_rescorer_retriever.yml                 | 225 ++++++++++
 .../test/search/90_search_after.yml           |  25 --
 .../search/functionscore/QueryRescorerIT.java |  23 +
 .../search/DefaultSearchContext.java          |   3 +-
 .../elasticsearch/search/SearchFeatures.java  |   7 +
 .../elasticsearch/search/SearchModule.java    |   2 +
 .../search/builder/SearchSourceBuilder.java   |  14 -
 .../query/QueryPhaseCollectorManager.java     |   3 +-
 .../search/rescore/RescorePhase.java          | 102 ++++-
 .../search/rescore/RescorerBuilder.java       |   2 +-
 .../retriever/CompoundRetrieverBuilder.java   |  43 +-
 .../retriever/RescorerRetrieverBuilder.java   | 173 ++++++++
 .../search/retriever/RetrieverBuilder.java    |   2 +-
 .../search/DefaultSearchContextTests.java     |   6 +-
 .../RescorerRetrieverBuilderParsingTests.java |  78 ++++
 .../retriever/QueryRuleRetrieverBuilder.java  |   1 -
 .../TextSimilarityRankRetrieverBuilder.java   |   1 -
 x-pack/plugin/rank-rrf/build.gradle           |   1 +
 .../xpack/rank/rrf/RRFRetrieverBuilder.java   |   1 -
 .../rrf/RRFRankClientYamlTestSuiteIT.java     |   1 +
 .../test/rrf/900_rrf_with_rescorer.yml        | 409 ++++++++++++++++++
 24 files changed, 1180 insertions(+), 71 deletions(-)
 create mode 100644 docs/changelog/118585.yaml
 create mode 100644 rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.retrievers/30_rescorer_retriever.yml
 create mode 100644 server/src/main/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilder.java
 create mode 100644 server/src/test/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilderParsingTests.java
 create mode 100644 x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/900_rrf_with_rescorer.yml

diff --git a/docs/changelog/118585.yaml b/docs/changelog/118585.yaml
new file mode 100644
index 0000000000000..4caa5efabbd33
--- /dev/null
+++ b/docs/changelog/118585.yaml
@@ -0,0 +1,7 @@
+pr: 118585
+summary: Add a generic `rescorer` retriever based on the search request's rescore
+  functionality
+area: Ranking
+type: feature
+issues:
+ - 118327
diff --git a/docs/reference/search/retriever.asciidoc b/docs/reference/search/retriever.asciidoc
index f20e9148bf5e7..c7df40ff5e070 100644
--- a/docs/reference/search/retriever.asciidoc
+++ b/docs/reference/search/retriever.asciidoc
@@ -22,6 +22,9 @@ A <<standard-retriever, retriever>> that replaces the functionality of a traditi
 `knn`::
 A <<knn-retriever, retriever>> that replaces the functionality of a <<search-api-knn, knn search>>.
 
+`rescorer`::
+A <<rescorer-retriever, retriever>> that replaces the functionality of the <<rescore, query rescorer>>.
+
 `rrf`::
 A <<rrf-retriever, retriever>> that produces top documents from <<rrf, reciprocal rank fusion (RRF)>>.
 
@@ -371,6 +374,122 @@ GET movies/_search
 ----
 // TEST[skip:uses ELSER]
 
+[[rescorer-retriever]]
+==== Rescorer Retriever
+
+The `rescorer` retriever re-scores only the results produced by its child retriever.
+For the `standard` and `knn` retrievers, the `window_size` parameter specifies the number of documents examined per shard.
+
+For compound retrievers like `rrf`, the `window_size` parameter defines the total number of documents examined globally.
+
+When using the `rescorer`, an error is returned if the following conditions are not met:
+
+* The minimum configured rescore's `window_size` is:
+** Greater than or equal to the `size` of the parent retriever for nested `rescorer` setups.
+** Greater than or equal to the `size` of the search request when used as the primary retriever in the tree.
+
+* And the maximum rescore's `window_size` is:
+** Smaller than or equal to the `size` or `rank_window_size` of the child retriever.
+
+[discrete]
+[[rescorer-retriever-parameters]]
+===== Parameters
+
+`rescore`::
+(Required. <<rescore, A rescorer definition or an array of rescorer definitions>>)
++
+Defines the <<rescore, rescorers>> applied sequentially to the top documents returned by the child retriever.
+
+`retriever`::
+(Required. <<retriever, retriever>>)
++
+Specifies the child retriever responsible for generating the initial set of top documents to be re-ranked.
+
+`filter`::
+(Optional. <<query-dsl, query object or list of query objects>>)
++
+Applies a <<query-dsl-bool-query, boolean query filter>> to the retriever, ensuring that all documents match the filter criteria without affecting their scores.
+
+[discrete]
+[[rescorer-retriever-example]]
+==== Example
+
+The `rescorer` retriever can be placed at any level within the retriever tree.
+The following example demonstrates a `rescorer` applied to the results produced by an `rrf` retriever:
+
+[source,console]
+----
+GET movies/_search
+{
+  "size": 10, <1>
+  "retriever": {
+    "rescorer": { <2>
+      "rescore": {
+        "query": { <3>
+          "window_size": 50, <4>
+          "rescore_query": {
+            "script_score": {
+              "script": {
+                "source": "cosineSimilarity(params.queryVector, 'product-vector_final_stage') + 1.0",
+                "params": {
+                  "queryVector": [-0.5, 90.0, -10, 14.8, -156.0]
+                }
+              }
+            }
+          }
+        }
+      },
+      "retriever": { <5>
+        "rrf": {
+          "rank_window_size": 100, <6>
+          "retrievers": [
+            {
+              "standard": {
+                "query": {
+                  "sparse_vector": {
+                    "field": "plot_embedding",
+                    "inference_id": "my-elser-model",
+                    "query": "films that explore psychological depths"
+                  }
+                }
+              }
+            },
+            {
+              "standard": {
+                "query": {
+                  "multi_match": {
+                    "query": "crime",
+                    "fields": [
+                      "plot",
+                      "title"
+                    ]
+                  }
+                }
+              }
+            },
+            {
+              "knn": {
+                "field": "vector",
+                "query_vector": [10, 22, 77],
+                "k": 10,
+                "num_candidates": 10
+              }
+            }
+          ]
+        }
+      }
+    }
+  }
+}
+----
+// TEST[skip:uses ELSER]
+<1> Specifies the number of top documents to return in the final response.
+<2> A `rescorer` retriever applied as the final step.
+<3> The definition of the `query` rescorer.
+<4> Defines the number of documents to rescore from the child retriever.
+<5> Specifies the child retriever definition.
+<6> Defines the number of documents returned by the `rrf` retriever, which limits the available documents to
+
 [[text-similarity-reranker-retriever]]
 ==== Text Similarity Re-ranker Retriever
 
@@ -777,4 +896,4 @@ When a retriever is specified as part of a search, the following elements are no
 * <<search-after, `search_after`>>
 * <<request-body-search-terminate-after, `terminate_after`>>
 * <<search-sort-param, `sort`>>
-* <<rescore, `rescore`>>
+* <<rescore, `rescore`>> use a <<rescorer-retriever, rescorer retriever>> instead
diff --git a/rest-api-spec/build.gradle b/rest-api-spec/build.gradle
index bdee32e596c4c..f23b5460f7d53 100644
--- a/rest-api-spec/build.gradle
+++ b/rest-api-spec/build.gradle
@@ -70,4 +70,5 @@ tasks.named("yamlRestCompatTestTransform").configure ({ task ->
   task.skipTest("search.vectors/41_knn_search_bbq_hnsw/Test knn search", "Scoring has changed in latest versions")
   task.skipTest("search.vectors/42_knn_search_bbq_flat/Test knn search", "Scoring has changed in latest versions")
   task.skipTest("synonyms/90_synonyms_reloading_for_synset/Reload analyzers for specific synonym set", "Can't work until auto-expand replicas is 0-1 for synonyms index")
+  task.skipTest("search/90_search_after/_shard_doc sort", "restriction has been lifted in latest versions")
 })
diff --git a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.retrievers/30_rescorer_retriever.yml b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.retrievers/30_rescorer_retriever.yml
new file mode 100644
index 0000000000000..2c16de61c6b15
--- /dev/null
+++ b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.retrievers/30_rescorer_retriever.yml
@@ -0,0 +1,225 @@
+setup:
+  - requires:
+      cluster_features: [ "search.retriever.rescorer.enabled" ]
+      reason: "Support for rescorer retriever"
+
+  - do:
+      indices.create:
+        index: test
+        body:
+          settings:
+            number_of_shards: 1
+            number_of_replicas: 0
+          mappings:
+            properties:
+              available:
+                type: boolean
+              features:
+                type: rank_features
+
+  - do:
+      bulk:
+        refresh: true
+        index: test
+        body:
+          - '{"index": {"_id": 1 }}'
+          - '{"features": { "first_stage": 1, "second_stage": 10}, "available": true, "group": 1}'
+          - '{"index": {"_id": 2 }}'
+          - '{"features": { "first_stage": 2, "second_stage": 9}, "available": false, "group": 1}'
+          - '{"index": {"_id": 3 }}'
+          - '{"features": { "first_stage": 3, "second_stage": 8}, "available": false, "group": 3}'
+          - '{"index": {"_id": 4 }}'
+          - '{"features": { "first_stage": 4, "second_stage": 7}, "available": true, "group": 1}'
+          - '{"index": {"_id": 5 }}'
+          - '{"features": { "first_stage": 5, "second_stage": 6}, "available": true, "group": 3}'
+          - '{"index": {"_id": 6 }}'
+          - '{"features": { "first_stage": 6, "second_stage": 5}, "available": false, "group": 2}'
+          - '{"index": {"_id": 7 }}'
+          - '{"features": { "first_stage": 7, "second_stage": 4}, "available": true, "group": 3}'
+          - '{"index": {"_id": 8 }}'
+          - '{"features": { "first_stage": 8, "second_stage": 3}, "available": true, "group": 1}'
+          - '{"index": {"_id": 9 }}'
+          - '{"features": { "first_stage": 9, "second_stage": 2}, "available": true, "group": 2}'
+          - '{"index": {"_id": 10 }}'
+          - '{"features": { "first_stage": 10, "second_stage": 1}, "available": false, "group": 1}'
+
+---
+"Rescorer retriever basic":
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 10
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.second_stage"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                standard:
+                  query:
+                    rank_feature:
+                      field: "features.first_stage"
+                      linear: { }
+          size: 2
+
+  - match: { hits.total.value: 10 }
+  - match: { hits.hits.0._id: "1" }
+  - match: { hits.hits.0._score: 10.0 }
+  - match: { hits.hits.1._id: "2" }
+  - match: { hits.hits.1._score: 9.0 }
+
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 3
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.second_stage"
+                      linear: {}
+                  query_weight: 0
+              retriever:
+                standard:
+                  query:
+                    rank_feature:
+                      field: "features.first_stage"
+                      linear: {}
+          size: 2
+
+  - match: {hits.total.value: 10}
+  - match: {hits.hits.0._id: "8"}
+  - match: { hits.hits.0._score: 3.0 }
+  - match: {hits.hits.1._id: "9"}
+  - match: { hits.hits.1._score: 2.0 }
+
+---
+"Rescorer retriever with pre-filters":
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              filter:
+                match:
+                  available: true
+              rescore:
+                window_size: 10
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.second_stage"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                standard:
+                  query:
+                    rank_feature:
+                      field: "features.first_stage"
+                      linear: { }
+          size: 2
+
+  - match: { hits.total.value: 6 }
+  - match: { hits.hits.0._id: "1" }
+  - match: { hits.hits.0._score: 10.0 }
+  - match: { hits.hits.1._id: "4" }
+  - match: { hits.hits.1._score: 7.0 }
+
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 4
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.second_stage"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                standard:
+                  filter:
+                    match:
+                      available: true
+                  query:
+                    rank_feature:
+                      field: "features.first_stage"
+                      linear: { }
+          size: 2
+
+  - match: { hits.total.value: 6 }
+  - match: { hits.hits.0._id: "5" }
+  - match: { hits.hits.0._score: 6.0 }
+  - match: { hits.hits.1._id: "7" }
+  - match: { hits.hits.1._score: 4.0 }
+
+---
+"Rescorer retriever and collapsing":
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 10
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.second_stage"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                standard:
+                  query:
+                    rank_feature:
+                      field: "features.first_stage"
+                      linear: { }
+          collapse:
+            field: group
+          size: 3
+
+  - match: { hits.total.value: 10 }
+  - match: { hits.hits.0._id: "1" }
+  - match: { hits.hits.0._score: 10.0 }
+  - match: { hits.hits.1._id: "3" }
+  - match: { hits.hits.1._score: 8.0 }
+  - match: { hits.hits.2._id: "6" }
+  - match: { hits.hits.2._score: 5.0 }
+
+---
+"Rescorer retriever and invalid window size":
+  - do:
+      catch: "/\\[rescorer\\] requires \\[window_size: 5\\] be greater than or equal to \\[size: 10\\]/"
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 5
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.second_stage"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                standard:
+                  query:
+                    rank_feature:
+                      field: "features.first_stage"
+                      linear: { }
+          size: 10
diff --git a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search/90_search_after.yml b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search/90_search_after.yml
index 1fefc8bffffa1..d3b2b5a412717 100644
--- a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search/90_search_after.yml
+++ b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search/90_search_after.yml
@@ -218,31 +218,6 @@
   - match: {hits.hits.0._source.timestamp: "2019-10-21 00:30:04.828740" }
   - match: {hits.hits.0.sort: [1571617804828740000] }
 
-
----
-"_shard_doc sort":
-  - requires:
-      cluster_features: ["gte_v7.12.0"]
-      reason: _shard_doc sort was added in 7.12
-
-  - do:
-      indices.create:
-        index:  test
-  - do:
-      index:
-        index:  test
-        id:     "1"
-        body:   { id: 1, foo: bar, age: 18 }
-
-  - do:
-      catch:      /\[_shard_doc\] sort field cannot be used without \[point in time\]/
-      search:
-        index: test
-        body:
-          size: 1
-          sort: ["_shard_doc"]
-          search_after: [ 0L ]
-
 ---
 "Format sort values":
   - requires:
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java
index a7efb2fe0e68b..fbdcfe26d28ee 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/QueryRescorerIT.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.search.collapse.CollapseBuilder;
 import org.elasticsearch.search.rescore.QueryRescoreMode;
 import org.elasticsearch.search.rescore.QueryRescorerBuilder;
+import org.elasticsearch.search.sort.FieldSortBuilder;
 import org.elasticsearch.search.sort.SortBuilders;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.xcontent.ParseField;
@@ -840,6 +841,20 @@ public void testRescorePhaseWithInvalidSort() throws Exception {
                 }
             }
         );
+
+        assertResponse(
+            prepareSearch().addSort(SortBuilders.scoreSort())
+                .addSort(new FieldSortBuilder(FieldSortBuilder.SHARD_DOC_FIELD_NAME))
+                .setTrackScores(true)
+                .addRescorer(new QueryRescorerBuilder(matchAllQuery()).setRescoreQueryWeight(100.0f), 50),
+            response -> {
+                assertThat(response.getHits().getTotalHits().value(), equalTo(5L));
+                assertThat(response.getHits().getHits().length, equalTo(5));
+                for (SearchHit hit : response.getHits().getHits()) {
+                    assertThat(hit.getScore(), equalTo(101f));
+                }
+            }
+        );
     }
 
     record GroupDoc(String id, String group, float firstPassScore, float secondPassScore, boolean shouldFilter) {}
@@ -879,6 +894,10 @@ public void testRescoreAfterCollapse() throws Exception {
             .setQuery(fieldValueScoreQuery("firstPassScore"))
             .addRescorer(new QueryRescorerBuilder(fieldValueScoreQuery("secondPassScore")))
             .setCollapse(new CollapseBuilder("group"));
+        if (randomBoolean()) {
+            request.addSort(SortBuilders.scoreSort());
+            request.addSort(new FieldSortBuilder(FieldSortBuilder.SHARD_DOC_FIELD_NAME));
+        }
         assertResponse(request, resp -> {
             assertThat(resp.getHits().getTotalHits().value(), equalTo(5L));
             assertThat(resp.getHits().getHits().length, equalTo(3));
@@ -958,6 +977,10 @@ public void testRescoreAfterCollapseRandom() throws Exception {
             .addRescorer(new QueryRescorerBuilder(fieldValueScoreQuery("secondPassScore")).setQueryWeight(0f).windowSize(numGroups))
             .setCollapse(new CollapseBuilder("group"))
             .setSize(Math.min(numGroups, 10));
+        if (randomBoolean()) {
+            request.addSort(SortBuilders.scoreSort());
+            request.addSort(new FieldSortBuilder(FieldSortBuilder.SHARD_DOC_FIELD_NAME));
+        }
         long expectedNumHits = numHits;
         assertResponse(request, resp -> {
             assertThat(resp.getHits().getTotalHits().value(), equalTo(expectedNumHits));
diff --git a/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java b/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java
index b87d097413b67..47d3ed337af73 100644
--- a/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java
+++ b/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java
@@ -73,6 +73,7 @@
 import org.elasticsearch.search.rank.context.QueryPhaseRankShardContext;
 import org.elasticsearch.search.rank.feature.RankFeatureResult;
 import org.elasticsearch.search.rescore.RescoreContext;
+import org.elasticsearch.search.rescore.RescorePhase;
 import org.elasticsearch.search.slice.SliceBuilder;
 import org.elasticsearch.search.sort.SortAndFormats;
 import org.elasticsearch.search.suggest.SuggestionSearchContext;
@@ -377,7 +378,7 @@ public void preProcess() {
             );
         }
         if (rescore != null) {
-            if (sort != null) {
+            if (RescorePhase.validateSort(sort) == false) {
                 throw new IllegalArgumentException("Cannot use [sort] option in conjunction with [rescore].");
             }
             int maxWindow = indexService.getIndexSettings().getMaxRescoreWindow();
diff --git a/server/src/main/java/org/elasticsearch/search/SearchFeatures.java b/server/src/main/java/org/elasticsearch/search/SearchFeatures.java
index beac39c2de304..553511346b182 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchFeatures.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchFeatures.java
@@ -23,4 +23,11 @@ public final class SearchFeatures implements FeatureSpecification {
     public Set<NodeFeature> getFeatures() {
         return Set.of(KnnVectorQueryBuilder.K_PARAM_SUPPORTED, LUCENE_10_0_0_UPGRADE);
     }
+
+    public static final NodeFeature RETRIEVER_RESCORER_ENABLED = new NodeFeature("search.retriever.rescorer.enabled");
+
+    @Override
+    public Set<NodeFeature> getTestFeatures() {
+        return Set.of(RETRIEVER_RESCORER_ENABLED);
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/SearchModule.java b/server/src/main/java/org/elasticsearch/search/SearchModule.java
index d282ba425b126..3294e1ba03f6b 100644
--- a/server/src/main/java/org/elasticsearch/search/SearchModule.java
+++ b/server/src/main/java/org/elasticsearch/search/SearchModule.java
@@ -231,6 +231,7 @@
 import org.elasticsearch.search.rescore.QueryRescorerBuilder;
 import org.elasticsearch.search.rescore.RescorerBuilder;
 import org.elasticsearch.search.retriever.KnnRetrieverBuilder;
+import org.elasticsearch.search.retriever.RescorerRetrieverBuilder;
 import org.elasticsearch.search.retriever.RetrieverBuilder;
 import org.elasticsearch.search.retriever.RetrieverParserContext;
 import org.elasticsearch.search.retriever.StandardRetrieverBuilder;
@@ -1080,6 +1081,7 @@ private void registerFetchSubPhase(FetchSubPhase subPhase) {
     private void registerRetrieverParsers(List<SearchPlugin> plugins) {
         registerRetriever(new RetrieverSpec<>(StandardRetrieverBuilder.NAME, StandardRetrieverBuilder::fromXContent));
         registerRetriever(new RetrieverSpec<>(KnnRetrieverBuilder.NAME, KnnRetrieverBuilder::fromXContent));
+        registerRetriever(new RetrieverSpec<>(RescorerRetrieverBuilder.NAME, RescorerRetrieverBuilder::fromXContent));
 
         registerFromPlugin(plugins, SearchPlugin::getRetrievers, this::registerRetriever);
     }
diff --git a/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
index 3554a6dc08b90..8c21abe4180ea 100644
--- a/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
@@ -48,9 +48,7 @@
 import org.elasticsearch.search.retriever.RetrieverParserContext;
 import org.elasticsearch.search.searchafter.SearchAfterBuilder;
 import org.elasticsearch.search.slice.SliceBuilder;
-import org.elasticsearch.search.sort.FieldSortBuilder;
 import org.elasticsearch.search.sort.ScoreSortBuilder;
-import org.elasticsearch.search.sort.ShardDocSortField;
 import org.elasticsearch.search.sort.SortBuilder;
 import org.elasticsearch.search.sort.SortBuilders;
 import org.elasticsearch.search.sort.SortOrder;
@@ -2341,18 +2339,6 @@ public ActionRequestValidationException validate(
                 validationException = rescorer.validate(this, validationException);
             }
         }
-
-        if (pointInTimeBuilder() == null && sorts() != null) {
-            for (var sortBuilder : sorts()) {
-                if (sortBuilder instanceof FieldSortBuilder fieldSortBuilder
-                    && ShardDocSortField.NAME.equals(fieldSortBuilder.getFieldName())) {
-                    validationException = addValidationError(
-                        "[" + FieldSortBuilder.SHARD_DOC_FIELD_NAME + "] sort field cannot be used without [point in time]",
-                        validationException
-                    );
-                }
-            }
-        }
         return validationException;
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/query/QueryPhaseCollectorManager.java b/server/src/main/java/org/elasticsearch/search/query/QueryPhaseCollectorManager.java
index cbc04dd460ff5..3d793a164f40a 100644
--- a/server/src/main/java/org/elasticsearch/search/query/QueryPhaseCollectorManager.java
+++ b/server/src/main/java/org/elasticsearch/search/query/QueryPhaseCollectorManager.java
@@ -58,6 +58,7 @@
 import org.elasticsearch.search.profile.query.CollectorResult;
 import org.elasticsearch.search.profile.query.InternalProfileCollector;
 import org.elasticsearch.search.rescore.RescoreContext;
+import org.elasticsearch.search.rescore.RescorePhase;
 import org.elasticsearch.search.sort.SortAndFormats;
 
 import java.io.IOException;
@@ -238,7 +239,7 @@ static CollectorManager<Collector, QueryPhaseResult> createQueryPhaseCollectorMa
             int numDocs = Math.min(searchContext.from() + searchContext.size(), totalNumDocs);
             final boolean rescore = searchContext.rescore().isEmpty() == false;
             if (rescore) {
-                assert searchContext.sort() == null;
+                assert RescorePhase.validateSort(searchContext.sort());
                 for (RescoreContext rescoreContext : searchContext.rescore()) {
                     numDocs = Math.max(numDocs, rescoreContext.getWindowSize());
                 }
diff --git a/server/src/main/java/org/elasticsearch/search/rescore/RescorePhase.java b/server/src/main/java/org/elasticsearch/search/rescore/RescorePhase.java
index 7e3646e7689cc..c23df9cdfa441 100644
--- a/server/src/main/java/org/elasticsearch/search/rescore/RescorePhase.java
+++ b/server/src/main/java/org/elasticsearch/search/rescore/RescorePhase.java
@@ -13,6 +13,7 @@
 import org.apache.lucene.search.ScoreDoc;
 import org.apache.lucene.search.SortField;
 import org.apache.lucene.search.TopDocs;
+import org.apache.lucene.search.TopFieldDocs;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.search.SearchShardTask;
 import org.elasticsearch.common.lucene.search.TopDocsAndMaxScore;
@@ -22,9 +23,12 @@
 import org.elasticsearch.search.internal.SearchContext;
 import org.elasticsearch.search.query.QueryPhase;
 import org.elasticsearch.search.query.SearchTimeoutException;
+import org.elasticsearch.search.sort.ShardDocSortField;
+import org.elasticsearch.search.sort.SortAndFormats;
 
 import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.List;
 import java.util.Map;
 
@@ -39,15 +43,27 @@ public static void execute(SearchContext context) {
         if (context.size() == 0 || context.rescore() == null || context.rescore().isEmpty()) {
             return;
         }
-
+        if (validateSort(context.sort()) == false) {
+            throw new IllegalStateException("Cannot use [sort] option in conjunction with [rescore], missing a validate?");
+        }
         TopDocs topDocs = context.queryResult().topDocs().topDocs;
         if (topDocs.scoreDocs.length == 0) {
             return;
         }
+        // Populate FieldDoc#score using the primary sort field (_score) to ensure compatibility with top docs rescoring
+        Arrays.stream(topDocs.scoreDocs).forEach(t -> {
+            if (t instanceof FieldDoc fieldDoc) {
+                fieldDoc.score = (float) fieldDoc.fields[0];
+            }
+        });
         TopFieldGroups topGroups = null;
+        TopFieldDocs topFields = null;
         if (topDocs instanceof TopFieldGroups topFieldGroups) {
-            assert context.collapse() != null;
+            assert context.collapse() != null && validateSortFields(topFieldGroups.fields);
             topGroups = topFieldGroups;
+        } else if (topDocs instanceof TopFieldDocs topFieldDocs) {
+            assert validateSortFields(topFieldDocs.fields);
+            topFields = topFieldDocs;
         }
         try {
             Runnable cancellationCheck = getCancellationChecks(context);
@@ -56,17 +72,18 @@ public static void execute(SearchContext context) {
                 topDocs = ctx.rescorer().rescore(topDocs, context.searcher(), ctx);
                 // It is the responsibility of the rescorer to sort the resulted top docs,
                 // here we only assert that this condition is met.
-                assert context.sort() == null && topDocsSortedByScore(topDocs) : "topdocs should be sorted after rescore";
+                assert topDocsSortedByScore(topDocs) : "topdocs should be sorted after rescore";
                 ctx.setCancellationChecker(null);
             }
+            /**
+             * Since rescorers are building top docs with score only, we must reconstruct the {@link TopFieldGroups}
+             * or {@link TopFieldDocs} using their original version before rescoring.
+             */
             if (topGroups != null) {
                 assert context.collapse() != null;
-                /**
-                 * Since rescorers don't preserve collapsing, we must reconstruct the group and field
-                 * values from the originalTopGroups to create a new {@link TopFieldGroups} from the
-                 * rescored top documents.
-                 */
-                topDocs = rewriteTopGroups(topGroups, topDocs);
+                topDocs = rewriteTopFieldGroups(topGroups, topDocs);
+            } else if (topFields != null) {
+                topDocs = rewriteTopFieldDocs(topFields, topDocs);
             }
             context.queryResult()
                 .topDocs(new TopDocsAndMaxScore(topDocs, topDocs.scoreDocs[0].score), context.queryResult().sortValueFormats());
@@ -81,29 +98,84 @@ public static void execute(SearchContext context) {
         }
     }
 
-    private static TopFieldGroups rewriteTopGroups(TopFieldGroups originalTopGroups, TopDocs rescoredTopDocs) {
-        assert originalTopGroups.fields.length == 1 && SortField.FIELD_SCORE.equals(originalTopGroups.fields[0])
-            : "rescore must always sort by score descending";
+    /**
+     * Returns whether the provided {@link SortAndFormats} can be used to rescore
+     * top documents.
+     */
+    public static boolean validateSort(SortAndFormats sortAndFormats) {
+        if (sortAndFormats == null) {
+            return true;
+        }
+        return validateSortFields(sortAndFormats.sort.getSort());
+    }
+
+    private static boolean validateSortFields(SortField[] fields) {
+        if (fields[0].equals(SortField.FIELD_SCORE) == false) {
+            return false;
+        }
+        if (fields.length == 1) {
+            return true;
+        }
+
+        // The ShardDocSortField can be used as a tiebreaker because it maintains
+        // the natural document ID order within the shard.
+        if (fields[1] instanceof ShardDocSortField == false || fields[1].getReverse()) {
+            return false;
+        }
+        return true;
+    }
+
+    private static TopFieldDocs rewriteTopFieldDocs(TopFieldDocs originalTopFieldDocs, TopDocs rescoredTopDocs) {
+        Map<Integer, FieldDoc> docIdToFieldDoc = Maps.newMapWithExpectedSize(originalTopFieldDocs.scoreDocs.length);
+        for (int i = 0; i < originalTopFieldDocs.scoreDocs.length; i++) {
+            docIdToFieldDoc.put(originalTopFieldDocs.scoreDocs[i].doc, (FieldDoc) originalTopFieldDocs.scoreDocs[i]);
+        }
+        var newScoreDocs = new FieldDoc[rescoredTopDocs.scoreDocs.length];
+        int pos = 0;
+        for (var doc : rescoredTopDocs.scoreDocs) {
+            newScoreDocs[pos] = docIdToFieldDoc.get(doc.doc);
+            newScoreDocs[pos].score = doc.score;
+            newScoreDocs[pos].fields[0] = newScoreDocs[pos].score;
+            pos++;
+        }
+        return new TopFieldDocs(originalTopFieldDocs.totalHits, newScoreDocs, originalTopFieldDocs.fields);
+    }
+
+    private static TopFieldGroups rewriteTopFieldGroups(TopFieldGroups originalTopGroups, TopDocs rescoredTopDocs) {
+        var newFieldDocs = rewriteFieldDocs((FieldDoc[]) originalTopGroups.scoreDocs, rescoredTopDocs.scoreDocs);
+
         Map<Integer, Object> docIdToGroupValue = Maps.newMapWithExpectedSize(originalTopGroups.scoreDocs.length);
         for (int i = 0; i < originalTopGroups.scoreDocs.length; i++) {
             docIdToGroupValue.put(originalTopGroups.scoreDocs[i].doc, originalTopGroups.groupValues[i]);
         }
-        var newScoreDocs = new FieldDoc[rescoredTopDocs.scoreDocs.length];
         var newGroupValues = new Object[originalTopGroups.groupValues.length];
         int pos = 0;
         for (var doc : rescoredTopDocs.scoreDocs) {
-            newScoreDocs[pos] = new FieldDoc(doc.doc, doc.score, new Object[] { doc.score });
             newGroupValues[pos++] = docIdToGroupValue.get(doc.doc);
         }
         return new TopFieldGroups(
             originalTopGroups.field,
             originalTopGroups.totalHits,
-            newScoreDocs,
+            newFieldDocs,
             originalTopGroups.fields,
             newGroupValues
         );
     }
 
+    private static FieldDoc[] rewriteFieldDocs(FieldDoc[] originalTopDocs, ScoreDoc[] rescoredTopDocs) {
+        Map<Integer, FieldDoc> docIdToFieldDoc = Maps.newMapWithExpectedSize(rescoredTopDocs.length);
+        Arrays.stream(originalTopDocs).forEach(d -> docIdToFieldDoc.put(d.doc, d));
+        var newDocs = new FieldDoc[rescoredTopDocs.length];
+        int pos = 0;
+        for (var doc : rescoredTopDocs) {
+            newDocs[pos] = docIdToFieldDoc.get(doc.doc);
+            newDocs[pos].score = doc.score;
+            newDocs[pos].fields[0] = doc.score;
+            pos++;
+        }
+        return newDocs;
+    }
+
     /**
      * Returns true if the provided docs are sorted by score.
      */
diff --git a/server/src/main/java/org/elasticsearch/search/rescore/RescorerBuilder.java b/server/src/main/java/org/elasticsearch/search/rescore/RescorerBuilder.java
index f624961515389..38a319321207f 100644
--- a/server/src/main/java/org/elasticsearch/search/rescore/RescorerBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/rescore/RescorerBuilder.java
@@ -39,7 +39,7 @@ public abstract class RescorerBuilder<RB extends RescorerBuilder<RB>>
 
     protected Integer windowSize;
 
-    private static final ParseField WINDOW_SIZE_FIELD = new ParseField("window_size");
+    public static final ParseField WINDOW_SIZE_FIELD = new ParseField("window_size");
 
     /**
      * Construct an empty RescoreBuilder.
diff --git a/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java b/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java
index 2ab6395db73b5..298340e5c579e 100644
--- a/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java
@@ -32,10 +32,12 @@
 import org.elasticsearch.search.sort.ScoreSortBuilder;
 import org.elasticsearch.search.sort.ShardDocSortField;
 import org.elasticsearch.search.sort.SortBuilder;
+import org.elasticsearch.xcontent.ParseField;
 
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Locale;
 import java.util.Objects;
 
 import static org.elasticsearch.action.ValidateActions.addValidationError;
@@ -49,6 +51,8 @@ public abstract class CompoundRetrieverBuilder<T extends CompoundRetrieverBuilde
 
     public static final NodeFeature INNER_RETRIEVERS_FILTER_SUPPORT = new NodeFeature("inner_retrievers_filter_support");
 
+    public static final ParseField RANK_WINDOW_SIZE_FIELD = new ParseField("rank_window_size");
+
     public record RetrieverSource(RetrieverBuilder retriever, SearchSourceBuilder source) {}
 
     protected final int rankWindowSize;
@@ -81,6 +85,14 @@ public final boolean isCompound() {
         return true;
     }
 
+    /**
+     * Retrieves the {@link ParseField} used to configure the {@link CompoundRetrieverBuilder#rankWindowSize}
+     * at the REST layer.
+     */
+    public ParseField getRankWindowSizeField() {
+        return RANK_WINDOW_SIZE_FIELD;
+    }
+
     @Override
     public final RetrieverBuilder rewrite(QueryRewriteContext ctx) throws IOException {
         if (ctx.getPointInTimeBuilder() == null) {
@@ -209,14 +221,14 @@ public ActionRequestValidationException validate(
         validationException = super.validate(source, validationException, isScroll, allowPartialSearchResults);
         if (source.size() > rankWindowSize) {
             validationException = addValidationError(
-                "["
-                    + this.getName()
-                    + "] requires [rank_window_size: "
-                    + rankWindowSize
-                    + "]"
-                    + " be greater than or equal to [size: "
-                    + source.size()
-                    + "]",
+                String.format(
+                    Locale.ROOT,
+                    "[%s] requires [%s: %d] be greater than or equal to [size: %d]",
+                    getName(),
+                    getRankWindowSizeField().getPreferredName(),
+                    rankWindowSize,
+                    source.size()
+                ),
                 validationException
             );
         }
@@ -231,6 +243,21 @@ public ActionRequestValidationException validate(
         }
         for (RetrieverSource innerRetriever : innerRetrievers) {
             validationException = innerRetriever.retriever().validate(source, validationException, isScroll, allowPartialSearchResults);
+            if (innerRetriever.retriever() instanceof CompoundRetrieverBuilder<?> compoundChild) {
+                if (rankWindowSize > compoundChild.rankWindowSize) {
+                    String errorMessage = String.format(
+                        Locale.ROOT,
+                        "[%s] requires [%s: %d] to be smaller than or equal to its sub retriever's %s [%s: %d]",
+                        this.getName(),
+                        getRankWindowSizeField().getPreferredName(),
+                        rankWindowSize,
+                        compoundChild.getName(),
+                        compoundChild.getRankWindowSizeField(),
+                        compoundChild.rankWindowSize
+                    );
+                    validationException = addValidationError(errorMessage, validationException);
+                }
+            }
         }
         return validationException;
     }
diff --git a/server/src/main/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilder.java b/server/src/main/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilder.java
new file mode 100644
index 0000000000000..09688b5b9b001
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilder.java
@@ -0,0 +1,173 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.search.retriever;
+
+import org.apache.lucene.search.ScoreDoc;
+import org.elasticsearch.common.ParsingException;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.search.rank.RankDoc;
+import org.elasticsearch.search.rescore.RescorerBuilder;
+import org.elasticsearch.xcontent.ConstructingObjectParser;
+import org.elasticsearch.xcontent.ObjectParser;
+import org.elasticsearch.xcontent.ParseField;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+import static org.elasticsearch.search.builder.SearchSourceBuilder.RESCORE_FIELD;
+import static org.elasticsearch.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * A {@link CompoundRetrieverBuilder} that re-scores only the results produced by its child retriever.
+ */
+public final class RescorerRetrieverBuilder extends CompoundRetrieverBuilder<RescorerRetrieverBuilder> {
+
+    public static final String NAME = "rescorer";
+    public static final ParseField RETRIEVER_FIELD = new ParseField("retriever");
+
+    @SuppressWarnings("unchecked")
+    public static final ConstructingObjectParser<RescorerRetrieverBuilder, RetrieverParserContext> PARSER = new ConstructingObjectParser<>(
+        NAME,
+        args -> new RescorerRetrieverBuilder((RetrieverBuilder) args[0], (List<RescorerBuilder<?>>) args[1])
+    );
+
+    static {
+        PARSER.declareNamedObject(constructorArg(), (parser, context, n) -> {
+            RetrieverBuilder innerRetriever = parser.namedObject(RetrieverBuilder.class, n, context);
+            context.trackRetrieverUsage(innerRetriever.getName());
+            return innerRetriever;
+        }, RETRIEVER_FIELD);
+        PARSER.declareField(constructorArg(), (parser, context) -> {
+            if (parser.currentToken() == XContentParser.Token.START_ARRAY) {
+                List<RescorerBuilder<?>> rescorers = new ArrayList<>();
+                while ((parser.nextToken()) != XContentParser.Token.END_ARRAY) {
+                    rescorers.add(RescorerBuilder.parseFromXContent(parser, name -> context.trackRescorerUsage(name)));
+                }
+                return rescorers;
+            } else if (parser.currentToken() == XContentParser.Token.START_OBJECT) {
+                return List.of(RescorerBuilder.parseFromXContent(parser, name -> context.trackRescorerUsage(name)));
+            } else {
+                throw new IllegalArgumentException(
+                    "Unknown format for [rescorer.rescore], expects an object or an array of objects, got: " + parser.currentToken()
+                );
+            }
+        }, RESCORE_FIELD, ObjectParser.ValueType.OBJECT_ARRAY);
+        RetrieverBuilder.declareBaseParserFields(NAME, PARSER);
+    }
+
+    public static RescorerRetrieverBuilder fromXContent(XContentParser parser, RetrieverParserContext context) throws IOException {
+        try {
+            return PARSER.apply(parser, context);
+        } catch (Exception e) {
+            throw new ParsingException(parser.getTokenLocation(), e.getMessage(), e);
+        }
+    }
+
+    private final List<RescorerBuilder<?>> rescorers;
+
+    public RescorerRetrieverBuilder(RetrieverBuilder retriever, List<RescorerBuilder<?>> rescorers) {
+        super(List.of(new RetrieverSource(retriever, null)), extractMinWindowSize(rescorers));
+        if (rescorers.isEmpty()) {
+            throw new IllegalArgumentException("Missing rescore definition");
+        }
+        this.rescorers = rescorers;
+    }
+
+    private RescorerRetrieverBuilder(RetrieverSource retriever, List<RescorerBuilder<?>> rescorers) {
+        super(List.of(retriever), extractMinWindowSize(rescorers));
+        this.rescorers = rescorers;
+    }
+
+    /**
+     * The minimum window size is used as the {@link CompoundRetrieverBuilder#rankWindowSize},
+     * the final number of top documents to return in this retriever.
+     */
+    private static int extractMinWindowSize(List<RescorerBuilder<?>> rescorers) {
+        int windowSize = Integer.MAX_VALUE;
+        for (var rescore : rescorers) {
+            windowSize = Math.min(rescore.windowSize() == null ? RescorerBuilder.DEFAULT_WINDOW_SIZE : rescore.windowSize(), windowSize);
+        }
+        return windowSize;
+    }
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public ParseField getRankWindowSizeField() {
+        return RescorerBuilder.WINDOW_SIZE_FIELD;
+    }
+
+    @Override
+    protected SearchSourceBuilder finalizeSourceBuilder(SearchSourceBuilder source) {
+        /**
+         * The re-scorer is passed downstream because this query operates only on
+         * the top documents retrieved by the child retriever.
+         *
+         * - If the sub-retriever is a {@link CompoundRetrieverBuilder}, only the top
+         *   documents are re-scored since they are already determined at this stage.
+         * - For other retrievers that do not require a rewrite, the re-scorer's window
+         *   size is applied per shard. As a result, more documents are re-scored
+         *   compared to the final top documents produced by these retrievers in isolation.
+         */
+        for (var rescorer : rescorers) {
+            source.addRescorer(rescorer);
+        }
+        return source;
+    }
+
+    @Override
+    public void doToXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.field(RETRIEVER_FIELD.getPreferredName(), innerRetrievers.getFirst().retriever());
+        builder.startArray(RESCORE_FIELD.getPreferredName());
+        for (RescorerBuilder<?> rescorer : rescorers) {
+            rescorer.toXContent(builder, params);
+        }
+        builder.endArray();
+    }
+
+    @Override
+    protected RescorerRetrieverBuilder clone(List<RetrieverSource> newChildRetrievers, List<QueryBuilder> newPreFilterQueryBuilders) {
+        var newInstance = new RescorerRetrieverBuilder(newChildRetrievers.get(0), rescorers);
+        newInstance.preFilterQueryBuilders = newPreFilterQueryBuilders;
+        return newInstance;
+    }
+
+    @Override
+    protected RankDoc[] combineInnerRetrieverResults(List<ScoreDoc[]> rankResults) {
+        assert rankResults.size() == 1;
+        ScoreDoc[] scoreDocs = rankResults.getFirst();
+        RankDoc[] rankDocs = new RankDoc[scoreDocs.length];
+        for (int i = 0; i < scoreDocs.length; i++) {
+            ScoreDoc scoreDoc = scoreDocs[i];
+            rankDocs[i] = new RankDoc(scoreDoc.doc, scoreDoc.score, scoreDoc.shardIndex);
+            rankDocs[i].rank = i + 1;
+        }
+        return rankDocs;
+    }
+
+    @Override
+    public boolean doEquals(Object o) {
+        RescorerRetrieverBuilder that = (RescorerRetrieverBuilder) o;
+        return super.doEquals(o) && Objects.equals(rescorers, that.rescorers);
+    }
+
+    @Override
+    public int doHashCode() {
+        return Objects.hash(super.doHashCode(), rescorers);
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/search/retriever/RetrieverBuilder.java b/server/src/main/java/org/elasticsearch/search/retriever/RetrieverBuilder.java
index d52c354cad69e..b9bfdfdf3402f 100644
--- a/server/src/main/java/org/elasticsearch/search/retriever/RetrieverBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/retriever/RetrieverBuilder.java
@@ -63,7 +63,7 @@ protected static void declareBaseParserFields(
         AbstractObjectParser<? extends RetrieverBuilder, RetrieverParserContext> parser
     ) {
         parser.declareObjectArray(
-            (r, v) -> r.preFilterQueryBuilders = v,
+            (r, v) -> r.preFilterQueryBuilders = new ArrayList<>(v),
             (p, c) -> AbstractQueryBuilder.parseTopLevelQuery(p, c::trackQueryUsage),
             PRE_FILTER_FIELD
         );
diff --git a/server/src/test/java/org/elasticsearch/search/DefaultSearchContextTests.java b/server/src/test/java/org/elasticsearch/search/DefaultSearchContextTests.java
index a474c1dc38c50..d3a3792f605db 100644
--- a/server/src/test/java/org/elasticsearch/search/DefaultSearchContextTests.java
+++ b/server/src/test/java/org/elasticsearch/search/DefaultSearchContextTests.java
@@ -23,6 +23,7 @@
 import org.apache.lucene.search.MatchNoDocsQuery;
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.Sort;
+import org.apache.lucene.search.SortField;
 import org.apache.lucene.store.Directory;
 import org.apache.lucene.tests.index.RandomIndexWriter;
 import org.apache.lucene.tests.store.BaseDirectoryWrapper;
@@ -245,7 +246,10 @@ protected Engine.Searcher acquireSearcherInternal(String source) {
                 // resultWindow not greater than maxResultWindow and both rescore and sort are not null
                 context1.from(0);
                 DocValueFormat docValueFormat = mock(DocValueFormat.class);
-                SortAndFormats sortAndFormats = new SortAndFormats(new Sort(), new DocValueFormat[] { docValueFormat });
+                SortAndFormats sortAndFormats = new SortAndFormats(
+                    new Sort(new SortField[] { SortField.FIELD_DOC }),
+                    new DocValueFormat[] { docValueFormat }
+                );
                 context1.sort(sortAndFormats);
 
                 RescoreContext rescoreContext = mock(RescoreContext.class);
diff --git a/server/src/test/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilderParsingTests.java b/server/src/test/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilderParsingTests.java
new file mode 100644
index 0000000000000..fa83246d90cb2
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/search/retriever/RescorerRetrieverBuilderParsingTests.java
@@ -0,0 +1,78 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.search.retriever;
+
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.search.SearchModule;
+import org.elasticsearch.search.rescore.QueryRescorerBuilderTests;
+import org.elasticsearch.search.rescore.RescorerBuilder;
+import org.elasticsearch.test.AbstractXContentTestCase;
+import org.elasticsearch.usage.SearchUsage;
+import org.elasticsearch.xcontent.NamedXContentRegistry;
+import org.elasticsearch.xcontent.XContentParser;
+import org.junit.AfterClass;
+import org.junit.BeforeClass;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+import static java.util.Collections.emptyList;
+
+public class RescorerRetrieverBuilderParsingTests extends AbstractXContentTestCase<RescorerRetrieverBuilder> {
+    private static List<NamedXContentRegistry.Entry> xContentRegistryEntries;
+
+    @BeforeClass
+    public static void init() {
+        xContentRegistryEntries = new SearchModule(Settings.EMPTY, emptyList()).getNamedXContents();
+    }
+
+    @AfterClass
+    public static void afterClass() throws Exception {
+        xContentRegistryEntries = null;
+    }
+
+    @Override
+    protected RescorerRetrieverBuilder createTestInstance() {
+        int num = randomIntBetween(1, 3);
+        List<RescorerBuilder<?>> rescorers = new ArrayList<>();
+        for (int i = 0; i < num; i++) {
+            rescorers.add(QueryRescorerBuilderTests.randomRescoreBuilder());
+        }
+        return new RescorerRetrieverBuilder(TestRetrieverBuilder.createRandomTestRetrieverBuilder(), rescorers);
+    }
+
+    @Override
+    protected RescorerRetrieverBuilder doParseInstance(XContentParser parser) throws IOException {
+        return (RescorerRetrieverBuilder) RetrieverBuilder.parseTopLevelRetrieverBuilder(
+            parser,
+            new RetrieverParserContext(new SearchUsage(), n -> true)
+        );
+    }
+
+    @Override
+    protected boolean supportsUnknownFields() {
+        return false;
+    }
+
+    @Override
+    protected NamedXContentRegistry xContentRegistry() {
+        List<NamedXContentRegistry.Entry> entries = new ArrayList<>(xContentRegistryEntries);
+        entries.add(
+            new NamedXContentRegistry.Entry(
+                RetrieverBuilder.class,
+                TestRetrieverBuilder.TEST_SPEC.getName(),
+                (p, c) -> TestRetrieverBuilder.TEST_SPEC.getParser().fromXContent(p, (RetrieverParserContext) c),
+                TestRetrieverBuilder.TEST_SPEC.getName().getForRestApiVersion()
+            )
+        );
+        return new NamedXContentRegistry(entries);
+    }
+}
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java
index 5b27cc7a3e05a..3a53ed977318d 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java
@@ -50,7 +50,6 @@ public final class QueryRuleRetrieverBuilder extends CompoundRetrieverBuilder<Qu
     public static final ParseField RULESET_IDS_FIELD = new ParseField("ruleset_ids");
     public static final ParseField MATCH_CRITERIA_FIELD = new ParseField("match_criteria");
     public static final ParseField RETRIEVER_FIELD = new ParseField("retriever");
-    public static final ParseField RANK_WINDOW_SIZE_FIELD = new ParseField("rank_window_size");
 
     @SuppressWarnings("unchecked")
     public static final ConstructingObjectParser<QueryRuleRetrieverBuilder, RetrieverParserContext> PARSER = new ConstructingObjectParser<>(
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
index fd2427dc8ac6a..46bebebff9c95 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
@@ -47,7 +47,6 @@ public class TextSimilarityRankRetrieverBuilder extends CompoundRetrieverBuilder
     public static final ParseField INFERENCE_ID_FIELD = new ParseField("inference_id");
     public static final ParseField INFERENCE_TEXT_FIELD = new ParseField("inference_text");
     public static final ParseField FIELD_FIELD = new ParseField("field");
-    public static final ParseField RANK_WINDOW_SIZE_FIELD = new ParseField("rank_window_size");
 
     public static final ConstructingObjectParser<TextSimilarityRankRetrieverBuilder, RetrieverParserContext> PARSER =
         new ConstructingObjectParser<>(TextSimilarityRankBuilder.NAME, args -> {
diff --git a/x-pack/plugin/rank-rrf/build.gradle b/x-pack/plugin/rank-rrf/build.gradle
index 2c3f217243aa4..b2d470c6618ea 100644
--- a/x-pack/plugin/rank-rrf/build.gradle
+++ b/x-pack/plugin/rank-rrf/build.gradle
@@ -22,6 +22,7 @@ dependencies {
   testImplementation(testArtifact(project(xpackModule('core'))))
   testImplementation(testArtifact(project(':server')))
 
+  clusterModules project(':modules:mapper-extras')
   clusterModules project(xpackModule('rank-rrf'))
   clusterModules project(xpackModule('inference'))
   clusterModules project(':modules:lang-painless')
diff --git a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java
index f1171b74f7468..c1447623dd5b1 100644
--- a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java
+++ b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java
@@ -48,7 +48,6 @@ public final class RRFRetrieverBuilder extends CompoundRetrieverBuilder<RRFRetri
     public static final NodeFeature RRF_RETRIEVER_COMPOSITION_SUPPORTED = new NodeFeature("rrf_retriever_composition_supported");
 
     public static final ParseField RETRIEVERS_FIELD = new ParseField("retrievers");
-    public static final ParseField RANK_WINDOW_SIZE_FIELD = new ParseField("rank_window_size");
     public static final ParseField RANK_CONSTANT_FIELD = new ParseField("rank_constant");
 
     public static final int DEFAULT_RANK_CONSTANT = 60;
diff --git a/x-pack/plugin/rank-rrf/src/yamlRestTest/java/org/elasticsearch/xpack/rank/rrf/RRFRankClientYamlTestSuiteIT.java b/x-pack/plugin/rank-rrf/src/yamlRestTest/java/org/elasticsearch/xpack/rank/rrf/RRFRankClientYamlTestSuiteIT.java
index 32b5aedd5d99a..1a22f8738a26a 100644
--- a/x-pack/plugin/rank-rrf/src/yamlRestTest/java/org/elasticsearch/xpack/rank/rrf/RRFRankClientYamlTestSuiteIT.java
+++ b/x-pack/plugin/rank-rrf/src/yamlRestTest/java/org/elasticsearch/xpack/rank/rrf/RRFRankClientYamlTestSuiteIT.java
@@ -21,6 +21,7 @@ public class RRFRankClientYamlTestSuiteIT extends ESClientYamlSuiteTestCase {
     @ClassRule
     public static ElasticsearchCluster cluster = ElasticsearchCluster.local()
         .nodes(2)
+        .module("mapper-extras")
         .module("rank-rrf")
         .module("lang-painless")
         .module("x-pack-inference")
diff --git a/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/900_rrf_with_rescorer.yml b/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/900_rrf_with_rescorer.yml
new file mode 100644
index 0000000000000..c825ede6fccf0
--- /dev/null
+++ b/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/900_rrf_with_rescorer.yml
@@ -0,0 +1,409 @@
+setup:
+  - requires:
+      cluster_features: [ "search.retriever.rescorer.enabled" ]
+      reason: "Support for rescorer retriever"
+  - do:
+      indices.create:
+        index: test
+        body:
+          settings:
+            number_of_shards: 3
+          mappings:
+            properties:
+              available:
+                type: boolean
+              features:
+                type: rank_features
+
+  - do:
+      bulk:
+        refresh: true
+        index: test
+        body:
+          - '{"index": {"_id": 1 }}'
+          - '{"features": { "first_query": 1, "second_query": 3, "final_score": 7}, "available": true}'
+          - '{"index": {"_id": 2 }}'
+          - '{"features": { "first_query": 5, "second_query": 7, "final_score": 4}, "available": false}'
+          - '{"index": {"_id": 3 }}'
+          - '{"features": { "first_query": 6, "second_query": 5, "final_score": 3}, "available": false}'
+          - '{"index": {"_id": 4 }}'
+          - '{"features": { "first_query": 3, "second_query": 2, "final_score": 2}, "available": true}'
+          - '{"index": {"_id": 5 }}'
+          - '{"features": { "first_query": 2, "second_query": 1, "final_score": 1}, "available": true}'
+          - '{"index": {"_id": 6 }}'
+          - '{"features": { "first_query": 4, "second_query": 4, "final_score": 8}, "available": false}'
+          - '{"index": {"_id": 7 }}'
+          - '{"features": { "first_query": 7, "second_query": 10, "final_score": 9}, "available": true}'
+          - '{"index": {"_id": 8 }}'
+          - '{"features": { "first_query": 8, "second_query": 8, "final_score": 10}, "available": true}'
+          - '{"index": {"_id": 9 }}'
+          - '{"features": { "first_query": 9, "second_query": 9, "final_score": 5}, "available": true}'
+          - '{"index": {"_id": 10 }}'
+          - '{"features": { "first_query": 10, "second_query": 6, "final_score": 6}, "available": false}'
+
+---
+"RRF with rescorer retriever basic":
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 10
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 10
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 3
+
+  - match:  { hits.total.value: 10 }
+  - length: { hits.hits: 3}
+  - match:  { hits.hits.0._id: "8" }
+  - match:  { hits.hits.0._score: 10.0 }
+  - match:  { hits.hits.1._id: "7" }
+  - match:  { hits.hits.1._score: 9.0 }
+  - match:  { hits.hits.2._id: "6" }
+  - match:  { hits.hits.2._score: 8.0 }
+
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 5
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 5
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 3
+
+  - match:  { hits.total.value: 10 }
+  - length: { hits.hits: 3}
+  - match:  { hits.hits.0._id: "8" }
+  - match:  { hits.hits.0._score: 10.0 }
+  - match:  { hits.hits.1._id: "7" }
+  - match:  { hits.hits.1._score: 9.0 }
+  - match:  { hits.hits.2._id: "10" }
+  - match:  { hits.hits.2._score: 6.0 }
+
+---
+"RRF with rescorer retriever and prefilters":
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              filter:
+                match:
+                  available: true
+              rescore:
+                window_size: 5
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 5
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 3
+
+  - match:  { hits.total.value: 6 }
+  - length: { hits.hits: 3}
+  - match:  { hits.hits.0._id: "8" }
+  - match:  { hits.hits.0._score: 10.0 }
+  - match:  { hits.hits.1._id: "7" }
+  - match:  { hits.hits.1._score: 9.0 }
+  - match:  { hits.hits.2._id: "1" }
+  - match:  { hits.hits.2._score: 7.0 }
+
+  - do:
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              filter:
+                match:
+                  available: true
+              rescore:
+                window_size: 5
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 5
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        filter: {
+                          match: {
+                            available: true
+                          }
+                        },
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 3
+
+  - match:  { hits.total.value: 6 }
+  - length: { hits.hits: 3}
+  - match:  { hits.hits.0._id: "8" }
+  - match:  { hits.hits.0._score: 10.0 }
+  - match:  { hits.hits.1._id: "7" }
+  - match:  { hits.hits.1._score: 9.0 }
+  - match:  { hits.hits.2._id: "1" }
+  - match:  { hits.hits.2._score: 7.0 }
+
+---
+"RRF with rescorer retriever and aggs":
+  - do:
+      search:
+        index: test
+        body:
+          aggs:
+            1:
+              terms:
+                field: available
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 5
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 5
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        filter: {
+                          match: {
+                            available: true
+                          }
+                        },
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 3
+
+  - match:  { hits.total.value: 10 }
+  - length: { hits.hits: 3}
+  - match:  { hits.hits.0._id: "8" }
+  - match:  { hits.hits.0._score: 10.0 }
+  - match:  { hits.hits.1._id: "7" }
+  - match:  { hits.hits.1._score: 9.0 }
+  - match:  { hits.hits.2._id: "1" }
+  - match:  { hits.hits.2._score: 7.0 }
+  - length: { aggregations.1.buckets: 2}
+  - match:  { aggregations.1.buckets.0.key: 1}
+  - match:  { aggregations.1.buckets.0.doc_count: 6}
+  - match:  { aggregations.1.buckets.1.key: 0 }
+  - match:  { aggregations.1.buckets.1.doc_count: 4 }
+
+---
+"RRF with rescorer retriever and invalid window size":
+  - do:
+      catch: "/\\[rescorer\\] requires \\[window_size: 5\\] be greater than or equal to \\[size: 10\\]/"
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 5
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 5
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 10
+
+  - do:
+      catch: "/\\[rescorer\\] requires \\[window_size: 10\\] to be smaller than or equal to its sub retriever's rrf \\[rank_window_size: 5\\]/"
+      search:
+        index: test
+        body:
+          retriever:
+            rescorer:
+              rescore:
+                window_size: 10
+                query:
+                  rescore_query:
+                    rank_feature:
+                      field: "features.final_score"
+                      linear: { }
+                  query_weight: 0
+              retriever:
+                rrf:
+                  rank_window_size: 5
+                  retrievers: [
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.first_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      standard: {
+                        query: {
+                          rank_feature: {
+                            field: "features.second_query",
+                            linear: { }
+                          }
+                        }
+                      }
+                    }
+                  ]
+          size: 5

From 8c5f0d65e4b59d495e018627004a21a9ab3d8458 Mon Sep 17 00:00:00 2001
From: Parker Timmins <parker.timmins@elastic.co>
Date: Wed, 18 Dec 2024 14:31:17 -0600
Subject: [PATCH 099/119] block-writes cannot be added after read-only
 (#119007)

Fix bug in ReindexDataStreamIndexAction. If the source index has
both a block-writes and is read-only, these must be updated on
the destination index. If read-only is set first, the block-writes
cannot be added because settings cannot be modified.
---
 docs/changelog/119007.yaml                                  | 6 ++++++
 muted-tests.yml                                             | 2 --
 .../action/ReindexDataStreamIndexTransportAction.java       | 2 +-
 3 files changed, 7 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelog/119007.yaml

diff --git a/docs/changelog/119007.yaml b/docs/changelog/119007.yaml
new file mode 100644
index 0000000000000..458101b68d454
--- /dev/null
+++ b/docs/changelog/119007.yaml
@@ -0,0 +1,6 @@
+pr: 119007
+summary: Block-writes cannot be added after read-only
+area: Data streams
+type: bug
+issues:
+ - 119002
diff --git a/muted-tests.yml b/muted-tests.yml
index 81480e89d1e8b..a06334146ed7b 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -293,8 +293,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118955
 - class: org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
   issue: https://github.com/elastic/elasticsearch/issues/118970
-- class:  org.elasticsearch.xpack.migrate.action.ReindexDatastreamIndexTransportActionIT
-  issue: https://github.com/elastic/elasticsearch/issues/119002
 
 # Examples:
 #
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
index 165fd61ae6599..66b13a9ce22b0 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
@@ -92,8 +92,8 @@ protected void doExecute(
             .<AcknowledgedResponse>andThen(l -> deleteDestIfExists(destIndexName, l))
             .<AcknowledgedResponse>andThen(l -> createIndex(sourceIndex, destIndexName, l))
             .<BulkByScrollResponse>andThen(l -> reindex(sourceIndexName, destIndexName, l))
-            .<AddIndexBlockResponse>andThen(l -> addBlockIfFromSource(READ_ONLY, settingsBefore, destIndexName, l))
             .<AddIndexBlockResponse>andThen(l -> addBlockIfFromSource(WRITE, settingsBefore, destIndexName, l))
+            .<AddIndexBlockResponse>andThen(l -> addBlockIfFromSource(READ_ONLY, settingsBefore, destIndexName, l))
             .andThenApply(ignored -> new ReindexDataStreamIndexAction.Response(destIndexName))
             .addListener(listener);
     }

From 6e2c614af34175f55b25ece83f90cffe0e96542c Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@iernst.net>
Date: Wed, 18 Dec 2024 13:01:55 -0800
Subject: [PATCH 100/119] Use minimum java version for javadoc tool (#118908)

When compiling we use a compiler for the minimum java version. However,
javadoc is left to whatever Java gradle uses. This commit adjusts
javadoc to also use a javadoc tool for the minimum java version.
---
 .../internal/ElasticsearchJavaPlugin.java     | 20 +++++++++++++++++--
 .../gradle/internal/MrjarPlugin.java          | 14 ++++++++++---
 2 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/ElasticsearchJavaPlugin.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/ElasticsearchJavaPlugin.java
index e62c26c7fbc01..3ab85ba69dc80 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/ElasticsearchJavaPlugin.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/ElasticsearchJavaPlugin.java
@@ -31,11 +31,15 @@
 import org.gradle.api.tasks.bundling.Jar;
 import org.gradle.api.tasks.javadoc.Javadoc;
 import org.gradle.external.javadoc.CoreJavadocOptions;
+import org.gradle.jvm.toolchain.JavaLanguageVersion;
+import org.gradle.jvm.toolchain.JavaToolchainService;
 import org.gradle.language.base.plugins.LifecycleBasePlugin;
 
 import java.io.File;
 import java.util.Map;
 
+import javax.inject.Inject;
+
 import static org.elasticsearch.gradle.internal.conventions.util.Util.toStringable;
 import static org.elasticsearch.gradle.internal.util.ParamsUtils.loadBuildParams;
 
@@ -44,6 +48,14 @@
  * common configuration for production code.
  */
 public class ElasticsearchJavaPlugin implements Plugin<Project> {
+
+    private final JavaToolchainService javaToolchains;
+
+    @Inject
+    ElasticsearchJavaPlugin(JavaToolchainService javaToolchains) {
+        this.javaToolchains = javaToolchains;
+    }
+
     @Override
     public void apply(Project project) {
         project.getRootProject().getPlugins().apply(GlobalBuildInfoPlugin.class);
@@ -55,7 +67,7 @@ public void apply(Project project) {
         // configureConfigurations(project);
         configureJars(project, buildParams.get());
         configureJarManifest(project, buildParams.get());
-        configureJavadoc(project);
+        configureJavadoc(project, buildParams.get());
         testCompileOnlyDeps(project);
     }
 
@@ -128,7 +140,7 @@ private static void configureJarManifest(Project project, BuildParameterExtensio
         project.getPluginManager().apply("nebula.info-jar");
     }
 
-    private static void configureJavadoc(Project project) {
+    private void configureJavadoc(Project project, BuildParameterExtension buildParams) {
         project.getTasks().withType(Javadoc.class).configureEach(javadoc -> {
             /*
              * Generate docs using html5 to suppress a warning from `javadoc`
@@ -136,6 +148,10 @@ private static void configureJavadoc(Project project) {
              */
             CoreJavadocOptions javadocOptions = (CoreJavadocOptions) javadoc.getOptions();
             javadocOptions.addBooleanOption("html5", true);
+
+            javadoc.getJavadocTool().set(javaToolchains.javadocToolFor(spec -> {
+                spec.getLanguageVersion().set(JavaLanguageVersion.of(buildParams.getMinimumRuntimeVersion().getMajorVersion()));
+            }));
         });
 
         TaskProvider<Javadoc> javadoc = project.getTasks().withType(Javadoc.class).named("javadoc");
diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/MrjarPlugin.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/MrjarPlugin.java
index 7c488e6e73fee..5402e0a04fe8f 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/MrjarPlugin.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/MrjarPlugin.java
@@ -86,14 +86,14 @@ public void apply(Project project) {
             configurePreviewFeatures(project, javaExtension.getSourceSets().getByName(SourceSet.TEST_SOURCE_SET_NAME), 21);
             for (int javaVersion : mainVersions) {
                 String mainSourceSetName = SourceSet.MAIN_SOURCE_SET_NAME + javaVersion;
-                SourceSet mainSourceSet = addSourceSet(project, javaExtension, mainSourceSetName, mainSourceSets, javaVersion);
+                SourceSet mainSourceSet = addSourceSet(project, javaExtension, mainSourceSetName, mainSourceSets, javaVersion, true);
                 configureSourceSetInJar(project, mainSourceSet, javaVersion);
                 addJar(project, mainSourceSet, javaVersion);
                 mainSourceSets.add(mainSourceSetName);
                 testSourceSets.add(mainSourceSetName);
 
                 String testSourceSetName = SourceSet.TEST_SOURCE_SET_NAME + javaVersion;
-                SourceSet testSourceSet = addSourceSet(project, javaExtension, testSourceSetName, testSourceSets, javaVersion);
+                SourceSet testSourceSet = addSourceSet(project, javaExtension, testSourceSetName, testSourceSets, javaVersion, false);
                 testSourceSets.add(testSourceSetName);
                 createTestTask(project, buildParams, testSourceSet, javaVersion, mainSourceSets);
             }
@@ -121,7 +121,8 @@ private SourceSet addSourceSet(
         JavaPluginExtension javaExtension,
         String sourceSetName,
         List<String> parentSourceSets,
-        int javaVersion
+        int javaVersion,
+        boolean isMainSourceSet
     ) {
         SourceSet sourceSet = javaExtension.getSourceSets().maybeCreate(sourceSetName);
         for (String parentSourceSetName : parentSourceSets) {
@@ -135,6 +136,13 @@ private SourceSet addSourceSet(
             CompileOptions compileOptions = compileTask.getOptions();
             compileOptions.getRelease().set(javaVersion);
         });
+        if (isMainSourceSet) {
+            project.getTasks().create(sourceSet.getJavadocTaskName(), Javadoc.class, javadocTask -> {
+                javadocTask.getJavadocTool().set(javaToolchains.javadocToolFor(spec -> {
+                    spec.getLanguageVersion().set(JavaLanguageVersion.of(javaVersion));
+                }));
+            });
+        }
         configurePreviewFeatures(project, sourceSet, javaVersion);
 
         // Since we configure MRJAR sourcesets to allow preview apis, class signatures for those

From 1f4fef13f49918afcc53593c99ec41ebab6b2de0 Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Wed, 18 Dec 2024 13:12:17 -0800
Subject: [PATCH 101/119] Improve efficiency of incremental builds when
 building bwc distributions (#118713)

---
 .../InternalDistributionBwcSetupPlugin.java   | 33 ++++++++++++++-----
 1 file changed, 24 insertions(+), 9 deletions(-)

diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPlugin.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPlugin.java
index da26cb66122ad..0e8dbb7fce26c 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPlugin.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPlugin.java
@@ -17,12 +17,12 @@
 import org.gradle.api.Plugin;
 import org.gradle.api.Project;
 import org.gradle.api.Task;
+import org.gradle.api.file.FileSystemOperations;
 import org.gradle.api.file.ProjectLayout;
 import org.gradle.api.model.ObjectFactory;
 import org.gradle.api.plugins.JvmToolchainsPlugin;
 import org.gradle.api.provider.Provider;
 import org.gradle.api.provider.ProviderFactory;
-import org.gradle.api.tasks.Copy;
 import org.gradle.api.tasks.PathSensitivity;
 import org.gradle.api.tasks.TaskProvider;
 import org.gradle.jvm.toolchain.JavaToolchainService;
@@ -54,11 +54,17 @@ public class InternalDistributionBwcSetupPlugin implements Plugin<Project> {
     private final ObjectFactory objectFactory;
     private ProviderFactory providerFactory;
     private JavaToolchainService toolChainService;
+    private FileSystemOperations fileSystemOperations;
 
     @Inject
-    public InternalDistributionBwcSetupPlugin(ObjectFactory objectFactory, ProviderFactory providerFactory) {
+    public InternalDistributionBwcSetupPlugin(
+        ObjectFactory objectFactory,
+        ProviderFactory providerFactory,
+        FileSystemOperations fileSystemOperations
+    ) {
         this.objectFactory = objectFactory;
         this.providerFactory = providerFactory;
+        this.fileSystemOperations = fileSystemOperations;
     }
 
     @Override
@@ -76,7 +82,8 @@ public void apply(Project project) {
                 providerFactory,
                 objectFactory,
                 toolChainService,
-                isCi
+                isCi,
+                fileSystemOperations
             );
         });
     }
@@ -88,7 +95,8 @@ private static void configureBwcProject(
         ProviderFactory providerFactory,
         ObjectFactory objectFactory,
         JavaToolchainService toolChainService,
-        Boolean isCi
+        Boolean isCi,
+        FileSystemOperations fileSystemOperations
     ) {
         ProjectLayout layout = project.getLayout();
         Provider<BwcVersions.UnreleasedVersionInfo> versionInfoProvider = providerFactory.provider(() -> versionInfo);
@@ -120,11 +128,18 @@ private static void configureBwcProject(
         List<DistributionProject> distributionProjects = resolveArchiveProjects(checkoutDir.get(), bwcVersion.get());
 
         // Setup gradle user home directory
-        project.getTasks().register("setupGradleUserHome", Copy.class, copy -> {
-            copy.into(project.getGradle().getGradleUserHomeDir().getAbsolutePath() + "-" + project.getName());
-            copy.from(project.getGradle().getGradleUserHomeDir().getAbsolutePath(), copySpec -> {
-                copySpec.include("gradle.properties");
-                copySpec.include("init.d/*");
+        // We don't use a normal `Copy` task here as snapshotting the entire gradle user home is very expensive. This task is cheap, so
+        // up-to-date checking doesn't buy us much
+        project.getTasks().register("setupGradleUserHome", task -> {
+            task.doLast(t -> {
+                fileSystemOperations.copy(copy -> {
+                    String gradleUserHome = project.getGradle().getGradleUserHomeDir().getAbsolutePath();
+                    copy.into(gradleUserHome + "-" + project.getName());
+                    copy.from(gradleUserHome, copySpec -> {
+                        copySpec.include("gradle.properties");
+                        copySpec.include("init.d/*");
+                    });
+                });
             });
         });
 

From 24773e0ba619e8f99293521b389a7266a0c8214d Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 08:23:51 +1100
Subject: [PATCH 102/119] Mute
 org.elasticsearch.xpack.security.authc.AuthenticationServiceTests
 testInvalidToken #119019

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index a06334146ed7b..2d215bfb04c57 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -293,6 +293,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118955
 - class: org.elasticsearch.repositories.blobstore.testkit.analyze.SecureHdfsRepositoryAnalysisRestIT
   issue: https://github.com/elastic/elasticsearch/issues/118970
+- class: org.elasticsearch.xpack.security.authc.AuthenticationServiceTests
+  method: testInvalidToken
+  issue: https://github.com/elastic/elasticsearch/issues/119019
 
 # Examples:
 #

From cc69e06974a8b9b543962e7fe98e1b954e89a268 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <christophbuescher@posteo.de>
Date: Wed, 18 Dec 2024 22:35:55 +0100
Subject: [PATCH 103/119] Re-add support for some metadata field parameters
 (#118825)

We removed support for type, fields, copy_to and boost in metadata field
definitions with #116944 but with the move towards supporting N-2
read-only indices we need to add them back. This change reverts previous
removal commits and adapts tests to also check we now throw errors for
newly created indices.
---
 docs/changelog/{116944.yaml => 118825.yaml}   |  4 +-
 .../index/mapper/MetadataFieldMapper.java     | 22 +++++
 .../index/KnownIndexVersions.java             |  1 +
 .../index/mapper/MetadataMapperTestCase.java  | 85 +++++++++++++++++++
 4 files changed, 110 insertions(+), 2 deletions(-)
 rename docs/changelog/{116944.yaml => 118825.yaml} (84%)

diff --git a/docs/changelog/116944.yaml b/docs/changelog/118825.yaml
similarity index 84%
rename from docs/changelog/116944.yaml
rename to docs/changelog/118825.yaml
index e7833e49cf965..23170ec4705da 100644
--- a/docs/changelog/116944.yaml
+++ b/docs/changelog/118825.yaml
@@ -1,4 +1,4 @@
-pr: 116944
+pr: 118825
 summary: "Remove support for type, fields, `copy_to` and boost in metadata field definition"
 area: Mapping
 type: breaking
@@ -6,6 +6,6 @@ issues: []
 breaking:
   title: "Remove support for type, fields, copy_to and boost in metadata field definition"
   area: Mapping
-  details: The type, fields, copy_to and boost parameters are no longer supported in metadata field definition
+  details: The type, fields, copy_to and boost parameters are no longer supported in metadata field definition starting with version 9.
   impact: Users providing type, fields, copy_to or boost as part of metadata field definition should remove them from their mappings.
   notable: false
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/MetadataFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/MetadataFieldMapper.java
index 31aa787c3f758..033742b3b57fc 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/MetadataFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/MetadataFieldMapper.java
@@ -10,13 +10,17 @@
 package org.elasticsearch.index.mapper;
 
 import org.elasticsearch.common.Explicit;
+import org.elasticsearch.common.logging.DeprecationCategory;
 import org.elasticsearch.common.util.Maps;
 import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.xcontent.XContentBuilder;
 
 import java.io.IOException;
 import java.util.Iterator;
 import java.util.Map;
+import java.util.Set;
 import java.util.function.Function;
 
 /**
@@ -132,6 +136,8 @@ public final MetadataFieldMapper build(MapperBuilderContext context) {
             return build();
         }
 
+        private static final Set<String> UNSUPPORTED_PARAMETERS_8_6_0 = Set.of("type", "fields", "copy_to", "boost");
+
         public final void parseMetadataField(String name, MappingParserContext parserContext, Map<String, Object> fieldNode) {
             final Parameter<?>[] params = getParameters();
             Map<String, Parameter<?>> paramsMap = Maps.newHashMapWithExpectedSize(params.length);
@@ -144,6 +150,22 @@ public final void parseMetadataField(String name, MappingParserContext parserCon
                 final Object propNode = entry.getValue();
                 Parameter<?> parameter = paramsMap.get(propName);
                 if (parameter == null) {
+                    IndexVersion indexVersionCreated = parserContext.indexVersionCreated();
+                    if (indexVersionCreated.before(IndexVersions.UPGRADE_TO_LUCENE_10_0_0)
+                        && UNSUPPORTED_PARAMETERS_8_6_0.contains(propName)) {
+                        if (indexVersionCreated.onOrAfter(IndexVersions.V_8_6_0)) {
+                            // silently ignore type, and a few other parameters: sadly we've been doing this for a long time
+                            deprecationLogger.warn(
+                                DeprecationCategory.API,
+                                propName,
+                                "Parameter [{}] has no effect on metadata field [{}] and will be removed in future",
+                                propName,
+                                name
+                            );
+                        }
+                        iterator.remove();
+                        continue;
+                    }
                     throw new MapperParsingException("unknown parameter [" + propName + "] on metadata field [" + name + "]");
                 }
                 parameter.parse(name, parserContext, propNode);
diff --git a/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java b/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java
index 5cdb3f1808a38..4f559a5f3eaef 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/KnownIndexVersions.java
@@ -19,6 +19,7 @@ public class KnownIndexVersions {
      * A sorted list of all known index versions
      */
     public static final List<IndexVersion> ALL_VERSIONS = List.copyOf(IndexVersions.getAllVersions());
+
     /**
      * A sorted list of all known index versions that can be written to
      */
diff --git a/test/framework/src/main/java/org/elasticsearch/index/mapper/MetadataMapperTestCase.java b/test/framework/src/main/java/org/elasticsearch/index/mapper/MetadataMapperTestCase.java
index 449ecc099412f..580eb6eacb27e 100644
--- a/test/framework/src/main/java/org/elasticsearch/index/mapper/MetadataMapperTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/index/mapper/MetadataMapperTestCase.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.core.CheckedConsumer;
 import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.mapper.MapperService.MergeReason;
 import org.elasticsearch.test.index.IndexVersionUtils;
 import org.elasticsearch.xcontent.XContentBuilder;
@@ -142,4 +143,88 @@ public final void testFixedMetaFieldsAreNotConfigurable() throws IOException {
         );
         assertEquals("Failed to parse mapping: " + fieldName() + " is not configurable", exception.getMessage());
     }
+
+    public void testTypeAndFriendsAreAcceptedBefore_8_6_0() throws IOException {
+        assumeTrue("Metadata field " + fieldName() + " isn't configurable", isConfigurable());
+        IndexVersion previousVersion = IndexVersionUtils.getPreviousVersion(IndexVersions.V_8_6_0);
+        // we randomly also pick read-only versions to test that we can still parse the parameters for them
+        IndexVersion version = IndexVersionUtils.randomVersionBetween(
+            random(),
+            IndexVersionUtils.getLowestReadCompatibleVersion(),
+            previousVersion
+        );
+        assumeTrue("Metadata field " + fieldName() + " is not supported on version " + version, isSupportedOn(version));
+        MapperService mapperService = createMapperService(version, mapping(b -> {}));
+        // these parameters were previously silently ignored, they will still be ignored in existing indices
+        String[] unsupportedParameters = new String[] { "fields", "copy_to", "boost", "type" };
+        for (String param : unsupportedParameters) {
+            String mappingAsString = "{\n"
+                + "    \"_doc\" : {\n"
+                + "      \""
+                + fieldName()
+                + "\" : {\n"
+                + "        \""
+                + param
+                + "\" : \"any\"\n"
+                + "      }\n"
+                + "    }\n"
+                + "}";
+            assertNotNull(mapperService.parseMapping("_doc", MergeReason.MAPPING_UPDATE, new CompressedXContent(mappingAsString)));
+        }
+    }
+
+    public void testTypeAndFriendsAreDeprecatedFrom_8_6_0_TO_9_0_0() throws IOException {
+        assumeTrue("Metadata field " + fieldName() + " isn't configurable", isConfigurable());
+        IndexVersion previousVersion = IndexVersionUtils.getPreviousVersion(IndexVersions.UPGRADE_TO_LUCENE_10_0_0);
+        IndexVersion version = IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_6_0, previousVersion);
+        assumeTrue("Metadata field " + fieldName() + " is not supported on version " + version, isSupportedOn(version));
+        MapperService mapperService = createMapperService(version, mapping(b -> {}));
+        // these parameters were deprecated, they now should throw an error in new indices
+        String[] unsupportedParameters = new String[] { "fields", "copy_to", "boost", "type" };
+        for (String param : unsupportedParameters) {
+            String mappingAsString = "{\n"
+                + "    \"_doc\" : {\n"
+                + "      \""
+                + fieldName()
+                + "\" : {\n"
+                + "        \""
+                + param
+                + "\" : \"any\"\n"
+                + "      }\n"
+                + "    }\n"
+                + "}";
+            assertNotNull(mapperService.parseMapping("_doc", MergeReason.MAPPING_UPDATE, new CompressedXContent(mappingAsString)));
+            assertWarnings("Parameter [" + param + "] has no effect on metadata field [" + fieldName() + "] and will be removed in future");
+        }
+    }
+
+    public void testTypeAndFriendsThrow_After_9_0_0() throws IOException {
+        assumeTrue("Metadata field " + fieldName() + " isn't configurable", isConfigurable());
+        IndexVersion version = IndexVersionUtils.randomVersionBetween(
+            random(),
+            IndexVersions.UPGRADE_TO_LUCENE_10_0_0,
+            IndexVersion.current()
+        );
+        assumeTrue("Metadata field " + fieldName() + " is not supported on version " + version, isSupportedOn(version));
+        MapperService mapperService = createMapperService(version, mapping(b -> {}));
+        // these parameters were previously silently ignored, they are now deprecated in new indices
+        String[] unsupportedParameters = new String[] { "fields", "copy_to", "boost", "type" };
+        for (String param : unsupportedParameters) {
+            String mappingAsString = "{\n"
+                + "    \"_doc\" : {\n"
+                + "      \""
+                + fieldName()
+                + "\" : {\n"
+                + "        \""
+                + param
+                + "\" : \"any\"\n"
+                + "      }\n"
+                + "    }\n"
+                + "}";
+            expectThrows(
+                MapperParsingException.class,
+                () -> mapperService.parseMapping("_doc", MergeReason.MAPPING_UPDATE, new CompressedXContent(mappingAsString))
+            );
+        }
+    }
 }

From b8130768f6c41e876014dff8838981c99c1078b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <christophbuescher@posteo.de>
Date: Wed, 18 Dec 2024 22:37:14 +0100
Subject: [PATCH 104/119] Add back version based logic from IndexSortConfig

This change re-introduces pre-7.13 deprecation logging and silent handling
of index sorting on alias fields. We need to still support this for v9 for read-only
indices.
---
 .../elasticsearch/index/IndexSortConfig.java  | 25 ++++++++++++++++++-
 .../index/IndexSortSettingsTests.java         | 14 +++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/index/IndexSortConfig.java b/server/src/main/java/org/elasticsearch/index/IndexSortConfig.java
index 2811c7493a277..6c044ab999899 100644
--- a/server/src/main/java/org/elasticsearch/index/IndexSortConfig.java
+++ b/server/src/main/java/org/elasticsearch/index/IndexSortConfig.java
@@ -14,6 +14,8 @@
 import org.apache.lucene.search.SortedNumericSortField;
 import org.apache.lucene.search.SortedSetSortField;
 import org.elasticsearch.cluster.metadata.DataStream;
+import org.elasticsearch.common.logging.DeprecationCategory;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.fielddata.IndexFieldData;
@@ -53,6 +55,8 @@
 **/
 public final class IndexSortConfig {
 
+    private static final DeprecationLogger DEPRECATION_LOGGER = DeprecationLogger.getLogger(IndexSortConfig.class);
+
     /**
      * The list of field names
      */
@@ -134,10 +138,14 @@ private static MultiValueMode parseMultiValueMode(String value) {
 
     // visible for tests
     final FieldSortSpec[] sortSpecs;
+    private final IndexVersion indexCreatedVersion;
+    private final String indexName;
     private final IndexMode indexMode;
 
     public IndexSortConfig(IndexSettings indexSettings) {
         final Settings settings = indexSettings.getSettings();
+        this.indexCreatedVersion = indexSettings.getIndexVersionCreated();
+        this.indexName = indexSettings.getIndex().getName();
         this.indexMode = indexSettings.getMode();
 
         if (this.indexMode == IndexMode.TIME_SERIES) {
@@ -230,7 +238,22 @@ public Sort buildIndexSort(
                 throw new IllegalArgumentException(err);
             }
             if (Objects.equals(ft.name(), sortSpec.field) == false) {
-                throw new IllegalArgumentException("Cannot use alias [" + sortSpec.field + "] as an index sort field");
+                if (this.indexCreatedVersion.onOrAfter(IndexVersions.V_7_13_0)) {
+                    throw new IllegalArgumentException("Cannot use alias [" + sortSpec.field + "] as an index sort field");
+                } else {
+                    DEPRECATION_LOGGER.warn(
+                        DeprecationCategory.MAPPINGS,
+                        "index-sort-aliases",
+                        "Index sort for index ["
+                            + indexName
+                            + "] defined on field ["
+                            + sortSpec.field
+                            + "] which resolves to field ["
+                            + ft.name()
+                            + "]. "
+                            + "You will not be able to define an index sort over aliased fields in new indexes"
+                    );
+                }
             }
             boolean reverse = sortSpec.order == null ? false : (sortSpec.order == SortOrder.DESC);
             MultiValueMode mode = sortSpec.mode;
diff --git a/server/src/test/java/org/elasticsearch/index/IndexSortSettingsTests.java b/server/src/test/java/org/elasticsearch/index/IndexSortSettingsTests.java
index 441ad8a5a225a..7221d69b74d46 100644
--- a/server/src/test/java/org/elasticsearch/index/IndexSortSettingsTests.java
+++ b/server/src/test/java/org/elasticsearch/index/IndexSortSettingsTests.java
@@ -160,6 +160,20 @@ public void testSortingAgainstAliases() {
         assertEquals("Cannot use alias [field] as an index sort field", e.getMessage());
     }
 
+    public void testSortingAgainstAliasesPre713() {
+        IndexSettings indexSettings = indexSettings(
+            Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersions.V_7_12_0).put("index.sort.field", "field").build()
+        );
+        MappedFieldType aliased = new KeywordFieldMapper.KeywordFieldType("aliased");
+        Sort sort = buildIndexSort(indexSettings, Map.of("field", aliased));
+        assertThat(sort.getSort(), arrayWithSize(1));
+        assertThat(sort.getSort()[0].getField(), equalTo("aliased"));
+        assertWarnings(
+            "Index sort for index [test] defined on field [field] which resolves to field [aliased]. "
+                + "You will not be able to define an index sort over aliased fields in new indexes"
+        );
+    }
+
     public void testTimeSeriesMode() {
         IndexSettings indexSettings = indexSettings(
             Settings.builder()

From e087f3d9371370c0cde96d83538938ca0d15276c Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Wed, 18 Dec 2024 15:43:53 -0600
Subject: [PATCH 105/119] Connecting the reindex data stream persistent task to
 ReindexDataStreamIndexAction (#118978)

---
 ...indexDataStreamPersistentTaskExecutor.java | 125 ++++++++++++--
 .../upgrades/DataStreamsUpgradeIT.java        | 156 ++++++++++++++++++
 2 files changed, 269 insertions(+), 12 deletions(-)

diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
index 494be303980a7..dc8e33bc091e6 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
@@ -9,8 +9,15 @@
 
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.admin.indices.rollover.RolloverAction;
+import org.elasticsearch.action.admin.indices.rollover.RolloverRequest;
 import org.elasticsearch.action.datastreams.GetDataStreamAction;
+import org.elasticsearch.action.datastreams.ModifyDataStreamsAction;
+import org.elasticsearch.action.support.CountDownActionListener;
+import org.elasticsearch.action.support.master.AcknowledgedResponse;
 import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.cluster.metadata.DataStream;
+import org.elasticsearch.cluster.metadata.DataStreamAction;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.index.Index;
@@ -20,9 +27,13 @@
 import org.elasticsearch.persistent.PersistentTasksExecutor;
 import org.elasticsearch.tasks.TaskId;
 import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.migrate.action.ReindexDataStreamIndexAction;
 
+import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
 import java.util.Map;
+import java.util.NoSuchElementException;
 
 import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.getOldIndexVersionPredicate;
 
@@ -72,22 +83,109 @@ protected void nodeOperation(AllocatedPersistentTask task, ReindexDataStreamTask
         reindexClient.execute(GetDataStreamAction.INSTANCE, request, ActionListener.wrap(response -> {
             List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = response.getDataStreams();
             if (dataStreamInfos.size() == 1) {
-                List<Index> indices = dataStreamInfos.getFirst().getDataStream().getIndices();
-                List<Index> indicesToBeReindexed = indices.stream()
-                    .filter(getOldIndexVersionPredicate(clusterService.state().metadata()))
-                    .toList();
-                reindexDataStreamTask.setPendingIndicesCount(indicesToBeReindexed.size());
-                for (Index index : indicesToBeReindexed) {
-                    reindexDataStreamTask.incrementInProgressIndicesCount(index.getName());
-                    // TODO This is just a placeholder. This is where the real data stream reindex logic will go
-                    reindexDataStreamTask.reindexSucceeded(index.getName());
+                DataStream dataStream = dataStreamInfos.getFirst().getDataStream();
+                if (getOldIndexVersionPredicate(clusterService.state().metadata()).test(dataStream.getWriteIndex())) {
+                    reindexClient.execute(
+                        RolloverAction.INSTANCE,
+                        new RolloverRequest(sourceDataStream, null),
+                        ActionListener.wrap(
+                            rolloverResponse -> reindexIndices(dataStream, reindexDataStreamTask, reindexClient, sourceDataStream),
+                            e -> completeFailedPersistentTask(reindexDataStreamTask, e)
+                        )
+                    );
+                } else {
+                    reindexIndices(dataStream, reindexDataStreamTask, reindexClient, sourceDataStream);
                 }
-
-                completeSuccessfulPersistentTask(reindexDataStreamTask);
             } else {
                 completeFailedPersistentTask(reindexDataStreamTask, new ElasticsearchException("data stream does not exist"));
             }
-        }, reindexDataStreamTask::markAsFailed));
+        }, exception -> completeFailedPersistentTask(reindexDataStreamTask, exception)));
+    }
+
+    private void reindexIndices(
+        DataStream dataStream,
+        ReindexDataStreamTask reindexDataStreamTask,
+        ExecuteWithHeadersClient reindexClient,
+        String sourceDataStream
+    ) {
+        List<Index> indices = dataStream.getIndices();
+        List<Index> indicesToBeReindexed = indices.stream().filter(getOldIndexVersionPredicate(clusterService.state().metadata())).toList();
+        reindexDataStreamTask.setPendingIndicesCount(indicesToBeReindexed.size());
+        // The CountDownActionListener is 1 more than the number of indices so that the count is not 0 if we have no indices
+        CountDownActionListener listener = new CountDownActionListener(indicesToBeReindexed.size() + 1, ActionListener.wrap(response1 -> {
+            completeSuccessfulPersistentTask(reindexDataStreamTask);
+        }, exception -> { completeFailedPersistentTask(reindexDataStreamTask, exception); }));
+        List<Index> indicesRemaining = Collections.synchronizedList(new ArrayList<>(indicesToBeReindexed));
+        final int maxConcurrentIndices = 1;
+        for (int i = 0; i < maxConcurrentIndices; i++) {
+            maybeProcessNextIndex(indicesRemaining, reindexDataStreamTask, reindexClient, sourceDataStream, listener);
+        }
+        // This takes care of the additional latch count referenced above:
+        listener.onResponse(null);
+    }
+
+    private void maybeProcessNextIndex(
+        List<Index> indicesRemaining,
+        ReindexDataStreamTask reindexDataStreamTask,
+        ExecuteWithHeadersClient reindexClient,
+        String sourceDataStream,
+        CountDownActionListener listener
+    ) {
+        if (indicesRemaining.isEmpty()) {
+            return;
+        }
+        Index index;
+        try {
+            index = indicesRemaining.removeFirst();
+        } catch (NoSuchElementException e) {
+            return;
+        }
+        reindexDataStreamTask.incrementInProgressIndicesCount(index.getName());
+        reindexClient.execute(
+            ReindexDataStreamIndexAction.INSTANCE,
+            new ReindexDataStreamIndexAction.Request(index.getName()),
+            ActionListener.wrap(response1 -> {
+                updateDataStream(sourceDataStream, index.getName(), response1.getDestIndex(), ActionListener.wrap(unused -> {
+                    reindexDataStreamTask.reindexSucceeded(index.getName());
+                    listener.onResponse(null);
+                    maybeProcessNextIndex(indicesRemaining, reindexDataStreamTask, reindexClient, sourceDataStream, listener);
+                }, exception -> {
+                    reindexDataStreamTask.reindexFailed(index.getName(), exception);
+                    listener.onResponse(null);
+                }), reindexClient);
+            }, exception -> {
+                reindexDataStreamTask.reindexFailed(index.getName(), exception);
+                listener.onResponse(null);
+            })
+        );
+    }
+
+    private void updateDataStream(
+        String dataStream,
+        String oldIndex,
+        String newIndex,
+        ActionListener<Void> listener,
+        ExecuteWithHeadersClient reindexClient
+    ) {
+        reindexClient.execute(
+            ModifyDataStreamsAction.INSTANCE,
+            new ModifyDataStreamsAction.Request(
+                TimeValue.MAX_VALUE,
+                TimeValue.MAX_VALUE,
+                List.of(DataStreamAction.removeBackingIndex(dataStream, oldIndex), DataStreamAction.addBackingIndex(dataStream, newIndex))
+            ),
+            new ActionListener<>() {
+                @Override
+                public void onResponse(AcknowledgedResponse response) {
+                    listener.onResponse(null);
+                }
+
+                @Override
+                public void onFailure(Exception e) {
+                    listener.onFailure(e);
+                }
+            }
+        );
     }
 
     private void completeSuccessfulPersistentTask(ReindexDataStreamTask persistentTask) {
@@ -105,6 +203,9 @@ private TimeValue getTimeToLive(ReindexDataStreamTask reindexDataStreamTask) {
         PersistentTasksCustomMetadata.PersistentTask<?> persistentTask = persistentTasksCustomMetadata.getTask(
             reindexDataStreamTask.getPersistentTaskId()
         );
+        if (persistentTask == null) {
+            return TimeValue.timeValueMillis(0);
+        }
         PersistentTaskState state = persistentTask.getState();
         final long completionTime;
         if (state == null) {
diff --git a/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/DataStreamsUpgradeIT.java b/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/DataStreamsUpgradeIT.java
index 40ad5bba29baa..58556dd420ca6 100644
--- a/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/DataStreamsUpgradeIT.java
+++ b/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/DataStreamsUpgradeIT.java
@@ -11,15 +11,23 @@
 import org.elasticsearch.client.Response;
 import org.elasticsearch.cluster.metadata.DataStream;
 import org.elasticsearch.cluster.metadata.DataStreamTestHelper;
+import org.elasticsearch.common.time.DateFormatter;
+import org.elasticsearch.common.time.FormatNames;
+import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.core.Booleans;
 import org.elasticsearch.core.Strings;
+import org.elasticsearch.xcontent.json.JsonXContent;
 import org.hamcrest.Matchers;
 
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
+import java.time.Instant;
 import java.util.List;
+import java.util.Map;
+import java.util.concurrent.TimeUnit;
 
 import static org.elasticsearch.upgrades.IndexingIT.assertCount;
+import static org.hamcrest.Matchers.equalTo;
 
 public class DataStreamsUpgradeIT extends AbstractUpgradeTestCase {
 
@@ -164,4 +172,152 @@ public void testDataStreamValidationDoesNotBreakUpgrade() throws Exception {
         }
     }
 
+    public void testUpgradeDataStream() throws Exception {
+        String dataStreamName = "reindex_test_data_stream";
+        int numRollovers = 5;
+        if (CLUSTER_TYPE == ClusterType.OLD) {
+            createAndRolloverDataStream(dataStreamName, numRollovers);
+        } else if (CLUSTER_TYPE == ClusterType.UPGRADED) {
+            upgradeDataStream(dataStreamName, numRollovers);
+        }
+    }
+
+    private static void createAndRolloverDataStream(String dataStreamName, int numRollovers) throws IOException {
+        // We want to create a data stream and roll it over several times so that we have several indices to upgrade
+        final String template = """
+            {
+                "settings":{
+                    "index": {
+                        "mode": "time_series"
+                    }
+                },
+                "mappings":{
+                    "dynamic_templates": [
+                        {
+                            "labels": {
+                                "path_match": "pod.labels.*",
+                                "mapping": {
+                                    "type": "keyword",
+                                    "time_series_dimension": true
+                                }
+                            }
+                        }
+                    ],
+                    "properties": {
+                        "@timestamp" : {
+                            "type": "date"
+                        },
+                        "metricset": {
+                            "type": "keyword",
+                            "time_series_dimension": true
+                        },
+                        "k8s": {
+                            "properties": {
+                                "pod": {
+                                    "properties": {
+                                        "name": {
+                                            "type": "keyword"
+                                        },
+                                        "network": {
+                                            "properties": {
+                                                "tx": {
+                                                    "type": "long"
+                                                },
+                                                "rx": {
+                                                    "type": "long"
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            """;
+        final String indexTemplate = """
+            {
+                "index_patterns": ["$PATTERN"],
+                "template": $TEMPLATE,
+                "data_stream": {
+                }
+            }""";
+        var putIndexTemplateRequest = new Request("POST", "/_index_template/reindex_test_data_stream_template");
+        putIndexTemplateRequest.setJsonEntity(indexTemplate.replace("$TEMPLATE", template).replace("$PATTERN", dataStreamName));
+        assertOK(client().performRequest(putIndexTemplateRequest));
+        bulkLoadData(dataStreamName);
+        for (int i = 0; i < numRollovers; i++) {
+            rollover(dataStreamName);
+            bulkLoadData(dataStreamName);
+        }
+    }
+
+    private void upgradeDataStream(String dataStreamName, int numRollovers) throws Exception {
+        Request reindexRequest = new Request("POST", "/_migration/reindex");
+        reindexRequest.setJsonEntity(Strings.format("""
+            {
+              "mode": "upgrade",
+              "source": {
+                "index": "%s"
+              }
+            }""", dataStreamName));
+        Response reindexResponse = client().performRequest(reindexRequest);
+        assertOK(reindexResponse);
+        assertBusy(() -> {
+            Request statusRequest = new Request("GET", "_migration/reindex/" + dataStreamName + "/_status");
+            Response statusResponse = client().performRequest(statusRequest);
+            Map<String, Object> statusResponseMap = XContentHelper.convertToMap(
+                JsonXContent.jsonXContent,
+                statusResponse.getEntity().getContent(),
+                false
+            );
+            assertOK(statusResponse);
+            assertThat(statusResponseMap.get("complete"), equalTo(true));
+            if (isOriginalClusterCurrent()) {
+                // If the original cluster was the same as this one, we don't want any indices reindexed:
+                assertThat(statusResponseMap.get("successes"), equalTo(0));
+            } else {
+                assertThat(statusResponseMap.get("successes"), equalTo(numRollovers + 1));
+            }
+        }, 60, TimeUnit.SECONDS);
+        Request cancelRequest = new Request("POST", "_migration/reindex/" + dataStreamName + "/_cancel");
+        Response cancelResponse = client().performRequest(cancelRequest);
+        assertOK(cancelResponse);
+    }
+
+    private static void bulkLoadData(String dataStreamName) throws IOException {
+        final String bulk = """
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "cat", "network": {"tx": 2001818691, "rx": 802133794}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "hamster", "network": {"tx": 2005177954, "rx": 801479970}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "cow", "network": {"tx": 2006223737, "rx": 802337279}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "rat", "network": {"tx": 2012916202, "rx": 803685721}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "dog", "network": {"tx": 1434521831, "rx": 530575198}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "tiger", "network": {"tx": 1434577921, "rx": 530600088}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "lion", "network": {"tx": 1434587694, "rx": 530604797}}}}
+            {"create": {}}
+            {"@timestamp": "$now", "metricset": "pod", "k8s": {"pod": {"name": "elephant", "network": {"tx": 1434595272, "rx": 530605511}}}}
+            """;
+        var bulkRequest = new Request("POST", "/" + dataStreamName + "/_bulk");
+        bulkRequest.setJsonEntity(bulk.replace("$now", formatInstant(Instant.now())));
+        var response = client().performRequest(bulkRequest);
+        assertOK(response);
+    }
+
+    static String formatInstant(Instant instant) {
+        return DateFormatter.forPattern(FormatNames.STRICT_DATE_OPTIONAL_TIME.getName()).format(instant);
+    }
+
+    private static void rollover(String dataStreamName) throws IOException {
+        Request rolloverRequest = new Request("POST", "/" + dataStreamName + "/_rollover");
+        Response rolloverResponse = client().performRequest(rolloverRequest);
+        assertOK(rolloverResponse);
+    }
 }

From c54a26db49da892170f13434cfe5dd9f3bfe78bb Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 09:20:22 +1100
Subject: [PATCH 106/119] Mute
 org.elasticsearch.backwards.MixedClusterClientYamlTestSuiteIT test
 {p0=synonyms/90_synonyms_reloading_for_synset/Reload analyzers for specific
 synonym set} #116777

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 2d215bfb04c57..35a9b31685794 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -296,6 +296,9 @@ tests:
 - class: org.elasticsearch.xpack.security.authc.AuthenticationServiceTests
   method: testInvalidToken
   issue: https://github.com/elastic/elasticsearch/issues/119019
+- class: org.elasticsearch.backwards.MixedClusterClientYamlTestSuiteIT
+  method: test {p0=synonyms/90_synonyms_reloading_for_synset/Reload analyzers for specific synonym set}
+  issue: https://github.com/elastic/elasticsearch/issues/116777
 
 # Examples:
 #

From c3a59bb9659accaf36f83f0b28d49f68939f6ce7 Mon Sep 17 00:00:00 2001
From: Patrick Doyle <810052+prdoyle@users.noreply.github.com>
Date: Wed, 18 Dec 2024 18:06:52 -0500
Subject: [PATCH 107/119] Process execution checks and IT tests (#119010)

* Process creation checks and IT tests

* Remove process queries; only forbid execution
---
 .../bridge/EntitlementChecker.java            |  7 ++++
 .../common/RestEntitlementsCheckAction.java   | 39 +++++++++++++------
 .../EntitlementAllowedNonModularPlugin.java   |  1 -
 .../qa/EntitlementAllowedPlugin.java          |  1 -
 .../EntitlementDeniedNonModularPlugin.java    |  1 -
 .../qa/EntitlementDeniedPlugin.java           |  1 -
 .../api/ElasticsearchEntitlementChecker.java  | 11 ++++++
 .../runtime/policy/PolicyManager.java         | 20 ++++++++++
 8 files changed, 66 insertions(+), 15 deletions(-)

diff --git a/libs/entitlement/bridge/src/main/java/org/elasticsearch/entitlement/bridge/EntitlementChecker.java b/libs/entitlement/bridge/src/main/java/org/elasticsearch/entitlement/bridge/EntitlementChecker.java
index a6b8a31fc3894..25f4e97bd12ee 100644
--- a/libs/entitlement/bridge/src/main/java/org/elasticsearch/entitlement/bridge/EntitlementChecker.java
+++ b/libs/entitlement/bridge/src/main/java/org/elasticsearch/entitlement/bridge/EntitlementChecker.java
@@ -11,6 +11,7 @@
 
 import java.net.URL;
 import java.net.URLStreamHandlerFactory;
+import java.util.List;
 
 public interface EntitlementChecker {
 
@@ -29,4 +30,10 @@ public interface EntitlementChecker {
     void check$java_net_URLClassLoader$(Class<?> callerClass, String name, URL[] urls, ClassLoader parent);
 
     void check$java_net_URLClassLoader$(Class<?> callerClass, String name, URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory);
+
+    // Process creation
+    void check$$start(Class<?> callerClass, ProcessBuilder that, ProcessBuilder.Redirect[] redirects);
+
+    void check$java_lang_ProcessBuilder$startPipeline(Class<?> callerClass, List<ProcessBuilder> builders);
+
 }
diff --git a/libs/entitlement/qa/common/src/main/java/org/elasticsearch/entitlement/qa/common/RestEntitlementsCheckAction.java b/libs/entitlement/qa/common/src/main/java/org/elasticsearch/entitlement/qa/common/RestEntitlementsCheckAction.java
index 1ac4a7506eacb..3cc4b97e9bfea 100644
--- a/libs/entitlement/qa/common/src/main/java/org/elasticsearch/entitlement/qa/common/RestEntitlementsCheckAction.java
+++ b/libs/entitlement/qa/common/src/main/java/org/elasticsearch/entitlement/qa/common/RestEntitlementsCheckAction.java
@@ -29,43 +29,47 @@
 import java.util.stream.Collectors;
 
 import static java.util.Map.entry;
+import static org.elasticsearch.entitlement.qa.common.RestEntitlementsCheckAction.CheckAction.deniedToPlugins;
+import static org.elasticsearch.entitlement.qa.common.RestEntitlementsCheckAction.CheckAction.forPlugins;
 import static org.elasticsearch.rest.RestRequest.Method.GET;
 
 public class RestEntitlementsCheckAction extends BaseRestHandler {
     private static final Logger logger = LogManager.getLogger(RestEntitlementsCheckAction.class);
     private final String prefix;
 
-    private record CheckAction(Runnable action, boolean isServerOnly) {
-
-        static CheckAction serverOnly(Runnable action) {
+    record CheckAction(Runnable action, boolean isAlwaysDeniedToPlugins) {
+        /**
+         * These cannot be granted to plugins, so our test plugins cannot test the "allowed" case.
+         * Used both for always-denied entitlements as well as those granted only to the server itself.
+         */
+        static CheckAction deniedToPlugins(Runnable action) {
             return new CheckAction(action, true);
         }
 
-        static CheckAction serverAndPlugin(Runnable action) {
+        static CheckAction forPlugins(Runnable action) {
             return new CheckAction(action, false);
         }
     }
 
     private static final Map<String, CheckAction> checkActions = Map.ofEntries(
-        entry("runtime_exit", CheckAction.serverOnly(RestEntitlementsCheckAction::runtimeExit)),
-        entry("runtime_halt", CheckAction.serverOnly(RestEntitlementsCheckAction::runtimeHalt)),
-        entry("create_classloader", CheckAction.serverAndPlugin(RestEntitlementsCheckAction::createClassLoader))
+        entry("runtime_exit", deniedToPlugins(RestEntitlementsCheckAction::runtimeExit)),
+        entry("runtime_halt", deniedToPlugins(RestEntitlementsCheckAction::runtimeHalt)),
+        entry("create_classloader", forPlugins(RestEntitlementsCheckAction::createClassLoader)),
+        // entry("processBuilder_start", deniedToPlugins(RestEntitlementsCheckAction::processBuilder_start)),
+        entry("processBuilder_startPipeline", deniedToPlugins(RestEntitlementsCheckAction::processBuilder_startPipeline))
     );
 
     @SuppressForbidden(reason = "Specifically testing Runtime.exit")
     private static void runtimeExit() {
-        logger.info("Calling Runtime.exit;");
         Runtime.getRuntime().exit(123);
     }
 
     @SuppressForbidden(reason = "Specifically testing Runtime.halt")
     private static void runtimeHalt() {
-        logger.info("Calling Runtime.halt;");
         Runtime.getRuntime().halt(123);
     }
 
     private static void createClassLoader() {
-        logger.info("Calling new URLClassLoader");
         try (var classLoader = new URLClassLoader("test", new URL[0], RestEntitlementsCheckAction.class.getClassLoader())) {
             logger.info("Created URLClassLoader [{}]", classLoader.getName());
         } catch (IOException e) {
@@ -73,6 +77,18 @@ private static void createClassLoader() {
         }
     }
 
+    private static void processBuilder_start() {
+        // TODO: processBuilder().start();
+    }
+
+    private static void processBuilder_startPipeline() {
+        try {
+            ProcessBuilder.startPipeline(List.of());
+        } catch (IOException e) {
+            throw new IllegalStateException(e);
+        }
+    }
+
     public RestEntitlementsCheckAction(String prefix) {
         this.prefix = prefix;
     }
@@ -80,7 +96,7 @@ public RestEntitlementsCheckAction(String prefix) {
     public static Set<String> getServerAndPluginsCheckActions() {
         return checkActions.entrySet()
             .stream()
-            .filter(kv -> kv.getValue().isServerOnly() == false)
+            .filter(kv -> kv.getValue().isAlwaysDeniedToPlugins() == false)
             .map(Map.Entry::getKey)
             .collect(Collectors.toSet());
     }
@@ -112,6 +128,7 @@ protected RestChannelConsumer prepareRequest(RestRequest request, NodeClient cli
         }
 
         return channel -> {
+            logger.info("Calling check action [{}]", actionName);
             checkAction.action().run();
             channel.sendResponse(new RestResponse(RestStatus.OK, Strings.format("Succesfully executed action [%s]", actionName)));
         };
diff --git a/libs/entitlement/qa/entitlement-allowed-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementAllowedNonModularPlugin.java b/libs/entitlement/qa/entitlement-allowed-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementAllowedNonModularPlugin.java
index d65981c30f0be..82146e6a87759 100644
--- a/libs/entitlement/qa/entitlement-allowed-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementAllowedNonModularPlugin.java
+++ b/libs/entitlement/qa/entitlement-allowed-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementAllowedNonModularPlugin.java
@@ -27,7 +27,6 @@
 import java.util.function.Supplier;
 
 public class EntitlementAllowedNonModularPlugin extends Plugin implements ActionPlugin {
-
     @Override
     public List<RestHandler> getRestHandlers(
         final Settings settings,
diff --git a/libs/entitlement/qa/entitlement-allowed/src/main/java/org/elasticsearch/entitlement/qa/EntitlementAllowedPlugin.java b/libs/entitlement/qa/entitlement-allowed/src/main/java/org/elasticsearch/entitlement/qa/EntitlementAllowedPlugin.java
index d81e23e311be1..8649daf272e70 100644
--- a/libs/entitlement/qa/entitlement-allowed/src/main/java/org/elasticsearch/entitlement/qa/EntitlementAllowedPlugin.java
+++ b/libs/entitlement/qa/entitlement-allowed/src/main/java/org/elasticsearch/entitlement/qa/EntitlementAllowedPlugin.java
@@ -27,7 +27,6 @@
 import java.util.function.Supplier;
 
 public class EntitlementAllowedPlugin extends Plugin implements ActionPlugin {
-
     @Override
     public List<RestHandler> getRestHandlers(
         final Settings settings,
diff --git a/libs/entitlement/qa/entitlement-denied-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementDeniedNonModularPlugin.java b/libs/entitlement/qa/entitlement-denied-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementDeniedNonModularPlugin.java
index 0f908d84260fb..7ca89c735a602 100644
--- a/libs/entitlement/qa/entitlement-denied-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementDeniedNonModularPlugin.java
+++ b/libs/entitlement/qa/entitlement-denied-nonmodular/src/main/java/org/elasticsearch/entitlement/qa/nonmodular/EntitlementDeniedNonModularPlugin.java
@@ -27,7 +27,6 @@
 import java.util.function.Supplier;
 
 public class EntitlementDeniedNonModularPlugin extends Plugin implements ActionPlugin {
-
     @Override
     public List<RestHandler> getRestHandlers(
         final Settings settings,
diff --git a/libs/entitlement/qa/entitlement-denied/src/main/java/org/elasticsearch/entitlement/qa/EntitlementDeniedPlugin.java b/libs/entitlement/qa/entitlement-denied/src/main/java/org/elasticsearch/entitlement/qa/EntitlementDeniedPlugin.java
index 0ed27e2e576e7..2a2fd35d47cf3 100644
--- a/libs/entitlement/qa/entitlement-denied/src/main/java/org/elasticsearch/entitlement/qa/EntitlementDeniedPlugin.java
+++ b/libs/entitlement/qa/entitlement-denied/src/main/java/org/elasticsearch/entitlement/qa/EntitlementDeniedPlugin.java
@@ -27,7 +27,6 @@
 import java.util.function.Supplier;
 
 public class EntitlementDeniedPlugin extends Plugin implements ActionPlugin {
-
     @Override
     public List<RestHandler> getRestHandlers(
         final Settings settings,
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java
index a5ca0543ad15a..75365fbb74d65 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java
@@ -14,6 +14,7 @@
 
 import java.net.URL;
 import java.net.URLStreamHandlerFactory;
+import java.util.List;
 
 /**
  * Implementation of the {@link EntitlementChecker} interface, providing additional
@@ -67,4 +68,14 @@ public ElasticsearchEntitlementChecker(PolicyManager policyManager) {
     ) {
         policyManager.checkCreateClassLoader(callerClass);
     }
+
+    @Override
+    public void check$$start(Class<?> callerClass, ProcessBuilder processBuilder, ProcessBuilder.Redirect[] redirects) {
+        policyManager.checkStartProcess(callerClass);
+    }
+
+    @Override
+    public void check$java_lang_ProcessBuilder$startPipeline(Class<?> callerClass, List<ProcessBuilder> builders) {
+        policyManager.checkStartProcess(callerClass);
+    }
 }
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
index 74ba986041dac..e06f7768eb8be 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
@@ -105,6 +105,26 @@ private static Map<String, List<Entitlement>> buildScopeEntitlementsMap(Policy p
         return policy.scopes.stream().collect(Collectors.toUnmodifiableMap(scope -> scope.name, scope -> scope.entitlements));
     }
 
+    public void checkStartProcess(Class<?> callerClass) {
+        neverEntitled(callerClass, "start process");
+    }
+
+    private void neverEntitled(Class<?> callerClass, String operationDescription) {
+        var requestingModule = requestingModule(callerClass);
+        if (isTriviallyAllowed(requestingModule)) {
+            return;
+        }
+
+        throw new NotEntitledException(
+            Strings.format(
+                "Not entitled: caller [%s], module [%s], operation [%s]",
+                callerClass,
+                requestingModule.getName(),
+                operationDescription
+            )
+        );
+    }
+
     public void checkExitVM(Class<?> callerClass) {
         checkEntitlementPresent(callerClass, ExitVMEntitlement.class);
     }

From c98ca63b460ac6f546ee1c151d7bda3dbd641701 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christoph=20B=C3=BCscher?= <christophbuescher@posteo.de>
Date: Thu, 19 Dec 2024 00:09:37 +0100
Subject: [PATCH 108/119] Revert 7.x related code from analysis common
 (#118972)

This reverts #113009 and re-introduces v7 compatibility logic and previous v7 tests
since we now support v7 indices as read-only on v9.
---
 .../analysis/common/CommonAnalysisPlugin.java | 131 +++++++-
 .../common/CommonAnalysisPluginTests.java     | 292 ++++++++++++++++++
 .../common/EdgeNGramTokenizerTests.java       |   3 +-
 3 files changed, 419 insertions(+), 7 deletions(-)
 create mode 100644 modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
index a97154fd4d1ff..c980aaba71444 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java
@@ -101,7 +101,12 @@
 import org.apache.lucene.analysis.tr.TurkishAnalyzer;
 import org.apache.lucene.analysis.util.ElisionFilter;
 import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.common.logging.DeprecationCategory;
+import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.regex.Regex;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.analysis.AnalyzerProvider;
 import org.elasticsearch.index.analysis.CharFilterFactory;
@@ -134,6 +139,8 @@
 
 public class CommonAnalysisPlugin extends Plugin implements AnalysisPlugin, ScriptPlugin {
 
+    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(CommonAnalysisPlugin.class);
+
     private final SetOnce<ScriptService> scriptServiceHolder = new SetOnce<>();
     private final SetOnce<SynonymsManagementAPIService> synonymsManagementServiceHolder = new SetOnce<>();
 
@@ -224,6 +231,28 @@ public Map<String, AnalysisProvider<TokenFilterFactory>> getTokenFilters() {
         filters.put("dictionary_decompounder", requiresAnalysisSettings(DictionaryCompoundWordTokenFilterFactory::new));
         filters.put("dutch_stem", DutchStemTokenFilterFactory::new);
         filters.put("edge_ngram", EdgeNGramTokenFilterFactory::new);
+        filters.put("edgeNGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            return new EdgeNGramTokenFilterFactory(indexSettings, environment, name, settings) {
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    if (indexSettings.getIndexVersionCreated().onOrAfter(IndexVersions.V_8_0_0)) {
+                        throw new IllegalArgumentException(
+                            "The [edgeNGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                                + "Please change the filter name to [edge_ngram] instead."
+                        );
+                    } else {
+                        deprecationLogger.warn(
+                            DeprecationCategory.ANALYSIS,
+                            "edgeNGram_deprecation",
+                            "The [edgeNGram] token filter name is deprecated and will be removed in a future version. "
+                                + "Please change the filter name to [edge_ngram] instead."
+                        );
+                    }
+                    return super.create(tokenStream);
+                }
+
+            };
+        });
         filters.put("elision", requiresAnalysisSettings(ElisionTokenFilterFactory::new));
         filters.put("fingerprint", FingerprintTokenFilterFactory::new);
         filters.put("flatten_graph", FlattenGraphTokenFilterFactory::new);
@@ -243,6 +272,28 @@ public Map<String, AnalysisProvider<TokenFilterFactory>> getTokenFilters() {
         filters.put("min_hash", MinHashTokenFilterFactory::new);
         filters.put("multiplexer", MultiplexerTokenFilterFactory::new);
         filters.put("ngram", NGramTokenFilterFactory::new);
+        filters.put("nGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            return new NGramTokenFilterFactory(indexSettings, environment, name, settings) {
+                @Override
+                public TokenStream create(TokenStream tokenStream) {
+                    if (indexSettings.getIndexVersionCreated().onOrAfter(IndexVersions.V_8_0_0)) {
+                        throw new IllegalArgumentException(
+                            "The [nGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                                + "Please change the filter name to [ngram] instead."
+                        );
+                    } else {
+                        deprecationLogger.warn(
+                            DeprecationCategory.ANALYSIS,
+                            "nGram_deprecation",
+                            "The [nGram] token filter name is deprecated and will be removed in a future version. "
+                                + "Please change the filter name to [ngram] instead."
+                        );
+                    }
+                    return super.create(tokenStream);
+                }
+
+            };
+        });
         filters.put("pattern_capture", requiresAnalysisSettings(PatternCaptureGroupTokenFilterFactory::new));
         filters.put("pattern_replace", requiresAnalysisSettings(PatternReplaceTokenFilterFactory::new));
         filters.put("persian_normalization", PersianNormalizationFilterFactory::new);
@@ -294,7 +345,39 @@ public Map<String, AnalysisProvider<TokenizerFactory>> getTokenizers() {
         tokenizers.put("simple_pattern", SimplePatternTokenizerFactory::new);
         tokenizers.put("simple_pattern_split", SimplePatternSplitTokenizerFactory::new);
         tokenizers.put("thai", ThaiTokenizerFactory::new);
+        tokenizers.put("nGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            if (indexSettings.getIndexVersionCreated().onOrAfter(IndexVersions.V_8_0_0)) {
+                throw new IllegalArgumentException(
+                    "The [nGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [ngram] for indices created in versions 8 or higher instead."
+                );
+            } else if (indexSettings.getIndexVersionCreated().onOrAfter(IndexVersions.V_7_6_0)) {
+                deprecationLogger.warn(
+                    DeprecationCategory.ANALYSIS,
+                    "nGram_tokenizer_deprecation",
+                    "The [nGram] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to [ngram] instead."
+                );
+            }
+            return new NGramTokenizerFactory(indexSettings, environment, name, settings);
+        });
         tokenizers.put("ngram", NGramTokenizerFactory::new);
+        tokenizers.put("edgeNGram", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {
+            if (indexSettings.getIndexVersionCreated().onOrAfter(IndexVersions.V_8_0_0)) {
+                throw new IllegalArgumentException(
+                    "The [edgeNGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [edge_nGram] for indices created in versions 8 or higher instead."
+                );
+            } else if (indexSettings.getIndexVersionCreated().onOrAfter(IndexVersions.V_7_6_0)) {
+                deprecationLogger.warn(
+                    DeprecationCategory.ANALYSIS,
+                    "edgeNGram_tokenizer_deprecation",
+                    "The [edgeNGram] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to [edge_ngram] instead."
+                );
+            }
+            return new EdgeNGramTokenizerFactory(indexSettings, environment, name, settings);
+        });
         tokenizers.put("edge_ngram", EdgeNGramTokenizerFactory::new);
         tokenizers.put("char_group", CharGroupTokenizerFactory::new);
         tokenizers.put("classic", ClassicTokenizerFactory::new);
@@ -505,17 +588,53 @@ public List<PreConfiguredTokenizer> getPreConfiguredTokenizers() {
         tokenizers.add(PreConfiguredTokenizer.singleton("letter", LetterTokenizer::new));
         tokenizers.add(PreConfiguredTokenizer.singleton("whitespace", WhitespaceTokenizer::new));
         tokenizers.add(PreConfiguredTokenizer.singleton("ngram", NGramTokenizer::new));
-        tokenizers.add(
-            PreConfiguredTokenizer.indexVersion(
-                "edge_ngram",
-                (version) -> new EdgeNGramTokenizer(NGramTokenizer.DEFAULT_MIN_NGRAM_SIZE, NGramTokenizer.DEFAULT_MAX_NGRAM_SIZE)
-            )
-        );
+        tokenizers.add(PreConfiguredTokenizer.indexVersion("edge_ngram", (version) -> {
+            if (version.onOrAfter(IndexVersions.V_7_3_0)) {
+                return new EdgeNGramTokenizer(NGramTokenizer.DEFAULT_MIN_NGRAM_SIZE, NGramTokenizer.DEFAULT_MAX_NGRAM_SIZE);
+            }
+            return new EdgeNGramTokenizer(EdgeNGramTokenizer.DEFAULT_MIN_GRAM_SIZE, EdgeNGramTokenizer.DEFAULT_MAX_GRAM_SIZE);
+        }));
         tokenizers.add(PreConfiguredTokenizer.singleton("pattern", () -> new PatternTokenizer(Regex.compile("\\W+", null), -1)));
         tokenizers.add(PreConfiguredTokenizer.singleton("thai", ThaiTokenizer::new));
         // TODO deprecate and remove in API
         // This is already broken with normalization, so backwards compat isn't necessary?
         tokenizers.add(PreConfiguredTokenizer.singleton("lowercase", XLowerCaseTokenizer::new));
+
+        tokenizers.add(PreConfiguredTokenizer.indexVersion("nGram", (version) -> {
+            if (version.onOrAfter(IndexVersions.V_8_0_0)) {
+                throw new IllegalArgumentException(
+                    "The [nGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [ngram] for indices created in versions 8 or higher instead."
+                );
+            } else if (version.onOrAfter(IndexVersions.V_7_6_0)) {
+                deprecationLogger.warn(
+                    DeprecationCategory.ANALYSIS,
+                    "nGram_tokenizer_deprecation",
+                    "The [nGram] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to [ngram] instead."
+                );
+            }
+            return new NGramTokenizer();
+        }));
+        tokenizers.add(PreConfiguredTokenizer.indexVersion("edgeNGram", (version) -> {
+            if (version.onOrAfter(IndexVersions.V_8_0_0)) {
+                throw new IllegalArgumentException(
+                    "The [edgeNGram] tokenizer name was deprecated in 7.6. "
+                        + "Please use the tokenizer name to [edge_ngram] for indices created in versions 8 or higher instead."
+                );
+            } else if (version.onOrAfter(IndexVersions.V_7_6_0)) {
+                deprecationLogger.warn(
+                    DeprecationCategory.ANALYSIS,
+                    "edgeNGram_tokenizer_deprecation",
+                    "The [edgeNGram] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to [edge_ngram] instead."
+                );
+            }
+            if (version.onOrAfter(IndexVersions.V_7_3_0)) {
+                return new EdgeNGramTokenizer(NGramTokenizer.DEFAULT_MIN_NGRAM_SIZE, NGramTokenizer.DEFAULT_MAX_NGRAM_SIZE);
+            }
+            return new EdgeNGramTokenizer(EdgeNGramTokenizer.DEFAULT_MIN_GRAM_SIZE, EdgeNGramTokenizer.DEFAULT_MAX_GRAM_SIZE);
+        }));
         tokenizers.add(PreConfiguredTokenizer.singleton("PathHierarchy", PathHierarchyTokenizer::new));
 
         return tokenizers;
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
new file mode 100644
index 0000000000000..9972d58b2dcc1
--- /dev/null
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/CommonAnalysisPluginTests.java
@@ -0,0 +1,292 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.analysis.common;
+
+import org.apache.lucene.analysis.Tokenizer;
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.env.Environment;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.IndexVersions;
+import org.elasticsearch.index.analysis.TokenizerFactory;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.IndexSettingsModule;
+import org.elasticsearch.test.index.IndexVersionUtils;
+
+import java.io.IOException;
+import java.util.Map;
+
+public class CommonAnalysisPluginTests extends ESTestCase {
+
+    /**
+     * Check that the deprecated "nGram" filter throws exception for indices created since 7.0.0 and
+     * logs a warning for earlier indices when the filter is used as a custom filter
+     */
+    public void testNGramFilterInCustomAnalyzerDeprecationError() throws IOException {
+        final Settings settings = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(
+                IndexMetadata.SETTING_VERSION_CREATED,
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_0_0, IndexVersion.current())
+            )
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+            .put("index.analysis.filter.my_ngram.type", "nGram")
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            IllegalArgumentException ex = expectThrows(
+                IllegalArgumentException.class,
+                () -> createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin)
+            );
+            assertEquals(
+                "The [nGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                    + "Please change the filter name to [ngram] instead.",
+                ex.getMessage()
+            );
+        }
+
+        final Settings settingsPre7 = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(
+                IndexMetadata.SETTING_VERSION_CREATED,
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_7_0_0, IndexVersions.V_7_6_0)
+            )
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+            .put("index.analysis.filter.my_ngram.type", "nGram")
+            .build();
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7), settingsPre7, commonAnalysisPlugin);
+            assertWarnings(
+                "The [nGram] token filter name is deprecated and will be removed in a future version. "
+                    + "Please change the filter name to [ngram] instead."
+            );
+        }
+    }
+
+    /**
+     * Check that the deprecated "edgeNGram" filter throws exception for indices created since 7.0.0 and
+     * logs a warning for earlier indices when the filter is used as a custom filter
+     */
+    public void testEdgeNGramFilterInCustomAnalyzerDeprecationError() throws IOException {
+        final Settings settings = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(
+                IndexMetadata.SETTING_VERSION_CREATED,
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_0_0, IndexVersion.current())
+            )
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+            .put("index.analysis.filter.my_ngram.type", "edgeNGram")
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            IllegalArgumentException ex = expectThrows(
+                IllegalArgumentException.class,
+                () -> createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin)
+            );
+            assertEquals(
+                "The [edgeNGram] token filter name was deprecated in 6.4 and cannot be used in new indices. "
+                    + "Please change the filter name to [edge_ngram] instead.",
+                ex.getMessage()
+            );
+        }
+
+        final Settings settingsPre7 = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(
+                IndexMetadata.SETTING_VERSION_CREATED,
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_7_0_0, IndexVersions.V_7_6_0)
+            )
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "standard")
+            .putList("index.analysis.analyzer.custom_analyzer.filter", "my_ngram")
+            .put("index.analysis.filter.my_ngram.type", "edgeNGram")
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settingsPre7), settingsPre7, commonAnalysisPlugin);
+            assertWarnings(
+                "The [edgeNGram] token filter name is deprecated and will be removed in a future version. "
+                    + "Please change the filter name to [edge_ngram] instead."
+            );
+        }
+    }
+
+    /**
+     * Check that we log a deprecation warning for "nGram" and "edgeNGram" tokenizer names with 7.6 and
+     * disallow usages for indices created after 8.0
+     */
+    public void testNGramTokenizerDeprecation() throws IOException {
+        // tests for prebuilt tokenizer
+        doTestPrebuiltTokenizerDeprecation(
+            "nGram",
+            "ngram",
+            IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_7_0_0, IndexVersions.V_7_5_2),
+            false
+        );
+        doTestPrebuiltTokenizerDeprecation(
+            "edgeNGram",
+            "edge_ngram",
+            IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_7_0_0, IndexVersions.V_7_5_2),
+            false
+        );
+        doTestPrebuiltTokenizerDeprecation(
+            "nGram",
+            "ngram",
+            IndexVersionUtils.randomVersionBetween(
+                random(),
+                IndexVersions.V_7_6_0,
+                IndexVersion.max(IndexVersions.V_7_6_0, IndexVersionUtils.getPreviousVersion(IndexVersions.V_8_0_0))
+            ),
+            true
+        );
+        doTestPrebuiltTokenizerDeprecation(
+            "edgeNGram",
+            "edge_ngram",
+            IndexVersionUtils.randomVersionBetween(
+                random(),
+                IndexVersions.V_7_6_0,
+                IndexVersion.max(IndexVersions.V_7_6_0, IndexVersionUtils.getPreviousVersion(IndexVersions.V_8_0_0))
+            ),
+            true
+        );
+        expectThrows(
+            IllegalArgumentException.class,
+            () -> doTestPrebuiltTokenizerDeprecation(
+                "nGram",
+                "ngram",
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_0_0, IndexVersion.current()),
+                true
+            )
+        );
+        expectThrows(
+            IllegalArgumentException.class,
+            () -> doTestPrebuiltTokenizerDeprecation(
+                "edgeNGram",
+                "edge_ngram",
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_0_0, IndexVersion.current()),
+                true
+            )
+        );
+
+        // same batch of tests for custom tokenizer definition in the settings
+        doTestCustomTokenizerDeprecation(
+            "nGram",
+            "ngram",
+            IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_7_0_0, IndexVersions.V_7_5_2),
+            false
+        );
+        doTestCustomTokenizerDeprecation(
+            "edgeNGram",
+            "edge_ngram",
+            IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_7_0_0, IndexVersions.V_7_5_2),
+            false
+        );
+        doTestCustomTokenizerDeprecation(
+            "nGram",
+            "ngram",
+            IndexVersionUtils.randomVersionBetween(
+                random(),
+                IndexVersions.V_7_6_0,
+                IndexVersion.max(IndexVersions.V_7_6_0, IndexVersionUtils.getPreviousVersion(IndexVersions.V_8_0_0))
+            ),
+            true
+        );
+        doTestCustomTokenizerDeprecation(
+            "edgeNGram",
+            "edge_ngram",
+            IndexVersionUtils.randomVersionBetween(
+                random(),
+                IndexVersions.V_7_6_0,
+                IndexVersion.max(IndexVersions.V_7_6_0, IndexVersionUtils.getPreviousVersion(IndexVersions.V_8_0_0))
+            ),
+            true
+        );
+        expectThrows(
+            IllegalArgumentException.class,
+            () -> doTestCustomTokenizerDeprecation(
+                "nGram",
+                "ngram",
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_0_0, IndexVersion.current()),
+                true
+            )
+        );
+        expectThrows(
+            IllegalArgumentException.class,
+            () -> doTestCustomTokenizerDeprecation(
+                "edgeNGram",
+                "edge_ngram",
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.V_8_0_0, IndexVersion.current()),
+                true
+            )
+        );
+    }
+
+    public void doTestPrebuiltTokenizerDeprecation(String deprecatedName, String replacement, IndexVersion version, boolean expectWarning)
+        throws IOException {
+        final Settings settings = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(IndexMetadata.SETTING_VERSION_CREATED, version)
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            Map<String, TokenizerFactory> tokenizers = createTestAnalysis(
+                IndexSettingsModule.newIndexSettings("index", settings),
+                settings,
+                commonAnalysisPlugin
+            ).tokenizer;
+            TokenizerFactory tokenizerFactory = tokenizers.get(deprecatedName);
+
+            Tokenizer tokenizer = tokenizerFactory.create();
+            assertNotNull(tokenizer);
+            if (expectWarning) {
+                assertWarnings(
+                    "The ["
+                        + deprecatedName
+                        + "] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to ["
+                        + replacement
+                        + "] instead."
+                );
+            }
+        }
+    }
+
+    public void doTestCustomTokenizerDeprecation(String deprecatedName, String replacement, IndexVersion version, boolean expectWarning)
+        throws IOException {
+        final Settings settings = Settings.builder()
+            .put(Environment.PATH_HOME_SETTING.getKey(), createTempDir())
+            .put(IndexMetadata.SETTING_VERSION_CREATED, version)
+            .put("index.analysis.analyzer.custom_analyzer.type", "custom")
+            .put("index.analysis.analyzer.custom_analyzer.tokenizer", "my_tokenizer")
+            .put("index.analysis.tokenizer.my_tokenizer.type", deprecatedName)
+            .build();
+
+        try (CommonAnalysisPlugin commonAnalysisPlugin = new CommonAnalysisPlugin()) {
+            createTestAnalysis(IndexSettingsModule.newIndexSettings("index", settings), settings, commonAnalysisPlugin);
+
+            if (expectWarning) {
+                assertWarnings(
+                    "The ["
+                        + deprecatedName
+                        + "] tokenizer name is deprecated and will be removed in a future version. "
+                        + "Please change the tokenizer name to ["
+                        + replacement
+                        + "] instead."
+                );
+            }
+        }
+    }
+}
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java
index 11d1653439e59..c998e927e25a8 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/EdgeNGramTokenizerTests.java
@@ -34,7 +34,7 @@
 
 public class EdgeNGramTokenizerTests extends ESTokenStreamTestCase {
 
-    private static IndexAnalyzers buildAnalyzers(IndexVersion version, String tokenizer) throws IOException {
+    private IndexAnalyzers buildAnalyzers(IndexVersion version, String tokenizer) throws IOException {
         Settings settings = Settings.builder().put(Environment.PATH_HOME_SETTING.getKey(), createTempDir().toString()).build();
         Settings indexSettings = Settings.builder()
             .put(IndexMetadata.SETTING_VERSION_CREATED, version)
@@ -54,6 +54,7 @@ public void testPreConfiguredTokenizer() throws IOException {
             assertNotNull(analyzer);
             assertAnalyzesTo(analyzer, "test", new String[] { "t", "te" });
         }
+
     }
 
     public void testCustomTokenChars() throws IOException {

From 547c7800e478ae69900c42d955262da5f4350a60 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@iernst.net>
Date: Wed, 18 Dec 2024 15:10:29 -0800
Subject: [PATCH 109/119] Improve error message when whitelist resource file is
 not found (#119012)

This commit replaces a NullPointerException that occurs if a whitelist
resource is not found with a customized message. Additionally it
augments the message with specific actions, especially in the case the
owning class is modularized which requies additional work.
---
 .../painless/spi/WhitelistLoader.java         | 32 ++++++++++-
 .../painless/WhitelistLoaderTests.java        | 57 +++++++++++++++++++
 .../bootstrap/test-framework.policy           |  2 +
 .../org/elasticsearch/test/jar/JarUtils.java  | 33 +++++++++++
 4 files changed, 121 insertions(+), 3 deletions(-)

diff --git a/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/WhitelistLoader.java b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/WhitelistLoader.java
index 2e7f0de027de7..37bff97a07ae2 100644
--- a/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/WhitelistLoader.java
+++ b/modules/lang-painless/spi/src/main/java/org/elasticsearch/painless/spi/WhitelistLoader.java
@@ -9,8 +9,10 @@
 
 package org.elasticsearch.painless.spi;
 
+import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.painless.spi.annotation.WhitelistAnnotationParser;
 
+import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.LineNumberReader;
 import java.lang.reflect.Constructor;
@@ -140,7 +142,7 @@ public static Whitelist loadFromResourceFiles(Class<?> resource, String... filep
      * }
      * }
      */
-    public static Whitelist loadFromResourceFiles(Class<?> resource, Map<String, WhitelistAnnotationParser> parsers, String... filepaths) {
+    public static Whitelist loadFromResourceFiles(Class<?> owner, Map<String, WhitelistAnnotationParser> parsers, String... filepaths) {
         List<WhitelistClass> whitelistClasses = new ArrayList<>();
         List<WhitelistMethod> whitelistStatics = new ArrayList<>();
         List<WhitelistClassBinding> whitelistClassBindings = new ArrayList<>();
@@ -153,7 +155,7 @@ public static Whitelist loadFromResourceFiles(Class<?> resource, Map<String, Whi
 
             try (
                 LineNumberReader reader = new LineNumberReader(
-                    new InputStreamReader(resource.getResourceAsStream(filepath), StandardCharsets.UTF_8)
+                    new InputStreamReader(getResourceAsStream(owner, filepath), StandardCharsets.UTF_8)
                 )
             ) {
 
@@ -483,16 +485,40 @@ public static Whitelist loadFromResourceFiles(Class<?> resource, Map<String, Whi
                 if (javaClassName != null) {
                     throw new IllegalArgumentException("invalid definition: expected closing bracket");
                 }
+            } catch (ResourceNotFoundException e) {
+                throw e; // rethrow
             } catch (Exception exception) {
                 throw new RuntimeException("error in [" + filepath + "] at line [" + number + "]", exception);
             }
         }
 
-        ClassLoader loader = AccessController.doPrivileged((PrivilegedAction<ClassLoader>) resource::getClassLoader);
+        ClassLoader loader = AccessController.doPrivileged((PrivilegedAction<ClassLoader>) owner::getClassLoader);
 
         return new Whitelist(loader, whitelistClasses, whitelistStatics, whitelistClassBindings, Collections.emptyList());
     }
 
+    private static InputStream getResourceAsStream(Class<?> owner, String name) {
+        InputStream stream = owner.getResourceAsStream(name);
+        if (stream == null) {
+            String msg = "Whitelist file ["
+                + owner.getPackageName().replace(".", "/")
+                + "/"
+                + name
+                + "] not found from owning class ["
+                + owner.getName()
+                + "].";
+            if (owner.getModule().isNamed()) {
+                msg += " Check that the file exists and the package ["
+                    + owner.getPackageName()
+                    + "] is opened "
+                    + "to module "
+                    + WhitelistLoader.class.getModule().getName();
+            }
+            throw new ResourceNotFoundException(msg);
+        }
+        return stream;
+    }
+
     private static List<Object> parseWhitelistAnnotations(Map<String, WhitelistAnnotationParser> parsers, String line) {
 
         List<Object> annotations;
diff --git a/modules/lang-painless/spi/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java b/modules/lang-painless/spi/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java
index e62d0b438b098..b46bc118e0913 100644
--- a/modules/lang-painless/spi/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java
+++ b/modules/lang-painless/spi/src/test/java/org/elasticsearch/painless/WhitelistLoaderTests.java
@@ -9,6 +9,7 @@
 
 package org.elasticsearch.painless;
 
+import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.painless.spi.Whitelist;
 import org.elasticsearch.painless.spi.WhitelistClass;
 import org.elasticsearch.painless.spi.WhitelistLoader;
@@ -17,10 +18,18 @@
 import org.elasticsearch.painless.spi.annotation.NoImportAnnotation;
 import org.elasticsearch.painless.spi.annotation.WhitelistAnnotationParser;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.compiler.InMemoryJavaCompiler;
+import org.elasticsearch.test.jar.JarUtils;
 
+import java.lang.ModuleLayer.Controller;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Path;
 import java.util.HashMap;
 import java.util.Map;
 
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.notNullValue;
+
 public class WhitelistLoaderTests extends ESTestCase {
 
     public void testUnknownAnnotations() {
@@ -96,4 +105,52 @@ public void testAnnotations() {
 
         assertEquals(3, count);
     }
+
+    public void testMissingWhitelistResource() {
+        var e = expectThrows(ResourceNotFoundException.class, () -> WhitelistLoader.loadFromResourceFiles(Whitelist.class, "missing.txt"));
+        assertThat(
+            e.getMessage(),
+            equalTo(
+                "Whitelist file [org/elasticsearch/painless/spi/missing.txt] not found"
+                    + " from owning class [org.elasticsearch.painless.spi.Whitelist]."
+            )
+        );
+    }
+
+    public void testMissingWhitelistResourceInModule() throws Exception {
+        Map<String, CharSequence> sources = new HashMap<>();
+        sources.put("module-info", "module m {}");
+        sources.put("p.TestOwner", "package p; public class TestOwner { }");
+        var classToBytes = InMemoryJavaCompiler.compile(sources);
+
+        Path dir = createTempDir(getTestName());
+        Path jar = dir.resolve("m.jar");
+        Map<String, byte[]> jarEntries = new HashMap<>();
+        jarEntries.put("module-info.class", classToBytes.get("module-info"));
+        jarEntries.put("p/TestOwner.class", classToBytes.get("p.TestOwner"));
+        jarEntries.put("p/resource.txt", "# test resource".getBytes(StandardCharsets.UTF_8));
+        JarUtils.createJarWithEntries(jar, jarEntries);
+
+        try (var loader = JarUtils.loadJar(jar)) {
+            Controller controller = JarUtils.loadModule(jar, loader.classloader(), "m");
+            Module module = controller.layer().findModule("m").orElseThrow();
+
+            Class<?> ownerClass = module.getClassLoader().loadClass("p.TestOwner");
+
+            // first check we get a nice error message when accessing the resource
+            var e = expectThrows(ResourceNotFoundException.class, () -> WhitelistLoader.loadFromResourceFiles(ownerClass, "resource.txt"));
+            assertThat(
+                e.getMessage(),
+                equalTo(
+                    "Whitelist file [p/resource.txt] not found from owning class [p.TestOwner]."
+                        + " Check that the file exists and the package [p] is opened to module null"
+                )
+            );
+
+            // now check we can actually read it once the package is opened to us
+            controller.addOpens(module, "p", WhitelistLoader.class.getModule());
+            var whitelist = WhitelistLoader.loadFromResourceFiles(ownerClass, "resource.txt");
+            assertThat(whitelist, notNullValue());
+        }
+    }
 }
diff --git a/server/src/main/resources/org/elasticsearch/bootstrap/test-framework.policy b/server/src/main/resources/org/elasticsearch/bootstrap/test-framework.policy
index 040a7a6205f9c..462fab651c211 100644
--- a/server/src/main/resources/org/elasticsearch/bootstrap/test-framework.policy
+++ b/server/src/main/resources/org/elasticsearch/bootstrap/test-framework.policy
@@ -88,6 +88,7 @@ grant codeBase "${codebase.elasticsearch}" {
 // this is the test-framework, but the jar is horribly named
 grant codeBase "${codebase.framework}" {
   permission java.lang.RuntimePermission "setSecurityManager";
+  permission java.lang.RuntimePermission "createClassLoader";
 };
 
 grant codeBase "${codebase.elasticsearch-rest-client}" {
@@ -129,4 +130,5 @@ grant {
   permission java.nio.file.LinkPermission "symbolic";
   // needed for keystore tests
   permission java.lang.RuntimePermission "accessUserInformation";
+  permission java.lang.RuntimePermission "getClassLoader";
 };
diff --git a/test/framework/src/main/java/org/elasticsearch/test/jar/JarUtils.java b/test/framework/src/main/java/org/elasticsearch/test/jar/JarUtils.java
index e5bdd66e949f7..0da392cb7fb01 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/jar/JarUtils.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/jar/JarUtils.java
@@ -9,13 +9,24 @@
 
 package org.elasticsearch.test.jar;
 
+import org.elasticsearch.test.PrivilegedOperations.ClosableURLClassLoader;
+
 import java.io.ByteArrayInputStream;
 import java.io.IOException;
 import java.io.OutputStream;
+import java.lang.module.Configuration;
+import java.lang.module.ModuleFinder;
+import java.net.MalformedURLException;
+import java.net.URL;
+import java.net.URLClassLoader;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.StandardOpenOption;
+import java.security.AccessController;
+import java.security.PrivilegedAction;
+import java.util.List;
 import java.util.Map;
+import java.util.Set;
 import java.util.jar.JarEntry;
 import java.util.jar.JarOutputStream;
 import java.util.jar.Manifest;
@@ -85,6 +96,28 @@ public static void createJarWithEntriesUTF(Path jarfile, Map<String, String> ent
         createJarWithEntries(jarfile, map);
     }
 
+    /**
+     * Creates a class loader for the given jar file.
+     * @param path Path to the jar file to load
+     * @return A URLClassLoader that will load classes from the jar. It should be closed when no longer needed.
+     */
+    public static ClosableURLClassLoader loadJar(Path path) {
+        try {
+            URL[] urls = new URL[] { path.toUri().toURL() };
+            return new ClosableURLClassLoader(URLClassLoader.newInstance(urls, JarUtils.class.getClassLoader()));
+        } catch (MalformedURLException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    public static ModuleLayer.Controller loadModule(Path path, ClassLoader loader, String name) {
+        var finder = ModuleFinder.of(path.getParent());
+        var cf = Configuration.resolveAndBind(finder, List.of(ModuleLayer.boot().configuration()), ModuleFinder.of(), Set.of(name));
+        return AccessController.doPrivileged(
+            (PrivilegedAction<ModuleLayer.Controller>) () -> ModuleLayer.defineModulesWithOneLoader(cf, List.of(ModuleLayer.boot()), loader)
+        );
+    }
+
     @FunctionalInterface
     interface UncheckedIOFunction<T, R> {
         R apply(T t) throws IOException;

From 93aee0f1c6ccec241a6dce229b96e40ff36c9358 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 16:43:15 +1100
Subject: [PATCH 110/119] Mute
 org.elasticsearch.xpack.security.authc.ldap.ActiveDirectoryRunAsIT
 org.elasticsearch.xpack.security.authc.ldap.ActiveDirectoryRunAsIT #115727

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 35a9b31685794..12f1fc510a332 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -299,6 +299,8 @@ tests:
 - class: org.elasticsearch.backwards.MixedClusterClientYamlTestSuiteIT
   method: test {p0=synonyms/90_synonyms_reloading_for_synset/Reload analyzers for specific synonym set}
   issue: https://github.com/elastic/elasticsearch/issues/116777
+- class: org.elasticsearch.xpack.security.authc.ldap.ActiveDirectoryRunAsIT
+  issue: https://github.com/elastic/elasticsearch/issues/115727
 
 # Examples:
 #

From d103036db1533b60ba217b4ab20d369e6a3be8d6 Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Thu, 19 Dec 2024 09:53:18 +0100
Subject: [PATCH 111/119] Broaden index versions tested in some mappings tests
 (#119026)

MINIMUM_READONLY_COMPATIBLE is used as a lower bound (N-2) as opposed to
MINIMUM_COMPATIBLE (N-1).
---
 .../org/elasticsearch/index/mapper/MappingParserTests.java | 6 +++++-
 .../java/org/elasticsearch/indices/IndicesModuleTests.java | 7 ++-----
 .../xpack/spatial/index/mapper/ShapeFieldMapperTests.java  | 7 +++++--
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/index/mapper/MappingParserTests.java b/server/src/test/java/org/elasticsearch/index/mapper/MappingParserTests.java
index e0f58b8922be2..b87ab09c530d6 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/MappingParserTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/MappingParserTests.java
@@ -322,7 +322,11 @@ public void testBlankFieldName() throws Exception {
     }
 
     public void testBlankFieldNameBefore8_6_0() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersions.V_8_5_0);
+        IndexVersion version = IndexVersionUtils.randomVersionBetween(
+            random(),
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
+            IndexVersions.V_8_5_0
+        );
         TransportVersion transportVersion = TransportVersionUtils.randomVersionBetween(
             random(),
             TransportVersions.MINIMUM_COMPATIBLE,
diff --git a/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java b/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java
index ab65d56557ad9..0e333491588a6 100644
--- a/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java
+++ b/server/src/test/java/org/elasticsearch/indices/IndicesModuleTests.java
@@ -9,7 +9,6 @@
 
 package org.elasticsearch.indices;
 
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.index.IndexVersion;
 import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.mapper.DataStreamTimestampFieldMapper;
@@ -98,8 +97,6 @@ public Map<String, MetadataFieldMapper.TypeParser> getMetadataMappers() {
         DataStreamTimestampFieldMapper.NAME,
         FieldNamesFieldMapper.NAME };
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_FOUNDATIONS)
-    @AwaitsFix(bugUrl = "test is referencing 7.x index versions so needs to be updated for 9.0 bump")
     public void testBuiltinMappers() {
         IndicesModule module = new IndicesModule(Collections.emptyList());
         {
@@ -239,14 +236,14 @@ public Map<String, MetadataFieldMapper.TypeParser> getMetadataMappers() {
 
     public void testFieldNamesIsLast() {
         IndicesModule module = new IndicesModule(Collections.emptyList());
-        IndexVersion version = IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         List<String> fieldNames = new ArrayList<>(module.getMapperRegistry().getMetadataMapperParsers(version).keySet());
         assertEquals(FieldNamesFieldMapper.NAME, fieldNames.get(fieldNames.size() - 1));
     }
 
     public void testFieldNamesIsLastWithPlugins() {
         IndicesModule module = new IndicesModule(fakePlugins);
-        IndexVersion version = IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current());
+        IndexVersion version = IndexVersionUtils.randomVersion();
         List<String> fieldNames = new ArrayList<>(module.getMapperRegistry().getMetadataMapperParsers(version).keySet());
         assertEquals(FieldNamesFieldMapper.NAME, fieldNames.get(fieldNames.size() - 1));
     }
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/ShapeFieldMapperTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/ShapeFieldMapperTests.java
index d030a2bbf81ad..5d2624735bebe 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/ShapeFieldMapperTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/ShapeFieldMapperTests.java
@@ -113,8 +113,11 @@ public void testDefaultConfiguration() throws IOException {
     }
 
     public void testDefaultDocValueConfigurationOnPre8_4() throws IOException {
-        // TODO verify which version this test is actually valid for (when PR is actually merged)
-        IndexVersion oldVersion = IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersions.V_8_3_0);
+        IndexVersion oldVersion = IndexVersionUtils.randomVersionBetween(
+            random(),
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
+            IndexVersions.V_8_3_0
+        );
         DocumentMapper defaultMapper = createDocumentMapper(oldVersion, fieldMapping(this::minimalMapping));
         Mapper fieldMapper = defaultMapper.mappers().getMapper(FIELD_NAME);
         assertThat(fieldMapper, instanceOf(fieldMapperClass()));

From f760b40815ab30c1b07f01a72b7a81740a780bf1 Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Thu, 19 Dec 2024 09:54:41 +0100
Subject: [PATCH 112/119] Broaden index versions tested to cover v7 versions
 for some analysis tests (#119024)

This replaces usages of MINIMUM_COMPATIBLE with MINIMUM_READONLY_COMPATIBLE as a
lower bound when randomizing the index version in some tests. This provides more
coverage as it relies on readonly versions as opposed to only those that can be
written to.
---
 .../analysis/common/SynonymsAnalysisTests.java       | 12 ++++++------
 .../analysis/common/UniqueTokenFilterTests.java      |  6 +-----
 .../phonetic/AnalysisPhoneticFactoryTests.java       |  2 +-
 .../index/analysis/PreBuiltAnalyzerTests.java        |  4 ++++
 .../index/similarity/SimilarityServiceTests.java     |  6 +++---
 .../script/VectorScoreScriptUtilsTests.java          |  8 ++++----
 .../script/field/vectors/DenseVectorTests.java       |  6 +++++-
 7 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java
index 4fc6ca96b5f08..af57b8270ff02 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/SynonymsAnalysisTests.java
@@ -118,7 +118,7 @@ public void testSynonymWordDeleteByAnalyzer() throws IOException {
         // Test with an index version where lenient should always be false by default
         IndexVersion randomNonLenientIndexVersion = IndexVersionUtils.randomVersionBetween(
             random(),
-            IndexVersions.MINIMUM_COMPATIBLE,
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
             IndexVersions.INDEX_SORTING_ON_NESTED
         );
         assertIsNotLenient.accept(randomNonLenientIndexVersion, false);
@@ -177,7 +177,7 @@ public void testSynonymWordDeleteByAnalyzerFromFile() throws IOException {
         // Test with an index version where lenient should always be false by default
         IndexVersion randomNonLenientIndexVersion = IndexVersionUtils.randomVersionBetween(
             random(),
-            IndexVersions.MINIMUM_COMPATIBLE,
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
             IndexVersions.INDEX_SORTING_ON_NESTED
         );
         assertIsNotLenient.accept(randomNonLenientIndexVersion, false);
@@ -231,7 +231,7 @@ public void testExpandSynonymWordDeleteByAnalyzer() throws IOException {
         // Test with an index version where lenient should always be false by default
         IndexVersion randomNonLenientIndexVersion = IndexVersionUtils.randomVersionBetween(
             random(),
-            IndexVersions.MINIMUM_COMPATIBLE,
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
             IndexVersions.INDEX_SORTING_ON_NESTED
         );
         assertIsNotLenient.accept(randomNonLenientIndexVersion, false);
@@ -338,7 +338,7 @@ public void testShingleFilters() {
         Settings settings = Settings.builder()
             .put(
                 IndexMetadata.SETTING_VERSION_CREATED,
-                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_READONLY_COMPATIBLE, IndexVersion.current())
             )
             .put("path.home", createTempDir().toString())
             .put("index.analysis.filter.synonyms.type", "synonym")
@@ -392,7 +392,7 @@ public void testPreconfiguredTokenFilters() throws IOException {
         Settings settings = Settings.builder()
             .put(
                 IndexMetadata.SETTING_VERSION_CREATED,
-                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_READONLY_COMPATIBLE, IndexVersion.current())
             )
             .put("path.home", createTempDir().toString())
             .build();
@@ -424,7 +424,7 @@ public void testDisallowedTokenFilters() throws IOException {
         Settings settings = Settings.builder()
             .put(
                 IndexMetadata.SETTING_VERSION_CREATED,
-                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_READONLY_COMPATIBLE, IndexVersion.current())
             )
             .put("path.home", createTempDir().toString())
             .putList("common_words", "a", "b")
diff --git a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/UniqueTokenFilterTests.java b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/UniqueTokenFilterTests.java
index 6bec8dc1ebc62..d30e9d3c68cc9 100644
--- a/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/UniqueTokenFilterTests.java
+++ b/modules/analysis-common/src/test/java/org/elasticsearch/analysis/common/UniqueTokenFilterTests.java
@@ -124,11 +124,7 @@ public void testOldVersionGetXUniqueTokenFilter() throws IOException {
         Settings settings = Settings.builder()
             .put(
                 IndexMetadata.SETTING_VERSION_CREATED,
-                IndexVersionUtils.randomVersionBetween(
-                    random(),
-                    IndexVersions.MINIMUM_COMPATIBLE,
-                    IndexVersionUtils.getPreviousVersion(IndexVersions.UNIQUE_TOKEN_FILTER_POS_FIX)
-                )
+                IndexVersionUtils.randomPreviousCompatibleVersion(random(), IndexVersions.UNIQUE_TOKEN_FILTER_POS_FIX)
             )
             .build();
         IndexSettings idxSettings = IndexSettingsModule.newIndexSettings("index", settings);
diff --git a/plugins/analysis-phonetic/src/test/java/org/elasticsearch/plugin/analysis/phonetic/AnalysisPhoneticFactoryTests.java b/plugins/analysis-phonetic/src/test/java/org/elasticsearch/plugin/analysis/phonetic/AnalysisPhoneticFactoryTests.java
index 483c8ccef1202..e51d1f24a88ad 100644
--- a/plugins/analysis-phonetic/src/test/java/org/elasticsearch/plugin/analysis/phonetic/AnalysisPhoneticFactoryTests.java
+++ b/plugins/analysis-phonetic/src/test/java/org/elasticsearch/plugin/analysis/phonetic/AnalysisPhoneticFactoryTests.java
@@ -44,7 +44,7 @@ public void testDisallowedWithSynonyms() throws IOException {
         Settings settings = Settings.builder()
             .put(
                 IndexMetadata.SETTING_VERSION_CREATED,
-                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())
+                IndexVersionUtils.randomVersionBetween(random(), IndexVersions.MINIMUM_READONLY_COMPATIBLE, IndexVersion.current())
             )
             .put("path.home", createTempDir().toString())
             .build();
diff --git a/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java b/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
index f5b86f422915e..7f3399cb24a15 100644
--- a/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
+++ b/server/src/test/java/org/elasticsearch/index/analysis/PreBuiltAnalyzerTests.java
@@ -55,6 +55,10 @@ public void testThatInstancesAreTheSameAlwaysForKeywordAnalyzer() {
             PreBuiltAnalyzers.KEYWORD.getAnalyzer(IndexVersion.current()),
             is(PreBuiltAnalyzers.KEYWORD.getAnalyzer(IndexVersions.MINIMUM_COMPATIBLE))
         );
+        assertThat(
+            PreBuiltAnalyzers.KEYWORD.getAnalyzer(IndexVersion.current()),
+            is(PreBuiltAnalyzers.KEYWORD.getAnalyzer(IndexVersions.MINIMUM_READONLY_COMPATIBLE))
+        );
     }
 
     public void testThatInstancesAreCachedAndReused() {
diff --git a/server/src/test/java/org/elasticsearch/index/similarity/SimilarityServiceTests.java b/server/src/test/java/org/elasticsearch/index/similarity/SimilarityServiceTests.java
index f6d7b3d1d65f3..ecb942492af53 100644
--- a/server/src/test/java/org/elasticsearch/index/similarity/SimilarityServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/index/similarity/SimilarityServiceTests.java
@@ -74,7 +74,7 @@ public float score(float freq, long norm) {
         };
         IllegalArgumentException e = expectThrows(
             IllegalArgumentException.class,
-            () -> SimilarityService.validateSimilarity(IndexVersions.MINIMUM_COMPATIBLE, negativeScoresSim)
+            () -> SimilarityService.validateSimilarity(IndexVersions.MINIMUM_READONLY_COMPATIBLE, negativeScoresSim)
         );
         assertThat(e.getMessage(), Matchers.containsString("Similarities should not return negative scores"));
 
@@ -99,7 +99,7 @@ public float score(float freq, long norm) {
         };
         e = expectThrows(
             IllegalArgumentException.class,
-            () -> SimilarityService.validateSimilarity(IndexVersions.MINIMUM_COMPATIBLE, decreasingScoresWithFreqSim)
+            () -> SimilarityService.validateSimilarity(IndexVersions.MINIMUM_READONLY_COMPATIBLE, decreasingScoresWithFreqSim)
         );
         assertThat(e.getMessage(), Matchers.containsString("Similarity scores should not decrease when term frequency increases"));
 
@@ -124,7 +124,7 @@ public float score(float freq, long norm) {
         };
         e = expectThrows(
             IllegalArgumentException.class,
-            () -> SimilarityService.validateSimilarity(IndexVersions.MINIMUM_COMPATIBLE, increasingScoresWithNormSim)
+            () -> SimilarityService.validateSimilarity(IndexVersions.MINIMUM_READONLY_COMPATIBLE, increasingScoresWithNormSim)
         );
         assertThat(e.getMessage(), Matchers.containsString("Similarity scores should not increase when norm increases"));
     }
diff --git a/server/src/test/java/org/elasticsearch/script/VectorScoreScriptUtilsTests.java b/server/src/test/java/org/elasticsearch/script/VectorScoreScriptUtilsTests.java
index dcaa64ede9e89..48d09c75cb2d1 100644
--- a/server/src/test/java/org/elasticsearch/script/VectorScoreScriptUtilsTests.java
+++ b/server/src/test/java/org/elasticsearch/script/VectorScoreScriptUtilsTests.java
@@ -51,12 +51,12 @@ public void testFloatVectorClassBindings() throws IOException {
                 BinaryDenseVectorScriptDocValuesTests.wrap(
                     new float[][] { docVector },
                     ElementType.FLOAT,
-                    IndexVersions.MINIMUM_COMPATIBLE
+                    IndexVersions.MINIMUM_READONLY_COMPATIBLE
                 ),
                 "test",
                 ElementType.FLOAT,
                 dims,
-                IndexVersions.MINIMUM_COMPATIBLE
+                IndexVersions.MINIMUM_READONLY_COMPATIBLE
             ),
             new BinaryDenseVectorDocValuesField(
                 BinaryDenseVectorScriptDocValuesTests.wrap(new float[][] { docVector }, ElementType.FLOAT, IndexVersion.current()),
@@ -303,12 +303,12 @@ public void testByteVsFloatSimilarity() throws IOException {
                 BinaryDenseVectorScriptDocValuesTests.wrap(
                     new float[][] { docVector },
                     ElementType.FLOAT,
-                    IndexVersions.MINIMUM_COMPATIBLE
+                    IndexVersions.MINIMUM_READONLY_COMPATIBLE
                 ),
                 "field0",
                 ElementType.FLOAT,
                 dims,
-                IndexVersions.MINIMUM_COMPATIBLE
+                IndexVersions.MINIMUM_READONLY_COMPATIBLE
             ),
             new BinaryDenseVectorDocValuesField(
                 BinaryDenseVectorScriptDocValuesTests.wrap(new float[][] { docVector }, ElementType.FLOAT, IndexVersion.current()),
diff --git a/server/src/test/java/org/elasticsearch/script/field/vectors/DenseVectorTests.java b/server/src/test/java/org/elasticsearch/script/field/vectors/DenseVectorTests.java
index 8a5298777ede0..63d502a248aa8 100644
--- a/server/src/test/java/org/elasticsearch/script/field/vectors/DenseVectorTests.java
+++ b/server/src/test/java/org/elasticsearch/script/field/vectors/DenseVectorTests.java
@@ -69,7 +69,11 @@ public void testFloatVsListQueryVector() {
         assertEquals(knn.cosineSimilarity(arrayQV), knn.cosineSimilarity(listQV), 0.001f);
         assertEquals(knn.cosineSimilarity((Object) listQV), knn.cosineSimilarity((Object) arrayQV), 0.001f);
 
-        for (IndexVersion indexVersion : List.of(IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current())) {
+        for (IndexVersion indexVersion : List.of(
+            IndexVersions.MINIMUM_READONLY_COMPATIBLE,
+            IndexVersions.MINIMUM_COMPATIBLE,
+            IndexVersion.current()
+        )) {
             BytesRef value = BinaryDenseVectorScriptDocValuesTests.mockEncodeDenseVector(docVector, ElementType.FLOAT, indexVersion);
             BinaryDenseVector bdv = new BinaryDenseVector(docVector, value, dims, indexVersion);
 

From 90f038d80237279e89cdb559da7e82b1896af677 Mon Sep 17 00:00:00 2001
From: Ievgen Degtiarenko <ievgen.degtiarenko@elastic.co>
Date: Thu, 19 Dec 2024 09:57:02 +0100
Subject: [PATCH 113/119] group dataset files (#118739)

*.csv files used for creating data and *.csv-spec used to define test scenarios are blending in the resource directory.
This change moves all *.csv files to data/*.csv so that it is easier to distinguish between data and specs.
This allows to have a quicker overview of existing data when starting a new spec.
---
 .../java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java   | 2 +-
 .../qa/testFixtures/src/main/resources/{ => data}/addresses.csv | 0
 .../esql/qa/testFixtures/src/main/resources/{ => data}/ages.csv | 0
 .../src/main/resources/{ => data}/airport_city_boundaries.csv   | 0
 .../qa/testFixtures/src/main/resources/{ => data}/airports.csv  | 0
 .../testFixtures/src/main/resources/{ => data}/airports_mp.csv  | 0
 .../testFixtures/src/main/resources/{ => data}/airports_web.csv | 0
 .../qa/testFixtures/src/main/resources/{ => data}/alerts.csv    | 0
 .../esql/qa/testFixtures/src/main/resources/{ => data}/apps.csv | 0
 .../qa/testFixtures/src/main/resources/{ => data}/books.csv     | 0
 .../src/main/resources/{ => data}/cartesian_multipolygons.csv   | 0
 .../testFixtures/src/main/resources/{ => data}/client_cidr.csv  | 0
 .../qa/testFixtures/src/main/resources/{ => data}/clientips.csv | 0
 .../src/main/resources/{ => data}/countries_bbox.csv            | 0
 .../src/main/resources/{ => data}/countries_bbox_web.csv        | 0
 .../testFixtures/src/main/resources/{ => data}/date_nanos.csv   | 0
 .../qa/testFixtures/src/main/resources/{ => data}/decades.csv   | 0
 .../qa/testFixtures/src/main/resources/{ => data}/distances.csv | 0
 .../qa/testFixtures/src/main/resources/{ => data}/employees.csv | 0
 .../src/main/resources/{ => data}/employees_incompatible.csv    | 0
 .../qa/testFixtures/src/main/resources/{ => data}/heights.csv   | 0
 .../qa/testFixtures/src/main/resources/{ => data}/hosts.csv     | 0
 .../esql/qa/testFixtures/src/main/resources/{ => data}/k8s.csv  | 0
 .../qa/testFixtures/src/main/resources/{ => data}/languages.csv | 0
 .../src/main/resources/{ => data}/languages_non_unique_key.csv  | 0
 .../src/main/resources/{ => data}/message_types.csv             | 0
 .../src/main/resources/{ => data}/missing_ip_sample_data.csv    | 0
 .../src/main/resources/{ => data}/multivalue_geometries.csv     | 0
 .../src/main/resources/{ => data}/multivalue_points.csv         | 0
 .../src/main/resources/{ => data}/mv_sample_data.csv            | 0
 .../testFixtures/src/main/resources/{ => data}/sample_data.csv  | 0
 .../src/main/resources/{ => data}/sample_data_ts_long.csv       | 0
 .../src/main/resources/{ => data}/sample_data_ts_nanos.csv      | 0
 .../src/main/resources/{ => data}/semantic_text.csv             | 0
 .../qa/testFixtures/src/main/resources/{ => data}/ul_logs.csv   | 0
 .../src/test/java/org/elasticsearch/xpack/esql/CsvTests.java    | 2 +-
 36 files changed, 2 insertions(+), 2 deletions(-)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/addresses.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/ages.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/airport_city_boundaries.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/airports.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/airports_mp.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/airports_web.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/alerts.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/apps.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/books.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/cartesian_multipolygons.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/client_cidr.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/clientips.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/countries_bbox.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/countries_bbox_web.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/date_nanos.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/decades.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/distances.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/employees.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/employees_incompatible.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/heights.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/hosts.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/k8s.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/languages.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/languages_non_unique_key.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/message_types.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/missing_ip_sample_data.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/multivalue_geometries.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/multivalue_points.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/mv_sample_data.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/sample_data.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/sample_data_ts_long.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/sample_data_ts_nanos.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/semantic_text.csv (100%)
 rename x-pack/plugin/esql/qa/testFixtures/src/main/resources/{ => data}/ul_logs.csv (100%)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
index 8e81d14b4dfd7..1d2de407219ee 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvTestsDataLoader.java
@@ -359,7 +359,7 @@ private static void load(RestClient client, TestsDataset dataset, Logger logger,
         if (mapping == null) {
             throw new IllegalArgumentException("Cannot find resource " + mappingName);
         }
-        final String dataName = "/" + dataset.dataFileName;
+        final String dataName = "/data/" + dataset.dataFileName;
         URL data = CsvTestsDataLoader.class.getResource(dataName);
         if (data == null) {
             throw new IllegalArgumentException("Cannot find resource " + dataName);
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/addresses.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/addresses.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/addresses.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/addresses.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/ages.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/ages.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/ages.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/ages.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/airport_city_boundaries.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airport_city_boundaries.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/airport_city_boundaries.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airport_city_boundaries.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/airports.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airports.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/airports.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airports.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/airports_mp.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airports_mp.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/airports_mp.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airports_mp.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/airports_web.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airports_web.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/airports_web.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/airports_web.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/alerts.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/alerts.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/alerts.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/alerts.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/apps.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/apps.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/apps.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/apps.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/books.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/books.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/books.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/books.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/cartesian_multipolygons.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/cartesian_multipolygons.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/cartesian_multipolygons.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/cartesian_multipolygons.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/client_cidr.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/client_cidr.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/client_cidr.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/client_cidr.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/clientips.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/clientips.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/clientips.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/clientips.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/countries_bbox.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/countries_bbox.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/countries_bbox.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/countries_bbox.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/countries_bbox_web.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/countries_bbox_web.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/countries_bbox_web.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/countries_bbox_web.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/date_nanos.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/date_nanos.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/decades.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/decades.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/decades.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/decades.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/distances.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/distances.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/distances.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/distances.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/employees.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/employees.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/employees.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/employees.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/employees_incompatible.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/employees_incompatible.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/employees_incompatible.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/employees_incompatible.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/heights.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/heights.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/heights.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/heights.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/hosts.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/hosts.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/hosts.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/hosts.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/k8s.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/k8s.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/k8s.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/k8s.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/languages.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/languages.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages_non_unique_key.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/languages_non_unique_key.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/languages_non_unique_key.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/languages_non_unique_key.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/message_types.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/message_types.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/message_types.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/message_types.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/missing_ip_sample_data.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/missing_ip_sample_data.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/missing_ip_sample_data.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/missing_ip_sample_data.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/multivalue_geometries.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/multivalue_geometries.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/multivalue_geometries.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/multivalue_geometries.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/multivalue_points.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/multivalue_points.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/multivalue_points.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/multivalue_points.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/mv_sample_data.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/mv_sample_data.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/mv_sample_data.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/mv_sample_data.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/sample_data.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/sample_data.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/sample_data.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/sample_data.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/sample_data_ts_long.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/sample_data_ts_long.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/sample_data_ts_long.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/sample_data_ts_long.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/sample_data_ts_nanos.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/sample_data_ts_nanos.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/sample_data_ts_nanos.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/sample_data_ts_nanos.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/semantic_text.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/semantic_text.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/semantic_text.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/semantic_text.csv
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/ul_logs.csv b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/ul_logs.csv
similarity index 100%
rename from x-pack/plugin/esql/qa/testFixtures/src/main/resources/ul_logs.csv
rename to x-pack/plugin/esql/qa/testFixtures/src/main/resources/data/ul_logs.csv
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index e627f99322f08..1e0374c648579 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -426,7 +426,7 @@ private static CsvTestsDataLoader.TestsDataset testsDataset(LogicalPlan parsed)
     }
 
     private static TestPhysicalOperationProviders testOperationProviders(CsvTestsDataLoader.TestsDataset dataset) throws Exception {
-        var testData = loadPageFromCsv(CsvTests.class.getResource("/" + dataset.dataFileName()), dataset.typeMapping());
+        var testData = loadPageFromCsv(CsvTests.class.getResource("/data/" + dataset.dataFileName()), dataset.typeMapping());
         return new TestPhysicalOperationProviders(testData.v1(), testData.v2());
     }
 

From 9cc6cd422912b253bb4410452c333609c4cefc7c Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Thu, 19 Dec 2024 10:22:13 +0100
Subject: [PATCH 114/119] ESQL: Fix attribute set equals (#118823)

Also add a test that uses this, for lookup join field attribute ids.
---
 docs/changelog/118823.yaml                    |  5 +++
 .../esql/core/expression/AttributeSet.java    |  8 +++-
 .../core/expression/AttributeMapTests.java    |  2 +-
 .../core/expression/AttributeSetTests.java    | 42 +++++++++++++++++++
 .../xpack/esql/analysis/AnalyzerTests.java    | 31 ++++++++++++++
 5 files changed, 85 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelog/118823.yaml
 create mode 100644 x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeSetTests.java

diff --git a/docs/changelog/118823.yaml b/docs/changelog/118823.yaml
new file mode 100644
index 0000000000000..b1afe1c873c17
--- /dev/null
+++ b/docs/changelog/118823.yaml
@@ -0,0 +1,5 @@
+pr: 118823
+summary: Fix attribute set equals
+area: ES|QL
+type: bug
+issues: []
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/AttributeSet.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/AttributeSet.java
index a092e17931237..8a075e8887512 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/AttributeSet.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/AttributeSet.java
@@ -174,8 +174,12 @@ public Stream<Attribute> parallelStream() {
     }
 
     @Override
-    public boolean equals(Object o) {
-        return delegate.equals(o);
+    public boolean equals(Object obj) {
+        if (obj instanceof AttributeSet as) {
+            obj = as.delegate;
+        }
+
+        return delegate.equals(obj);
     }
 
     @Override
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeMapTests.java b/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeMapTests.java
index 511c7f4b1d2f8..ade79c8168076 100644
--- a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeMapTests.java
+++ b/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeMapTests.java
@@ -30,7 +30,7 @@
 
 public class AttributeMapTests extends ESTestCase {
 
-    private static Attribute a(String name) {
+    static Attribute a(String name) {
         return new UnresolvedAttribute(Source.EMPTY, name);
     }
 
diff --git a/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeSetTests.java b/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeSetTests.java
new file mode 100644
index 0000000000000..0e97773fb90d2
--- /dev/null
+++ b/x-pack/plugin/esql-core/src/test/java/org/elasticsearch/xpack/esql/core/expression/AttributeSetTests.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+package org.elasticsearch.xpack.esql.core.expression;
+
+import org.elasticsearch.test.ESTestCase;
+
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.expression.AttributeMapTests.a;
+
+public class AttributeSetTests extends ESTestCase {
+
+    public void testEquals() {
+        Attribute a1 = a("1");
+        Attribute a2 = a("2");
+
+        AttributeSet first = new AttributeSet(List.of(a1, a2));
+        assertEquals(first, first);
+
+        AttributeSet second = new AttributeSet();
+        second.add(a1);
+        second.add(a2);
+
+        assertEquals(first, second);
+        assertEquals(second, first);
+
+        AttributeSet third = new AttributeSet();
+        third.add(a("1"));
+        third.add(a("2"));
+
+        assertNotEquals(first, third);
+        assertNotEquals(third, first);
+
+        assertEquals(AttributeSet.EMPTY, AttributeSet.EMPTY);
+        assertEquals(AttributeSet.EMPTY, first.intersect(third));
+        assertEquals(third.intersect(first), AttributeSet.EMPTY);
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
index 5d1ff43dfe31b..674eda8916c5a 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
 import org.elasticsearch.xpack.esql.core.expression.Alias;
 import org.elasticsearch.xpack.esql.core.expression.Attribute;
+import org.elasticsearch.xpack.esql.core.expression.AttributeSet;
 import org.elasticsearch.xpack.esql.core.expression.Expressions;
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
 import org.elasticsearch.xpack.esql.core.expression.Literal;
@@ -2190,6 +2191,36 @@ public void testLookupJoinUnknownField() {
         assertThat(e.getMessage(), containsString(errorMessage3 + "right side of join"));
     }
 
+    public void testMultipleLookupJoinsGiveDifferentAttributes() {
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
+
+        // The field attributes that get contributed by different LOOKUP JOIN commands must have different name ids,
+        // even if they have the same names. Otherwise, things like dependency analysis - like in PruneColumns - cannot work based on
+        // name ids and shadowing semantics proliferate into all kinds of optimizer code.
+
+        String query = "FROM test"
+            + "| EVAL language_code = languages"
+            + "| LOOKUP JOIN languages_lookup ON language_code"
+            + "| LOOKUP JOIN languages_lookup ON language_code";
+        LogicalPlan analyzedPlan = analyze(query);
+
+        List<AttributeSet> lookupFields = new ArrayList<>();
+        List<Set<String>> lookupFieldNames = new ArrayList<>();
+        analyzedPlan.forEachUp(EsRelation.class, esRelation -> {
+            if (esRelation.indexMode() == IndexMode.LOOKUP) {
+                lookupFields.add(esRelation.outputSet());
+                lookupFieldNames.add(esRelation.outputSet().stream().map(NamedExpression::name).collect(Collectors.toSet()));
+            }
+        });
+
+        assertEquals(lookupFieldNames.size(), 2);
+        assertEquals(lookupFieldNames.get(0), lookupFieldNames.get(1));
+
+        assertEquals(lookupFields.size(), 2);
+        AttributeSet intersection = lookupFields.get(0).intersect(lookupFields.get(1));
+        assertEquals(AttributeSet.EMPTY, intersection);
+    }
+
     public void testLookupJoinIndexMode() {
         assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V8.isEnabled());
 

From 8845cf725bf7412c7d53cfaac261026f95d78601 Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Thu, 19 Dec 2024 10:32:47 +0100
Subject: [PATCH 115/119] Include read-only index versions in
 randomCompatbileVersion/randomCompatiblePreviousVersion (#119013)

Read-only versions are now included in all index versions, see #118793 . The next step is to broaden testing where possible to include index versions that cannot be written to. To do that, we change the behaviour of the existing randomCompatbileVersion and randomCompatiblePreviousVersion and methods to include read-only versions and we introduce corresponding variants of these methods that only return write compatible index versions.

As part of this change, we can also remove some of the `@UpdateForV9` annotations that relate to v7 index versions which randomCompatibleVersion no longer covered. That's now fixed and such tests can simply be restored.
---
 .../search/GeoBoundingBoxQueryLegacyGeoShapeIT.java    |  2 +-
 .../legacygeo/search/LegacyGeoShapeIT.java             |  2 +-
 .../legacygeo/GeoJsonShapeParserTests.java             |  3 ---
 .../legacygeo/GeoWKTShapeParserTests.java              |  7 -------
 .../mapper/LegacyGeoShapeFieldMapperTests.java         |  4 ----
 .../legacygeo/mapper/LegacyGeoShapeFieldTypeTests.java |  4 ----
 .../action/admin/indices/create/CloneIndexIT.java      |  2 +-
 .../action/admin/indices/create/SplitIndexIT.java      |  4 ++--
 .../seqno/PeerRecoveryRetentionLeaseCreationIT.java    |  2 +-
 .../search/aggregations/bucket/GeoDistanceIT.java      |  2 +-
 .../search/aggregations/bucket/GeoHashGridIT.java      |  2 +-
 .../search/functionscore/DecayFunctionScoreIT.java     |  2 +-
 .../search/geo/GeoBoundingBoxQueryGeoPointIT.java      |  2 +-
 .../org/elasticsearch/search/geo/GeoDistanceIT.java    |  2 +-
 .../org/elasticsearch/search/geo/GeoPolygonIT.java     |  2 +-
 .../org/elasticsearch/search/sort/GeoDistanceIT.java   |  8 ++++----
 .../search/sort/GeoDistanceSortBuilderIT.java          |  6 +++---
 .../cluster/metadata/IndexMetadataVerifierTests.java   |  2 +-
 .../replication/RetentionLeasesReplicationTests.java   |  2 +-
 .../test/test/InternalClusterForbiddenSettingIT.java   |  4 ++--
 .../elasticsearch/test/index/IndexVersionUtils.java    | 10 ++++++++++
 .../xpack/spatial/search/CartesianShapeIT.java         |  2 +-
 .../GeoBoundingBoxQueryGeoShapeWithDocValuesIT.java    |  2 +-
 .../xpack/spatial/search/GeoShapeWithDocValuesIT.java  |  2 +-
 .../mapper/GeoShapeWithDocValuesFieldMapperTests.java  |  3 ---
 25 files changed, 36 insertions(+), 47 deletions(-)

diff --git a/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/GeoBoundingBoxQueryLegacyGeoShapeIT.java b/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/GeoBoundingBoxQueryLegacyGeoShapeIT.java
index 37c31c8af47b0..d2dd5b7442dd2 100644
--- a/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/GeoBoundingBoxQueryLegacyGeoShapeIT.java
+++ b/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/GeoBoundingBoxQueryLegacyGeoShapeIT.java
@@ -45,6 +45,6 @@ public XContentBuilder getMapping() throws IOException {
 
     @Override
     public IndexVersion randomSupportedVersion() {
-        return IndexVersionUtils.randomCompatibleVersion(random());
+        return IndexVersionUtils.randomCompatibleWriteVersion(random());
     }
 }
diff --git a/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/LegacyGeoShapeIT.java b/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/LegacyGeoShapeIT.java
index 918c343b79b7b..73b7c07c45fe5 100644
--- a/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/LegacyGeoShapeIT.java
+++ b/modules/legacy-geo/src/internalClusterTest/java/org/elasticsearch/legacygeo/search/LegacyGeoShapeIT.java
@@ -41,7 +41,7 @@ protected void getGeoShapeMapping(XContentBuilder b) throws IOException {
 
     @Override
     protected IndexVersion randomSupportedVersion() {
-        return IndexVersionUtils.randomCompatibleVersion(random());
+        return IndexVersionUtils.randomCompatibleWriteVersion(random());
     }
 
     @Override
diff --git a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoJsonShapeParserTests.java b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoJsonShapeParserTests.java
index 9b83cd9ffdb2b..bd5b289abc588 100644
--- a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoJsonShapeParserTests.java
+++ b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoJsonShapeParserTests.java
@@ -15,7 +15,6 @@
 import org.elasticsearch.common.geo.GeometryNormalizer;
 import org.elasticsearch.common.geo.GeometryParser;
 import org.elasticsearch.common.geo.Orientation;
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.geometry.Geometry;
 import org.elasticsearch.geometry.GeometryCollection;
 import org.elasticsearch.geometry.Line;
@@ -344,8 +343,6 @@ public void testParsePolygon() throws IOException, ParseException {
         assertGeometryEquals(p, polygonGeoJson, false);
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-    @AwaitsFix(bugUrl = "this test is using pre 8.0.0 index versions so needs to be removed or updated")
     public void testParse3DPolygon() throws IOException, ParseException {
         XContentBuilder polygonGeoJson = XContentFactory.jsonBuilder()
             .startObject()
diff --git a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoWKTShapeParserTests.java b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoWKTShapeParserTests.java
index 5d0df9215ef25..f944a368b2a6c 100644
--- a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoWKTShapeParserTests.java
+++ b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/GeoWKTShapeParserTests.java
@@ -14,7 +14,6 @@
 import org.elasticsearch.common.geo.GeoPoint;
 import org.elasticsearch.common.geo.GeometryNormalizer;
 import org.elasticsearch.common.geo.Orientation;
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.geometry.Geometry;
 import org.elasticsearch.geometry.Line;
 import org.elasticsearch.geometry.MultiLine;
@@ -303,8 +302,6 @@ public void testParseMixedDimensionPolyWithHole() throws IOException, ParseExcep
         assertThat(e, hasToString(containsString("coordinate dimensions do not match")));
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-    @AwaitsFix(bugUrl = "this test is using pre 8.0.0 index versions so needs to be removed or updated")
     public void testParseMixedDimensionPolyWithHoleStoredZ() throws IOException {
         List<Coordinate> shellCoordinates = new ArrayList<>();
         shellCoordinates.add(new Coordinate(100, 0));
@@ -338,8 +335,6 @@ public void testParseMixedDimensionPolyWithHoleStoredZ() throws IOException {
         assertThat(e, hasToString(containsString("unable to add coordinate to CoordinateBuilder: coordinate dimensions do not match")));
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-    @AwaitsFix(bugUrl = "this test is using pre 8.0.0 index versions so needs to be removed or updated")
     public void testParsePolyWithStoredZ() throws IOException {
         List<Coordinate> shellCoordinates = new ArrayList<>();
         shellCoordinates.add(new Coordinate(100, 0, 0));
@@ -363,8 +358,6 @@ public void testParsePolyWithStoredZ() throws IOException {
         assertEquals(shapeBuilder.numDimensions(), 3);
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-    @AwaitsFix(bugUrl = "this test is using pre 8.0.0 index versions so needs to be removed or updated")
     public void testParseOpenPolygon() throws IOException {
         String openPolygon = "POLYGON ((100 5, 100 10, 90 10, 90 5))";
 
diff --git a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldMapperTests.java b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldMapperTests.java
index 7352b4d88a42b..c97b0a28d22de 100644
--- a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldMapperTests.java
+++ b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldMapperTests.java
@@ -13,7 +13,6 @@
 import org.apache.lucene.spatial.prefix.RecursivePrefixTreeStrategy;
 import org.apache.lucene.spatial.prefix.tree.GeohashPrefixTree;
 import org.apache.lucene.spatial.prefix.tree.QuadPrefixTree;
-import org.apache.lucene.tests.util.LuceneTestCase.AwaitsFix;
 import org.elasticsearch.ElasticsearchException;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.geo.GeoUtils;
@@ -21,7 +20,6 @@
 import org.elasticsearch.common.geo.ShapeRelation;
 import org.elasticsearch.common.geo.SpatialStrategy;
 import org.elasticsearch.core.CheckedConsumer;
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.geometry.Point;
 import org.elasticsearch.index.IndexVersion;
 import org.elasticsearch.index.IndexVersions;
@@ -56,8 +54,6 @@
 import static org.mockito.Mockito.when;
 
 @SuppressWarnings("deprecation")
-@UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-@AwaitsFix(bugUrl = "this is testing legacy functionality so can likely be removed in 9.0")
 public class LegacyGeoShapeFieldMapperTests extends MapperTestCase {
 
     @Override
diff --git a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldTypeTests.java b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldTypeTests.java
index bf616c8190324..f5e09f19c1a71 100644
--- a/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldTypeTests.java
+++ b/modules/legacy-geo/src/test/java/org/elasticsearch/legacygeo/mapper/LegacyGeoShapeFieldTypeTests.java
@@ -8,9 +8,7 @@
  */
 package org.elasticsearch.legacygeo.mapper;
 
-import org.apache.lucene.tests.util.LuceneTestCase;
 import org.elasticsearch.common.geo.SpatialStrategy;
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.index.IndexVersion;
 import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.mapper.FieldTypeTestCase;
@@ -23,8 +21,6 @@
 import java.util.List;
 import java.util.Map;
 
-@UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-@LuceneTestCase.AwaitsFix(bugUrl = "this is testing legacy functionality so can likely be removed in 9.0")
 public class LegacyGeoShapeFieldTypeTests extends FieldTypeTestCase {
 
     /**
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/CloneIndexIT.java b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/CloneIndexIT.java
index 47f96aebacd7d..fa2b053ead348 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/CloneIndexIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/CloneIndexIT.java
@@ -39,7 +39,7 @@ protected boolean forbidPrivateIndexSettings() {
     }
 
     public void testCreateCloneIndex() {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         int numPrimaryShards = randomIntBetween(1, 5);
         prepareCreate("source").setSettings(
             Settings.builder().put(indexSettings()).put("number_of_shards", numPrimaryShards).put("index.version.created", version)
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java
index 8391ab270b1d1..9ba6ac4bd9c58 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/indices/create/SplitIndexIT.java
@@ -341,8 +341,8 @@ private static IndexMetadata indexMetadata(final Client client, final String ind
         return clusterStateResponse.getState().metadata().index(index);
     }
 
-    public void testCreateSplitIndex() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+    public void testCreateSplitIndex() {
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         prepareCreate("source").setSettings(
             Settings.builder().put(indexSettings()).put("number_of_shards", 1).put("index.version.created", version)
         ).get();
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java b/server/src/internalClusterTest/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java
index 07f9d9ee7b6c3..92e5eb8e046bc 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/index/seqno/PeerRecoveryRetentionLeaseCreationIT.java
@@ -48,7 +48,7 @@ public void testCanRecoverFromStoreWithoutPeerRecoveryRetentionLease() throws Ex
                 Settings.builder()
                     .put(IndexMetadata.SETTING_NUMBER_OF_REPLICAS, 0)
                     .put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true)
-                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomCompatibleVersion(random()))
+                    .put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomCompatibleWriteVersion(random()))
             )
         );
         ensureGreen(INDEX_NAME);
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java
index 907f943e68422..6c67bd2a98606 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoDistanceIT.java
@@ -56,7 +56,7 @@ protected boolean forbidPrivateIndexSettings() {
         return false;
     }
 
-    private final IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+    private final IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
 
     private IndexRequestBuilder indexCity(String idx, String name, String... latLons) throws Exception {
         XContentBuilder source = jsonBuilder().startObject().field("city", name);
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java
index 1ad7d1a11bea7..1de51d6df8197 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/aggregations/bucket/GeoHashGridIT.java
@@ -49,7 +49,7 @@ protected boolean forbidPrivateIndexSettings() {
         return false;
     }
 
-    private final IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+    private final IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
 
     static Map<String, Integer> expectedDocCountsForGeoHash = null;
     static Map<String, Integer> multiValuedExpectedDocCountsForGeoHash = null;
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java
index 9988624f6a677..a55edf3782bcc 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/functionscore/DecayFunctionScoreIT.java
@@ -748,7 +748,7 @@ public void testDateWithoutOrigin() throws Exception {
     }
 
     public void testManyDocsLin() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         XContentBuilder xContentBuilder = jsonBuilder().startObject()
             .startObject("_doc")
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryGeoPointIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryGeoPointIT.java
index 2489889be19e5..8104e4ed7a825 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryGeoPointIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoBoundingBoxQueryGeoPointIT.java
@@ -32,6 +32,6 @@ public XContentBuilder getMapping() throws IOException {
 
     @Override
     public IndexVersion randomSupportedVersion() {
-        return IndexVersionUtils.randomCompatibleVersion(random());
+        return IndexVersionUtils.randomCompatibleWriteVersion(random());
     }
 }
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoDistanceIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoDistanceIT.java
index 9b4e28055a988..a309fa81f6dc1 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoDistanceIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoDistanceIT.java
@@ -96,7 +96,7 @@ protected boolean forbidPrivateIndexSettings() {
 
     @Before
     public void setupTestIndex() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()
             .startObject()
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoPolygonIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoPolygonIT.java
index 4b8f29f3cc9a5..aadefd9bd8018 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoPolygonIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/geo/GeoPolygonIT.java
@@ -39,7 +39,7 @@ protected boolean forbidPrivateIndexSettings() {
 
     @Override
     protected void setupSuiteScopeCluster() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
 
         assertAcked(
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceIT.java
index e80678c4f5fc6..f55d4505f3f58 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceIT.java
@@ -45,7 +45,7 @@ protected boolean forbidPrivateIndexSettings() {
     }
 
     public void testDistanceSortingMVFields() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()
             .startObject()
@@ -237,7 +237,7 @@ public void testDistanceSortingMVFields() throws Exception {
     // Regression bug:
     // https://github.com/elastic/elasticsearch/issues/2851
     public void testDistanceSortingWithMissingGeoPoint() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()
             .startObject()
@@ -299,7 +299,7 @@ public void testDistanceSortingWithMissingGeoPoint() throws Exception {
     }
 
     public void testDistanceSortingNestedFields() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         XContentBuilder xContentBuilder = XContentFactory.jsonBuilder()
             .startObject()
@@ -551,7 +551,7 @@ public void testDistanceSortingNestedFields() throws Exception {
      * Issue 3073
      */
     public void testGeoDistanceFilter() throws IOException {
-        IndexVersion version = IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         double lat = 40.720611;
         double lon = -73.998776;
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java
index aabca1b9333f8..d53c90a5d1e28 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/sort/GeoDistanceSortBuilderIT.java
@@ -60,7 +60,7 @@ public void testManyToManyGeoPoints() throws ExecutionException, InterruptedExce
          * |___________________________
          * 1   2   3   4   5   6   7
          */
-        IndexVersion version = randomBoolean() ? IndexVersion.current() : IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = randomBoolean() ? IndexVersion.current() : IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         assertAcked(prepareCreate("index").setSettings(settings).setMapping(LOCATION_FIELD, "type=geo_point"));
         XContentBuilder d1Builder = jsonBuilder();
@@ -152,7 +152,7 @@ public void testSingeToManyAvgMedian() throws ExecutionException, InterruptedExc
          * d1 = (0, 1), (0, 4), (0, 10); so avg. distance is 5, median distance is 4
          * d2 = (0, 1), (0, 5), (0, 6); so avg. distance is 4, median distance is 5
          */
-        IndexVersion version = randomBoolean() ? IndexVersion.current() : IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = randomBoolean() ? IndexVersion.current() : IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         assertAcked(prepareCreate("index").setSettings(settings).setMapping(LOCATION_FIELD, "type=geo_point"));
         XContentBuilder d1Builder = jsonBuilder();
@@ -225,7 +225,7 @@ public void testManyToManyGeoPointsWithDifferentFormats() throws ExecutionExcept
          * |______________________
          * 1   2   3   4   5   6
          */
-        IndexVersion version = randomBoolean() ? IndexVersion.current() : IndexVersionUtils.randomCompatibleVersion(random());
+        IndexVersion version = randomBoolean() ? IndexVersion.current() : IndexVersionUtils.randomCompatibleWriteVersion(random());
         Settings settings = Settings.builder().put(IndexMetadata.SETTING_VERSION_CREATED, version).build();
         assertAcked(prepareCreate("index").setSettings(settings).setMapping(LOCATION_FIELD, "type=geo_point"));
         XContentBuilder d1Builder = jsonBuilder();
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/IndexMetadataVerifierTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/IndexMetadataVerifierTests.java
index 3b122864aa472..6ee86470861b4 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/IndexMetadataVerifierTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/IndexMetadataVerifierTests.java
@@ -97,7 +97,7 @@ public void testCustomSimilarity() {
                 .put("index.similarity.my_similarity.after_effect", "l")
                 .build()
         );
-        service.verifyIndexMetadata(src, IndexVersions.MINIMUM_COMPATIBLE);
+        service.verifyIndexMetadata(src, IndexVersions.MINIMUM_READONLY_COMPATIBLE);
     }
 
     public void testIncompatibleVersion() {
diff --git a/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java b/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
index 8f45a15c73bb6..1f82d7998257e 100644
--- a/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
+++ b/server/src/test/java/org/elasticsearch/index/replication/RetentionLeasesReplicationTests.java
@@ -147,7 +147,7 @@ protected void syncRetentionLeases(ShardId id, RetentionLeases leases, ActionLis
     public void testTurnOffTranslogRetentionAfterAllShardStarted() throws Exception {
         final Settings.Builder settings = Settings.builder().put(IndexSettings.INDEX_SOFT_DELETES_SETTING.getKey(), true);
         if (randomBoolean()) {
-            settings.put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomCompatibleVersion(random()));
+            settings.put(IndexMetadata.SETTING_VERSION_CREATED, IndexVersionUtils.randomCompatibleWriteVersion(random()));
         }
         try (ReplicationGroup group = createGroup(between(1, 2), settings.build())) {
             group.startAll();
diff --git a/test/framework/src/integTest/java/org/elasticsearch/test/test/InternalClusterForbiddenSettingIT.java b/test/framework/src/integTest/java/org/elasticsearch/test/test/InternalClusterForbiddenSettingIT.java
index d13450fbb52dd..2033743354f34 100644
--- a/test/framework/src/integTest/java/org/elasticsearch/test/test/InternalClusterForbiddenSettingIT.java
+++ b/test/framework/src/integTest/java/org/elasticsearch/test/test/InternalClusterForbiddenSettingIT.java
@@ -26,7 +26,7 @@ protected boolean forbidPrivateIndexSettings() {
     }
 
     public void testRestart() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomPreviousCompatibleVersion(random(), IndexVersion.current());
+        IndexVersion version = IndexVersionUtils.randomPreviousCompatibleWriteVersion(random(), IndexVersion.current());
         // create / delete an index with forbidden setting
         prepareCreate("test").setSettings(settings(version).build()).get();
         indicesAdmin().prepareDelete("test").get();
@@ -38,7 +38,7 @@ public void testRestart() throws Exception {
     }
 
     public void testRollingRestart() throws Exception {
-        IndexVersion version = IndexVersionUtils.randomPreviousCompatibleVersion(random(), IndexVersion.current());
+        IndexVersion version = IndexVersionUtils.randomPreviousCompatibleWriteVersion(random(), IndexVersion.current());
         // create / delete an index with forbidden setting
         prepareCreate("test").setSettings(settings(version).build()).get();
         indicesAdmin().prepareDelete("test").get();
diff --git a/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java b/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java
index 592cffac33552..667149e4bdd3e 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/index/IndexVersionUtils.java
@@ -122,11 +122,21 @@ public static IndexVersion getNextVersion(IndexVersion version) {
 
     /** Returns a random {@code IndexVersion} that is compatible with {@link IndexVersion#current()} */
     public static IndexVersion randomCompatibleVersion(Random random) {
+        return randomVersionBetween(random, IndexVersions.MINIMUM_READONLY_COMPATIBLE, IndexVersion.current());
+    }
+
+    /** Returns a random {@code IndexVersion} that is compatible with {@link IndexVersion#current()} and can be written to */
+    public static IndexVersion randomCompatibleWriteVersion(Random random) {
         return randomVersionBetween(random, IndexVersions.MINIMUM_COMPATIBLE, IndexVersion.current());
     }
 
     /** Returns a random {@code IndexVersion} that is compatible with the previous version to {@code version} */
     public static IndexVersion randomPreviousCompatibleVersion(Random random, IndexVersion version) {
+        return randomVersionBetween(random, IndexVersions.MINIMUM_READONLY_COMPATIBLE, getPreviousVersion(version));
+    }
+
+    /** Returns a random {@code IndexVersion} that is compatible with the previous version to {@code version} and can be written to */
+    public static IndexVersion randomPreviousCompatibleWriteVersion(Random random, IndexVersion version) {
         return randomVersionBetween(random, IndexVersions.MINIMUM_COMPATIBLE, getPreviousVersion(version));
     }
 }
diff --git a/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/CartesianShapeIT.java b/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/CartesianShapeIT.java
index 83fbd7262461d..eb4515a897118 100644
--- a/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/CartesianShapeIT.java
+++ b/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/CartesianShapeIT.java
@@ -36,7 +36,7 @@ protected void getGeoShapeMapping(XContentBuilder b) throws IOException {
 
     @Override
     protected IndexVersion randomSupportedVersion() {
-        return IndexVersionUtils.randomCompatibleVersion(random());
+        return IndexVersionUtils.randomCompatibleWriteVersion(random());
     }
 
     @Override
diff --git a/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoBoundingBoxQueryGeoShapeWithDocValuesIT.java b/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoBoundingBoxQueryGeoShapeWithDocValuesIT.java
index 3d91fb443aabd..4a6fa5d545bef 100644
--- a/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoBoundingBoxQueryGeoShapeWithDocValuesIT.java
+++ b/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoBoundingBoxQueryGeoShapeWithDocValuesIT.java
@@ -40,6 +40,6 @@ public XContentBuilder getMapping() throws IOException {
 
     @Override
     public IndexVersion randomSupportedVersion() {
-        return IndexVersionUtils.randomCompatibleVersion(random());
+        return IndexVersionUtils.randomCompatibleWriteVersion(random());
     }
 }
diff --git a/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoShapeWithDocValuesIT.java b/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoShapeWithDocValuesIT.java
index b4d7a472591bd..0857b078be579 100644
--- a/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoShapeWithDocValuesIT.java
+++ b/x-pack/plugin/spatial/src/internalClusterTest/java/org/elasticsearch/xpack/spatial/search/GeoShapeWithDocValuesIT.java
@@ -60,7 +60,7 @@ protected void getGeoShapeMapping(XContentBuilder b) throws IOException {
 
     @Override
     protected IndexVersion randomSupportedVersion() {
-        return IndexVersionUtils.randomCompatibleVersion(random());
+        return IndexVersionUtils.randomCompatibleWriteVersion(random());
     }
 
     @Override
diff --git a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/GeoShapeWithDocValuesFieldMapperTests.java b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/GeoShapeWithDocValuesFieldMapperTests.java
index 4b13a7bf1f829..58fde288cfc60 100644
--- a/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/GeoShapeWithDocValuesFieldMapperTests.java
+++ b/x-pack/plugin/spatial/src/test/java/org/elasticsearch/xpack/spatial/index/mapper/GeoShapeWithDocValuesFieldMapperTests.java
@@ -10,7 +10,6 @@
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.geo.Orientation;
-import org.elasticsearch.core.UpdateForV9;
 import org.elasticsearch.geometry.Geometry;
 import org.elasticsearch.geometry.utils.GeometryValidator;
 import org.elasticsearch.geometry.utils.WellKnownBinary;
@@ -280,8 +279,6 @@ public void testInvalidCurrentVersion() {
         );
     }
 
-    @UpdateForV9(owner = UpdateForV9.Owner.SEARCH_ANALYTICS)
-    @AwaitsFix(bugUrl = "this is testing legacy functionality so can likely be removed in 9.0")
     public void testGeoShapeLegacyMerge() throws Exception {
         IndexVersion version = IndexVersionUtils.randomPreviousCompatibleVersion(random(), IndexVersions.V_8_0_0);
         MapperService m = createMapperService(version, fieldMapping(b -> b.field("type", getFieldName())));

From 1cf5b03b31716a5424a60a75aeade6d7379ca761 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 19 Dec 2024 21:08:51 +1100
Subject: [PATCH 116/119] Mute
 org.elasticsearch.cluster.coordination.NodeJoinExecutorTests testSuccess
 #119052

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 12f1fc510a332..8cfc7c082473f 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -301,6 +301,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/116777
 - class: org.elasticsearch.xpack.security.authc.ldap.ActiveDirectoryRunAsIT
   issue: https://github.com/elastic/elasticsearch/issues/115727
+- class: org.elasticsearch.cluster.coordination.NodeJoinExecutorTests
+  method: testSuccess
+  issue: https://github.com/elastic/elasticsearch/issues/119052
 
 # Examples:
 #

From 4efeca83b4a9f40f5a8fac9a8a3b4f2191d5282e Mon Sep 17 00:00:00 2001
From: Mary Gouseti <mary.gouseti@elastic.co>
Date: Thu, 19 Dec 2024 12:20:12 +0200
Subject: [PATCH 117/119] [Failure store] Reconciliate failure indices during
 snapshotting  (#118834)

In this PR we reconciliate the failure indices of a data stream just
like we do for the backing indices. The only difference is that a data
stream can have an empty list of failure indices, while it cannot have
an empty list of backing indices.

An easy way to create a situation where certain backing or failure
indices are not included in a snapshot is via using exclusions in the
multi-target expression of the snapshot. For example:

```
PUT /_snapshot/my_repository/my-snapshot?wait_for_completion=true
{
  "indices": "my-ds*", "-.fs-my-ds-000001"
}
```
---
 .../datastreams/DataStreamsSnapshotsIT.java   | 279 +++++++++---------
 .../cluster/metadata/DataStream.java          |  49 ++-
 .../snapshots/SnapshotsService.java           |  10 +-
 .../cluster/metadata/DataStreamTests.java     |  66 ++++-
 4 files changed, 224 insertions(+), 180 deletions(-)

diff --git a/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/DataStreamsSnapshotsIT.java b/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/DataStreamsSnapshotsIT.java
index 286ad68896797..32d080ccc46b1 100644
--- a/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/DataStreamsSnapshotsIT.java
+++ b/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/DataStreamsSnapshotsIT.java
@@ -60,7 +60,6 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
-import java.util.concurrent.ExecutionException;
 import java.util.stream.Collectors;
 
 import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
@@ -77,6 +76,7 @@
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
 
 public class DataStreamsSnapshotsIT extends AbstractSnapshotIntegTestCase {
@@ -145,18 +145,11 @@ public void setup() throws Exception {
 
         // Resolve backing index names after data streams have been created:
         // (these names have a date component, and running around midnight could lead to test failures otherwise)
-        GetDataStreamAction.Request getDataStreamRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" });
-        GetDataStreamAction.Response getDataStreamResponse = client.execute(GetDataStreamAction.INSTANCE, getDataStreamRequest).actionGet();
-        dsBackingIndexName = getDataStreamResponse.getDataStreams().get(0).getDataStream().getIndices().get(0).getName();
-        otherDsBackingIndexName = getDataStreamResponse.getDataStreams().get(1).getDataStream().getIndices().get(0).getName();
-        fsBackingIndexName = getDataStreamResponse.getDataStreams().get(2).getDataStream().getIndices().get(0).getName();
-        fsFailureIndexName = getDataStreamResponse.getDataStreams()
-            .get(2)
-            .getDataStream()
-            .getFailureIndices()
-            .getIndices()
-            .get(0)
-            .getName();
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("*");
+        dsBackingIndexName = dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName();
+        otherDsBackingIndexName = dataStreamInfos.get(1).getDataStream().getIndices().get(0).getName();
+        fsBackingIndexName = dataStreamInfos.get(2).getDataStream().getIndices().get(0).getName();
+        fsFailureIndexName = dataStreamInfos.get(2).getDataStream().getFailureIndices().getIndices().get(0).getName();
 
         // Will be used in some tests, to test renaming while restoring a snapshot:
         ds2BackingIndexName = dsBackingIndexName.replace("-ds-", "-ds2-");
@@ -198,9 +191,7 @@ public void testSnapshotAndRestore() throws Exception {
 
         assertEquals(Collections.singletonList(dsBackingIndexName), getSnapshot(REPO, SNAPSHOT).indices());
 
-        assertAcked(
-            client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds" }))
-        );
+        assertAcked(client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, "ds")));
 
         RestoreSnapshotResponse restoreSnapshotResponse = client.admin()
             .cluster()
@@ -218,13 +209,10 @@ public void testSnapshotAndRestore() throws Exception {
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds" })
-        ).get();
-        assertEquals(1, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(dsBackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> ds = getDataStreamInfo("ds");
+        assertEquals(1, ds.size());
+        assertEquals(1, ds.get(0).getDataStream().getIndices().size());
+        assertEquals(dsBackingIndexName, ds.get(0).getDataStream().getIndices().get(0).getName());
 
         GetAliasesResponse getAliasesResponse = client.admin().indices().getAliases(new GetAliasesRequest("my-alias")).actionGet();
         assertThat(getAliasesResponse.getDataStreamAliases().keySet(), containsInAnyOrder("ds", "other-ds"));
@@ -278,19 +266,18 @@ public void testSnapshotAndRestoreAllDataStreamsInPlace() throws Exception {
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Request getDataSteamRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" });
-        GetDataStreamAction.Response ds = client.execute(GetDataStreamAction.INSTANCE, getDataSteamRequest).get();
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("*");
         assertThat(
-            ds.getDataStreams().stream().map(e -> e.getDataStream().getName()).collect(Collectors.toList()),
+            dataStreamInfos.stream().map(e -> e.getDataStream().getName()).collect(Collectors.toList()),
             contains(equalTo("ds"), equalTo("other-ds"), equalTo("with-fs"))
         );
-        List<Index> backingIndices = ds.getDataStreams().get(0).getDataStream().getIndices();
+        List<Index> backingIndices = dataStreamInfos.get(0).getDataStream().getIndices();
         assertThat(backingIndices.stream().map(Index::getName).collect(Collectors.toList()), contains(dsBackingIndexName));
-        backingIndices = ds.getDataStreams().get(1).getDataStream().getIndices();
+        backingIndices = dataStreamInfos.get(1).getDataStream().getIndices();
         assertThat(backingIndices.stream().map(Index::getName).collect(Collectors.toList()), contains(otherDsBackingIndexName));
-        backingIndices = ds.getDataStreams().get(2).getDataStream().getIndices();
+        backingIndices = dataStreamInfos.get(2).getDataStream().getIndices();
         assertThat(backingIndices.stream().map(Index::getName).collect(Collectors.toList()), contains(fsBackingIndexName));
-        List<Index> failureIndices = ds.getDataStreams().get(2).getDataStream().getFailureIndices().getIndices();
+        List<Index> failureIndices = dataStreamInfos.get(2).getDataStream().getFailureIndices().getIndices();
         assertThat(failureIndices.stream().map(Index::getName).collect(Collectors.toList()), contains(fsFailureIndexName));
     }
 
@@ -337,14 +324,10 @@ public void testSnapshotAndRestoreInPlace() {
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Request getDataSteamRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds" });
-        GetDataStreamAction.Response ds = client.execute(GetDataStreamAction.INSTANCE, getDataSteamRequest).actionGet();
-        assertThat(
-            ds.getDataStreams().stream().map(e -> e.getDataStream().getName()).collect(Collectors.toList()),
-            contains(equalTo("ds"))
-        );
-        List<Index> backingIndices = ds.getDataStreams().get(0).getDataStream().getIndices();
-        assertThat(ds.getDataStreams().get(0).getDataStream().getIndices(), hasSize(1));
+        List<GetDataStreamAction.Response.DataStreamInfo> dsInfo = getDataStreamInfo("ds");
+        assertThat(dsInfo.stream().map(e -> e.getDataStream().getName()).collect(Collectors.toList()), contains(equalTo("ds")));
+        List<Index> backingIndices = dsInfo.get(0).getDataStream().getIndices();
+        assertThat(dsInfo.get(0).getDataStream().getIndices(), hasSize(1));
         assertThat(backingIndices.stream().map(Index::getName).collect(Collectors.toList()), contains(equalTo(dsBackingIndexName)));
 
         // The backing index created as part of rollover should still exist (but just not part of the data stream)
@@ -357,39 +340,40 @@ public void testSnapshotAndRestoreInPlace() {
     }
 
     public void testFailureStoreSnapshotAndRestore() throws Exception {
+        String dataStreamName = "with-fs";
         CreateSnapshotResponse createSnapshotResponse = client.admin()
             .cluster()
             .prepareCreateSnapshot(TEST_REQUEST_TIMEOUT, REPO, SNAPSHOT)
             .setWaitForCompletion(true)
-            .setIndices("with-fs")
+            .setIndices(dataStreamName)
             .setIncludeGlobalState(false)
             .get();
 
         RestStatus status = createSnapshotResponse.getSnapshotInfo().status();
         assertEquals(RestStatus.OK, status);
 
+        assertThat(getSnapshot(REPO, SNAPSHOT).dataStreams(), containsInAnyOrder(dataStreamName));
         assertThat(getSnapshot(REPO, SNAPSHOT).indices(), containsInAnyOrder(fsBackingIndexName, fsFailureIndexName));
 
-        assertAcked(client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, "with-fs")));
+        assertAcked(
+            client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, dataStreamName))
+        );
 
         {
             RestoreSnapshotResponse restoreSnapshotResponse = client.admin()
                 .cluster()
                 .prepareRestoreSnapshot(TEST_REQUEST_TIMEOUT, REPO, SNAPSHOT)
                 .setWaitForCompletion(true)
-                .setIndices("with-fs")
+                .setIndices(dataStreamName)
                 .get();
 
             assertEquals(2, restoreSnapshotResponse.getRestoreInfo().successfulShards());
 
-            GetDataStreamAction.Response ds = client.execute(
-                GetDataStreamAction.INSTANCE,
-                new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "with-fs" })
-            ).get();
-            assertEquals(1, ds.getDataStreams().size());
-            assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-            assertEquals(fsBackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
-            assertEquals(fsFailureIndexName, ds.getDataStreams().get(0).getDataStream().getFailureIndices().getIndices().get(0).getName());
+            List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo(dataStreamName);
+            assertEquals(1, dataStreamInfos.size());
+            assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+            assertEquals(fsBackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
+            assertEquals(fsFailureIndexName, dataStreamInfos.get(0).getDataStream().getFailureIndices().getIndices().get(0).getName());
         }
         {
             // With rename pattern
@@ -397,21 +381,18 @@ public void testFailureStoreSnapshotAndRestore() throws Exception {
                 .cluster()
                 .prepareRestoreSnapshot(TEST_REQUEST_TIMEOUT, REPO, SNAPSHOT)
                 .setWaitForCompletion(true)
-                .setIndices("with-fs")
+                .setIndices(dataStreamName)
                 .setRenamePattern("-fs")
                 .setRenameReplacement("-fs2")
                 .get();
 
             assertEquals(2, restoreSnapshotResponse.getRestoreInfo().successfulShards());
 
-            GetDataStreamAction.Response ds = client.execute(
-                GetDataStreamAction.INSTANCE,
-                new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "with-fs2" })
-            ).get();
-            assertEquals(1, ds.getDataStreams().size());
-            assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-            assertEquals(fs2BackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
-            assertEquals(fs2FailureIndexName, ds.getDataStreams().get(0).getDataStream().getFailureIndices().getIndices().get(0).getName());
+            List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("with-fs2");
+            assertEquals(1, dataStreamInfos.size());
+            assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+            assertEquals(fs2BackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
+            assertEquals(fs2FailureIndexName, dataStreamInfos.get(0).getDataStream().getFailureIndices().getIndices().get(0).getName());
         }
     }
 
@@ -477,13 +458,10 @@ public void testSnapshotAndRestoreAllIncludeSpecificDataStream() throws Exceptio
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { dataStreamToSnapshot })
-        ).get();
-        assertEquals(1, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(backingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo(dataStreamToSnapshot);
+        assertEquals(1, dataStreamInfos.size());
+        assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+        assertEquals(backingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
 
         GetAliasesResponse getAliasesResponse = client.admin().indices().getAliases(new GetAliasesRequest("my-alias")).actionGet();
         assertThat(getAliasesResponse.getDataStreamAliases().keySet(), contains(dataStreamToSnapshot));
@@ -536,13 +514,10 @@ public void testSnapshotAndRestoreReplaceAll() throws Exception {
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" })
-        ).get();
-        assertEquals(3, ds.getDataStreams().size());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("*");
+        assertEquals(3, dataStreamInfos.size());
         assertThat(
-            ds.getDataStreams().stream().map(i -> i.getDataStream().getName()).collect(Collectors.toList()),
+            dataStreamInfos.stream().map(i -> i.getDataStream().getName()).collect(Collectors.toList()),
             containsInAnyOrder("ds", "other-ds", "with-fs")
         );
 
@@ -596,19 +571,16 @@ public void testSnapshotAndRestoreAll() throws Exception {
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" })
-        ).get();
-        assertEquals(3, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(dsBackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
-        assertEquals(1, ds.getDataStreams().get(1).getDataStream().getIndices().size());
-        assertEquals(otherDsBackingIndexName, ds.getDataStreams().get(1).getDataStream().getIndices().get(0).getName());
-        assertEquals(1, ds.getDataStreams().get(2).getDataStream().getIndices().size());
-        assertEquals(fsBackingIndexName, ds.getDataStreams().get(2).getDataStream().getIndices().get(0).getName());
-        assertEquals(1, ds.getDataStreams().get(2).getDataStream().getFailureIndices().getIndices().size());
-        assertEquals(fsFailureIndexName, ds.getDataStreams().get(2).getDataStream().getFailureIndices().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("*");
+        assertEquals(3, dataStreamInfos.size());
+        assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+        assertEquals(dsBackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
+        assertEquals(1, dataStreamInfos.get(1).getDataStream().getIndices().size());
+        assertEquals(otherDsBackingIndexName, dataStreamInfos.get(1).getDataStream().getIndices().get(0).getName());
+        assertEquals(1, dataStreamInfos.get(2).getDataStream().getIndices().size());
+        assertEquals(fsBackingIndexName, dataStreamInfos.get(2).getDataStream().getIndices().get(0).getName());
+        assertEquals(1, dataStreamInfos.get(2).getDataStream().getFailureIndices().getIndices().size());
+        assertEquals(fsFailureIndexName, dataStreamInfos.get(2).getDataStream().getFailureIndices().getIndices().get(0).getName());
 
         GetAliasesResponse getAliasesResponse = client.admin().indices().getAliases(new GetAliasesRequest("my-alias")).actionGet();
         assertThat(getAliasesResponse.getDataStreamAliases().keySet(), containsInAnyOrder("ds", "other-ds"));
@@ -667,19 +639,16 @@ public void testSnapshotAndRestoreIncludeAliasesFalse() throws Exception {
             assertEquals(DOCUMENT_SOURCE, hits[0].getSourceAsMap());
         });
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" })
-        ).get();
-        assertEquals(3, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(dsBackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
-        assertEquals(1, ds.getDataStreams().get(1).getDataStream().getIndices().size());
-        assertEquals(otherDsBackingIndexName, ds.getDataStreams().get(1).getDataStream().getIndices().get(0).getName());
-        assertEquals(1, ds.getDataStreams().get(2).getDataStream().getIndices().size());
-        assertEquals(fsBackingIndexName, ds.getDataStreams().get(2).getDataStream().getIndices().get(0).getName());
-        assertEquals(1, ds.getDataStreams().get(2).getDataStream().getIndices().size());
-        assertEquals(fsFailureIndexName, ds.getDataStreams().get(2).getDataStream().getFailureIndices().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("*");
+        assertEquals(3, dataStreamInfos.size());
+        assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+        assertEquals(dsBackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
+        assertEquals(1, dataStreamInfos.get(1).getDataStream().getIndices().size());
+        assertEquals(otherDsBackingIndexName, dataStreamInfos.get(1).getDataStream().getIndices().get(0).getName());
+        assertEquals(1, dataStreamInfos.get(2).getDataStream().getIndices().size());
+        assertEquals(fsBackingIndexName, dataStreamInfos.get(2).getDataStream().getIndices().get(0).getName());
+        assertEquals(1, dataStreamInfos.get(2).getDataStream().getIndices().size());
+        assertEquals(fsFailureIndexName, dataStreamInfos.get(2).getDataStream().getFailureIndices().getIndices().get(0).getName());
 
         GetAliasesResponse getAliasesResponse = client.admin().indices().getAliases(new GetAliasesRequest("*")).actionGet();
         assertThat(getAliasesResponse.getDataStreamAliases(), anEmptyMap());
@@ -721,13 +690,10 @@ public void testRename() throws Exception {
             .setRenameReplacement("ds2")
             .get();
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds2" })
-        ).get();
-        assertEquals(1, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(ds2BackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("ds2");
+        assertEquals(1, dataStreamInfos.size());
+        assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+        assertEquals(ds2BackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
         assertResponse(
             client.prepareSearch("ds2"),
             response -> assertEquals(DOCUMENT_SOURCE, response.getHits().getHits()[0].getSourceAsMap())
@@ -779,13 +745,10 @@ public void testRenameWriteDataStream() throws Exception {
             .setRenameReplacement("other-ds2")
             .get();
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "other-ds2" })
-        ).get();
-        assertEquals(1, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(otherDs2BackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("other-ds2");
+        assertEquals(1, dataStreamInfos.size());
+        assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+        assertEquals(otherDs2BackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
 
         GetAliasesResponse getAliasesResponse = client.admin().indices().getAliases(new GetAliasesRequest("my-alias")).actionGet();
         assertThat(getAliasesResponse.getDataStreamAliases().keySet(), containsInAnyOrder("ds", "other-ds", "other-ds2"));
@@ -849,9 +812,8 @@ public void testBackingIndexIsNotRenamedWhenRestoringDataStream() {
 
         assertThat(restoreSnapshotResponse.status(), is(RestStatus.OK));
 
-        GetDataStreamAction.Request getDSRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds" });
-        GetDataStreamAction.Response response = client.execute(GetDataStreamAction.INSTANCE, getDSRequest).actionGet();
-        assertThat(response.getDataStreams().get(0).getDataStream().getIndices().get(0).getName(), is(dsBackingIndexName));
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("ds");
+        assertThat(dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName(), is(dsBackingIndexName));
     }
 
     public void testDataStreamAndBackingIndicesAreRenamedUsingRegex() {
@@ -888,17 +850,15 @@ public void testDataStreamAndBackingIndicesAreRenamedUsingRegex() {
         assertThat(restoreSnapshotResponse.status(), is(RestStatus.OK));
 
         // assert "ds" was restored as "test-ds" and the backing index has a valid name
-        GetDataStreamAction.Request getRenamedDS = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "test-ds" });
-        GetDataStreamAction.Response response = client.execute(GetDataStreamAction.INSTANCE, getRenamedDS).actionGet();
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("test-ds");
         assertThat(
-            response.getDataStreams().get(0).getDataStream().getIndices().get(0).getName(),
+            dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName(),
             is(DataStream.getDefaultBackingIndexName("test-ds", 1L))
         );
 
         // data stream "ds" should still exist in the system
-        GetDataStreamAction.Request getDSRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds" });
-        response = client.execute(GetDataStreamAction.INSTANCE, getDSRequest).actionGet();
-        assertThat(response.getDataStreams().get(0).getDataStream().getIndices().get(0).getName(), is(dsBackingIndexName));
+        dataStreamInfos = getDataStreamInfo("ds");
+        assertThat(dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName(), is(dsBackingIndexName));
     }
 
     public void testWildcards() throws Exception {
@@ -924,16 +884,13 @@ public void testWildcards() throws Exception {
 
         assertEquals(RestStatus.OK, restoreSnapshotResponse.status());
 
-        GetDataStreamAction.Response ds = client.execute(
-            GetDataStreamAction.INSTANCE,
-            new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "ds2" })
-        ).get();
-        assertEquals(1, ds.getDataStreams().size());
-        assertEquals(1, ds.getDataStreams().get(0).getDataStream().getIndices().size());
-        assertEquals(ds2BackingIndexName, ds.getDataStreams().get(0).getDataStream().getIndices().get(0).getName());
+        List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = getDataStreamInfo("ds2");
+        assertEquals(1, dataStreamInfos.size());
+        assertEquals(1, dataStreamInfos.get(0).getDataStream().getIndices().size());
+        assertEquals(ds2BackingIndexName, dataStreamInfos.get(0).getDataStream().getIndices().get(0).getName());
         assertThat(
             "we renamed the restored data stream to one that doesn't match any existing composable template",
-            ds.getDataStreams().get(0).getIndexTemplate(),
+            dataStreamInfos.get(0).getIndexTemplate(),
             is(nullValue())
         );
     }
@@ -955,7 +912,7 @@ public void testDataStreamNotStoredWhenIndexRequested() {
         );
     }
 
-    public void testDataStreamNotRestoredWhenIndexRequested() throws Exception {
+    public void testDataStreamNotRestoredWhenIndexRequested() {
         CreateSnapshotResponse createSnapshotResponse = client.admin()
             .cluster()
             .prepareCreateSnapshot(TEST_REQUEST_TIMEOUT, REPO, "snap2")
@@ -984,7 +941,7 @@ public void testDataStreamNotRestoredWhenIndexRequested() throws Exception {
         expectThrows(ResourceNotFoundException.class, client.execute(GetDataStreamAction.INSTANCE, getRequest));
     }
 
-    public void testDataStreamNotIncludedInLimitedSnapshot() throws ExecutionException, InterruptedException {
+    public void testDataStreamNotIncludedInLimitedSnapshot() {
         final String snapshotName = "test-snap";
         CreateSnapshotResponse createSnapshotResponse = client.admin()
             .cluster()
@@ -1042,12 +999,7 @@ public void testDeleteDataStreamDuringSnapshot() throws Exception {
         assertDocCount(dataStream, 100L);
         // Resolve backing index name after the data stream has been created because it has a date component,
         // and running around midnight could lead to test failures otherwise
-        GetDataStreamAction.Request getDataStreamRequest = new GetDataStreamAction.Request(
-            TEST_REQUEST_TIMEOUT,
-            new String[] { dataStream }
-        );
-        GetDataStreamAction.Response getDataStreamResponse = client.execute(GetDataStreamAction.INSTANCE, getDataStreamRequest).actionGet();
-        String backingIndexName = getDataStreamResponse.getDataStreams().get(0).getDataStream().getIndices().get(0).getName();
+        String backingIndexName = getDataStreamInfo(dataStream).get(0).getDataStream().getIndices().get(0).getName();
 
         logger.info("--> snapshot");
         ActionFuture<CreateSnapshotResponse> future = client1.admin()
@@ -1235,7 +1187,7 @@ public void testSnapshotDSDuringRolloverAndDeleteOldIndex() throws Exception {
         assertEquals(restoreSnapshotResponse.failedShards(), 0);
     }
 
-    public void testExcludeDSFromSnapshotWhenExcludingItsIndices() {
+    public void testExcludeDSFromSnapshotWhenExcludingAnyOfItsIndices() {
         final String snapshot = "test-snapshot";
         final String indexWithoutDataStream = "test-idx-no-ds";
         createIndexWithContent(indexWithoutDataStream);
@@ -1251,10 +1203,47 @@ public void testExcludeDSFromSnapshotWhenExcludingItsIndices() {
             .getRestoreInfo();
         assertThat(restoreInfo.failedShards(), is(0));
         assertThat(restoreInfo.successfulShards(), is(1));
+
+        // Exclude only failure store indices
+        {
+            String dataStreamName = "with-fs";
+            CreateSnapshotResponse createSnapshotResponse = client.admin()
+                .cluster()
+                .prepareCreateSnapshot(TEST_REQUEST_TIMEOUT, REPO, SNAPSHOT)
+                .setWaitForCompletion(true)
+                .setIndices(dataStreamName + "*", "-.fs*")
+                .setIncludeGlobalState(false)
+                .get();
+
+            RestStatus status = createSnapshotResponse.getSnapshotInfo().status();
+            assertEquals(RestStatus.OK, status);
+
+            SnapshotInfo retrievedSnapshot = getSnapshot(REPO, SNAPSHOT);
+            assertThat(retrievedSnapshot.dataStreams(), contains(dataStreamName));
+            assertThat(retrievedSnapshot.indices(), containsInAnyOrder(fsBackingIndexName));
+
+            assertAcked(
+                safeGet(client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, "*")))
+            );
+
+            RestoreInfo restoreSnapshotResponse = clusterAdmin().prepareRestoreSnapshot(TEST_REQUEST_TIMEOUT, REPO, SNAPSHOT)
+                .setWaitForCompletion(true)
+                .setIndices(dataStreamName)
+                .get()
+                .getRestoreInfo();
+
+            assertThat(restoreSnapshotResponse, notNullValue());
+            assertThat(restoreSnapshotResponse.successfulShards(), equalTo(restoreSnapshotResponse.totalShards()));
+            assertThat(restoreSnapshotResponse.failedShards(), is(0));
+
+            GetDataStreamAction.Response.DataStreamInfo dataStream = getDataStreamInfo(dataStreamName).getFirst();
+            assertThat(dataStream.getDataStream().getBackingIndices().getIndices(), not(empty()));
+            assertThat(dataStream.getDataStream().getFailureIndices().getIndices(), empty());
+        }
     }
 
     /**
-     * This test is a copy of the {@link #testExcludeDSFromSnapshotWhenExcludingItsIndices()} the only difference
+     * This test is a copy of the {@link #testExcludeDSFromSnapshotWhenExcludingAnyOfItsIndices()} ()} the only difference
      * is that one include the global state and one doesn't. In general this shouldn't matter that's why it used to be
      * a random parameter of the test, but because of #107515 it fails when we include the global state. Keep them
      * separate until this is fixed.
@@ -1284,10 +1273,7 @@ public void testRestoreSnapshotFully() throws Exception {
         createIndexWithContent(indexName);
         createFullSnapshot(REPO, snapshotName);
 
-        assertAcked(
-            client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" }))
-                .get()
-        );
+        assertAcked(client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, "*")).get());
         assertAcked(client.admin().indices().prepareDelete("*").setIndicesOptions(IndicesOptions.lenientExpandOpenHidden()).get());
 
         RestoreSnapshotResponse restoreSnapshotResponse = client.admin()
@@ -1297,8 +1283,7 @@ public void testRestoreSnapshotFully() throws Exception {
             .get();
         assertEquals(RestStatus.OK, restoreSnapshotResponse.status());
 
-        GetDataStreamAction.Request getRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, new String[] { "*" });
-        assertThat(client.execute(GetDataStreamAction.INSTANCE, getRequest).get().getDataStreams(), hasSize(3));
+        assertThat(getDataStreamInfo("*"), hasSize(3));
         assertNotNull(client.admin().indices().prepareGetIndex().setIndices(indexName).get());
     }
 
@@ -1326,7 +1311,7 @@ public void testRestoreDataStreamAliasWithConflictingDataStream() throws Excepti
         }
     }
 
-    public void testRestoreDataStreamAliasWithConflictingIndicesAlias() throws Exception {
+    public void testRestoreDataStreamAliasWithConflictingIndicesAlias() {
         var snapshotName = "test-snapshot";
         createFullSnapshot(REPO, snapshotName);
         client.execute(DeleteDataStreamAction.INSTANCE, new DeleteDataStreamAction.Request(TEST_REQUEST_TIMEOUT, "*")).actionGet();
@@ -1484,4 +1469,8 @@ public void testWarningHeaderOnRestoreTemplateFromSnapshot() throws Exception {
 
     }
 
+    protected List<GetDataStreamAction.Response.DataStreamInfo> getDataStreamInfo(String... dataStreamNames) {
+        GetDataStreamAction.Request getRequest = new GetDataStreamAction.Request(TEST_REQUEST_TIMEOUT, dataStreamNames);
+        return safeGet(client.execute(GetDataStreamAction.INSTANCE, getRequest)).getDataStreams();
+    }
 }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java b/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java
index 7745ec9cc75b2..db602ef6ef291 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java
@@ -49,7 +49,6 @@
 import java.time.Instant;
 import java.time.temporal.ChronoUnit;
 import java.util.ArrayList;
-import java.util.Collection;
 import java.util.Comparator;
 import java.util.HashMap;
 import java.util.List;
@@ -794,27 +793,57 @@ public DataStream promoteDataStream() {
 
     /**
      * Reconciles this data stream with a list of indices available in a snapshot. Allows snapshots to store accurate data
-     * stream definitions that do not reference backing indices not contained in the snapshot.
+     * stream definitions that do not reference backing indices and failure indices not contained in the snapshot.
      *
      * @param indicesInSnapshot List of indices in the snapshot
+     * @param snapshotMetadataBuilder a metadata builder with the current view of the snapshot metadata
      * @return Reconciled {@link DataStream} instance or {@code null} if no reconciled version of this data stream could be built from the
      *         given indices
      */
     @Nullable
-    public DataStream snapshot(Collection<String> indicesInSnapshot) {
+    public DataStream snapshot(Set<String> indicesInSnapshot, Metadata.Builder snapshotMetadataBuilder) {
+        boolean backingIndicesChanged = false;
+        boolean failureIndicesChanged = false;
+
         // do not include indices not available in the snapshot
-        List<Index> reconciledIndices = new ArrayList<>(this.backingIndices.indices);
-        if (reconciledIndices.removeIf(x -> indicesInSnapshot.contains(x.getName()) == false) == false) {
+        List<Index> reconciledBackingIndices = this.backingIndices.indices;
+        if (isAnyIndexMissing(this.backingIndices.getIndices(), snapshotMetadataBuilder, indicesInSnapshot)) {
+            reconciledBackingIndices = new ArrayList<>(this.backingIndices.indices);
+            backingIndicesChanged = reconciledBackingIndices.removeIf(x -> indicesInSnapshot.contains(x.getName()) == false);
+            if (reconciledBackingIndices.isEmpty()) {
+                return null;
+            }
+        }
+
+        List<Index> reconciledFailureIndices = this.failureIndices.indices;
+        if (DataStream.isFailureStoreFeatureFlagEnabled()
+            && isAnyIndexMissing(failureIndices.indices, snapshotMetadataBuilder, indicesInSnapshot)) {
+            reconciledFailureIndices = new ArrayList<>(this.failureIndices.indices);
+            failureIndicesChanged = reconciledFailureIndices.removeIf(x -> indicesInSnapshot.contains(x.getName()) == false);
+        }
+
+        if (backingIndicesChanged == false && failureIndicesChanged == false) {
             return this;
         }
 
-        if (reconciledIndices.size() == 0) {
-            return null;
+        Builder builder = copy();
+        if (backingIndicesChanged) {
+            builder.setBackingIndices(backingIndices.copy().setIndices(reconciledBackingIndices).build());
+        }
+        if (failureIndicesChanged) {
+            builder.setFailureIndices(failureIndices.copy().setIndices(reconciledFailureIndices).build());
         }
+        return builder.setMetadata(metadata == null ? null : new HashMap<>(metadata)).build();
+    }
 
-        return copy().setBackingIndices(backingIndices.copy().setIndices(reconciledIndices).build())
-            .setMetadata(metadata == null ? null : new HashMap<>(metadata))
-            .build();
+    private static boolean isAnyIndexMissing(List<Index> indices, Metadata.Builder builder, Set<String> indicesInSnapshot) {
+        for (Index index : indices) {
+            final String indexName = index.getName();
+            if (builder.get(indexName) == null || indicesInSnapshot.contains(indexName) == false) {
+                return true;
+            }
+        }
+        return false;
     }
 
     /**
diff --git a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
index 8d526f3e114e1..6f690a9e6ccd5 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/SnapshotsService.java
@@ -786,15 +786,7 @@ private static Metadata metadataForSnapshot(SnapshotsInProgress.Entry snapshot,
                 assert snapshot.partial()
                     : "Data stream [" + dataStreamName + "] was deleted during a snapshot but snapshot was not partial.";
             } else {
-                boolean missingIndex = false;
-                for (Index index : dataStream.getIndices()) {
-                    final String indexName = index.getName();
-                    if (builder.get(indexName) == null || indicesInSnapshot.contains(indexName) == false) {
-                        missingIndex = true;
-                        break;
-                    }
-                }
-                final DataStream reconciled = missingIndex ? dataStream.snapshot(indicesInSnapshot) : dataStream;
+                final DataStream reconciled = dataStream.snapshot(indicesInSnapshot, builder);
                 if (reconciled != null) {
                     dataStreams.put(dataStreamName, reconciled);
                 }
diff --git a/server/src/test/java/org/elasticsearch/cluster/metadata/DataStreamTests.java b/server/src/test/java/org/elasticsearch/cluster/metadata/DataStreamTests.java
index 7108a4fd4f19e..cfdcfe48c8d9a 100644
--- a/server/src/test/java/org/elasticsearch/cluster/metadata/DataStreamTests.java
+++ b/server/src/test/java/org/elasticsearch/cluster/metadata/DataStreamTests.java
@@ -45,8 +45,10 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
+import java.util.Set;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Predicate;
+import java.util.stream.Collectors;
 
 import static org.elasticsearch.cluster.metadata.DataStream.getDefaultBackingIndexName;
 import static org.elasticsearch.cluster.metadata.DataStreamTestHelper.newInstance;
@@ -866,23 +868,39 @@ public void testReplaceFailureIndexThrowsExceptionIfReplacingWriteIndex() {
     }
 
     public void testSnapshot() {
-        var preSnapshotDataStream = DataStreamTestHelper.randomInstance();
-        var indicesToRemove = randomSubsetOf(preSnapshotDataStream.getIndices());
-        if (indicesToRemove.size() == preSnapshotDataStream.getIndices().size()) {
+        var preSnapshotDataStream = DataStreamTestHelper.randomInstance(true);
+
+        // Mutate backing indices
+        var backingIndicesToRemove = randomSubsetOf(preSnapshotDataStream.getIndices());
+        if (backingIndicesToRemove.size() == preSnapshotDataStream.getIndices().size()) {
             // never remove them all
-            indicesToRemove.remove(0);
+            backingIndicesToRemove.remove(0);
         }
-        var indicesToAdd = randomIndexInstances();
-        var postSnapshotIndices = new ArrayList<>(preSnapshotDataStream.getIndices());
-        postSnapshotIndices.removeAll(indicesToRemove);
-        postSnapshotIndices.addAll(indicesToAdd);
+        var backingIndicesToAdd = randomIndexInstances();
+        var postSnapshotBackingIndices = new ArrayList<>(preSnapshotDataStream.getIndices());
+        postSnapshotBackingIndices.removeAll(backingIndicesToRemove);
+        postSnapshotBackingIndices.addAll(backingIndicesToAdd);
+
+        // Mutate failure indices
+        var failureIndicesToRemove = randomSubsetOf(preSnapshotDataStream.getFailureIndices().getIndices());
+        var failureIndicesToAdd = randomIndexInstances();
+        var postSnapshotFailureIndices = new ArrayList<>(preSnapshotDataStream.getFailureIndices().getIndices());
+        postSnapshotFailureIndices.removeAll(failureIndicesToRemove);
+        postSnapshotFailureIndices.addAll(failureIndicesToAdd);
 
         var replicated = preSnapshotDataStream.isReplicated() && randomBoolean();
         var postSnapshotDataStream = preSnapshotDataStream.copy()
             .setBackingIndices(
                 preSnapshotDataStream.getBackingIndices()
                     .copy()
-                    .setIndices(postSnapshotIndices)
+                    .setIndices(postSnapshotBackingIndices)
+                    .setRolloverOnWrite(replicated == false && preSnapshotDataStream.rolloverOnWrite())
+                    .build()
+            )
+            .setFailureIndices(
+                preSnapshotDataStream.getFailureIndices()
+                    .copy()
+                    .setIndices(postSnapshotFailureIndices)
                     .setRolloverOnWrite(replicated == false && preSnapshotDataStream.rolloverOnWrite())
                     .build()
             )
@@ -891,9 +909,10 @@ public void testSnapshot() {
             .setReplicated(replicated)
             .build();
 
-        var reconciledDataStream = postSnapshotDataStream.snapshot(
-            preSnapshotDataStream.getIndices().stream().map(Index::getName).toList()
-        );
+        Set<String> indicesInSnapshot = new HashSet<>();
+        preSnapshotDataStream.getIndices().forEach(index -> indicesInSnapshot.add(index.getName()));
+        preSnapshotDataStream.getFailureIndices().getIndices().forEach(index -> indicesInSnapshot.add(index.getName()));
+        var reconciledDataStream = postSnapshotDataStream.snapshot(indicesInSnapshot, Metadata.builder());
 
         assertThat(reconciledDataStream.getName(), equalTo(postSnapshotDataStream.getName()));
         assertThat(reconciledDataStream.getGeneration(), equalTo(postSnapshotDataStream.getGeneration()));
@@ -907,9 +926,19 @@ public void testSnapshot() {
         }
         assertThat(reconciledDataStream.isHidden(), equalTo(postSnapshotDataStream.isHidden()));
         assertThat(reconciledDataStream.isReplicated(), equalTo(postSnapshotDataStream.isReplicated()));
-        assertThat(reconciledDataStream.getIndices(), everyItem(not(in(indicesToRemove))));
-        assertThat(reconciledDataStream.getIndices(), everyItem(not(in(indicesToAdd))));
-        assertThat(reconciledDataStream.getIndices().size(), equalTo(preSnapshotDataStream.getIndices().size() - indicesToRemove.size()));
+        assertThat(reconciledDataStream.getIndices(), everyItem(not(in(backingIndicesToRemove))));
+        assertThat(reconciledDataStream.getIndices(), everyItem(not(in(backingIndicesToAdd))));
+        assertThat(
+            reconciledDataStream.getIndices().size(),
+            equalTo(preSnapshotDataStream.getIndices().size() - backingIndicesToRemove.size())
+        );
+        var reconciledFailureIndices = reconciledDataStream.getFailureIndices().getIndices();
+        assertThat(reconciledFailureIndices, everyItem(not(in(failureIndicesToRemove))));
+        assertThat(reconciledFailureIndices, everyItem(not(in(failureIndicesToAdd))));
+        assertThat(
+            reconciledFailureIndices.size(),
+            equalTo(preSnapshotDataStream.getFailureIndices().getIndices().size() - failureIndicesToRemove.size())
+        );
     }
 
     public void testSnapshotWithAllBackingIndicesRemoved() {
@@ -920,7 +949,12 @@ public void testSnapshotWithAllBackingIndicesRemoved() {
             .setBackingIndices(preSnapshotDataStream.getBackingIndices().copy().setIndices(indicesToAdd).build())
             .build();
 
-        assertNull(postSnapshotDataStream.snapshot(preSnapshotDataStream.getIndices().stream().map(Index::getName).toList()));
+        assertNull(
+            postSnapshotDataStream.snapshot(
+                preSnapshotDataStream.getIndices().stream().map(Index::getName).collect(Collectors.toSet()),
+                Metadata.builder()
+            )
+        );
     }
 
     public void testSelectTimeSeriesWriteIndex() {

From 78bd9ec6f082e67199bd1df742c72325b2169e2c Mon Sep 17 00:00:00 2001
From: kosabogi <105062005+kosabogi@users.noreply.github.com>
Date: Thu, 19 Dec 2024 11:43:34 +0100
Subject: [PATCH 118/119] [DOCS] Updates SharePoint Online page (#118318)

---
 .../connectors-sharepoint-online.asciidoc     | 105 ++++++++++++++++++
 1 file changed, 105 insertions(+)

diff --git a/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc b/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc
index 02f598c16f63c..2680e3ff840a6 100644
--- a/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc
+++ b/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc
@@ -133,6 +133,58 @@ The application name will appear in the Title box.
 </AppPermissionRequests>
 ----
 
+[discrete#es-connectors-sharepoint-online-sites-selected-permissions]
+====== Granting `Sites.Selected` permissions
+
+To configure `Sites.Selected` permissions, follow these steps in the Azure Active Directory portal. These permissions enable precise access control to specific SharePoint sites.
+
+. Sign in to the https://portal.azure.com/[Azure Active Directory portal^].
+. Navigate to **App registrations** and locate the application created for the connector.
+. Under **API permissions**, click **Add permission**.
+. Select **Microsoft Graph** > **Application permissions**, then add `Sites.Selected`.
+. Click **Grant admin consent** to approve the permission.
+
+[TIP]
+====
+Refer to the official https://learn.microsoft.com/en-us/graph/permissions-reference[Microsoft documentation] for managing permissions in Azure AD.
+====
+
+To assign access to specific SharePoint sites using `Sites.Selected`:
+
+. Use Microsoft Graph Explorer or PowerShell to grant access.
+. To fetch the site ID, run the following Graph API query:
++
+[source, http]
+----
+GET https://graph.microsoft.com/v1.0/sites?select=webUrl,Title,Id&$search="<Name of the site>*"
+----
++
+This will return the `id` of the site.
+
+. Use the `id` to assign read or write access:
++
+[source, http]
+----
+POST https://graph.microsoft.com/v1.0/sites/<siteId>/permissions
+{
+    "roles": ["read"], // or "write"
+    "grantedToIdentities": [
+        {
+            "application": {
+                "id": "<App_Client_ID>",
+                "displayName": "<App_Display_Name>"
+            }
+        }
+    ]
+}
+----
+
+[NOTE]
+====
+When using the `Comma-separated list of sites` configuration field, ensure the sites specified match those granted `Sites.Selected` permission in SharePoint.
+If the `Comma-separated list of sites` field is set to `*` or the `Enumerate all sites` toggle is enabled, the connector will attempt to access all sites. This requires broader permissions, which are not supported with `Sites.Selected`.
+====
+
 .Graph API permissions
 ****
 Microsoft recommends using Graph API for all operations with Sharepoint Online. Graph API is well-documented and more efficient at fetching data, which helps avoid throttling.
@@ -594,6 +646,59 @@ The application name will appear in the Title box.
 </AppPermissionRequests>
 ----
 
+[discrete#es-connectors-sharepoint-online-sites-selected-permissions-self-managed]
+====== Granting `Sites.Selected` permissions
+
+To configure `Sites.Selected` permissions, follow these steps in the Azure Active Directory portal. These permissions enable precise access control to specific SharePoint sites.
+
+. Sign in to the https://portal.azure.com/[Azure Active Directory portal^].
+. Navigate to **App registrations** and locate the application created for the connector.
+. Under **API permissions**, click **Add permission**.
+. Select **Microsoft Graph** > **Application permissions**, then add `Sites.Selected`.
+. Click **Grant admin consent** to approve the permission.
+
+[TIP]
+====
+Refer to the official https://learn.microsoft.com/en-us/graph/permissions-reference[Microsoft documentation] for managing permissions in Azure AD.
+====
+
+
+To assign access to specific SharePoint sites using `Sites.Selected`:
+
+. Use Microsoft Graph Explorer or PowerShell to grant access.
+. To fetch the site ID, run the following Graph API query:
++
+[source, http]
+----
+GET https://graph.microsoft.com/v1.0/sites?select=webUrl,Title,Id&$search="<Name of the site>*"
+----
++
+This will return the `id` of the site.
+
+. Use the `id` to assign read or write access:
++
+[source, http]
+----
+POST https://graph.microsoft.com/v1.0/sites/<siteId>/permissions
+{
+    "roles": ["read"], // or "write"
+    "grantedToIdentities": [
+        {
+            "application": {
+                "id": "<App_Client_ID>",
+                "displayName": "<App_Display_Name>"
+            }
+        }
+    ]
+}
+----
+
+[NOTE]
+====
+When using the `Comma-separated list of sites` configuration field, ensure the sites specified match those granted `Sites.Selected` permission in SharePoint.
+If the `Comma-separated list of sites` field is set to `*` or the `Enumerate all sites` toggle is enabled, the connector will attempt to access all sites. This requires broader permissions, which are not supported with `Sites.Selected`.
+====
+
 .Graph API permissions
 ****
 Microsoft recommends using Graph API for all operations with Sharepoint Online. Graph API is well-documented and more efficient at fetching data, which helps avoid throttling.

From 54879278b1c15ed5fd7fac2f22b6cc852326a143 Mon Sep 17 00:00:00 2001
From: Luke Whiting <luke.whiting@elastic.co>
Date: Thu, 19 Dec 2024 11:40:09 +0000
Subject: [PATCH 119/119] Update data stream deprecations warnings to new
 format and filter searchable snapshots from response (#118562)

* Update data stream deprecations warnings to new format

* Add reindex_required flag to index version deprecation notice response

* PR Changes

* Move all deprecation checks to use a shared predicate which also excludes snapshots

* Update docs/changelog/118562.yaml

* Tests for excluding snapshots

* PR Changes - Remove leftover comment
---
 docs/changelog/118562.yaml                    |  6 ++
 .../deprecation/DeprecatedIndexPredicate.java | 47 ++++++++++++
 .../DataStreamDeprecationChecks.java          | 58 +++++---------
 .../deprecation/IndexDeprecationChecks.java   |  9 ++-
 .../DataStreamDeprecationChecksTests.java     | 76 +++++++++----------
 .../IndexDeprecationChecksTests.java          | 24 +++++-
 .../action/ReindexDataStreamAction.java       | 18 -----
 ...ReindexDataStreamIndexTransportAction.java |  5 +-
 .../ReindexDataStreamTransportAction.java     |  4 +-
 ...indexDataStreamPersistentTaskExecutor.java |  6 +-
 10 files changed, 138 insertions(+), 115 deletions(-)
 create mode 100644 docs/changelog/118562.yaml
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/deprecation/DeprecatedIndexPredicate.java

diff --git a/docs/changelog/118562.yaml b/docs/changelog/118562.yaml
new file mode 100644
index 0000000000000..a6b00b326151f
--- /dev/null
+++ b/docs/changelog/118562.yaml
@@ -0,0 +1,6 @@
+pr: 118562
+summary: Update data stream deprecations warnings to new format and filter searchable
+  snapshots from response
+area: Data streams
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/deprecation/DeprecatedIndexPredicate.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/deprecation/DeprecatedIndexPredicate.java
new file mode 100644
index 0000000000000..024d24fdf5151
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/deprecation/DeprecatedIndexPredicate.java
@@ -0,0 +1,47 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.core.deprecation;
+
+import org.elasticsearch.cluster.metadata.IndexMetadata;
+import org.elasticsearch.cluster.metadata.Metadata;
+import org.elasticsearch.index.Index;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.IndexVersions;
+
+import java.util.function.Predicate;
+
+public class DeprecatedIndexPredicate {
+
+    public static final IndexVersion MINIMUM_WRITEABLE_VERSION_AFTER_UPGRADE = IndexVersions.UPGRADE_TO_LUCENE_10_0_0;
+
+    /*
+     * This predicate allows through only indices that were created with a previous lucene version, meaning that they need to be reindexed
+     * in order to be writable in the _next_ lucene version.
+     *
+     * It ignores searchable snapshots as they are not writable.
+     */
+    public static Predicate<Index> getReindexRequiredPredicate(Metadata metadata) {
+        return index -> {
+            IndexMetadata indexMetadata = metadata.index(index);
+            return reindexRequired(indexMetadata);
+        };
+    }
+
+    public static boolean reindexRequired(IndexMetadata indexMetadata) {
+        return creationVersionBeforeMinimumWritableVersion(indexMetadata) && isNotSearchableSnapshot(indexMetadata);
+    }
+
+    private static boolean isNotSearchableSnapshot(IndexMetadata indexMetadata) {
+        return indexMetadata.isSearchableSnapshot() == false;
+    }
+
+    private static boolean creationVersionBeforeMinimumWritableVersion(IndexMetadata metadata) {
+        return metadata.getCreationVersion().before(MINIMUM_WRITEABLE_VERSION_AFTER_UPGRADE);
+    }
+
+}
diff --git a/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecks.java b/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecks.java
index ee029d01427aa..65f2659fda04a 100644
--- a/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecks.java
+++ b/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecks.java
@@ -10,10 +10,12 @@
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.metadata.DataStream;
 import org.elasticsearch.index.Index;
-import org.elasticsearch.index.IndexVersions;
+import org.elasticsearch.xpack.core.deprecation.DeprecatedIndexPredicate;
 import org.elasticsearch.xpack.core.deprecation.DeprecationIssue;
 
 import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
 
 import static java.util.Map.entry;
 import static java.util.Map.ofEntries;
@@ -21,54 +23,28 @@
 public class DataStreamDeprecationChecks {
     static DeprecationIssue oldIndicesCheck(DataStream dataStream, ClusterState clusterState) {
         List<Index> backingIndices = dataStream.getIndices();
-        boolean hasOldIndices = backingIndices.stream()
-            .anyMatch(index -> clusterState.metadata().index(index).getCompatibilityVersion().before(IndexVersions.V_8_0_0));
-        if (hasOldIndices) {
-            long totalIndices = backingIndices.size();
-            List<Index> oldIndices = backingIndices.stream()
-                .filter(index -> clusterState.metadata().index(index).getCompatibilityVersion().before(IndexVersions.V_8_0_0))
-                .toList();
-            long totalOldIndices = oldIndices.size();
-            long totalOldSearchableSnapshots = oldIndices.stream()
-                .filter(index -> clusterState.metadata().index(index).isSearchableSnapshot())
-                .count();
-            long totalOldPartiallyMountedSearchableSnapshots = oldIndices.stream()
-                .filter(index -> clusterState.metadata().index(index).isPartialSearchableSnapshot())
-                .count();
-            long totalOldFullyMountedSearchableSnapshots = totalOldSearchableSnapshots - totalOldPartiallyMountedSearchableSnapshots;
+
+        Set<String> indicesNeedingUpgrade = backingIndices.stream()
+            .filter(DeprecatedIndexPredicate.getReindexRequiredPredicate(clusterState.metadata()))
+            .map(Index::getName)
+            .collect(Collectors.toUnmodifiableSet());
+
+        if (indicesNeedingUpgrade.isEmpty() == false) {
             return new DeprecationIssue(
                 DeprecationIssue.Level.CRITICAL,
-                "Old data stream with a compatibility version < 8.0",
+                "Old data stream with a compatibility version < 9.0",
                 "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking-changes-9.0.html",
-                "This data stream has backing indices that were created before Elasticsearch 8.0.0",
+                "This data stream has backing indices that were created before Elasticsearch 9.0.0",
                 false,
                 ofEntries(
-                    entry(
-                        "backing_indices",
-                        ofEntries(
-                            entry("count", totalIndices),
-                            entry(
-                                "need_upgrading",
-                                ofEntries(
-                                    entry("count", totalOldIndices),
-                                    entry(
-                                        "searchable_snapshots",
-                                        ofEntries(
-                                            entry("count", totalOldSearchableSnapshots),
-                                            entry("fully_mounted", ofEntries(entry("count", totalOldFullyMountedSearchableSnapshots))),
-                                            entry(
-                                                "partially_mounted",
-                                                ofEntries(entry("count", totalOldPartiallyMountedSearchableSnapshots))
-                                            )
-                                        )
-                                    )
-                                )
-                            )
-                        )
-                    )
+                    entry("reindex_required", true),
+                    entry("total_backing_indices", backingIndices.size()),
+                    entry("indices_requiring_upgrade_count", indicesNeedingUpgrade.size()),
+                    entry("indices_requiring_upgrade", indicesNeedingUpgrade)
                 )
             );
         }
+
         return null;
     }
 }
diff --git a/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecks.java b/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecks.java
index aaf58a44a6565..de06e270a867e 100644
--- a/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecks.java
+++ b/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecks.java
@@ -14,12 +14,13 @@
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.IndexVersion;
-import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.engine.frozen.FrozenEngine;
 import org.elasticsearch.index.mapper.SourceFieldMapper;
+import org.elasticsearch.xpack.core.deprecation.DeprecatedIndexPredicate;
 import org.elasticsearch.xpack.core.deprecation.DeprecationIssue;
 
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
@@ -36,14 +37,14 @@ static DeprecationIssue oldIndicesCheck(IndexMetadata indexMetadata, ClusterStat
         // TODO: this check needs to be revised. It's trivially true right now.
         IndexVersion currentCompatibilityVersion = indexMetadata.getCompatibilityVersion();
         // We intentionally exclude indices that are in data streams because they will be picked up by DataStreamDeprecationChecks
-        if (currentCompatibilityVersion.before(IndexVersions.V_8_0_0) && isNotDataStreamIndex(indexMetadata, clusterState)) {
+        if (DeprecatedIndexPredicate.reindexRequired(indexMetadata) && isNotDataStreamIndex(indexMetadata, clusterState)) {
             return new DeprecationIssue(
                 DeprecationIssue.Level.CRITICAL,
-                "Old index with a compatibility version < 8.0",
+                "Old index with a compatibility version < 9.0",
                 "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking-changes-9.0.html",
                 "This index has version: " + currentCompatibilityVersion.toReleaseVersion(),
                 false,
-                null
+                Collections.singletonMap("reindex_required", true)
             );
         }
         return null;
diff --git a/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecksTests.java b/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecksTests.java
index d5325fb0ff3a4..b297cc1a5bdf8 100644
--- a/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecksTests.java
+++ b/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/DataStreamDeprecationChecksTests.java
@@ -17,41 +17,46 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexMode;
 import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.snapshots.SearchableSnapshotsSettings;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.deprecation.DeprecationIssue;
 
 import java.util.ArrayList;
 import java.util.HashMap;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 import static java.util.Collections.singletonList;
+import static java.util.Map.entry;
+import static java.util.Map.ofEntries;
+import static org.elasticsearch.index.IndexModule.INDEX_STORE_TYPE_SETTING;
 import static org.elasticsearch.xpack.deprecation.DeprecationChecks.DATA_STREAM_CHECKS;
 import static org.hamcrest.Matchers.equalTo;
 
 public class DataStreamDeprecationChecksTests extends ESTestCase {
 
     public void testOldIndicesCheck() {
-        long oldIndexCount = randomIntBetween(1, 100);
-        long newIndexCount = randomIntBetween(1, 100);
-        long oldSearchableSnapshotCount = 0;
-        long oldFullyManagedSearchableSnapshotCount = 0;
-        long oldPartiallyManagedSearchableSnapshotCount = 0;
+        int oldIndexCount = randomIntBetween(1, 100);
+        int newIndexCount = randomIntBetween(1, 100);
+
         List<Index> allIndices = new ArrayList<>();
         Map<String, IndexMetadata> nameToIndexMetadata = new HashMap<>();
+        Set<String> expectedIndices = new HashSet<>();
+
         for (int i = 0; i < oldIndexCount; i++) {
-            Settings.Builder settingsBuilder = settings(IndexVersion.fromId(7170099));
-            if (randomBoolean()) {
-                settingsBuilder.put("index.store.type", "snapshot");
-                if (randomBoolean()) {
-                    oldFullyManagedSearchableSnapshotCount++;
-                } else {
-                    settingsBuilder.put("index.store.snapshot.partial", true);
-                    oldPartiallyManagedSearchableSnapshotCount++;
-                }
-                oldSearchableSnapshotCount++;
+            Settings.Builder settings = settings(IndexVersion.fromId(7170099));
+
+            String indexName = "old-data-stream-index-" + i;
+            if (expectedIndices.isEmpty() == false && randomIntBetween(0, 2) == 0) {
+                settings.put(INDEX_STORE_TYPE_SETTING.getKey(), SearchableSnapshotsSettings.SEARCHABLE_SNAPSHOT_STORE_TYPE);
+            } else {
+                expectedIndices.add(indexName);
             }
-            IndexMetadata oldIndexMetadata = IndexMetadata.builder("old-data-stream-index-" + i)
+
+            Settings.Builder settingsBuilder = settings;
+            IndexMetadata oldIndexMetadata = IndexMetadata.builder(indexName)
                 .settings(settingsBuilder)
                 .numberOfShards(1)
                 .numberOfReplicas(0)
@@ -59,11 +64,9 @@ public void testOldIndicesCheck() {
             allIndices.add(oldIndexMetadata.getIndex());
             nameToIndexMetadata.put(oldIndexMetadata.getIndex().getName(), oldIndexMetadata);
         }
+
         for (int i = 0; i < newIndexCount; i++) {
             Settings.Builder settingsBuilder = settings(IndexVersion.current());
-            if (randomBoolean()) {
-                settingsBuilder.put("index.store.type", "snapshot");
-            }
             IndexMetadata newIndexMetadata = IndexMetadata.builder("new-data-stream-index-" + i)
                 .settings(settingsBuilder)
                 .numberOfShards(1)
@@ -72,6 +75,7 @@ public void testOldIndicesCheck() {
             allIndices.add(newIndexMetadata.getIndex());
             nameToIndexMetadata.put(newIndexMetadata.getIndex().getName(), newIndexMetadata);
         }
+
         DataStream dataStream = new DataStream(
             randomAlphaOfLength(10),
             allIndices,
@@ -88,37 +92,27 @@ public void testOldIndicesCheck() {
             randomBoolean(),
             null
         );
+
         Metadata metadata = Metadata.builder().indices(nameToIndexMetadata).build();
         ClusterState clusterState = ClusterState.builder(ClusterName.DEFAULT).metadata(metadata).build();
+
         DeprecationIssue expected = new DeprecationIssue(
             DeprecationIssue.Level.CRITICAL,
-            "Old data stream with a compatibility version < 8.0",
+            "Old data stream with a compatibility version < 9.0",
             "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking-changes-9.0.html",
-            "This data stream has backing indices that were created before Elasticsearch 8.0.0",
+            "This data stream has backing indices that were created before Elasticsearch 9.0.0",
             false,
-            Map.of(
-                "backing_indices",
-                Map.of(
-                    "count",
-                    oldIndexCount + newIndexCount,
-                    "need_upgrading",
-                    Map.of(
-                        "count",
-                        oldIndexCount,
-                        "searchable_snapshots",
-                        Map.of(
-                            "count",
-                            oldSearchableSnapshotCount,
-                            "fully_mounted",
-                            Map.of("count", oldFullyManagedSearchableSnapshotCount),
-                            "partially_mounted",
-                            Map.of("count", oldPartiallyManagedSearchableSnapshotCount)
-                        )
-                    )
-                )
+            ofEntries(
+                entry("reindex_required", true),
+                entry("total_backing_indices", oldIndexCount + newIndexCount),
+                entry("indices_requiring_upgrade_count", expectedIndices.size()),
+                entry("indices_requiring_upgrade", expectedIndices)
             )
         );
+
         List<DeprecationIssue> issues = DeprecationChecks.filterChecks(DATA_STREAM_CHECKS, c -> c.apply(dataStream, clusterState));
+
         assertThat(issues, equalTo(singletonList(expected)));
     }
+
 }
diff --git a/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecksTests.java b/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecksTests.java
index 48cbef6831a2b..c6f3208a1cfb0 100644
--- a/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecksTests.java
+++ b/x-pack/plugin/deprecation/src/test/java/org/elasticsearch/xpack/deprecation/IndexDeprecationChecksTests.java
@@ -19,8 +19,8 @@
 import org.elasticsearch.index.IndexModule;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.IndexVersion;
-import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.engine.frozen.FrozenEngine;
+import org.elasticsearch.snapshots.SearchableSnapshotsSettings;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.core.deprecation.DeprecationIssue;
 
@@ -29,6 +29,8 @@
 import java.util.Map;
 
 import static java.util.Collections.singletonList;
+import static java.util.Collections.singletonMap;
+import static org.elasticsearch.index.IndexModule.INDEX_STORE_TYPE_SETTING;
 import static org.elasticsearch.xpack.deprecation.DeprecationChecks.INDEX_SETTINGS_CHECKS;
 import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
@@ -48,11 +50,11 @@ public void testOldIndicesCheck() {
             .build();
         DeprecationIssue expected = new DeprecationIssue(
             DeprecationIssue.Level.CRITICAL,
-            "Old index with a compatibility version < 8.0",
+            "Old index with a compatibility version < 9.0",
             "https://www.elastic.co/guide/en/elasticsearch/reference/master/breaking-changes-9.0.html",
             "This index has version: " + createdWith.toReleaseVersion(),
             false,
-            null
+            singletonMap("reindex_required", true)
         );
         List<DeprecationIssue> issues = DeprecationChecks.filterChecks(INDEX_SETTINGS_CHECKS, c -> c.apply(indexMetadata, clusterState));
         assertEquals(singletonList(expected), issues);
@@ -100,6 +102,20 @@ public void testOldIndicesCheckDataStreamIndex() {
         assertThat(issues.size(), equalTo(0));
     }
 
+    public void testOldIndicesCheckSnapshotIgnored() {
+        IndexVersion createdWith = IndexVersion.fromId(7170099);
+        Settings.Builder settings = settings(createdWith);
+        settings.put(INDEX_STORE_TYPE_SETTING.getKey(), SearchableSnapshotsSettings.SEARCHABLE_SNAPSHOT_STORE_TYPE);
+        IndexMetadata indexMetadata = IndexMetadata.builder("test").settings(settings).numberOfShards(1).numberOfReplicas(0).build();
+        ClusterState clusterState = ClusterState.builder(ClusterState.EMPTY_STATE)
+            .metadata(Metadata.builder().put(indexMetadata, true))
+            .build();
+
+        List<DeprecationIssue> issues = DeprecationChecks.filterChecks(INDEX_SETTINGS_CHECKS, c -> c.apply(indexMetadata, clusterState));
+
+        assertThat(issues, empty());
+    }
+
     public void testTranslogRetentionSettings() {
         Settings.Builder settings = settings(IndexVersion.current());
         settings.put(IndexSettings.INDEX_TRANSLOG_RETENTION_AGE_SETTING.getKey(), randomPositiveTimeValue());
@@ -229,7 +245,7 @@ public void testCamelCaseDeprecation() throws IOException {
             + "} }";
 
         IndexMetadata simpleIndex = IndexMetadata.builder(randomAlphaOfLengthBetween(5, 10))
-            .settings(settings(IndexVersions.MINIMUM_COMPATIBLE))
+            .settings(settings(IndexVersion.current()))
             .numberOfShards(1)
             .numberOfReplicas(1)
             .putMapping(simpleMapping)
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java
index b10bea9e54230..9e4cbb1082215 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java
@@ -13,14 +13,10 @@
 import org.elasticsearch.action.ActionType;
 import org.elasticsearch.action.IndicesRequest;
 import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.cluster.metadata.Metadata;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.util.FeatureFlag;
 import org.elasticsearch.features.NodeFeature;
-import org.elasticsearch.index.Index;
-import org.elasticsearch.index.IndexVersion;
-import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.xcontent.ConstructingObjectParser;
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xcontent.ToXContent;
@@ -43,24 +39,10 @@ public class ReindexDataStreamAction extends ActionType<ReindexDataStreamAction.
     public static final ParseField SOURCE_FIELD = new ParseField("source");
     public static final ParseField INDEX_FIELD = new ParseField("index");
 
-    /*
-     * The version before which we do not support writes in the _next_ major version of Elasticsearch. For example, Elasticsearch 10.x will
-     * not support writing to indices created before version 9.0.0.
-     */
-    public static final IndexVersion MINIMUM_WRITEABLE_VERSION_AFTER_UPGRADE = IndexVersions.UPGRADE_TO_LUCENE_10_0_0;
-
     public ReindexDataStreamAction() {
         super(NAME);
     }
 
-    /*
-     * This predicate allows through only indices that were created with a previous lucene version, meaning that they need to be reindexed
-     * in order to be writable in the _next_ lucene version.
-     */
-    public static Predicate<Index> getOldIndexVersionPredicate(Metadata metadata) {
-        return index -> metadata.index(index).getCreationVersion().onOrBefore(MINIMUM_WRITEABLE_VERSION_AFTER_UPGRADE);
-    }
-
     public enum Mode {
         UPGRADE
     }
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
index 66b13a9ce22b0..38b5da6527039 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamIndexTransportAction.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.deprecation.DeprecatedIndexPredicate;
 
 import java.util.Locale;
 import java.util.Map;
@@ -78,13 +79,13 @@ protected void doExecute(
         IndexMetadata sourceIndex = clusterService.state().getMetadata().index(sourceIndexName);
         Settings settingsBefore = sourceIndex.getSettings();
 
-        var hasOldVersion = ReindexDataStreamAction.getOldIndexVersionPredicate(clusterService.state().metadata());
+        var hasOldVersion = DeprecatedIndexPredicate.getReindexRequiredPredicate(clusterService.state().metadata());
         if (hasOldVersion.test(sourceIndex.getIndex()) == false) {
             logger.warn(
                 "Migrating index [{}] with version [{}] is unnecessary as its version is not before [{}]",
                 sourceIndexName,
                 sourceIndex.getCreationVersion(),
-                ReindexDataStreamAction.MINIMUM_WRITEABLE_VERSION_AFTER_UPGRADE
+                DeprecatedIndexPredicate.MINIMUM_WRITEABLE_VERSION_AFTER_UPGRADE
             );
         }
 
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java
index f011c429ce79c..cc648c1984544 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java
@@ -26,8 +26,8 @@
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamTask;
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamTaskParams;
 
+import static org.elasticsearch.xpack.core.deprecation.DeprecatedIndexPredicate.getReindexRequiredPredicate;
 import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.TASK_ID_PREFIX;
-import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.getOldIndexVersionPredicate;
 
 /*
  * This transport action creates a new persistent task for reindexing the source data stream given in the request. On successful creation
@@ -68,7 +68,7 @@ protected void doExecute(Task task, ReindexDataStreamRequest request, ActionList
             return;
         }
         int totalIndices = dataStream.getIndices().size();
-        int totalIndicesToBeUpgraded = (int) dataStream.getIndices().stream().filter(getOldIndexVersionPredicate(metadata)).count();
+        int totalIndicesToBeUpgraded = (int) dataStream.getIndices().stream().filter(getReindexRequiredPredicate(metadata)).count();
         ReindexDataStreamTaskParams params = new ReindexDataStreamTaskParams(
             sourceDataStreamName,
             transportService.getThreadPool().absoluteTimeInMillis(),
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
index dc8e33bc091e6..30f64fdd1d6f6 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
@@ -35,7 +35,7 @@
 import java.util.Map;
 import java.util.NoSuchElementException;
 
-import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.getOldIndexVersionPredicate;
+import static org.elasticsearch.xpack.core.deprecation.DeprecatedIndexPredicate.getReindexRequiredPredicate;
 
 public class ReindexDataStreamPersistentTaskExecutor extends PersistentTasksExecutor<ReindexDataStreamTaskParams> {
     private static final TimeValue TASK_KEEP_ALIVE_TIME = TimeValue.timeValueDays(1);
@@ -84,7 +84,7 @@ protected void nodeOperation(AllocatedPersistentTask task, ReindexDataStreamTask
             List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = response.getDataStreams();
             if (dataStreamInfos.size() == 1) {
                 DataStream dataStream = dataStreamInfos.getFirst().getDataStream();
-                if (getOldIndexVersionPredicate(clusterService.state().metadata()).test(dataStream.getWriteIndex())) {
+                if (getReindexRequiredPredicate(clusterService.state().metadata()).test(dataStream.getWriteIndex())) {
                     reindexClient.execute(
                         RolloverAction.INSTANCE,
                         new RolloverRequest(sourceDataStream, null),
@@ -109,7 +109,7 @@ private void reindexIndices(
         String sourceDataStream
     ) {
         List<Index> indices = dataStream.getIndices();
-        List<Index> indicesToBeReindexed = indices.stream().filter(getOldIndexVersionPredicate(clusterService.state().metadata())).toList();
+        List<Index> indicesToBeReindexed = indices.stream().filter(getReindexRequiredPredicate(clusterService.state().metadata())).toList();
         reindexDataStreamTask.setPendingIndicesCount(indicesToBeReindexed.size());
         // The CountDownActionListener is 1 more than the number of indices so that the count is not 0 if we have no indices
         CountDownActionListener listener = new CountDownActionListener(indicesToBeReindexed.size() + 1, ActionListener.wrap(response1 -> {