[SPARK-12244] Rename trackStateByKey to mapWithState

• Type: Bug
• Status: Resolved
• Priority: Blocker
• Resolution: Fixed
• Fix Version/s: 1.6.0
• Component/s: DStreams
• Target Version/s: 1.6.0
• Epic Link: Improved State Management
• Assignee: Tathagata Das
• Reporter: Tathagata Das
• Created: 09/Dec/15 20:38
• Updated: 10/Dec/15 05:04
• Resolved: 10/Dec/15 05:04

Description

Based on feedback from early users and personal experience attempting to explain it, the name trackStateByKey had two problem.

• "trackState" is a completely new term which really does not give any intuition on what the operation is
• the resultant data stream of objects returned by the function is called in docs as the "emitted" data for the lack of a better.

"mapWithState" makes sense because the API is like a mapping function like (Key, Value) => T with State as an additional parameter. The resultant data stream is "mapped data". So both problems are solved.

Issue Links

• links to: [Github] Pull Request #10224 (tdas)