org.elasticsearch.index.engine

Class ShadowEngine

java.lang.Object

org.elasticsearch.index.engine.Engine

org.elasticsearch.index.engine.ShadowEngine

All Implemented Interfaces:

Closeable, AutoCloseable

public class ShadowEngine
extends Engine

ShadowEngine is a specialized engine that only allows read-only operations on the underlying Lucene index. An IndexReader is opened instead of an IndexWriter. All methods that would usually perform write operations are no-ops, this means: - No operations are written to or read from the translog - Create, Index, and Delete do nothing - Flush does not fsync any files, or make any on-disk changes In order for new segments to become visible, the ShadowEngine may perform stage1 of the traditional recovery process (copying segment files) from a regular primary (which uses InternalEngine) Notice that since this Engine does not deal with the translog, any Engine.get(Get get) request goes directly to the searcher, meaning it is non-realtime.

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.index.engine.Engine

Engine.CommitId, Engine.Create, Engine.Delete, Engine.DeleteByQuery, Engine.FailedEngineListener, Engine.Get, Engine.GetResult, Engine.Index, Engine.IndexingOperation, Engine.IndexThrottle, Engine.NoOpLock, Engine.Operation, Engine.Searcher, Engine.SyncedFlushResult

Field Summary

Fields

Modifier and Type	Field and Description
static TimeValue	DEFAULT_NONEXISTENT_INDEX_RETRY_WAIT
static String	NONEXISTENT_INDEX_RETRY_WAIT how long to wait for an index to exist

Fields inherited from class org.elasticsearch.index.engine.Engine

deletionPolicy, engineConfig, failedEngine, failedEngineListener, failEngineLock, isClosed, logger, readLock, rwl, shardId, store, SYNC_COMMIT_ID, writeLock

Constructor Summary

Constructors

Constructor and Description
ShadowEngine(EngineConfig engineConfig)

Method Summary

Modifier and Type	Method and Description
protected void	closeNoLock(String reason) Method to close the engine while the write lock is held.
void	create(Engine.Create create)
void	delete(Engine.Delete delete)
void	delete(Engine.DeleteByQuery delete) Deprecated. This was removed, but we keep this API so translog can replay any DBQs on upgrade.
Engine.CommitId	flush() Flushes the state of the engine including the transaction log, clearing memory and persisting documents in the lucene index to disk including a potentially heavy and durable fsync operation.
Engine.CommitId	flush(boolean force, boolean waitIfOngoing) Flushes the state of the engine including the transaction log, clearing memory.
void	forceMerge(boolean flush, int maxNumSegments, boolean onlyExpungeDeletes, boolean upgrade, boolean upgradeOnlyAncientSegments) Triggers a forced merge on this engine
Engine.GetResult	get(Engine.Get get)
protected org.apache.lucene.index.SegmentInfos	getLastCommittedSegmentInfos()
protected org.apache.lucene.search.SearcherManager	getSearcherManager()
Translog	getTranslog() returns the translog for this engine
boolean	hasUncommittedChanges() Returns true the internal writer has any uncommitted changes.
boolean	index(Engine.Index index)
long	indexWriterRAMBytesUsed() How much heap Lucene's IndexWriter is using
void	refresh(String source) Refreshes the engine for new search operations to reflect the latest changes.
List<Segment>	segments(boolean verbose) The list of segments in the engine.
SnapshotIndexCommit	snapshotIndex(boolean flushFirst) Snapshots the index and returns a handle to it.
Engine.SyncedFlushResult	syncFlush(String syncId, Engine.CommitId expectedCommitId) Attempts to do a special commit where the given syncID is put into the commit data.

Methods inherited from class org.elasticsearch.index.engine.Engine

acquireSearcher, acquireSearcher, close, commitStats, config, ensureOpen, failEngine, flushAndClose, forceMerge, getFromSearcher, getMergeStats, getSegmentInfo, guardedRamBytesUsed, isMergedSegment, maybeFailEngine, newSearcher, onSettingsChanged, readLastCommittedSegmentInfos, refreshNeeded, segmentReader, segmentsStats, wrapIfClosed, writerSegmentStats

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NONEXISTENT_INDEX_RETRY_WAIT

public static final String NONEXISTENT_INDEX_RETRY_WAIT

how long to wait for an index to exist

See Also:

Constant Field Values

DEFAULT_NONEXISTENT_INDEX_RETRY_WAIT

public static final TimeValue DEFAULT_NONEXISTENT_INDEX_RETRY_WAIT

