8d877cc87c
Since we supported unix socket, use TiDB as a library no longer provide much benefit. Use MySQL driver should be the only way to access TiDB.
1.7 KiB
Quick Start
Run TiDB with docker
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 a 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.
Run TiDB on HBase
Read this doc.
Pre-requirement
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
Run command line interpreter
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.
Run as MySQL protocol server
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