通過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      |
+------+------+---------+