Add Support for Field Star in Nested Function

[forestmvey]

Description

Add support for using the * at end of field parameter in the nested function. All nested fields under supplied path will be expanded as column identifiers. Grammar has been added to only support the AllTupleFields usage with the nested function since this change will effect field usage in all queries and needs further planning with V2 implementation.

Example Queries

SELECT nested(message.*) from nested_objects;

Issues Resolved

Portion of Issue: 1111

Changes From Legacy

• Path parameter is redundant therefore not supported in parser and will fallback to legacy engine.

Edge Cases

Queries that produce repeating column identifiers like:

SELECT nested(field.*), nested(field.innerField) ...

Or

SELECT nested(field.*), nested(field.*) ...

Will result in error:

{
  "error": {
    "reason": "Invalid SQL query",
    "details": "Multiple entries with same key: nested(message.info)=\"a\" and nested(message.info)=\"a\"",
    "type": "IllegalArgumentException"
  },
  "status": 400
}

Check List

• New functionality includes testing.
  • All tests pass, including unit test, integration test and doctest
• New functionality has been documented.
  • New functionality has javadoc added
  • New functionality has user manual doc added
• Commits are signed per the DCO using --signoff

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.

[codecov]

Codecov Report

Merging #1773 (51094dd) into main (1ec696d) will increase coverage by 0.01%.
The diff coverage is 100.00%.

@@             Coverage Diff              @@
##               main    #1773      +/-   ##
============================================
+ Coverage     97.30%   97.32%   +0.01%     
- Complexity     4442     4458      +16     
============================================
  Files           388      388              
  Lines         11000    11050      +50     
  Branches        785      790       +5     
============================================
+ Hits          10704    10754      +50     
  Misses          289      289              
  Partials          7        7              

Flag	Coverage Δ
sql-engine	97.32% <100.00%> (+0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...ain/java/org/opensearch/sql/analysis/Analyzer.java	100.00% <100.00%> (ø)
...rg/opensearch/sql/analysis/ExpressionAnalyzer.java	100.00% <100.00%> (ø)
...va/org/opensearch/sql/analysis/NestedAnalyzer.java	100.00% <100.00%> (ø)
...nsearch/sql/analysis/SelectExpressionAnalyzer.java	100.00% <100.00%> (ø)
...a/org/opensearch/sql/analysis/TypeEnvironment.java	100.00% <100.00%> (ø)
...rg/opensearch/sql/analysis/symbol/SymbolTable.java	100.00% <100.00%> (ø)
...pensearch/sql/sql/parser/AstExpressionBuilder.java	100.00% <100.00%> (ø)

[Yury-Fridlyand]

Please, fix DCO