使用

连接MySQL实例与数据库分布式存储引擎

• 配置 SequoiaDB 连接地址

  默认的 SequoiaDB 连接地址为“localhost:11810”，如需修改可参考以下两种方式

  • 通过bin/sdb_sql_ctl指定实例名修改

    例如，设置实例 myinst 连接地址为“sdbserver1:11810”和“sdbserver2:11810”

    $ bin/sdb_sql_ctl chconf myinst --sdb-conn-addr=sdbserver1:11810,sdbserver2:11810

  • 通过配置文件修改。具体参考引擎配置章节。

• 登录 MySQL shell

  MySQL 支持基于 UNIX 域套接字文件和 TCP/IP 的连接方式。

  • UNIX 套接字文件连接

    进程间通信，不需要使用网络协议，比 TCP/IP 传输效率更高，但仅限于本地连接，连接时指定对应的套接字文件。

    $ cd /opt/sequoiasql/mysql
    $ bin/mysql -S database/3306/mysqld.sock -u root

    Note: SequoiaSQL-MySQL 实例默认无密码，所以无需输入 -p 选项。

  • TCP/IP 连接方式

    网络通信，可以本地连接（环回接口）和远程连接，同时可以灵活地配置和授权客户端 IP 的访问权限。

    • 本地连接

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

    • 远程连接

      MySQL 默认未授予远程连接的权限，所以首先需要在服务端对客户端 IP 进行访问授权，以下例子对所有的 IP 都授权访问。

      mysql> UPDATE mysql.user SET host='%' WHERE user='root';
      mysql> FLUSH PRIVILEGES;

      假设 mysql 服务器地址为“sdbserver1:3306”，在客户端可以这样远程连接：

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

• 设置密码

  在允许远程连接时，建议为 MySQL 设置密码。例如为 root 用户设置密码 123456。

  mysql> ALTER USER root@'%' IDENTIFIED BY '123456';

  注意，设置密码后，后续登录 MySQL shell 的时候要指定 -p 参数，回车并输入密码。

基本操作示例

• 创建数据库实例

  mysql> CREATE DATABASE company;
  mysql> USE company;

• 创建表

  mysql> CREATE TABLE employee(id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(128), age INT);
  mysql> CREATE TABLE manager(employee_id INT, department TEXT, INDEX id_idx(employee_id));

• 基本数据操作

  mysql> INSERT INTO employee(name, age) VALUES("Jacky", 36);
  mysql> INSERT INTO employee(name, age) VALUES("Alice", 18);
  mysql> INSERT INTO manager VALUES(1, "Wireless Business");
  mysql> SELECT * FROM employee ORDER BY id ASC LIMIT 1;
  mysql> SELECT * FROM employee, manager WHERE employee.id=manager.employee_id;
  mysql> UPDATE employee SET name="Bob" WHERE id=1;
  mysql> DELETE FROM employee WHERE id=2;

• 创建索引

  mysql> ALTER TABLE employee ADD INDEX name_idx(name(30));

• 存储过程

  mysql> DELIMITER //
  mysql> CREATE PROCEDURE delete_match()
   -> BEGIN
   -> DELETE FROM employee WHERE id=1;
   -> END//
  mysql> DELIMITER ;
  mysql> CALL delete_match();

• 视图

  mysql> CREATE VIEW manager_view AS
   -> SELECT
   -> e.name, m.department
   -> FROM
   -> employee AS e, manager AS m
   -> WHERE e.id=m.employee_id;
  mysql> SELECT * FROM manager_view;

在线修改 DDL

MySQL实例组件支持大多数 DDL 的在线修改。在线修改支持原表中（INPLACE）修改表属性，并且允许并发的 DML。可以通过 ALGORITHM 参数控制 ALTER TABLE 语句修改 DDL 时使用的算法。当 ALGORITHM = INPLACE 时，可以在线地修改表属性，而 ALGORITHM = COPY 时，则会把原表内容拷贝到新表，性能会下降。不指定 ALGORITHM 时会自动选择算法。如需在线修改 DDL，一般建议显式地指定 ALGORITHM = INPLACE。例子：

 mysql> ALTER TABLE cl ADD INDEX id_idx(id), ALGORITHM=INPLACE;

• 建表选项

  可以在线修改字符集（CHARACTER SET）、重命名（RENAME）。支持修改表备注（COMMENT），它包含建表时的一些自定义表配置。

  Note: 表备注不支持auto_partition修改；支持table_options原有配置项值修改和增加配置项，不支持减少配置项。

• 主键与索引

  支持在线添加删除主键和（唯一）索引。

• 列

  支持在线添加列、删除列和数据类型扩容的操作。其中，添加 DEFAULT NULL 的列，以及为数据类型扩容（如 VARCHAR(64) 改 VARCHAR(128)、INT 改 BIGINT）是轻量级的操作，可以快速返回。

数据类型映射关系