TiKV JAVA Client

A Java client for TiKV. It is supposed to:

• Communicate via gRPC
• Talk to Placement Driver searching for a region
• Talk to TiKV for reading/writing data

Quick Start

TiKV Java Client is designed to communicate with PD and TiKV, please run PD and TiKV in advance.

Build Java client from source file:

mvn clean install -Dmaven.test.skip=true

Add maven dependency to pom.xml:

<dependency>
<groupId>org.tikv</groupId>
<artifactId>tikv-client-java</artifactId>
<version>3.3.0</version>
</dependency>

Create a transactional KVClient and communicates with TiKV:

importorg.tikv.common.TiConfiguration;
importorg.tikv.common.TiSession;
importorg.tikv.txn.KVClient;
publicclassMain {
publicstaticvoidmain(String[] args) throwsException {
TiConfigurationconf = TiConfiguration.createDefault(YOUR_PD_ADDRESSES);
TiSessionsession = TiSession.create(conf);
KVClientclient = session.createKVClient();
}
}

Or create a RawKVClient if you don't need the transaction semantic:

importorg.tikv.common.TiConfiguration;
importorg.tikv.common.TiSession;
importorg.tikv.raw.RawKVClient;
publicclassMain {
publicstaticvoidmain(String[] args) throwsException {
TiConfigurationconf = TiConfiguration.createRawDefault(YOUR_PD_ADDRESSES);
TiSessionsession = TiSession.create(conf);
RawKVClientclient = session.createRawClient();
}
}

Find more demo in TiKV Java Client User Documents

Documentation

See Java Client Documents for references about how to config and monitor Java Client.

A Maven site is also available. It includes:

1. API reference
2. Spotbugs Reports
3. Source Code Xref

Community

Forum

• User forum: AskTUG
• Contributor forum: https://internals.tidb.io/

Contribute to TiKV Java Client

See Contribution Guide for references about how to contribute to this project.

License

Apache 2.0 license. See the LICENSE file for details.