Lindorm-cli串連寬表引擎 - Lindorm

Lindorm-cli是Lindorm提供的簡易命令列工具，用於串連和管理Lindorm資料庫。您可以通過Lindorm-cli完成基本的SQL操作，例如建表、資料查詢、資料寫入和匯出等。本文介紹通過Lindorm-cli串連並使用Lindorm寬表引擎的方法。

前提條件

已將用戶端IP地址添加至Lindorm白名單，具體操作請參見設定白名單。

串連Lindorm寬表使用的網路類型

網路類型	說明
專用網路（推薦）	Virtual Private Cloud（Virtual Private Cloud）是您自己的雲上私人網路，不同的專用網路之間二層邏輯隔離，具有較高的安全性。Lindorm-cli部署在ECS執行個體上時，通過專用網路串連至Lindorm寬表，可獲得更高的安全性和更低的網路延遲。
公網	公網即互連網，當本地裝置需要測試或管理Lindorm寬表時，可在本地裝置上部署Lindorm-cli，然後通過公網串連至Lindorm寬表。說明通過公網串連不會產生流量費用，但存在一定的安全風險，推薦通過專用網路串連以擷取更高的安全性。公網地址需要在控制台開通。如何開通，請參見操作步驟。

Lindorm-cli常用命令

關於Lindorm寬表SQL的文法使用請參見Lindorm寬頻SQL文法手冊。

!help：查看協助命令。
!connect：串連伺服器命令。
exit、quit和ctrl+d：退出當前串連。

操作步驟

步驟一：安裝Lindorm-cli

根據您的作業系統，下載對應的Lindorm-cli安裝包。下載連結如下表所示。
作業系統
下載連結
Linux
lindorm-cli for linux
Mac
lindorm-cli for mac
Windows
lindorm-cli for windows-x64
Linux-arm64
lindorm-cli for linux-arm64
解壓Lindorm-cli壓縮包。
以Linux作業系統為例，執行以下命令解壓。
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```
解壓後lindorm-cli-linux-latest檔案夾中為lindorm-cli.exe檔案。

步驟二：串連Lindorm寬表引擎

用戶端部署在Linux或Mac系統

跳轉至Lindorm-cli.exe所在目錄。
```
cd <Lindorm-cli.exe所在目錄>
```

執行以下語句串連寬表引擎。

./lindorm-cli -url <jdbc url> -username <使用者名稱> -password <密碼>

參數說明

參數	樣本值	擷取方法
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	Lindorm寬表SQL的串連地址，擷取方法請參見訪問執行個體。
使用者名稱	user	如果您忘記使用者名稱密碼，可以通過Lindorm寬表引擎的叢集管理系統修改密碼，具體操作請參見修改使用者密碼。重要修改密碼後，請通過控制台重啟引擎。
密碼	test

串連成功將返回以下結果：

lindorm-cli version: 1.0.xx

其中，1.0.xx為Lindorm-cli的版本號碼。

用戶端部署在Windows系統

方法一

開啟命令提示字元（CMD），跳轉至lindorm-cli.exe的所在目錄下。
```
cd <lindorm-cli.exe所在目錄>
```

在CMD上執行以下語句串連寬表引擎。

lindorm-cli -url <jdbc url> -username <使用者名稱> -password <密碼>

參數說明

參數	樣本值	擷取方法
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	Lindorm寬表SQL的串連地址，擷取方法請參見訪問執行個體。
使用者名稱	user	如果您忘記使用者名稱密碼，可以通過Lindorm寬表引擎的叢集管理系統修改密碼，具體操作請參見修改使用者密碼。重要修改密碼後，請通過控制台重啟引擎。
密碼	test

串連成功將返回如下結果：

Connected to jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
lindorm-cli version: 1.0.xx

其中，1.0.xx為Lindorm-cli的版本號碼。

方法二

雙擊開啟Lindorm-cli.exe程式，執行以下語句：

connect <jdbc url> <使用者名稱> <密碼>

串連成功無結果返回。

步驟三：使用Lindorm寬表引擎

建立資料庫

執行以下語句建立名為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

作業系統	下載連結
Linux	lindorm-cli for linux
Mac	lindorm-cli for mac
Windows	lindorm-cli for windows-x64
Linux-arm64	lindorm-cli for linux-arm64