lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Hoss Man (JIRA)" <>
Subject [jira] [Commented] (SOLR-3539) rethink softCommit=true|false param on commits?
Date Tue, 12 Jun 2012 20:02:43 GMT


Hoss Man commented on SOLR-3539:

This is something that started to concern me while trying to update the tutorial.  I'm having
a hard time articulating my concerns to myself, so this will largely be stream of consciousness...

Both of these params seen defined more in terms of what they *don't* do then what they actually
do -- softCommit in particular -- and while they aren't too terrible to explain indivdually,
it's very hard to clearly articulate how they interplay with eachother.

* openSearcher
** true - opens a new searcher against this commit point
** false - does not open a new searcher against this commit point
* softCommit
** true - a new searcher is opened against the commit point, but no data is flushed to disk.
** false - the commit point is flushed to disk.

Certain combinations of these params seem redundent (openSearcher=true&softCommit=true)
while others not only make no sense, but are directly contradictory (openSearcher=false&softCommit=true)...

| - |softCommit=true|softCommit=false|
|openSearcher=true|openSearcher is redundent|OK|
|openSearcher=false|contradictory (openSearcher is currently ignored)|OK|

>From a vocabulary standpoint, they also seem confusing to understand.  Consider a new
user, starting with the 4x example which contains the following...


Documents this user adds will automaticly get flushed to disk, but won't be visible in search
results until the user takes some explicit action.  The user, upon reading some docs or asking
on the list will become aware that he needs to open a new searcher, and will be guided to
"do a commit" (or maybe a commit explicitly adding openSearcher=true).  But this is actually
overkill for what the user needs, because it will also flush any pending docs to disk.  All
the user really needs to "open a new searcher" is to do an explicit commit with softCommit=true.


I would like to suggest that we throw out the the "softCommit" param and replace it with a
"flush" (or "flushToDisk" or "persist") param, which is solely concerned with the persistence
of the commit, and completely disjoint from "searcher" opening which would be controled entirely
with the "openSearcher" param.

* openSearcher
** true - opens a new searcher against this commit point
** false - does not open a new searcher against this commit point
* flush
** true - flushes this commit point to stable storage
** false - does not flush this commit point to stable storage

Making the interaction much easier to understand...

| - |flush=true|flush=false|


I've mainly been thinking about this from a user perspective the last few days, so I haven'thad
a chance to figure out how much this would impact the internals related to softCommit right
now.  I supsect there are a lot of places that would need to be tweaked, but hopefully most
of them would just involve flipping logic (softCommit=true -> flush=false).  The biggest
challenges i can think of are:
* how to deal with the autocommit options in solrconfig.xml.  in 3x we supported a single
<autoCommit/> block.  On the 4x branch we support one <autoCommit/> lock and one
<autoSoftCommit/> block -- should we continue to do that? would <autoSoftCommit/>
just implicitly specify flush=false? or should we try to generalize to support N <autoCommit/>
blocks where <openSearcher/> and <flush/> are config options for all of them?
* event eventlistener -- it looks like the SolrEventListener API had a postSoftCommit() method
added to it, but it doesn't seem to be configurable in any way -- i think this is just for
tests, but if it's intentionally being expost we would need to revamp it ... off the cuff
i would suggest removing postSoftCommit() changing the postCommit() method to take in some
new structure specifying the options on the commit.

> rethink softCommit=true|false param on commits?
> -----------------------------------------------
>                 Key: SOLR-3539
>                 URL:
>             Project: Solr
>          Issue Type: Bug
>            Reporter: Hoss Man
>             Fix For: 4.0
> I think the current NTR related options when doing a commit, particularly "openSearcher="true|false"
and "softCommit=true|false", is confusing, and we should rethink them before they get baked
into the user API in 4.0.

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:!default.jspa
For more information on JIRA, see:


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message