快速部署

本入门教程使用 SequoiaDB v3.4 及 MySQL 实例组件 v3.4 在 Ubuntu 16.04 上搭建一个基础运行环境，以快速了解 SequoiaDB 巨杉数据库及 MySQL 实例组件的基本功能。

SequoiaDB 可以选择部署在单台机器上，也可以部署在多台机器上。

部署SequoiaDB及MySQL实例

用户在部署 SequoiaDB 及 MySQL 实例之前应先完成 SequoiaDB 安装 和 MySQL 实例组件安装。SequoiaDB 部署方案可以选择在单台机器上进行伪集群部署，或者在多台机器上进行集群部署。

部署前准备

在进行集群部署之前，需要使用 root 用户或者管理员用户登录主机，在每台主机上执行以下命令查看 11800 端口是否被占用：

# netstat -anp | grep 11800

Note：

SequoiaDB 默认需要的端口号为 11800、11810、11820、11830、11840 及 18800，MySQL 实例默认需要的端口号为 3306，需确保这些端口没有被占用。

部署工具说明

• 以下介绍的伪集群部署和集群部署均使用快速部署工具进行操作，快速部署工具的使用与配置可参考 quickDeploy.sh。

• 如果用户在执行快速部署的过程中发生异常，则需要解决异常后再次执行 quickDeploy.sh 命令。如果依然失败，应在软件包解压路径下执行 ./setup.sh --clean 命令进行环境清理，然后按照快速入门指南重新操作一次。

伪集群部署

部署 SequoiaDB 到本机上，创建三个数据组，每个数据组单副本，并创建一个 MySQL 实例。

1. 切换到 sdbadmin 用户

   # su - sdbadmin

2. 切换到 SequoiaDB 安装目录下

   $ cd /opt/sequoiadb 

3. 执行快速部署工具

   $ ./tools/deploy/quickDeploy.sh

   输出以下信息则表示部署成功：

   ************ Deploy SequoiaDB ************************
   Create catalog: sdbserver1:11800
   Create coord:   sdbserver1:11810
   Create data:    sdbserver1:11820
   Create data:    sdbserver1:11830
   Create data:    sdbserver1:11840
   
   ************ Deploy SequoiaSQL-MySQL *****************
   Create instance: [name: myinst, port: 3306]

集群部署

部署 SequoiaDB 到三台机器上，主机名分别为 sdbserver1/sdbserver2/sdbserver3，创建三个数据组，每个数据组三副本，并在 sdbserver1 上创建一个 MySQL 实例。

1. 切换到 sdbadmin 用户

   # su - sdbadmin

2. 切换到 SequoiaDB 安装目录下

   $ cd /opt/sequoiadb

3. 修改第一台主机 sdbserver1 上的配置文件 tools/deploy/sequoiadb.conf（ 主机名 sdbserver1/sdbserver2/sdbserver3 可根据实际需要修改），修改内容如下：

   role,groupName,hostName,serviceName,dbPath
   
   catalog,SYSCatalogGroup,sdbserver1,11800,[installPath]/database/catalog/11800
   catalog,SYSCatalogGroup,sdbserver2,11800,[installPath]/database/catalog/11800
   catalog,SYSCatalogGroup,sdbserver3,11800,[installPath]/database/catalog/11800
   
   coord,SYSCoord,sdbserver1,11810,[installPath]/database/coord/11810
   coord,SYSCoord,sdbserver2,11810,[installPath]/database/coord/11810
   coord,SYSCoord,sdbserver3,11810,[installPath]/database/coord/11810
   
   data,group1,sdbserver1,11820,[installPath]/database/data/11820
   data,group1,sdbserver2,11820,[installPath]/database/data/11820
   data,group1,sdbserver3,11820,[installPath]/database/data/11820
   
   data,group2,sdbserver1,11830,[installPath]/database/data/11830
   data,group2,sdbserver2,11830,[installPath]/database/data/11830
   data,group2,sdbserver3,11830,[installPath]/database/data/11830
   
   data,group3,sdbserver1,11840,[installPath]/database/data/11840
   data,group3,sdbserver2,11840,[installPath]/database/data/11840
   data,group3,sdbserver3,11840,[installPath]/database/data/11840

