Update main with branch release of azure-search-documents 11.8.0 (#46985)

* Update main with branch release of azure-search-documents 11.8.0

* Fix linting

Author: alzimmermsft

eng/versioning/version_client.txt

@@ -171,7 +171,7 @@ com.azure:azure-monitor-query-perf;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-openrewrite;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-perf-test-parent;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-quantum-jobs;1.0.0-beta.1;1.0.0-beta.2
-com.azure:azure-search-documents;11.7.10;11.8.0-beta.9
+com.azure:azure-search-documents;11.8.0;11.9.0-beta.1
 com.azure:azure-search-perf;1.0.0-beta.1;1.0.0-beta.1
 com.azure:azure-security-attestation;1.1.36;1.2.0-beta.1
 com.azure:azure-security-confidentialledger;1.0.32;1.1.0-beta.2

sdk/search/azure-search-documents/CHANGELOG.md

@@ -1,13 +1,52 @@
 # Release History
 
-## 11.8.0-beta.9 (Unreleased)
+## 11.9.0-beta.1 (Unreleased)
 
 ### Features Added
 
+- Added back all service preview features dropped in `2025-09-01` service version release.
+
 ### Breaking Changes
 
+- Updated `RescoringOptions` to match what was changed in `11.8.0` release.
+    - `isEnableRescoring` -> `isRescoringEnabled`
+    - `setEnableRescoring` -> `setRescoringEnabled`
+- Changed `RankingOrder.RE_RANKER_SCORE` to `RankingOrder.RERANKER_SCORE`.
+- Changed `SearchOptions.getDebug` and `.setDebug` to `.getDebugMode` and `.setDebugMode`.
+- Default `SearchServiceVersion` changed from `2025_09_01` to `V2025_08_01_PREVIEW`.
+
 ### Bugs Fixed
 
+## 11.8.0 (2025-10-10)
+
+### Features Added
+
+- Added support for `2025-09-01` service version.
+    - Support for reranker boosted scores in search results and the ability to sort results on either reranker or reranker
+      boosted scores in `SemanticConfiguration.rankingOrder`.
+    - Support for `VectorSearchCompression.RescoringOptions` to configure how vector compression handles the original
+      vector when indexing and how vectors are used during rescoring.
+    - Added `SearchIndex.description` to provide a textual description of the index.
+    - Support for `LexicalNormalizer` when defining `SearchIndex`, `SimpleField`, and `SearchableField` and the ability to
+      use it when analyzing text with `SearchIndexClient.analyzeText` and `SearchIndexAsyncClient.analyzeText`.
+    - Support `DocumentIntelligenceLayoutSkill` skillset skill and `OneLake` `SearchIndexerDataSourceConnection` data source.
+    - Support for `QueryDebugMode` in searching to retrieve detailed information about search processing. Only `vector` is
+      supported for `QueryDebugMode`.
+
+### Breaking Changes
+
+- All features from `11.8.0-beta.x` versions that weren't GA'd in `2025-09-01` were removed.
+- `VectorSearchCompression.rerankWithOriginalVectors` and `VectorSearchCompression.defaultOversampling` don't work with
+  `2025-09-01` and were replaced by `VectorSearchCompression.RescoringOptions.enabledRescoring` and
+  `VectorSearchCompression.RescoringOptions.defaultOversampling`. If using `2024-07-01` continue using the old properties,
+  otherwise if using `2025-09-01` use the new properties in `RescoringOptions`.
+
+### Other Changes
+
+- Upgraded `azure-core` from `1.56.1` to version `1.57.0`.
+- Upgraded `azure-core-http-netty` from `1.16.1` to version `1.16.2`.
+- Upgraded `azure-core-serializer-json-jackson` from `1.6.1` to version `1.6.2`.
+
 ## 11.7.10 (2025-09-25)
 
 ### Other Changes

sdk/search/azure-search-documents/README.md

@@ -75,7 +75,7 @@ add the direct dependency to your project as follows.
 <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-search-documents</artifactId>
-    <version>11.8.0-beta.8</version>
+    <version>11.8.0</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})

sdk/search/azure-search-documents/pom.xml

@@ -16,7 +16,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-search-documents</artifactId>
-  <version>11.8.0-beta.9</version> <!-- {x-version-update;com.azure:azure-search-documents;current} -->
+  <version>11.9.0-beta.1</version> <!-- {x-version-update;com.azure:azure-search-documents;current} -->
   <packaging>jar</packaging>
 
   <properties>

sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/SearchAsyncClient.java

