[GRPC] Add gRPC support for Min, Max, and Terms aggregations

[lucy66hw]

Description

Based on #20676, #20970

• Min/Max metric aggregations — converts InternalMin/InternalMax to SingleMetricAggregateBase proto
• Terms bucket aggregations — converts all five terms variants to their respective proto types:
  • StringTerms → sterms
  • LongTerms → lterms
  • DoubleTerms → dterms
  • UnsignedLongTerms → ulterms
  • UnmappedTerms → umterms

TEST

Index Mapping

{
  "properties": {
    "status":      { "type": "keyword"       },
    "category_id": { "type": "long"          },
    "price":       { "type": "double"        },
    "big_id":      { "type": "unsigned_long" }
  }
}

Document count: 5

---

Test 1 — Keyword field (status)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "status_terms": {
        "terms_aggregation": { "terms": { "field": "status" } }
      }
    }
  }
}

REST Response (aggregations only)

{
  "status_terms": {
    "doc_count_error_upper_bound": 0,
    "sum_other_doc_count": 0,
    "buckets": [
      { "key": "active",   "doc_count": 3 },
      { "key": "inactive", "doc_count": 2 }
    ]
  }
}

gRPC Response (aggregations only)

{
  "status_terms": {
    "sterms": {
      "doc_count_error_upper_bound": "0",
      "sum_other_doc_count": "0",
      "buckets": [
        { "key": "active",   "docCount": "3" },
        { "key": "inactive", "docCount": "2" }
      ]
    }
  }
}

---

Test 2 — Long field (category_id)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "category_terms": {
        "terms_aggregation": { "terms": { "field": "category_id" } }
      }
    }
  }
}

REST Response (aggregations only)

{
  "category_terms": {
    "doc_count_error_upper_bound": 0,
    "sum_other_doc_count": 0,
    "buckets": [
      { "key": 1, "doc_count": 2 },
      { "key": 2, "doc_count": 2 },
      { "key": 3, "doc_count": 1 }
    ]
  }
}

gRPC Response (aggregations only)

{
  "category_terms": {
    "lterms": {
      "doc_count_error_upper_bound": "0",
      "sum_other_doc_count": "0",
      "buckets": [
        { "key": { "signed": "1" }, "docCount": "2" },
        { "key": { "signed": "2" }, "docCount": "2" },
        { "key": { "signed": "3" }, "docCount": "1" }
      ]
    }
  }
}

---

Test 3 — Double field (price)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "price_terms": {
        "terms_aggregation": { "terms": { "field": "price" } }
      }
    }
  }
}

REST Response (aggregations only)

{
  "price_terms": {
    "doc_count_error_upper_bound": 0,
    "sum_other_doc_count": 0,
    "buckets": [
      { "key": 5.2,  "doc_count": 1 },
      { "key": 10.5, "doc_count": 1 },
      { "key": 15.0, "doc_count": 1 },
      { "key": 25.0, "doc_count": 1 },
      { "key": 30.0, "doc_count": 1 }
    ]
  }
}

gRPC Response (aggregations only)

{
  "price_terms": {
    "dterms": {
      "doc_count_error_upper_bound": "0",
      "sum_other_doc_count": "0",
      "buckets": [
        { "key": 5.2,  "docCount": "1" },
        { "key": 10.5, "docCount": "1" },
        { "key": 15,   "docCount": "1" },
        { "key": 25,   "docCount": "1" },
        { "key": 30,   "docCount": "1" }
      ]
    }
  }
}

---

Test 4 — Unsigned Long field (big_id)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "bigid_terms": {
        "terms_aggregation": { "terms": { "field": "big_id" } }
      }
    }
  }
}

REST Response (aggregations only)

{
  "bigid_terms": {
    "doc_count_error_upper_bound": 0,
    "sum_other_doc_count": 0,
    "buckets": [
      { "key": 9223372036854775808, "doc_count": 2 },
      { "key": 9223372036854775809, "doc_count": 2 },
      { "key": 9223372036854775810, "doc_count": 1 }
    ]
  }
}

gRPC Response (aggregations only)

{
  "bigid_terms": {
    "ulterms": {
      "doc_count_error_upper_bound": "0",
      "sum_other_doc_count": "0",
      "buckets": [
        { "key": "9223372036854775808", "docCount": "2" },
        { "key": "9223372036854775809", "docCount": "2" },
        { "key": "9223372036854775810", "docCount": "1" }
      ]
    }
  }
}

---

Test 5 — Unmapped field (does_not_exist)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "unmapped_terms": {
        "terms_aggregation": { "terms": { "field": "does_not_exist" } }
      }
    }
  }
}

REST Response (aggregations only)

{
  "unmapped_terms": {
    "doc_count_error_upper_bound": 0,
    "sum_other_doc_count": 0,
    "buckets": []
  }
}

gRPC Response (aggregations only)

{
  "unmapped_terms": {
    "umterms": {
      "doc_count_error_upper_bound": "0",
      "sum_other_doc_count": "0"
    }
  }
}

---

Test 6 — Keyword field with sub-aggregation (status + max_price)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "status_terms": {
        "terms_aggregation": {
          "terms": { "field": "status" },
          "aggregations": {
            "max_price": { "max": { "field": "price" } }
          }
        }
      }
    }
  }
}

REST Response (aggregations only)

