You can quickly test tidb with docker, the source repository contains the Dockerfile which contains local tidb-server.
Or you can pull TiDB docker image contains HBase standalone and then run TiDB as distributed database in a docker container.
To install docker on your system, you can read the document on https://docs.docker.com/
docker pull pingcap/tidb:latest
docker run --name tidb-server -d -p 4000:4000 pingcap/tidb:latest
docker pull
may take a while to download images ~560M.
Then you can use official mysql client to connect to TiDB.
mysql -h 127.0.0.1 -P 4000 -u root -D test
Notice: OSX user may use docker-machine ip
to connect it.
Read this doc.
Go environment. Currently a 64-bit version of go >= 1.5 is required.
git clone https://github.com/pingcap/tidb.git $GOPATH/src/github.com/pingcap/tidb
cd $GOPATH/src/github.com/pingcap/tidb
make
Interpreter is an interactive command line TiDB client. You can just enter some SQL statements and get the result.
make interpreter
cd interpreter && ./interpreter
Press Ctrl+C
to quit.
See USAGE.md for detailed instructions to use TiDB as library in Go code.
make server
cd tidb-server && ./tidb-server
In case you want to compile a specific location:
make server TARGET=$GOPATH/bin/tidb-server
The default server port is 4000
and can be changed by flag -P <port>
.
Run ./tidb-server -h
to see more flag options.
After you started tidb-server, you can use official mysql client to connect to TiDB.
mysql -h 127.0.0.1 -P 4000 -u root -D test