[FLINK-21467] Document possible recommended usage of Bounded{One/Multi}Input.endInput and emphasize that they could be called multiple times

• Type: Improvement
• Status: Closed
• Priority: Not a Priority
• Resolution: Implemented
• Affects Version/s: 1.13.0
• Fix Version/s: 1.13.6, 1.14.3, 1.15.0
• Component/s: API / DataStream
• Labels: auto-deprioritized-major pull-request-available stale-minor
• Assignee: Dawid Wysakowicz
• Reporter: Kezhu Wang
• Created: 23/Feb/21 13:06
• Updated: 15/Dec/21 01:44
• Resolved: 01/Dec/21 16:02

Description

It is too tempting to use these api, especially BoundedOneInput.endInput, to commit final result before FLIP-147 delivered. And this will cause re-commit after failover as gaoyunhaii has pointed out in FLINK-21132.

I have pointed this out in apache/iceberg#2033, please correct me if I was wrong.

cc aljoscha pnowojski roman_khachatryan

Issue Links

• links to: GitHub Pull Request #17929