Skip to content

feat(api): Add pre-compilation adapter for datetime UDF type bridging#18

Closed
dai-chen wants to merge 2 commits into
mainfrom
feature/ppl-udt-compilation-adapter
Closed

feat(api): Add pre-compilation adapter for datetime UDF type bridging#18
dai-chen wants to merge 2 commits into
mainfrom
feature/ppl-udt-compilation-adapter

Conversation

@dai-chen
Copy link
Copy Markdown
Owner

@dai-chen dai-chen commented May 7, 2026

Description

Add preCompilationRules to LanguageSpec.LanguageExtension and register DatetimeUdfCompilationAdapterRule in DatetimeExtension. The rule inserts CAST nodes to bridge the type mismatch between normalized standard types (DATE/TIME/TIMESTAMP as int/long) and PPL UDF implementors (which expect and produce String values):

Before: LAST_DAY($2:DATE) : DATE
After: CAST(LAST_DAY(CAST($2 AS VARCHAR)):VARCHAR AS DATE)

Applied only in UnifiedQueryCompiler before Enumerable code generation, so the logical plan seen by other consumers (Analytics Engine, Substrait) remains clean with standard types.

Related Issues

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

Check List

  • New functionality includes testing.
  • New functionality has been documented.
  • New functionality has javadoc added.
  • New functionality has a user manual doc added.
  • New PPL command checklist all confirmed.
  • API changes companion pull request created.
  • Commits are signed per the DCO using --signoff or -s.
  • Public documentation issue/PR created.

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 added 2 commits May 7, 2026 15:39
… spec (opensearch-project#5419)

* feat(api): Register LENGTH, REGEXP_REPLACE, DATE_TRUNC in operator table

Add FunctionSpecBuilder DSL with three construction paths: delegateTo()
for existing Calcite operators, vararg() for pushdown-only UDFs, and
operands() for typed functions with optional late-binding impl.

Register LENGTH, REGEXP_REPLACE, and DATE_TRUNC in UnifiedFunctionSpec
LIBRARY category. Contribute via CoreExtension registered in
UnifiedSqlSpec.extended().

This unblocks ClickBench q28 (LENGTH), q29 (REGEXP_REPLACE), and q43
(DATE_TRUNC) at the SQL Plugin parsing/validation layer.

Signed-off-by: Chen Dai <daichen@amazon.com>

* feat(api): Add pre-compilation rule for late-binding function impl

Add preCompilationRules() extension point to LanguageSpec that allows
extensions to transform the logical plan before in-memory execution
only. The plan remains clean for external consumers (Analytics Engine).

CoreExtension registers FunctionImplBindingRule which fetches impl
bindings from UnifiedFunctionSpec and rewrites custom function calls
into executable Calcite expressions at compilation time.

DATE_TRUNC now has an impl that rewrites to FLOOR(ts TO unit), making
it executable in-memory while preserving DATE_TRUNC in the logical plan
for the Analytics Engine path.

Signed-off-by: Chen Dai <daichen@amazon.com>

---------

Signed-off-by: Chen Dai <daichen@amazon.com>
Add preCompilationRules to LanguageSpec.LanguageExtension and register
DatetimeUdfCompilationAdapterRule in DatetimeExtension. The rule inserts
CAST nodes to bridge the type mismatch between normalized standard types
(DATE/TIME/TIMESTAMP as int/long) and PPL UDF implementors (which expect
and produce String values):

  Before: LAST_DAY($2:DATE) : DATE
  After:  CAST(LAST_DAY(CAST($2 AS VARCHAR)):VARCHAR AS DATE)

Applied only in UnifiedQueryCompiler before Enumerable code generation,
so the logical plan seen by other consumers (Analytics Engine, Substrait)
remains clean with standard types.

Signed-off-by: Chen Dai <daichen@amazon.com>
@dai-chen dai-chen force-pushed the feature/ppl-udt-compilation-adapter branch from ec1a11a to 8995649 Compare May 7, 2026 22:59
@dai-chen dai-chen closed this May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant