×

cockroach db初体验

96
孙飞撩技术
2017.11.04 13:00* 字数 1147

结论前置 1。

  1. CR(笔者对cockroach的简称)数据库的产品体验比TIDB要好,例如官网、文档、部署维护、后台管理、监控,当然这里不是说tidb不好,tidb兼容mysql协议就非常棒,而且中文文档和中文的客服支持也是极棒的。

2.CR对标准sql的支持比较完善,详情见sql特性支持 sql语句

3.单节点性能大概是postgre数据库的60%,延迟抖动控制的较好

4.整体上手速度很快,从看文档、搭建环境到修改一个应用为postgre连接并成功的运行起来,大概1个小时左右

5.吐槽一下简书,代码高亮很不完善,估计是hilight.js中只引入了少数所谓主流语言的插件

下载

下载地址

下载极其简单,只要下载获得cockroach的binary文件(Go语言的可执行文件)即可

安装

安装文档

节点 Host
1 10.100.1.1
2 10.100.1.2
3 10.100.1.3

本文使用以下三个节点(host为虚构)

节点 Host
1 10.100.1.1
2 10.100.1.2
3 10.100.1.3
启动常用启动参数 描述
--insecure 不启用TLS加密模式,建议非生产环境使用
--host 数据库监听地址,默认为本机的外网IP
--port 数据库监听端口,默认为26257
--http-port HTTP请求的端口,比如后台管理服务,默认为8089
查看详细 cockroach start -h
启动节点1
cockroach start --insecure 

启动成功后能看到以下命令行提示(请忽略里面的主机信息):

* WARNING: RUNNING IN INSECURE MODE!
*
* - Your cluster is open for any client that can access <all your IP addresses>.
* - Any user, even root, can log in without providing a password.
* - Any user, connecting as root, can read or write any data in your cluster.
* - There is no network encryption nor authentication, and thus no confidentiality.
*
* Check out how to secure your cluster: https://www.cockroachlabs.com/docs/stable/secure-a-cluster.html
*

sf:cockroach-v1.1.2.darwin-10.9-amd64 sf$ CockroachDB node starting at 2017-11-04 03:57:55.322402865 +0000 UTC (took 1.0s)
build:      CCL v1.1.2 @ 2017/11/02 19:30:00 (go1.8.3)
admin:      http://sf.local:9090
sql:        postgresql://root@sf.local:26257?application_name=cockroach&sslmode=disable
logs:       /Users/sf/Downloads/cockroach-v1.1.2.darwin-10.9-amd64/cockroach-data/logs
store[0]:   path=/Users/sf/Downloads/cockroach-v1.1.2.darwin-10.9-amd64/cockroach-data
status:     restarted pre-existing node
clusterID:  514ebcce-7320-4d72-b2db-b618c0b404bf
nodeID:     1

这里有三点需要注意

  • admin: 后台管理地址
  • logs: 日志位置
  • store: 数据存储位置

其中logs和store位置都可以在启动参数中指定

依次启动节点2和3
cockroach start --insecure --join=10.100.1.1:26257

如果三个节点是部署在同一台机器

cockroach start \
--insecure \
--store=node2 \
--host=localhost \
--port=26258 \
--http-port=8081 \
--join=localhost:26257
结果查验

至此所有节点都启动成功,我们来看看集群是否搭建成功:
访问任意节点的后台管理http://host:8080例如http://10.100.1.2:8080

可以看到以下界面(以下所有图里的节点地址和我们的三个虚拟节点地址不一致,因为笔者周末在家临时搭建了一套集群):

后台管理首页
  • 正中间区域是总体监控图,可以在Dashboard中选择更多的监控维度,具体的监控项解释可以把鼠标移动到叹号上查看
  • 右边是集群状态和集群重要事件通知

下面我们选择View nodes list,进入以下界面:

集群节点状态
  • 这里能看到每个节点的状态
  • Bytes和Replicas代表了数据的分布,因为CR每份数据默认是存三份,我们恰好三个节点,因此每个节点存一份,最终三个节点存储的bytes和replicas会同步一致,实际上tidb也差不多是这个原理,都是基于谷歌的f1和spanner论文产生的
  • 点击logs可以查看每个节点的详细日志

至此所有的安装就结束了,下面开始简单的使用之旅

CR客户端

CR的客户端其实就是CR本身,是不是很爽?服务器程序和客户端程序都是同一个执行文件。

连接数据库

