tikv
/
client-go
mirror of https://github.com/tikv/client-go.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Go client for TiKV
458 Commits 27 Branches 11 Tags 33 MiB
Go 99.9%
Go to file
MyonKeminta 92db9f7b15
Support specifying checking forUpdateTS in prewrite (#756) 
* Support specifying checking forUpdateTS in prewrite

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Fix go mod in tests

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Add test

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Fix test

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Add successful cases to the test

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Fix test

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Update dependencies

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

* Check LockedWithConflictTS greater than requested ForUpdateTS

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>

---------

Signed-off-by: MyonKeminta <MyonKeminta@users.noreply.github.com>
Co-authored-by: MyonKeminta <MyonKeminta@users.noreply.github.com>
 		2023-04-17 14:53:28 +08:00
.github *: remove deprecated linters (#726) 2023-03-06 12:17:18 +08:00
config region_request: handle resource group error before Backoff (#719) 2023-03-02 13:40:57 +08:00
error region_request: handle resource group error before Backoff (#719) 2023-03-02 13:40:57 +08:00
examples config support both path and names (#683) 2023-02-02 18:11:45 +08:00
integration_tests Support specifying checking forUpdateTS in prewrite (#756) 2023-04-17 14:53:28 +08:00
internal Finer `is_retry_request` settings (#763) 2023-04-10 10:39:43 +08:00
kv region_request: handle resource group error before Backoff (#719) 2023-03-02 13:40:57 +08:00
metrics metrics: add txn ttl lifetime (#766) 2023-04-14 13:59:29 +08:00
oracle fix data race at the memChangeHook (#625) 2022-11-28 10:56:02 +08:00
rawkv Finer `is_retry_request` settings (#763) 2023-04-10 10:39:43 +08:00
testutils fix license (#267) 2021-08-15 01:48:01 +08:00
tikv Finer `is_retry_request` settings (#763) 2023-04-10 10:39:43 +08:00
tikvrpc Support return TiFlash system table by grpc (#759) 2023-04-06 14:42:57 +08:00
txnkv Support specifying checking forUpdateTS in prewrite (#756) 2023-04-17 14:53:28 +08:00
util Introduce the RURuntimeStats (#732) 2023-03-16 10:19:36 +08:00
.gitignore rechange to retry when tikv disk full (#302) 2021-09-15 13:01:35 +08:00
.golangci.yml *: remove deprecated linters (#726) 2023-03-06 12:17:18 +08:00
CONTRIBUTING.md add contributing (#94) 2021-06-19 04:01:45 +08:00
LICENSE Initial commit 2018-12-01 12:03:35 +08:00
README.md Update README.md (#571) 2022-08-25 11:10:36 +08:00
go.mod Support specifying checking forUpdateTS in prewrite (#756) 2023-04-17 14:53:28 +08:00
go.sum Support specifying checking forUpdateTS in prewrite (#756) 2023-04-17 14:53:28 +08:00

README.md

TiKV Go Client

TiKV Go Client provides support for interacting with the TiKV server in the form of a Go library.

Stability Active Go Reference

Unit Test Integration Test Compatibility Test

Package versions

There are 2 major versions of the client-go package.

  • v2 is the latest stable version. This version was extracted from pingcap/tidb and it includes new TiKV features like Follower Read, 1PC, Async Commit. The development of this version is on the master branch. The documentation for this version is below.

  • v1 is the previous stable version and is only maintained for bug fixes. You can read the documentation here.

Usage/Examples

  # valid versions be like @latest, @e5f932ae270887550b0cd221343dbd6b870b6c8f, @v2.0.0, @v2.0.1...
  go get github.com/tikv/client-go/v2@COMMIT_HASH_OR_TAG_VERSION

Explanation of related concepts and sample code can be found in the Client-Go Wiki. There are also executable examples in examples directory.

Contributing to client-go

Pull Requests and issues are welcomed. Please check CONTRIBUTING.md.

Developing

Running Tests

Note: All the following tests are included in the CI and you can submit a Pull Request directly to hand over the work.

To run unit tests, use following command

go test ./...

To run code linter, make sure golangci-lint is installed. Then use following command

golangci-lint run

integration_tests can run against a real TiKV cluster. Here is an example:

./pd-server &
sleep 5
./tikv-server &
sleep 10
cd integration_tests
go test --with-tikv

Test with TiDB

It is a common task to update client-go and then test it with TiDB.

If you only need to test locally, you can directly use the modified client-go on the same host by replacing:

go mod edit -replace=github.com/tikv/client-go/v2=/path/to/client-go

If you want to push your TiDB code to GitHub for running CI or for code review, you need to change the client-go used by TiDB to your developing branch using the following steps:

go get -d github.com/GITHUB_USERNAME/client-go/v2@DEV_BRANCH
# Output:
# go get: github.com/GITHUB_USERNAME/client-go/v2@none updating to
#         github.com/GITHUB_USERNAME/client-go/v2@v2.0.0-XXXXXXXXXXXXXX-XXXXXXXXXXXX: parsing go.mod:
#         module declares its path as: github.com/tikv/client-go/v2
#                 but was required as: github.com/GITHUB_USERNAME/client-go/v2
go mod edit -replace=github.com/tikv/client-go/v2=github.com/GITHUB_USERNAME/client-go/v2@v2.0.0-XXXXXXXXXXXXXX-XXXXXXXXXXXX
go mod download github.com/tikv/client-go/v2

Used By

client-go is used by the following projects:

  • TiDB: TiDB is an open source distributed HTAP database compatible with the MySQL protocol
  • BR: A command-line tool for distributed backup and restoration of the TiDB cluster data
  • TiCDC: Change data capture for TiDB
  • go-ycsb: A Go port of Yahoo! Cloud Serving Benchmark (YCSB)
  • JuiceFS: JuiceFS is a distributed POSIX file system built on top of Redis and S3
  • tcli: A CLI tool for TiKV, for human being :)

License

Apache License 2.0