Constructor Detail

ShadowEngine

public ShadowEngine(EngineConfig engineConfig)

Method Detail

create

public void create(Engine.Create create)
            throws EngineException

Specified by:

create in class Engine

Throws:

EngineException

index

public boolean index(Engine.Index index)
              throws EngineException

Specified by:

index in class Engine

Throws:

EngineException

delete

public void delete(Engine.Delete delete)
            throws EngineException

Specified by:

delete in class Engine

Throws:

EngineException

delete

@Deprecated
public void delete(Engine.DeleteByQuery delete)
                        throws EngineException

Deprecated. This was removed, but we keep this API so translog can replay any DBQs on upgrade.

Specified by:

delete in class Engine

Throws:

EngineException

syncFlush

public Engine.SyncedFlushResult syncFlush(String syncId,
                                          Engine.CommitId expectedCommitId)

Description copied from class: Engine

Attempts to do a special commit where the given syncID is put into the commit data. The attempt succeeds if there are not pending writes in lucene and the current point is equal to the expected one.

Specified by:

syncFlush in class Engine

Parameters:

syncId - id of this sync

expectedCommitId - the expected value of

Returns:

true if the sync commit was made, false o.w.

flush

public Engine.CommitId flush()
                      throws EngineException

Description copied from class: Engine

Flushes the state of the engine including the transaction log, clearing memory and persisting documents in the lucene index to disk including a potentially heavy and durable fsync operation. This operation is not going to block if another flush operation is currently running and won't write a lucene commit if nothing needs to be committed.

Specified by:

flush in class Engine

Returns:

the commit Id for the resulting commit

Throws:

EngineException

flush

public Engine.CommitId flush(boolean force,
                             boolean waitIfOngoing)
                      throws EngineException

Description copied from class: Engine

Flushes the state of the engine including the transaction log, clearing memory.

Specified by:

flush in class Engine

Parameters:

force - if true a lucene commit is executed even if no changes need to be committed.

waitIfOngoing - if true this call will block until all currently running flushes have finished. Otherwise this call will return without blocking.

Returns:

the commit Id for the resulting commit

Throws:

EngineException

forceMerge

public void forceMerge(boolean flush,
                       int maxNumSegments,
                       boolean onlyExpungeDeletes,
                       boolean upgrade,
                       boolean upgradeOnlyAncientSegments)
                throws EngineException

Description copied from class: Engine

Triggers a forced merge on this engine

Specified by:

forceMerge in class Engine

Throws:

EngineException

get

public Engine.GetResult get(Engine.Get get)
                     throws EngineException

Specified by:

get in class Engine

Throws:

EngineException

getTranslog

public Translog getTranslog()

Description copied from class: Engine

returns the translog for this engine

Specified by:

getTranslog in class Engine

segments

public List<Segment> segments(boolean verbose)

Description copied from class: Engine

The list of segments in the engine.

Specified by:

segments in class Engine

refresh

public void refresh(String source)
             throws EngineException

Description copied from class: Engine

Refreshes the engine for new search operations to reflect the latest changes.

Specified by:

refresh in class Engine

Throws:

EngineException

snapshotIndex

public SnapshotIndexCommit snapshotIndex(boolean flushFirst)
                                  throws EngineException

Description copied from class: Engine

Snapshots the index and returns a handle to it. If needed will try and "commit" the lucene index to make sure we have a "fresh" copy of the files to snapshot.

Specified by:

snapshotIndex in class Engine

Parameters:

flushFirst - indicates whether the engine should flush before returning the snapshot

Throws:

EngineException

getSearcherManager

protected org.apache.lucene.search.SearcherManager getSearcherManager()

Specified by:

getSearcherManager in class Engine

closeNoLock

protected void closeNoLock(String reason)

Description copied from class: Engine

Method to close the engine while the write lock is held.

Specified by:

closeNoLock in class Engine

hasUncommittedChanges

public boolean hasUncommittedChanges()

Description copied from class: Engine

Returns true the internal writer has any uncommitted changes. Otherwise false

Specified by:

hasUncommittedChanges in class Engine

getLastCommittedSegmentInfos

protected org.apache.lucene.index.SegmentInfos getLastCommittedSegmentInfos()

Specified by:

getLastCommittedSegmentInfos in class Engine

indexWriterRAMBytesUsed

public long indexWriterRAMBytesUsed()

Description copied from class: Engine

How much heap Lucene's IndexWriter is using

Specified by:

indexWriterRAMBytesUsed in class Engine