Skip to content

[FLINK-40807][docs] Fix the docs of PARSE_XML and XML_STRING - #29905

Open
manner wants to merge 1 commit into
apache:masterfrom
manner:xml-functions-docs-fix
Open

manner wants to merge 1 commit into
apache:masterfrom
manner:xml-functions-docs-fix

Conversation

@manner

@manner manner commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

What is the purpose of the change

Two statements in the docs of PARSE_XML and XML_STRING didn't match the behavior.

Brief change log

  • PARSE_XML: a dateTime whose offset moves it past the year 9999 in UTC stays a STRING. The docs said that 9999-12-31T23:00:00-08:00 maps to a TIMESTAMP_LTZ.
  • XML_STRING: the docs said that every value other than a string or a UUID gets an xsi:type. Only the text of an element without child elements gets one. Attribute values, and text next to child elements, are written without a type and read back as strings.

Verifying this change

This change is a docs-only fix without any test coverage.

Does this pull request potentially affect one of the following parts:

  • Dependencies (does it add or upgrade a dependency): no
  • The public API, i.e., is any changed class annotated with @Public(Evolving): no
  • The serializers: no
  • The runtime per-record code paths (performance sensitive): no
  • Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn, ZooKeeper: no
  • The S3 file system connector: no

Documentation

  • Does this pull request introduce a new feature? no
  • If yes, how is the feature documented? not applicable

Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

Generated-by: Claude Opus 5.5

🤖 Generated with Claude Code

A dateTime whose offset moves it past the year 9999 in UTC stays a
string, but the docs still said that 9999-12-31T23:00:00-08:00 maps to
a TIMESTAMP_LTZ.

The docs of XML_STRING said that every value other than a string or a
UUID gets an xsi:type. Attribute values and text next to child elements
are written without one and read back as strings.

Generated-by: Claude Opus 5.5
@flinkbot

flinkbot commented Nov 12, 2026 •

Copy link
Copy Markdown
Collaborator

CI report:

Bot commands The @flinkbot bot supports the following commands:
  • @flinkbot run azure re-run the last Azure build

@raminqaf raminqaf left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

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.

3 participants