通过MySQL命令行连接并使用宽表引擎 - 云原生多模数据库 Lindorm

Lindorm宽表引擎支持MySQL协议接入，您可以通过MySQL命令行工具连接Lindorm宽表引擎，并通过Lindorm SQL完成数据开发。本文提供详细的操作步骤，从工具下载到完成简单的数据读写，带您快速上手Lindorm宽表引擎。

前提条件

宽表引擎为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命令行工具。

连接并使用宽表引擎

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

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

说明

连接时添加--get-server-public-key参数可以避免报错Authentication plugin 'caching_sha2_password' reported error: Authentication requires secure connection.。

使用到的参数说明如下：

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

使用宽表引擎。

执行以下语句创建名为test1的数据库。
```
CREATE DATABASE test1; 
```
执行以下语句使用test1数据库。
```
USE test1; 
```

在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');

查询tb表中的数据。

SELECT * FROM tb;

返回结果：

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