org.tikv.kvproto

Class ImportKVGrpc.ImportKVBlockingStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractBlockingStub<ImportKVGrpc.ImportKVBlockingStub>

org.tikv.kvproto.ImportKVGrpc.ImportKVBlockingStub

Enclosing class:

ImportKVGrpc

public static final class ImportKVGrpc.ImportKVBlockingStub
extends io.grpc.stub.AbstractBlockingStub<ImportKVGrpc.ImportKVBlockingStub>

A stub to allow clients to do synchronous 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.ImportKVBlockingStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
ImportKvpb.CleanupEngineResponse	cleanupEngine(ImportKvpb.CleanupEngineRequest request) Clean up the engine.
ImportKvpb.CloseEngineResponse	closeEngine(ImportKvpb.CloseEngineRequest request) Close the engine.
ImportKvpb.CompactClusterResponse	compactCluster(ImportKvpb.CompactClusterRequest request) Compact the target cluster for better performance.
ImportKvpb.GetMetricsResponse	getMetrics(ImportKvpb.GetMetricsRequest request) Get importer metrics
ImportKvpb.GetVersionResponse	getVersion(ImportKvpb.GetVersionRequest request) Get current version and commit hash
ImportKvpb.ImportEngineResponse	importEngine(ImportKvpb.ImportEngineRequest request) Import the engine to the target cluster.
ImportKvpb.OpenEngineResponse	openEngine(ImportKvpb.OpenEngineRequest request) Open an engine.
ImportKvpb.SwitchModeResponse	switchMode(ImportKvpb.SwitchModeRequest request) Switch the target cluster to normal/import mode.
ImportKvpb.WriteEngineResponse	writeEngineV3(ImportKvpb.WriteEngineV3Request request) Write to engine, single message version

Methods inherited from class io.grpc.stub.AbstractBlockingStub

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.ImportKVBlockingStub build(io.grpc.Channel channel,
                                                  io.grpc.CallOptions callOptions)

Specified by:

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

switchMode

public ImportKvpb.SwitchModeResponse switchMode(ImportKvpb.SwitchModeRequest request)

 Switch the target cluster to normal/import mode.
 

openEngine

public ImportKvpb.OpenEngineResponse openEngine(ImportKvpb.OpenEngineRequest request)

 Open an engine.
 

writeEngineV3

public ImportKvpb.WriteEngineResponse writeEngineV3(ImportKvpb.WriteEngineV3Request request)

 Write to engine, single message version
 

closeEngine

public ImportKvpb.CloseEngineResponse closeEngine(ImportKvpb.CloseEngineRequest request)

 Close the engine.
 

importEngine

public ImportKvpb.ImportEngineResponse importEngine(ImportKvpb.ImportEngineRequest request)

 Import the engine to the target cluster.
 

cleanupEngine

public ImportKvpb.CleanupEngineResponse cleanupEngine(ImportKvpb.CleanupEngineRequest request)

 Clean up the engine.
 

compactCluster

public ImportKvpb.CompactClusterResponse compactCluster(ImportKvpb.CompactClusterRequest request)

 Compact the target cluster for better performance.
 

getVersion

public ImportKvpb.GetVersionResponse getVersion(ImportKvpb.GetVersionRequest request)

 Get current version and commit hash
 

getMetrics

public ImportKvpb.GetMetricsResponse getMetrics(ImportKvpb.GetMetricsRequest request)

 Get importer metrics