用户可以选择连接到三台服务器上去使用CR客户端,也可以在开发机(本地电脑)安装一个CR客户端(适合当前系统的cockroach可执行程序),这里我们选择在本地电脑上远程连接,可以连接三台服务器中的任何一台:

cockroach sql --insecure --host=10.100.1.2 --port=26257

连接成功后,在命令行输入

show databases; 

查看默认存在的数据库

CR客户端命令文档

一个简单的例子

我们以Go语言为例,来看看怎么连接数据库并进行简单的操作

下载go驱动
go get -u -v github.com/lib/pq
创建用户maxroach
cockroach user set maxroach --insecure --host=10.100.1.2 --port=26257
创建数据库
cockroach sql --insecure -e 'CREATE DATABASE bank' --host=10.100.1.2 --port=26257

这里我们直接使用客户端的外部命令,用户也可以进入客户端命令行,使用sql命令创建

给用户授权
cockroach sql --insecure -e 'GRANT ALL ON DATABASE bank TO maxroach'
代码连接数据库
package main

import (
    "database/sql"
    "fmt"
    "log"

    _ "github.com/lib/pq"
)

func main() {
    // Connect to the "bank" database.
    db, err := sql.Open("postgres", "postgresql://maxroach@10.100.1.3:26257/bank?sslmode=disable")
    if err != nil {
        log.Fatal("error connecting to the database: ", err)
    }

    // Create the "accounts" table.
    if _, err := db.Exec(
        "CREATE TABLE IF NOT EXISTS accounts (id INT PRIMARY KEY, balance INT)"); err != nil {
        log.Fatal(err)
    }

    // Insert two rows into the "accounts" table.
    if _, err := db.Exec(
        "INSERT INTO accounts (id, balance) VALUES (1, 1000), (2, 250)"); err != nil {
        log.Fatal(err)
    }

    // Print out the balances.
    rows, err := db.Query("SELECT id, balance FROM accounts")
    if err != nil {
        log.Fatal(err)
    }
    defer rows.Close()
    fmt.Println("Initial balances:")
    for rows.Next() {
        var id, balance int
        if err := rows.Scan(&id, &balance); err != nil {
            log.Fatal(err)
        }
        fmt.Printf("%d %d\n", id, balance)
    }
}

运行代码

go run basic-sample.go

结果

Initial balances:
1 1000
2 250
使用事务(包含重试逻辑)
package main

import (
    "context"
    "database/sql"
    "fmt"
    "log"

    "github.com/cockroachdb/cockroach-go/crdb"
)

func transferFunds(tx *sql.Tx, from int, to int, amount int) error {
    // Read the balance.
    var fromBalance int
    if err := tx.QueryRow(
        "SELECT balance FROM accounts WHERE id = $1", from).Scan(&fromBalance); err != nil {
        return err
    }

    if fromBalance < amount {
        return fmt.Errorf("insufficient funds")
    }

    // Perform the transfer.
    if _, err := tx.Exec(
        "UPDATE accounts SET balance = balance - $1 WHERE id = $2", amount, from); err != nil {
        return err
    }
    if _, err := tx.Exec(
        "UPDATE accounts SET balance = balance + $1 WHERE id = $2", amount, to); err != nil {
        return err
    }
    return nil
}

func main() {
    db, err := sql.Open("postgres", "postgresql://maxroach@localhost:26257/bank?sslmode=disable")
    if err != nil {
        log.Fatal("error connecting to the database: ", err)
    }

    // Run a transfer in a transaction.
    err = crdb.ExecuteTx(context.Background(), db, nil, func(tx *sql.Tx) error {
        return transferFunds(tx, 1 /* from acct# */, 2 /* to acct# */, 100 /* amount */)
    })
    if err == nil {
        fmt.Println("Success")
    } else {
        log.Fatal("error: ", err)
    }
}

这里我们引用了"github.com/cockroachdb/cockroach-go/crdb",因为CR的事务重试逻辑封装在里面。

执行结果:

Success

查询结果

cockroach sql --insecure -e 'SELECT id, balance FROM accounts' --database=bank --host=10.100.1.1 --port=26257

+----+---------+
| id | balance |
+----+---------+
|  1 |     900 |
|  2 |     350 |
+----+---------+
(2 rows)
写在最后

至此,我们初体验该结束了,相信大家也学会了怎么搭建集群和写代码去访问数据库了,后面有更多的感悟,我会继续完善这个系列。

总之,Cockroach真的是一个很不错也很有潜力的数据库,同时衷心的祝愿国产的Tidb越来越好,扬中华开源之威。

架构设计
Web note ad 1