[PoC] Set routing shard in SQL via the relation partition

[acarbonetto]

Description

Allows user to set routing shard via the relation partition keys. For example:

select _id, _index, _routing, int0 from calcs_routing PARTITION(KEY1, KEY2) where _routing = 'KEY1' or _routing = 'KEY2'

Note that multiple keys can be send to OpenSearch storage by using comma-delimited list.

TODO

• Remove quotes/backticks from around the routingId before sending
• Rebase
• Propose PPL syntax

Issues Resolved

• resolves Allow individual shards to be targeted during query execution [FEATURE] #1478 for SQL

Note (out of scope): PPL syntax is still TBD

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 #1808 (c3e594f) into main (1a7134b) will decrease coverage by 3.10%.
The diff coverage is 33.33%.

❗ Current head c3e594f differs from pull request most recent head e2b2b04. Consider uploading reports for the commit e2b2b04 to get more accurate results

@@             Coverage Diff              @@
##               main    #1808      +/-   ##
============================================
- Coverage     97.39%   94.30%   -3.10%     
+ Complexity     4603      946    -3657     
============================================
  Files           401      100     -301     
  Lines         11397     2772    -8625     
  Branches        835      241     -594     
============================================
- Hits          11100     2614    -8486     
+ Misses          290      154     -136     
+ Partials          7        4       -3     

Flag	Coverage Δ
sql-engine	94.30% <33.33%> (-3.10%)	⬇️

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

Files Changed	Coverage Δ
...earch/sql/datasources/exceptions/ErrorMessage.java	0.00% <ø> (ø)
...model/transport/CreateDataSourceActionRequest.java	27.27% <ø> (ø)
...odel/transport/CreateDataSourceActionResponse.java	0.00% <ø> (ø)
...model/transport/DeleteDataSourceActionRequest.java	18.75% <ø> (ø)
...odel/transport/DeleteDataSourceActionResponse.java	0.00% <ø> (ø)
...es/model/transport/GetDataSourceActionRequest.java	27.27% <ø> (ø)
...s/model/transport/GetDataSourceActionResponse.java	0.00% <ø> (ø)
...model/transport/UpdateDataSourceActionRequest.java	27.27% <ø> (ø)
...odel/transport/UpdateDataSourceActionResponse.java	0.00% <ø> (ø)
...ql/datasources/rest/RestDataSourceQueryAction.java	0.00% <ø> (ø)
... and 5 more

... and 306 files with indirect coverage changes

[acarbonetto]

Closing Proof of Concept