4. 在主机 sdbserver1 上执行快速部署工具

   $ ./tools/deploy/quickDeploy.sh

   输出以下信息则表示部署成功：

   ************ Deploy SequoiaDB ************************
   Create catalog: sdbserver1:11800
   Create catalog: sdbserver2:11800
   Create catalog: sdbserver3:11800
   Create coord:   sdbserver1:11810
   Create coord:   sdbserver2:11810
   Create coord:   sdbserver3:11810
   Create data:    sdbserver1:11820
   Create data:    sdbserver2:11820
   Create data:    sdbserver3:11820
   Create data:    sdbserver1:11830
   Create data:    sdbserver2:11830
   Create data:    sdbserver3:11830
   Create data:    sdbserver1:11840
   Create data:    sdbserver2:11840
   Create data:    sdbserver3:11840
   
   ************ Deploy SequoiaSQL-MySQL *****************
   Create instance: [name: myinst, port: 3306]

基本操作

MySQL Shell

• 登录 MySQL Shell

  $ /opt/sequoiasql/mysql/bin/mysql -h 127.0.0.1 -P 3306 -u root

• 创建数据库实例

  mysql> create database cs;
  Query OK, 1 row affected (0.00 sec)
  
  mysql> use cs;
  Database changed

• 创建表

  mysql> create table cl(a int, b int, c text, primary key(a, b) ) ;
  Query OK, 0 rows affected (0.66 sec)

• 使用 SQL 语句进行增删改查操作

  mysql> insert into cl values(1, 101, "SequoiaDB test");
  Query OK, 1 row affected (0.05 sec)
  
  mysql> insert into cl values(2, 102, "SequoiaDB test");
  Query OK, 1 row affected (0.01 sec)
  
  mysql> select * from cl order by b asc;
  +---+-----+----------------+
  | a | b   | c              |
  +---+-----+----------------+
  | 1 | 101 | SequoiaDB test |
  | 2 | 102 | SequoiaDB test |
  +---+-----+----------------+
  2 rows in set (0.00 sec)
  
  mysql> update cl set c="My test" where a=1;
  Query OK, 1 row affected (0.01 sec)
  Rows matched: 1  Changed: 1  Warnings: 0
  
  mysql> delete from cl where b=102;
  Query OK, 1 row affected (0.02 sec)
  
  mysql> select * from cl order by b asc;
  +---+-----+---------+
  | a | b   | c       |
  +---+-----+---------+
  | 1 | 101 | My test |
  +---+-----+---------+
  1 row in set (0.00 sec)

SDB Shell

• 登录 SDB Shell

  $ sdb

• 使用 JavaScript 连接协调节点

  > var db = new Sdb("localhost", 11810)

• 创建集合空间

  db.createCS("sample")

• 创建集合

  db.sample.createCL("employee")

• 向集合 sample.employee 中插入两条数据

  > db.sample.employee.insert({"id":1,"name":"xiaoli","phone":5553})
  > db.sample.employee.insert({"id":2,"name":"xiaozhang","phone":1371})

• 修改字段"phone"为 5553 的记录，将"name"的值修改为"xiaolili"

  > db.sample.employee.update({$set:{"name":"xiaolili"}},{"phone":5553})

• 查询集合 sample.employee 中的记录

  > db.sample.employee.find()

  输出结果如下：

  {
   "_id": {
     "$oid": "5c98d499ee15aef104e88722"
   },
   "id": 1,
   "name": "xiaolili",
   "phone": 5553
  }
  {
   "_id": {
     "$oid": "5c98d499ee15aef104e88723"
   },
   "id": 2,
   "name": "xiaozhang",
   "phone": 1371
  Return 2 row(s).

• 删除字段"phone"为 5553 的记录

  > db.sample.employee.remove({"phone":5553})