[
https://issues.apache.org/jira/browse/FLINK-12525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Flink Jira Bot updated FLINK-12525:
-----------------------------------
Labels: auto-deprioritized-major stale-minor (was:
auto-deprioritized-major)
I am the [Flink Jira Bot|https://github.com/apache/flink-jira-bot/] and I help
the community manage its development. I see this issues has been marked as
Minor but is unassigned and neither itself nor its Sub-Tasks have been updated
for 180 days. I have gone ahead and marked it "stale-minor". If this ticket is
still Minor, please either assign yourself or give an update. Afterwards,
please remove the label or in 7 days the issue will be deprioritized.
> Impose invariant StreamExecutionEnvironment.setBufferTimeout > 0
> ----------------------------------------------------------------
>
> Key: FLINK-12525
> URL: https://issues.apache.org/jira/browse/FLINK-12525
> Project: Flink
> Issue Type: Improvement
> Components: API / DataStream, Runtime / Network
> Reporter: Robert Stoll
> Priority: Minor
> Labels: auto-deprioritized-major, stale-minor
>
> The documentation for the [DataStream
> API|https://github.com/apache/flink/blob/8674b69964eae50cad024f2c5caf92a71bf21a09/docs/dev/datastream_api.md#controlling-latency]
> states:
> {quote}buffer timeout of 0 should be avoided, because it can cause severe
> performance degradation.
> {quote}
> I don't know if the documentation is not appropriate and there are valid
> cases where a timeout of 0 makes sense. But if not, then the invariant should
> not be
> {code}
> if (timeoutMillis < -1) {
> throw new IllegalArgumentException("Timeout of buffer must be non-negative
> or -1");
> }
> {code}
> But {{timeoutMillis < 0}} (can also be a second invariant)
> IMO it is bad practice to state it only in the documentation. The API should
> guide the user in this case (in this sense a second invariant stating the
> quote above would make more sense).
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
