org.tikv.kvproto

Class ImportKVGrpc.ImportKVFutureStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractFutureStub<ImportKVGrpc.ImportKVFutureStub>

org.tikv.kvproto.ImportKVGrpc.ImportKVFutureStub

Enclosing class:

ImportKVGrpc

public static final class ImportKVGrpc.ImportKVFutureStub
extends io.grpc.stub.AbstractFutureStub<ImportKVGrpc.ImportKVFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service ImportKV.

 ImportKV provides a service to import key-value pairs to TiKV.
 In order to import key-value pairs to TiKV, the user should:
 1. Open an engine identified by an UUID.
 2. Open write streams to write key-value batches to the opened engine.
    Different streams/clients can write to the same engine concurrently.
 3. Close the engine after all write batches have been finished. An
    engine can only be closed when all write streams are closed. An
    engine can only be closed once, and it can not be opened again
    once it is closed.
 4. Import the data in the engine to the target cluster. Note that
    the import process is not atomic, it requires the data to be
    idempotent on retry. An engine can only be imported after it is
    closed. An engine can be imported multiple times, but can not be
    imported concurrently.
 5. Clean up the engine after it has been imported. Delete all data
    in the engine. An engine can not be cleaned up when it is
    writing or importing.
 

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

Method Summary

Modifier and Type	Method and Description
protected ImportKVGrpc.ImportKVFutureStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.CleanupEngineResponse>	cleanupEngine(ImportKvpb.CleanupEngineRequest request) Clean up the engine.
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.CloseEngineResponse>	closeEngine(ImportKvpb.CloseEngineRequest request) Close the engine.
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.CompactClusterResponse>	compactCluster(ImportKvpb.CompactClusterRequest request) Compact the target cluster for better performance.
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.GetMetricsResponse>	getMetrics(ImportKvpb.GetMetricsRequest request) Get importer metrics
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.GetVersionResponse>	getVersion(ImportKvpb.GetVersionRequest request) Get current version and commit hash
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.ImportEngineResponse>	importEngine(ImportKvpb.ImportEngineRequest request) Import the engine to the target cluster.
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.OpenEngineResponse>	openEngine(ImportKvpb.OpenEngineRequest request) Open an engine.
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.SwitchModeResponse>	switchMode(ImportKvpb.SwitchModeRequest request) Switch the target cluster to normal/import mode.
com.google.common.util.concurrent.ListenableFuture<ImportKvpb.WriteEngineResponse>	writeEngineV3(ImportKvpb.WriteEngineV3Request request) Write to engine, single message version

Methods inherited from class io.grpc.stub.AbstractFutureStub

newStub, newStub

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOption, withWaitForReady

Methods inherited from class java.lang.Object

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

Method Detail

build

protected ImportKVGrpc.ImportKVFutureStub build(io.grpc.Channel channel,
                                                io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<ImportKVGrpc.ImportKVFutureStub>

switchMode

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.SwitchModeResponse> switchMode(ImportKvpb.SwitchModeRequest request)

 Switch the target cluster to normal/import mode.
 

openEngine

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.OpenEngineResponse> openEngine(ImportKvpb.OpenEngineRequest request)

 Open an engine.
 

writeEngineV3

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.WriteEngineResponse> writeEngineV3(ImportKvpb.WriteEngineV3Request request)

 Write to engine, single message version
 

closeEngine

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.CloseEngineResponse> closeEngine(ImportKvpb.CloseEngineRequest request)

 Close the engine.
 

importEngine

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.ImportEngineResponse> importEngine(ImportKvpb.ImportEngineRequest request)

 Import the engine to the target cluster.
 

cleanupEngine

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.CleanupEngineResponse> cleanupEngine(ImportKvpb.CleanupEngineRequest request)

 Clean up the engine.
 

compactCluster

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.CompactClusterResponse> compactCluster(ImportKvpb.CompactClusterRequest request)

 Compact the target cluster for better performance.
 

getVersion

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.GetVersionResponse> getVersion(ImportKvpb.GetVersionRequest request)

 Get current version and commit hash
 

getMetrics

public com.google.common.util.concurrent.ListenableFuture<ImportKvpb.GetMetricsResponse> getMetrics(ImportKvpb.GetMetricsRequest request)

 Get importer metrics