Skip to content

Conversation

@featzhang
Copy link
Member

@featzhang featzhang commented Feb 10, 2026

What is the purpose of the change?

This PR FLINK-39062 adds support for the ALTER VIEW SET WATERMARK SQL syntax in Flink SQL, allowing users to specify watermark strategies for views after creation.

Brief change log

  • Add new AST node SqlAlterViewSetWatermark in Parser layer
  • Add new Operation AlterViewSetWatermarkOperation in Planner layer
  • Add new Converter SqlAlterViewSetWatermarkConverter to translate SQL to Operation
  • Update Parser.tdd to include new SQL node import
  • Update parserImpls.ftl to support new SQL syntax parsing
  • Register new converter in SqlNodeConverters

Verifying this change

This change added tests and can be verified as follows:

  • Added test SQL file test_alter_view_watermark.sql with multiple test cases
  • Manually verified the following SQL syntax works:
    ALTER VIEW my_view SET WATERMARK FOR event_time 
    AS event_time - INTERVAL '5' SECOND;

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: yes
  • If yes, how is the feature documented: JavaDocs and code comments

This commit adds support for ALTER VIEW ... SET WATERMARK FOR <column> AS <expression> syntax.

Changes:
- Added SqlAlterViewSetWatermark parser node
- Added AlterViewSetWatermarkOperation for operation layer
- Added SqlAlterViewSetWatermarkConverter for conversion
- Updated Parser.tdd and parserImpls.ftl to support new syntax
- Registered converter in SqlNodeConverters

Example usage:
ALTER VIEW my_view SET WATERMARK FOR event_time AS event_time - INTERVAL '5' SECOND;

This allows users to specify watermark strategies directly in ALTER VIEW statements,
making it easier to manage event-time characteristics of views.
@flinkbot
Copy link
Collaborator

flinkbot commented Feb 10, 2026

CI report:

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

@featzhang featzhang changed the title [FLINK-XXXXX][table] Support ALTER VIEW SET WATERMARK syntax [FLINK-39062][table] Support ALTER VIEW SET WATERMARK syntax Feb 11, 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.

2 participants