Add Support for Lucene Byte Sized Vector

[naveentatikonda]

Description

This PR contains changes which adds indexing, querying and docValues support to lucene byte sized vector and corresponding tests to validate it. It helps users to index vectors as byte sized vectors(which theoretically saves 75% of memory when compared to float vectors) by setting the optional data_type field as byte while creating the index. As we are not adding support for Quantization Techniques, users are expected to index vectors that are in the byte range [-128 to 127] without any decimal values. Also, right now this feature is only supported for lucene engine.

Issues Resolved

#812

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed as 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 #971 (2d04aba) into main (d55eccb) will decrease coverage by 0.20%.
The diff coverage is 86.66%.

@@             Coverage Diff              @@
##               main     #971      +/-   ##
============================================
- Coverage     85.33%   85.13%   -0.20%     
- Complexity     1117     1141      +24     
============================================
  Files           152      154       +2     
  Lines          4520     4683     +163     
  Branches        406      423      +17     
============================================
+ Hits           3857     3987     +130     
- Misses          480      504      +24     
- Partials        183      192       +9     

Impacted Files	Coverage Δ
...opensearch/knn/index/mapper/LuceneFieldMapper.java	71.15% <64.00%> (-3.27%)	⬇️
...ain/java/org/opensearch/knn/index/VectorField.java	71.42% <66.66%> (-3.58%)	⬇️
...nsearch/knn/index/mapper/KNNVectorFieldMapper.java	82.93% <79.41%> (-0.88%)	⬇️
...rg/opensearch/knn/index/query/KNNQueryFactory.java	88.13% <85.00%> (-2.35%)	⬇️
...rch/knn/index/mapper/KNNVectorFieldMapperUtil.java	90.47% <90.47%> (ø)
...n/java/org/opensearch/knn/common/KNNConstants.java	93.75% <100.00%> (+0.41%)	⬆️
...opensearch/knn/index/KNNVectorDVLeafFieldData.java	75.00% <100.00%> (+2.27%)	⬆️
.../opensearch/knn/index/KNNVectorIndexFieldData.java	100.00% <100.00%> (ø)
...opensearch/knn/index/KNNVectorScriptDocValues.java	84.61% <100.00%> (-5.87%)	⬇️
.../java/org/opensearch/knn/index/VectorDataType.java	100.00% <100.00%> (ø)
... and 5 more

... and 2 files with indirect coverage changes

[vamshin]

LGTM! Thanks

[opensearch-trigger-bot]

The backport to 2.x failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-2.x 2.x
# Navigate to the new working tree
cd .worktrees/backport-2.x
# Create a new branch
git switch --create backport/backport-971-to-2.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 bf04854c483fdfd38663bdc490e1730c994bda6d
# Push it to GitHub
git push --set-upstream origin backport/backport-971-to-2.x
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-2.x

Then, create a pull request where the base branch is 2.x and the compare/head branch is backport/backport-971-to-2.x.

[opensearch-trigger-bot]

The backport to 2.9 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-2.9 2.9
# Navigate to the new working tree
cd .worktrees/backport-2.9
# Create a new branch
git switch --create backport/backport-971-to-2.9
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 bf04854c483fdfd38663bdc490e1730c994bda6d
# Push it to GitHub
git push --set-upstream origin backport/backport-971-to-2.9
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-2.9

Then, create a pull request where the base branch is 2.9 and the compare/head branch is backport/backport-971-to-2.9.