Add typeof function.

[Yury-Fridlyand]

Signed-off-by: Yury-Fridlyand yuryf@bitquilltech.com

Description

TYPEOF function is useful for debugging to check types of other functions. Extremely useful for testing and debugging upcoming PRs with datetime functions.
Not added to documentation, because it is not supposed for an end user.
See team review discussion in Bit-Quill#123.

Usage

opensearchsql> SELECT typeof(DATETIME('1961-04-12 09:07:00')), typeof(CAST('1961-04-12 09:07:00' AS TIMESTAMP)), typeof(CAST('09:07:00' AS TIME)), typeof(CAST('1961-04-12' AS DATE));
Output longer than terminal width
Do you want to display data vertically for better visual effect? [y/N]: y
fetched rows / total rows = 1/1
-[ RECORD 1 ]-------------------------
typeof(DATETIME('1961-04-12 09:07:00')           | DATETIME
typeof(CAST('1961-04-12 09:07:00' AS TIMESTAMP)) | TIMESTAMP
typeof(CAST('09:07:00' AS TIME))                 | TIME
typeof(CAST('1961-04-12' AS DATE))               | DATE

UPD

TYPEOF function perfectly works with SQL types. It works with some OpenSearch (OpenSearchDataType) types, which could be implicitly casted to SQL ones. Unfortunately, function can't accept OpenSearch types, so some information lost.
IP, GEO_POINT, BINARY and NESTED types cause crash.
https://github.com/Bit-Quill/opensearch-project-sql/blob/d02e16f147a9f3e6afa065f701efa7ece70d310b/opensearch/src/main/java/org/opensearch/sql/opensearch/data/type/OpenSearchDataType.java#L49-L53

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.

[dai-chen]

Just a minor comment. Thanks for the changes!

Btw, do we want to add this to user manual like PGSQL? Doc: https://www.postgresql.org/docs/current/functions-info.html

[Yury-Fridlyand]

Just a minor comment. Thanks for the changes!

Btw, do we want to add this to user manual like PGSQL? Doc: https://www.postgresql.org/docs/current/functions-info.html

Added in b4dc828.

[codecov-commenter]

Codecov Report

Merging #867 (b4dc828) into 2.x (3ca6450) will decrease coverage by 2.74%.
The diff coverage is 100.00%.

@@             Coverage Diff              @@
##                2.x     #867      +/-   ##
============================================
- Coverage     97.85%   95.10%   -2.75%     
- Complexity     2989     3075      +86     
============================================
  Files           281      304      +23     
  Lines          7357     8258     +901     
  Branches        467      609     +142     
============================================
+ Hits           7199     7854     +655     
- Misses          157      350     +193     
- Partials          1       54      +53     

Flag	Coverage Δ
query-workbench	62.76% <ø> (?)
sql-engine	97.90% <100.00%> (+0.05%)	⬆️

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

Impacted Files	Coverage Δ
...c/main/java/org/opensearch/sql/expression/DSL.java	100.00% <100.00%> (ø)
...search/sql/expression/config/ExpressionConfig.java	100.00% <100.00%> (ø)
...h/sql/expression/function/BuiltinFunctionName.java	100.00% <100.00%> (ø)
...nsearch/sql/expression/system/SystemFunctions.java	100.00% <100.00%> (ø)
...main/java/org/opensearch/sql/utils/ParseUtils.java	100.00% <0.00%> (ø)
...ain/java/org/opensearch/sql/analysis/Analyzer.java	100.00% <0.00%> (ø)
...java/org/opensearch/sql/ppl/parser/AstBuilder.java	100.00% <0.00%> (ø)
...org/opensearch/sql/analysis/HighlightAnalyzer.java	100.00% <0.00%> (ø)
...opensearch/sql/expression/HighlightExpression.java	100.00% <0.00%> (ø)
... and 33 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[dai-chen]

Thanks for the changes!