Lindorm-cli是Lindorm提供的簡易命令列工具，用於串連和管理Lindorm資料庫。您可以通過Lindorm-cli完成基本的SQL操作，例如建表、資料查詢、資料寫入和匯出等。本文介紹通過Lindorm-cli串連並使用Lindorm寬表引擎的方法。
前提條件
已將用戶端IP地址添加至Lindorm白名單，具體操作請參見設定白名單。
網路類型說明
串連寬表引擎可使用的網路類型如下：
網路類型 | 說明 |
專用網路（推薦） | Virtual Private Cloud（Virtual Private Cloud）是您自己的雲上私人網路，不同的專用網路之間二層邏輯隔離，具有較高的安全性。Lindorm-cli部署在ECS執行個體上時，通過專用網路串連至Lindorm寬表，可獲得更高的安全性和更低的網路延遲。 |
公網 | 公網即互連網，當本地裝置需要測試或管理Lindorm寬表時，可在本地裝置上部署Lindorm-cli，然後通過公網串連至Lindorm寬表。 說明
|
通過MySQL協議串連（推薦）
步驟一：安裝Lindorm-cli
根據您的作業系統，下載對應的Lindorm-cli安裝包。下載連結如下表所示。
說明下表中SHA256校正和可用於驗證下載的Lindorm-cli安裝包的完整性和真實性。
作業系統
下載連結
SHA256校正和
Linux
命令直接下載：
wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-latest.tar.gz21945c466e2de2c256edd16afdfbb2234301573feb649a673939471a3d882b1a
Linux-arm64
命令直接下載：
wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gzbcae4d8479201d69e4883105d1a7f933fa46d78e19c171e8e1ebfbee28f6d953
Mac（Intel晶片）
e82cb1678ea5b263813ccb87fff0149526c36a2654082785efe5a6aaeb4eb24b
Mac（Arm晶片）
538d5fef122b416ca2ab63fd7074b77ef25840e9feb8d3490405aae36a537a68
Windows
e61078108a72b85382363e9619b8820aa5245bad60dec79ffd4bf9fea976e280
解壓Lindorm-cli壓縮包。
以Linux作業系統為例，執行以下命令解壓。解壓後可得到
lindorm-cli檔案。tar zxvf lindorm-cli-linux-latest.tar.gz
步驟二：串連寬表引擎
僅2.0.0以上版本的lindorm-cli支援通過MySQL協議串連寬表引擎。
用戶端部署在Linux或Mac系統
跳轉至
Lindorm-cli所在目錄。cd <Lindorm-cli所在目錄>執行以下語句串連寬表引擎。
./lindorm-cli -url <mysql url> -username <使用者名稱> -password <密碼>參數說明
參數
說明
mysql url
使用者名稱
串連Lindorm寬表引擎的使用者名稱。
密碼
串連Lindorm寬表引擎的密碼。
重要如果忘記密碼，可以通過Lindorm寬表引擎的叢集管理系統修改使用者密碼。
修改密碼後，請通過控制台重啟引擎。
串連配置說明
支援的串連配置
說明
mysql://協議頭支援在mysql url前添加
mysql://協議頭。例如：
mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060。服務端自訂串連參數
您可以在mysql url後設定服務端自訂串連參數，格式為
key1=value1&key2=value2。目前支援的參數如下：
operationTimeout：表示查詢逾時時間。格式為
<mysql url>?operationTimeout=<逾時時間>，其中逾時時間單位為毫秒（ms）。例如：ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000。串連樣本
./lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test --添加mysql://協議頭串連 ./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test --指定查詢逾時時間 ./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test串連成功將返回以下結果：
lindorm-cli version: 2.0.x其中，
2.0.x為Lindorm-cli的版本號碼。
用戶端部署在Windows系統
方法一
開啟命令提示字元（CMD），跳轉至
lindorm-cli.exe的所在目錄下。cd <lindorm-cli.exe所在目錄>在CMD上執行以下語句串連寬表引擎。
lindorm-cli -url <mysql url> -username <使用者名稱> -password <密碼>參數說明
參數
樣本值
擷取方法
mysql url
ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060
使用者名稱
user
串連Lindorm寬表引擎的使用者名稱。
密碼
test
串連Lindorm寬表引擎的密碼。
重要如果忘記密碼，可以通過Lindorm寬表引擎的叢集管理系統修改使用者密碼。
修改密碼後，請通過控制台重啟引擎。
串連配置說明
支援的串連配置
說明
mysql://協議頭支援在mysql url前添加
mysql://協議頭。例如：
mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060。服務端自訂串連參數
您可以在mysql url後設定服務端自訂串連參數，格式為
key1=value1&key2=value2。目前支援的參數如下：
operationTimeout：表示查詢逾時時間。格式為
<mysql url>?operationTimeout=<逾時時間>，其中逾時時間單位為毫秒（ms）。例如：ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000。串連樣本
lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test --添加mysql://協議頭串連 lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test --指定查詢逾時時間 lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test串連成功將返回如下結果：
Connected to ld-bp187uwcx5f40****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com:33060 lindorm-cli version: 2.0.x其中，
2.0.x為Lindorm-cli的版本號碼。
方法二
雙擊開啟Lindorm-cli.exe程式，執行以下語句：
connect <mysql url> <使用者名稱> <密碼>串連樣本
connect ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:33060 user test串連成功無結果返回。
步驟三：使用寬表引擎
建立資料庫
執行以下語句建立名為
test的資料庫。CREATE DATABASE test;執行以下語句使用
test資料庫。USE test;
建表
在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'); 資料查詢
資料有多種輸出格式，包括表格輸出、CSV格式輸出以及每一行中的列豎直輸出。您可以通過format命令自訂資料的輸出格式，修改資料的輸出格式後，通過SELECT語句查詢的資料將按指定格式輸出。如果未指定輸出格式，預設以表格形式輸出結果。
format命令僅支援在Lindorm-cli工具中使用。
表格輸出（預設）
查詢語句如下：
format table;
SELECT * FROM tb;執行效果等效於以下語句：
SELECT * FROM tb;資料輸出效果如下：
+-----+-------+---------+
| id | name | address |
+-----+-------+---------+
| 001 | jack | hz |
+-----+-------+---------+CSV格式輸出
format csv;
SELECT * FROM tb;資料輸出效果如下：
id,name,address
001,jack,hz每一行中的列豎直輸出
format vertical;
SELECT * FROM tb;資料輸出效果如下：
********************* 1. row *********************
id: 001
name: jack
address: hz通過Avatica協議串連
步驟一：安裝Lindorm-cli
步驟二：串連寬表引擎
步驟三：使用寬表引擎
Lindorm-cli常用命令
!help：查看協助命令。
!connect：串連伺服器命令。
exit、quit和ctrl+d：退出當前串連。
常見問題
為什麼會連線逾時或失敗？
連線逾時或失敗時會報錯Failed to connect to <寬表串連地址> connection check failed或connection timeout。
可能存在的原因具體如下，請您依次排查：
原因 | 解決方案 |
使用公網串連，但未將公網IP地址添加至白名單中。 | 將用戶端公網IP地址添加至Lindorm白名單。 查詢用戶端公網IP地址的方式有以下兩種：
|
已將公網地址添加至白名單，仍舊連線逾時。 | 可能存在網路環境不穩定等因素，建議您更換為專用網路串連。 |
使用ECS訪問，未將ECS的IP地址添加至Lindorm白名單。 | |
未使用正確的串連地址。 | Lindorm串連地址區分專用網路地址和公網地址，請根據網路環境使用正確的串連地址。 |
如果以上方案仍無法解決您的問題，請聯絡Lindorm支援人員（DingTalk號：s0s3eg3）。
相關文檔
關於Lindorm寬表SQL的文法使用說明：SQL參考。
其他串連方式：通過MySQL命令列串連並使用寬表引擎、使用MySQL協議（推薦）。