org.elasticsearch.index.snapshots

インタフェース IndexShardRepository

既知の実装クラスのリスト:

BlobStoreIndexShardRepository, URLIndexShardRepository

public interface IndexShardRepository

Shard-level snapshot repository

IndexShardRepository is used on data node to create snapshots of individual shards. See Repository for more information.

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	restore(SnapshotId snapshotId, Version version, ShardId shardId, ShardId snapshotShardId, RecoveryState recoveryState) Restores snapshot of the shard.
void	snapshot(SnapshotId snapshotId, ShardId shardId, SnapshotIndexCommit snapshotIndexCommit, IndexShardSnapshotStatus snapshotStatus) Creates a snapshot of the shard based on the index commit point.
IndexShardSnapshotStatus	snapshotStatus(SnapshotId snapshotId, Version version, ShardId shardId) Retrieve shard snapshot status for the stored snapshot
void	verify(String verificationToken) Verifies repository settings on data node

メソッドの詳細

snapshot

void snapshot(SnapshotId snapshotId,
              ShardId shardId,
              SnapshotIndexCommit snapshotIndexCommit,
              IndexShardSnapshotStatus snapshotStatus)

Creates a snapshot of the shard based on the index commit point.

The index commit point can be obtained by using Engine.snapshotIndex(boolean) method. IndexShardRepository implementations shouldn't release the snapshot index commit point. It is done by the method caller.

As snapshot process progresses, implementation of this method should update IndexShardSnapshotStatus object and check IndexShardSnapshotStatus.aborted() to see if the snapshot process should be aborted.

パラメータ:

snapshotId - snapshot id

shardId - shard to be snapshotted

snapshotIndexCommit - commit point

snapshotStatus - snapshot status

restore

void restore(SnapshotId snapshotId,
             Version version,
             ShardId shardId,
             ShardId snapshotShardId,
             RecoveryState recoveryState)

Restores snapshot of the shard.

The index can be renamed on restore, hence different shardId and snapshotShardId are supplied.

パラメータ:

snapshotId - snapshot id

shardId - shard id (in the current index)

version - version of elasticsearch that created this snapshot

snapshotShardId - shard id (in the snapshot)

recoveryState - recovery state

snapshotStatus

IndexShardSnapshotStatus snapshotStatus(SnapshotId snapshotId,
                                        Version version,
                                        ShardId shardId)

Retrieve shard snapshot status for the stored snapshot

パラメータ:

snapshotId - snapshot id

version - version of elasticsearch that created this snapshot

shardId - shard id

戻り値:

snapshot status

verify

void verify(String verificationToken)

Verifies repository settings on data node

パラメータ:

verificationToken - value returned by Repository.startVerification()