[
https://issues.apache.org/jira/browse/FLINK-21931?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17309208#comment-17309208
]
Jark Wu commented on FLINK-21931:
---------------------------------
IIUC, pipeline.auto-watermak-interval = 0 just disable **periodic** watermark
emission,
it doesn't mean the watermark will never be emitted.
In Table API/SQL, it has the same meaning. If watermark interval = 0, we
disable periodic watermark emission,
and emit watermark once it advances.
So I think the SQL documentation is correct. But we can improve the
documentation to make it more clear.
> Watermark documentation needs to be fixed
> -----------------------------------------
>
> Key: FLINK-21931
> URL: https://issues.apache.org/jira/browse/FLINK-21931
> Project: Flink
> Issue Type: Bug
> Components: Documentation, Table SQL / API
> Affects Versions: 1.12.2
> Reporter: Matthias
> Priority: Minor
>
> There's a [ML
> thread|http://apache-flink-user-mailing-list-archive.2336050.n4.nabble.com/pipeline-auto-watermark-interval-vs-setAutoWatermarkInterval-td41891.html]
> about inconsistencies in the Watermark documentation. The description
> provided by the docs about setting {{pipeline.auto-watermark-interval}} to
> {{0}} does not match the actual implementation and the description provided
> in the JavaDocs of
> [ExecutionConfig.setAutoWatermarkInterval|https://ci.apache.org/projects/flink/flink-docs-master/api/java/org/apache/flink/api/common/ExecutionConfig.html#setAutoWatermarkInterval-long-].
> I went through the code verifying that the functionality described by the
> JavaDoc is correct. Setting the parameter to {{0}} disables the automatic
> watermark generation. The docs need to be updated accordingly.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
