ErickErickson commented on a change in pull request #1692:
URL: https://github.com/apache/lucene-solr/pull/1692#discussion_r460286512
##########
File path: solr/solr-ref-guide/src/shards-and-indexing-data-in-solrcloud.adoc
##########
@@ -122,6 +122,8 @@ More details on how to use shard splitting is in the
section on the Collection A
In most cases, when running in SolrCloud mode, indexing client applications
should not send explicit commit requests. Rather, you should configure auto
commits with `openSearcher=false` and auto soft-commits to make recent updates
visible in search requests. This ensures that auto commits occur on a regular
schedule in the cluster.
+NOTE: Using auto soft commit or commitWithin requires the client app to
embrace the realities of "eventual consistency". Solr will make documents
searchable at _roughly_ the same time across NRT replicas of a collection but
there are no hard guarantees. Consequently, in rare cases, it's possible for a
document to show up in one search only for it not to appear in a subsequent
search occurring immediately after when the second search is routed to a
different replica. Also, documents added in a particular order (even in the
same batch) might become searchable out of the order of submission when there
is sharding.
Review comment:
"auto soft commit"
IDK whether it's worth including hard-commit-with-opensearcher=true
"across NRT replicas"
Same thing happens with TLOG/PULL replicas. The followers' polling time may
expire at skewed times. Maybe just take the "NRT" out?
"when there is sharding."
I think it would be reassuring to say that the document will become visible
even in this case. Perhaps add a sentence like: "The document will become
visible on all replicas of a shard after the next auto commit or commitWithin
interval expires.".
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org
