Skip to content

[MINOR] Improve docs for Global Store operations#6803

Merged
bbejeck merged 2 commits into
apache:trunkfrom
ableegoldman:GlobalStoreDocs
May 30, 2019
Merged

[MINOR] Improve docs for Global Store operations#6803
bbejeck merged 2 commits into
apache:trunkfrom
ableegoldman:GlobalStoreDocs

Conversation

@ableegoldman

Copy link
Copy Markdown
Member

A lot of confusion seems to have arisen from the StreamBuilder#addGlobalStore(...ProcessorSupplier) method. Users have assumed they can safely use this to transform records before populating their global state store; unfortunately this results in corrupted data as on restore the records are read directly from the source topic changelog, bypassing their custom processor.

We should probably provide a means to do this at some point but for the time being we should clarify the proper use of #addGlobalStore as it currently functions

@ableegoldman

Copy link
Copy Markdown
Member Author

* <p>
* The provided {@link ProcessorSupplier} will be used to create an {@link ProcessorNode} that will receive all
* records forwarded from the {@link SourceNode}.
* records forwarded from the {@link SourceNode}. NOTE: you should not use this to insert transformed records into

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: remove use this to

Or use the {@code Processor} to

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ack

@cadonna

cadonna commented May 28, 2019

Copy link
Copy Markdown
Member

Retest this, please

@bbejeck

bbejeck commented May 29, 2019

Copy link
Copy Markdown
Member

retest this please

@ableegoldman

Copy link
Copy Markdown
Member Author

Do we really need a green build for this? It's just docs...

@bbejeck
bbejeck merged commit 91ccbca into apache:trunk May 30, 2019
@bbejeck

bbejeck commented May 30, 2019

Copy link
Copy Markdown
Member

Merged #6803 to trunk

bbejeck pushed a commit that referenced this pull request May 30, 2019
A lot of confusion seems to have arisen from the StreamBuilder#addGlobalStore(...ProcessorSupplier) method. Users have assumed they can safely use this to transform records before populating their global state store; unfortunately this results in corrupted data as on restore the records are read directly from the source topic changelog, bypassing their custom processor.

We should probably provide a means to do this at some point but for the time being we should clarify the proper use of #addGlobalStore as it currently functions

Reviewers:  Matthias J. Sax <mjsax@apache.org>, Bruno Cadonna <bruno@confluent.io>
@bbejeck

bbejeck commented May 30, 2019

Copy link
Copy Markdown
Member

cherry-picked to 2.3

pengxiaolong pushed a commit to pengxiaolong/kafka that referenced this pull request Jun 14, 2019
A lot of confusion seems to have arisen from the StreamBuilder#addGlobalStore(...ProcessorSupplier) method. Users have assumed they can safely use this to transform records before populating their global state store; unfortunately this results in corrupted data as on restore the records are read directly from the source topic changelog, bypassing their custom processor.

We should probably provide a means to do this at some point but for the time being we should clarify the proper use of #addGlobalStore as it currently functions

Reviewers:  Matthias J. Sax <mjsax@apache.org>, Bruno Cadonna <bruno@confluent.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants