[ 
https://issues.apache.org/jira/browse/FLINK-4047?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15853688#comment-15853688
 ] 

Fabian Hueske commented on FLINK-4047:
--------------------------------------

Identity is something different. The computed key value might (and usually is) 
different from the input value.

We need to change "arbitrary computations" to "deterministic computations". 
It would be good to add a bit more detail to explain what this means.

> Fix documentation about determinism of KeySelectors
> ---------------------------------------------------
>
>                 Key: FLINK-4047
>                 URL: https://issues.apache.org/jira/browse/FLINK-4047
>             Project: Flink
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 1.1.0, 1.0.3
>            Reporter: Fabian Hueske
>              Labels: starter
>
> KeySelectors must return deterministic keys, i.e., if invoked multiple times 
> on the same object, the returned key must be the same.
> The documentation about this aspect is broken ("The key can be of any type 
> and be derived from arbitrary computations.").
> We need to fix the JavaDocs of the {{KeySelector}} interface and the web 
> documentation 
> (https://ci.apache.org/projects/flink/flink-docs-master/apis/common/index.html#specifying-keys).



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to