Skip to content

MINOR: Document top-level-only field casting limitation in Cast SMT#22697

Open
itsmehotpants wants to merge 1 commit into
apache:trunkfrom
itsmehotpants:docs/cast-transform-top-level-limitation
Open

MINOR: Document top-level-only field casting limitation in Cast SMT#22697
itsmehotpants wants to merge 1 commit into
apache:trunkfrom
itsmehotpants:docs/cast-transform-top-level-limitation

Conversation

@itsmehotpants

Copy link
Copy Markdown

Motivation

The Cast SMT only supports top-level fields. Nested field casting via dotted notation (e.g. outer.inner:int32) is not supported. This was noted in an internal TODO comment but never surfaced to users.

Changes

connect/transforms/src/main/java/org/apache/kafka/connect/transforms/Cast.java

  • OVERVIEW_DOC: note that only top-level fields are supported
  • spec ConfigDef description: same clarification

Documentation strings only. No logic, behaviour, or API change.

Committer checklist

  • No new public API or behaviour change
  • No new tests required (doc-only change)
  • Internal TODO comment preserved for future nested-field support

The Cast SMT only supports casting top-level fields. This was noted in
an internal TODO comment but was absent from the user-visible OVERVIEW_DOC
and spec ConfigDef description, causing confusion when users attempt
dotted-path nested field specs.

Surfaces the limitation in:
- OVERVIEW_DOC (shown in docs site and connector UIs)
- spec ConfigDef description (shown in validation errors)

Documentation strings only; no logic or API change.
@github-actions github-actions Bot added triage PRs from the community connect small Small PRs labels Jun 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

connect small Small PRs triage PRs from the community

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant