通过MySQL命令行连接并使用宽表引擎

前提条件

• 宽表引擎为2.6.0及以上版本。如何查看或升级当前版本，请参见宽表引擎版本说明和升级小版本。

• 已将客户端IP地址添加至Lindorm白名单。具体操作，请参见设置白名单。

• 已开通MySQL协议兼容功能。如何开通，请参见开通MySQL协议兼容功能。

• 已了解MySQL协议开发说明。具体内容，请参见MySQL协议开发说明。

注意事项

• 8.0及之前版本的MySQL命令行工具会在建立加密连接时使用TLSv1.1作为默认TLS协议，Lindorm支持的TLS协议版本为TLSv1.2。由于TLS协议版本不一致，可能会导致连接Lindorm实例失败，因此需要在启动MySQL命令行工具的命令行参数中添加--ssl-mode=DISABLED强制建立非加密通信。

  重要

  非加密通信在公网环境下请谨慎使用。

• 8.0及之前版本的MySQL命令行工具默认使用 mysql_native_password鉴权协议。由于Lindorm中MySQL协议对宽表引擎版本的要求，可能会出现鉴权失败的情况。同时，8.0及以前版本的MySQL命令行工具也不支持caching_sha2_password鉴权协议，因此只能通过明文方式传递密码：在启动MySQL命令行工具的命令行参数中添加 --enable_cleartext_plugin参数。

  重要

  公网环境下请谨慎使用该方式。

操作步骤

工具安装

• Linux系统

  请根据已有的管理工具，执行相应的安装命令。

  • APT包管理工具

    sudo apt-get install mysql-client

  • Yum包管理工具

    sudo yum install mysql

• Mac系统

  使用homebrew包管理工具，执行以下命令安装。

  brew install mysql-client

• Windows系统

  安装方式请参见安装MySQL命令行工具。

连接并使用宽表引擎

1. 执行以下语句连接宽表引擎。

   mysql -h<mysql url> -P33060 -u<用户名> -p<密码> -D<数据库>

   使用到的参数说明如下：

   参数	示例值	获取方法
   mysql url	ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com	在控制台获取宽表引擎的MySQL兼容地址，并去掉末尾的冒号及端口号。 重要 如果应用部署在ECS实例，建议您通过专有网络访问Lindorm实例，可获得更高的安全性和更低的网络延迟。 如果应用部署在本地，在通过公网连接Lindorm实例前，需在控制台开通公网地址。开通方式：在控制台选择数据库连接 > 宽表引擎，在宽表引擎页签单击开通公网地址。
   用户名	test	连接宽表引擎的用户名。
   密码	test	用户名对应的密码。
   数据库	default	连接Lindorm宽表引擎的数据库。如未指定，则默认连接default数据库。

2. 使用宽表引擎。

   1. 执行以下语句创建名为test1的数据库。

      CREATE DATABASE test1; 

   2. 执行以下语句使用test1数据库。

      USE test1; 

   3. 在test数据库中创建名为tb的数据表，并插入一条数据。

      CREATE TABLE tb (id varchar, name varchar, address varchar,  primary key(id, name)) ; 
      UPSERT INTO tb (id, name, address) values ('001', 'jack',  'hz'); 

   4. 查询tb表中的数据。

      SELECT * FROM tb;

      返回结果：

      +------+------+---------+
      | id   | name | address |
      +------+------+---------+
      | 001  | jack | hz      |
      +------+------+---------+