@@ -1502,7 +1502,7 @@ static SearchRequest createSearchRequest(String searchText, SearchOptions option
             .setTop(options.getTop())
             .setQueryLanguage(options.getQueryLanguage())
             .setSpeller(options.getSpeller())
-            .setDebug(options.getDebug());
+            .setDebug(options.getDebugMode());
 
         SemanticSearchOptions semanticSearchOptions = options.getSemanticSearchOptions();
         if (semanticSearchOptions != null) {

sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/SearchServiceVersion.java

@@ -24,6 +24,11 @@ public enum SearchServiceVersion implements ServiceVersion {
      */
     V2024_07_01("2024-07-01"),
 
+    /**
+     * {@code 2025-09-01} service version.
+     */
+    V2025_09_01("2025-09-01"),
+
     /**
      * {@code 2025-08-01-preview} service version.
      */

sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/AnalyzeTextOptions.java

@@ -40,6 +40,11 @@ public final class AnalyzeTextOptions {
      */
     private List<CharFilterName> charFilters;
 
+    /*
+     * The name of the normalizer to use to normalize the given text.
+     */
+    private LexicalNormalizerName normalizerName;
+
     /**
      * Constructor to {@link AnalyzeTextOptions} which takes analyzerName.
      *
@@ -130,4 +135,24 @@ public AnalyzeTextOptions setCharFilters(CharFilterName... charFilters) {
         this.charFilters = (charFilters == null) ? null : Arrays.asList(charFilters);
         return this;
     }
+
+    /**
+     * Get the normalizer property: The name of the normalizer to use to normalize the given text.
+     *
+     * @return the normalizer value.
+     */
+    public LexicalNormalizerName getNormalizerName() {
+        return this.normalizerName;
+    }
+
+    /**
+     * Set the normalizer property: The name of the normalizer to use to normalize the given text.
+     *
+     * @param normalizerName the normalizer value to set.
+     * @return the AnalyzeRequest object itself.
+     */
+    public AnalyzeTextOptions setNormalizerName(LexicalNormalizerName normalizerName) {
+        this.normalizerName = normalizerName;
+        return this;
+    }
 }

sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/RankingOrder.java

@@ -24,7 +24,7 @@ public final class RankingOrder extends ExpandableStringEnum<RankingOrder> {
      * Sets sort order as ReRankerScore.
      */
     @Generated
-    public static final RankingOrder RE_RANKER_SCORE = fromString("RerankerScore");
+    public static final RankingOrder RERANKER_SCORE = fromString("RerankerScore");
 
     /**
      * Creates a new instance of RankingOrder value.

sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/RescoringOptions.java

@@ -24,7 +24,7 @@ public final class RescoringOptions implements JsonSerializable<RescoringOptions
      * the full-precision vectors. This will improve recall at the expense of latency.
      */
     @Generated
-    private Boolean enableRescoring;
+    private Boolean rescoringEnabled;
 
     /*
      * Default oversampling factor. Oversampling retrieves a greater set of potential documents to offset the resolution
@@ -49,28 +49,28 @@ public RescoringOptions() {
     }
 
     /**
-     * Get the enableRescoring property: If set to true, after the initial search on the compressed vectors, the
+     * Get the rescoringEnabled property: If set to true, after the initial search on the compressed vectors, the
      * similarity scores are recalculated using the full-precision vectors. This will improve recall at the expense of
      * latency.
      * 
-     * @return the enableRescoring value.
+     * @return the rescoringEnabled value.
      */
     @Generated
-    public Boolean isEnableRescoring() {
-        return this.enableRescoring;
+    public Boolean isRescoringEnabled() {
+        return this.rescoringEnabled;
     }
 
     /**
-     * Set the enableRescoring property: If set to true, after the initial search on the compressed vectors, the
+     * Set the rescoringEnabled property: If set to true, after the initial search on the compressed vectors, the
      * similarity scores are recalculated using the full-precision vectors. This will improve recall at the expense of
      * latency.
      * 
-     * @param enableRescoring the enableRescoring value to set.
+     * @param rescoringEnabled the rescoringEnabled value to set.
      * @return the RescoringOptions object itself.
      */
     @Generated
-    public RescoringOptions setEnableRescoring(Boolean enableRescoring) {
-        this.enableRescoring = enableRescoring;
+    public RescoringOptions setRescoringEnabled(Boolean rescoringEnabled) {
+        this.rescoringEnabled = rescoringEnabled;
         return this;
     }
 
@@ -133,7 +133,7 @@ public RescoringOptions setRescoreStorageMethod(VectorSearchCompressionRescoreSt
     @Override
     public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
         jsonWriter.writeStartObject();
-        jsonWriter.writeBooleanField("enableRescoring", this.enableRescoring);
+        jsonWriter.writeBooleanField("enableRescoring", this.rescoringEnabled);
         jsonWriter.writeNumberField("defaultOversampling", this.defaultOversampling);
         jsonWriter.writeStringField("rescoreStorageMethod",
             this.rescoreStorageMethod == null ? null : this.rescoreStorageMethod.toString());
@@ -157,7 +157,7 @@ public static RescoringOptions fromJson(JsonReader jsonReader) throws IOExceptio
                 reader.nextToken();
 
                 if ("enableRescoring".equals(fieldName)) {
-                    deserializedRescoringOptions.enableRescoring = reader.getNullable(JsonReader::getBoolean);
+                    deserializedRescoringOptions.rescoringEnabled = reader.getNullable(JsonReader::getBoolean);
                 } else if ("defaultOversampling".equals(fieldName)) {
                     deserializedRescoringOptions.defaultOversampling = reader.getNullable(JsonReader::getDouble);
                 } else if ("rescoreStorageMethod".equals(fieldName)) {

sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/indexes/models/VectorSearchCompression.java

@@ -35,6 +35,8 @@ public class VectorSearchCompression implements JsonSerializable<VectorSearchCom
      * If set to true, once the ordered set of results calculated using compressed vectors are obtained, they will be
      * reranked again by recalculating the full-precision similarity scores. This will improve recall at the expense of
      * latency.
+     * For use with only service version 2024-07-01. If using 2025-09-01 or later, use
+     * RescoringOptions.rescoringEnabled.
      */
     @Generated
     private Boolean rerankWithOriginalVectors;
@@ -44,6 +46,8 @@ public class VectorSearchCompression implements JsonSerializable<VectorSearchCom
      * in the initial search. This increases the set of results that will be reranked using recomputed similarity scores
      * from full-precision vectors. Minimum value is 1, meaning no oversampling (1x). This parameter can only be set
      * when rerankWithOriginalVectors is true. Higher values improve recall at the expense of latency.
+     * For use with only service version 2024-07-01. If using 2025-09-01 or later, use
+     * RescoringOptions.defaultOversampling.
      */
     @Generated
     private Double defaultOversampling;
@@ -98,6 +102,8 @@ public String getCompressionName() {
      * Get the rerankWithOriginalVectors property: If set to true, once the ordered set of results calculated using
      * compressed vectors are obtained, they will be reranked again by recalculating the full-precision similarity
      * scores. This will improve recall at the expense of latency.
+     * For use with only service version 2024-07-01. If using 2025-09-01 or later, use
+     * RescoringOptions.rescoringEnabled.
      * 
      * @return the rerankWithOriginalVectors value.
      */
@@ -110,6 +116,8 @@ public Boolean isRerankWithOriginalVectors() {
      * Set the rerankWithOriginalVectors property: If set to true, once the ordered set of results calculated using
      * compressed vectors are obtained, they will be reranked again by recalculating the full-precision similarity
      * scores. This will improve recall at the expense of latency.
+     * For use with only service version 2024-07-01. If using 2025-09-01 or later, use
+     * RescoringOptions.rescoringEnabled.
      * 
      * @param rerankWithOriginalVectors the rerankWithOriginalVectors value to set.
      * @return the VectorSearchCompression object itself.
@@ -126,6 +134,8 @@ public VectorSearchCompression setRerankWithOriginalVectors(Boolean rerankWithOr
      * reranked using recomputed similarity scores from full-precision vectors. Minimum value is 1, meaning no
      * oversampling (1x). This parameter can only be set when rerankWithOriginalVectors is true. Higher values improve
      * recall at the expense of latency.
+     * For use with only service version 2024-07-01. If using 2025-09-01 or later, use
+     * RescoringOptions.defaultOversampling.
      * 
      * @return the defaultOversampling value.
      */
@@ -140,6 +150,8 @@ public Double getDefaultOversampling() {
      * reranked using recomputed similarity scores from full-precision vectors. Minimum value is 1, meaning no
      * oversampling (1x). This parameter can only be set when rerankWithOriginalVectors is true. Higher values improve
      * recall at the expense of latency.
+     * For use with only service version 2024-07-01. If using 2025-09-01 or later, use
+     * RescoringOptions.defaultOversampling.
      * 
      * @param defaultOversampling the defaultOversampling value to set.
      * @return the VectorSearchCompression object itself.