README
¶
Vitess
Vitess is a set of servers and tools meant to facilitate scaling of MySQL databases for the web. It's currently used as a fundamental component of YouTube's MySQL infrastructure.
The project is currently under active development. We haven't spent much time on documentation. However, you can subscribe to our mailing list vitess@googlegroups.com for questions and updates.
Development
cd $WORKSPACE
sudo apt-get install automake libtool flex bison memcached python-mysqldb libssl-dev # to compile MySQL
git clone git@github.com:youtube/vitess.git src/github.com/youtube/vitess
cd src/github.com/youtube/vitess
./bootstrap.sh
. ./dev.env
Optionally:
VTDATAROOT=... # $VTROOT/vt if not set
VTPORTSTART=15000
To run the tests:
make # run the tests
License
Unless otherwise noted, the vitess source files are distributed under the BSD-style license found in the LICENSE file.
Directories
¶
| Path | Synopsis |
|---|---|
|
go
|
|
|
bufio2
Package bufio implements buffered I/O. It wraps an io.Reader or io.Writer object, creating another object (Reader or AsyncWriter) that also implements the interface but provides buffering and some help for textual I/O.
|
Package bufio implements buffered I/O. It wraps an io.Reader or io.Writer object, creating another object (Reader or AsyncWriter) that also implements the interface but provides buffering and some help for textual I/O. |
|
cache
The implementation borrows heavily from SmallLRUCache (originally by Nathan Schrenk).
|
The implementation borrows heavily from SmallLRUCache (originally by Nathan Schrenk). |
|
cmd/normalizer
normalizer takes a file of sql statements as input and converts the statements into normalized sql statements with bind variables.
|
normalizer takes a file of sql statements as input and converts the statements into normalized sql statements with bind variables. |
|
cmd/vt_binlog_player
The vt_binlog_player reads data from the a remote host via vt_binlog_server.
|
The vt_binlog_player reads data from the a remote host via vt_binlog_server. |
|
cmd/vt_binlog_server
vt binlog server: Serves binlog for out of band replication.
|
vt binlog server: Serves binlog for out of band replication. |
|
cmd/vttablet
vt tablet server: Serves queries and performs housekeeping jobs.
|
vt tablet server: Serves queries and performs housekeeping jobs. |
|
cmd/vttopo
toporeader is a plain non-caching interface to the topo.Server API, to discover the serving graph.
|
toporeader is a plain non-caching interface to the topo.Server API, to discover the serving graph. |
|
netutil
This packages contains a few utility functions for network related functions.
|
This packages contains a few utility functions for network related functions. |
|
pools
Package pools provides functionality to manage and reuse resources like connections.
|
Package pools provides functionality to manage and reuse resources like connections. |
|
proc
Package proc allows you to configure servers to be restarted with negligible downtime.
|
Package proc allows you to configure servers to be restarted with negligible downtime. |
|
rpcplus
Package rpc provides access to the exported methods of an object across a network or other I/O connection.
|
Package rpc provides access to the exported methods of an object across a network or other I/O connection. |
|
rpcplus/jsonrpc
Package jsonrpc implements a JSON-RPC ClientCodec and ServerCodec for the rpc package.
|
Package jsonrpc implements a JSON-RPC ClientCodec and ServerCodec for the rpc package. |
|
sqltypes
Package sqltypes implements interfaces and types that represent SQL values.
|
Package sqltypes implements interfaces and types that represent SQL values. |
|
stats
Package stats is a wrapper for expvar.
|
Package stats is a wrapper for expvar. |
|
timer
Package timer provides timer functionality that can be controlled by the user.
|
Package timer provides timer functionality that can be controlled by the user. |
|
vt/client2/tablet
API compliant to the requirements of database/sql Open expects name to be "hostname:port/keyspace/shard" For query arguments, we assume place-holders in the query string in the form of :v0, :v1, etc.
|
API compliant to the requirements of database/sql Open expects name to be "hostname:port/keyspace/shard" For query arguments, we assume place-holders in the query string in the form of :v0, :v1, etc. |
|
vt/dbconfigs
Package dbconfigs is reusable by vt tools to load the db configs file.
|
Package dbconfigs is reusable by vt tools to load the db configs file. |
|
vt/mysqlctl
vt binlog server: Serves binlog for out of band replication.
|
vt binlog server: Serves binlog for out of band replication. |
|
vt/topo/test
package test contains utilities to test topo.Server implementations.
|
package test contains utilities to test topo.Server implementations. |
|
vt/topotools
topotools package contains a few utility classes to handle topo.Server objects, and transitions.
|
topotools package contains a few utility classes to handle topo.Server objects, and transitions. |
|
vt/vtgate
Package vtgate provides query routing rpc services for vttablets.
|
Package vtgate provides query routing rpc services for vttablets. |
|
vt/vttablet
Package vttablet contains the meat of the vttablet binary.
|
Package vttablet contains the meat of the vttablet binary. |
|
zk
Emulate a "global" namespace across n zk quorums.
|
Emulate a "global" namespace across n zk quorums. |
|
zk/fakezk
Package fakezk is a pretty complete mock implementation of a Zookeper connection (see go/zk/zk.Conn).
|
Package fakezk is a pretty complete mock implementation of a Zookeper connection (see go/zk/zk.Conn). |
|
zk/zkocc
cache for zkocc
|
cache for zkocc |
|
test
|
|
|
third_party
|
|
|
go/launchpad.net/gozk/zookeeper
gozk - ZooKeeper support for the Go language
|
gozk - ZooKeeper support for the Go language |
Click to show internal directories.
Click to hide internal directories.