{
  "status_terms": {
    "doc_count_error_upper_bound": 0,
    "sum_other_doc_count": 0,
    "buckets": [
      { "key": "active",   "doc_count": 3, "max_price": { "value": 25.0 } },
      { "key": "inactive", "doc_count": 2, "max_price": { "value": 30.0 } }
    ]
  }
}

gRPC Response (aggregations only)

{
  "status_terms": {
    "sterms": {
      "doc_count_error_upper_bound": "0",
      "sum_other_doc_count": "0",
      "buckets": [
        {
          "key": "active",
          "docCount": "3",
          "aggregate": {
            "max_price": { "max": { "value": { "double": 25 } } }
          }
        },
        {
          "key": "inactive",
          "docCount": "2",
          "aggregate": {
            "max_price": { "max": { "value": { "double": 30 } } }
          }
        }
      ]
    }
  }
}

---

---

Test 7 — Min aggregation (price, category_id, big_id)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "min_price": { "min": { "field": "price" } },
      "min_catid": { "min": { "field": "category_id" } },
      "min_bigid": { "min": { "field": "big_id" } }
    }
  }
}

REST Response (aggregations only)

{
  "min_price": { "value": 5.2  },
  "min_catid": { "value": 1.0  },
  "min_bigid": { "value": 9.223372036854776e+18, "value_as_string": "9.223372036854776E18" }
}

gRPC Response (aggregations only)

{
  "min_price": { "min": { "value": { "double": 5.2  } } },
  "min_catid": { "min": { "value": { "double": 1    } } },
  "min_bigid": { "min": { "value": { "double": 9.223372036854776e+18 }, "valueAsString": "9.223372036854776E18" } }
}

---

Test 8 — Max aggregation (price, category_id, big_id)

gRPC Request

{
  "index": ["test-terms-agg"],
  "search_request_body": {
    "size": 0,
    "aggregations": {
      "max_price": { "max": { "field": "price" } },
      "max_catid": { "max": { "field": "category_id" } },
      "max_bigid": { "max": { "field": "big_id" } }
    }
  }
}

REST Response (aggregations only)

{
  "max_price": { "value": 30.0 },
  "max_catid": { "value": 3.0  },
  "max_bigid": { "value": 9.223372036854776e+18, "value_as_string": "9.223372036854776E18" }
}

gRPC Response (aggregations only)

{
  "max_price": { "max": { "value": { "double": 30   } } },
  "max_catid": { "max": { "value": { "double": 3    } } },
  "max_bigid": { "max": { "value": { "double": 9.223372036854776e+18 }, "valueAsString": "9.223372036854776E18" } }
}

---

Test 9 — Min/Max on unmapped field (does_not_exist)

REST Response (aggregations only)

{
  "min_missing": { "value": null },
  "max_missing": { "value": null }
}

gRPC Response (aggregations only)

{
  "min_missing": { "min": { "value": { "nullValue": "NULL_VALUE_NULL" } } },
  "max_missing": { "max": { "value": { "nullValue": "NULL_VALUE_NULL" } } }
}

Related Issues

Resolves #[Issue number to be closed when this PR is merged]

Check List

• Functionality includes testing.
• API changes companion pull request created, if applicable.
• Public documentation issue/PR created, if applicable.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

PR Code Analyzer ❗

AI-powered 'Code-Diff-Analyzer' found issues on commit 6c7e5b4.

Path	Line	Severity	Description
gradle/libs.versions.toml	30	high	Dependency version bump: opensearchprotobufs upgraded from 1.3.0 to 1.4.0. Per mandatory flagging rule, all dependency version changes must be flagged regardless of apparent legitimacy. Maintainers should verify the new artifact at version 1.4.0 against the updated SHA1 (c09d98cf3c06fe49f77c5090309ba1769ba9b3c1) from a trusted source before merging.

The table above displays the top 10 most important findings.

Total: 1 | Critical: 0 | High: 1 | Medium: 0 | Low: 0

---

Pull Requests Author(s): Please update your Pull Request according to the report above.

Repository Maintainer(s): You can bypass diff analyzer by adding label skip-diff-analyzer after reviewing the changes carefully, then re-run failed actions. To re-enable the analyzer, remove the label, then re-run all actions.

---

⚠️ Note: The Code-Diff-Analyzer helps protect against potentially harmful code patterns. Please ensure you have thoroughly reviewed the changes beforehand.

Thanks.

[karenyrx]

Looks good overall

[github-actions]

Persistent review updated to latest commit 9338dd0

[github-actions]

❌ Gradle check result for 9338dd0: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions]

❌ Gradle check result for 9338dd0: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions]

❌ Gradle check result for 9338dd0: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions]

✅ Gradle check result for 9338dd0: SUCCESS

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.21%. Comparing base (c93eb90) to head (249661e).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff              @@
##               main   #21205      +/-   ##
============================================
- Coverage     73.22%   73.21%   -0.01%     
- Complexity    73325    73455     +130     
============================================
  Files          5910     5911       +1     
  Lines        334422   334936     +514     
  Branches      48207    48257      +50     
============================================
+ Hits         244880   245236     +356     
- Misses        69964    70107     +143     
- Partials      19578    19593      +15     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Persistent review updated to latest commit 5af5162

[github-actions]

❌ Gradle check result for 5af5162: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions]

Persistent review updated to latest commit b15b75c

[github-actions]

❌ Gradle check result for b15b75c: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions]

Persistent review updated to latest commit 249661e

[github-actions]

✅ Gradle check result for 249661e: SUCCESS