[
https://issues.apache.org/jira/browse/FLINK-24465?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17428659#comment-17428659
]
Dawid Wysakowicz commented on FLINK-24465:
------------------------------------------
Unfortunately, we cannot drop the {{-1}} option. We use internally for blocking
exchanges. We set that e.g. in the SQL planner and
{{RuntimeExecutionMode.BATCH}}
I think the problem is that we started treating {{-1}} as an undefined value in
the configuration layer and as {{DISABLED}} in the runtime layer. We should
revert that change and let -1 pass from configuration to runtime in all cases
(not just for blocking exchanges).
> Wrong javadoc and documentation for buffer timeout
> --------------------------------------------------
>
> Key: FLINK-24465
> URL: https://issues.apache.org/jira/browse/FLINK-24465
> Project: Flink
> Issue Type: Bug
> Components: Documentation, Runtime / Configuration, Runtime / Network
> Affects Versions: 1.14.0, 1.13.2
> Reporter: Dawid Wysakowicz
> Priority: Major
> Labels: pull-request-available
> Fix For: 1.15.0, 1.14.1, 1.13.4
>
>
> The javadoc for {{setBufferTimeout}} and similarly the documentation for
> {{execution.buffer-timeout}} claims:
> {code}
> /**
> * Sets the maximum time frequency (milliseconds) for the flushing of the
> output buffers. By
> * default the output buffers flush frequently to provide low latency and
> to aid smooth
> * developer experience. Setting the parameter can result in three
> logical modes:
> *
> * <ul>
> * <li>A positive integer triggers flushing periodically by that integer
> * <li>0 triggers flushing after every record thus minimizing latency
> * <li>-1 triggers flushing only when the output buffer is full thus
> maximizing throughput
> * </ul>
> *
> * @param timeoutMillis The maximum time between two output flushes.
> */
> {code}
> which is not true.
> The {{-1}} value translates to 100ms. See
> {{org.apache.flink.streaming.api.graph.StreamingJobGraphGenerator#checkAndResetBufferTimeout}}
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
