通過Lindorm-cli連接并使用寬表引擎
Lindorm-cli是Lindorm提供的簡易命令行工具，用于連接和管理Lindorm數(shù)據(jù)庫。您可以通過Lindorm-cli完成基本的SQL操作，例如建表、數(shù)據(jù)查詢、數(shù)據(jù)寫入和導(dǎo)出等。本文介紹通過Lindorm-cli連接并使用云原生多模數(shù)據(jù)庫 Lindorm寬表引擎的方法。
前提條件
已將客戶端IP地址添加至Lindorm白名單，具體操作請參見設(shè)置白名單。
連接Lindorm寬表使用的網(wǎng)絡(luò)類型
網(wǎng)絡(luò)類型 | 說明 |
專有網(wǎng)絡(luò)（推薦） | 專有網(wǎng)絡(luò)VPC（Virtual Private Cloud）是您自己的云上私有網(wǎng)絡(luò)，不同的專有網(wǎng)絡(luò)之間二層邏輯隔離，具有較高的安全性。Lindorm-cli部署在ECS實例上時，通過專有網(wǎng)絡(luò)連接至Lindorm寬表，可獲得更高的安全性和更低的網(wǎng)絡(luò)延遲。 |
公網(wǎng) | 公網(wǎng)即互聯(lián)網(wǎng)，當(dāng)本地設(shè)備需要測試或管理Lindorm寬表時，可在本地設(shè)備上部署Lindorm-cli，然后通過公網(wǎng)連接至Lindorm寬表。 說明
|
Lindorm-cli常用命令
關(guān)于Lindorm寬表SQL的語法使用請參見Lindorm寬表SQL語法手冊。
!help：查看幫助命令。
!connect：連接服務(wù)器命令。
exit、quit和ctrl+d：退出當(dāng)前連接。
操作步驟
步驟一：安裝Lindorm-cli
根據(jù)您的操作系統(tǒng)，下載對應(yīng)的Lindorm-cli安裝包。下載鏈接如下表所示。
操作系統(tǒng)
下載鏈接
Linux
Mac
Windows
Linux-arm64
解壓Lindorm-cli壓縮包。
以Linux操作系統(tǒng)為例，執(zhí)行以下命令解壓。
tar zxvf lindorm-cli-linux-latest.tar.gz解壓后
lindorm-cli-linux-latest文件夾中為lindorm-cli.exe文件。
步驟二：連接Lindorm寬表引擎
客戶端部署在Linux或Mac系統(tǒng)
跳轉(zhuǎn)至
Lindorm-cli.exe所在目錄。cd <Lindorm-cli.exe所在目錄>執(zhí)行以下語句連接寬表引擎。
./lindorm-cli -url <jdbc url> -username <用戶名> -password <密碼>參數(shù)說明
參數(shù)
示例值
獲取方法
jdbc url
jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
Lindorm寬表SQL的連接地址，獲取方法請參見訪問實例。
用戶名
user
如果您忘記用戶名密碼，可以通過Lindorm寬表引擎的集群管理系統(tǒng)修改密碼，具體操作請參見修改用戶密碼。
重要修改密碼后，請通過控制臺重啟引擎。
密碼
test
連接成功將返回以下結(jié)果：
lindorm-cli version: 1.0.xx其中，
1.0.xx為Lindorm-cli的版本號。
客戶端部署在Windows系統(tǒng)
方法一
打開命令提示符（CMD），跳轉(zhuǎn)至
lindorm-cli.exe的所在目錄下。cd <lindorm-cli.exe所在目錄>在CMD上執(zhí)行以下語句連接寬表引擎。
lindorm-cli -url <jdbc url> -username <用戶名> -password <密碼>參數(shù)說明
參數(shù)
示例值
獲取方法
jdbc url
jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
Lindorm寬表SQL的連接地址，獲取方法請參見訪問實例。
用戶名
user
如果您忘記用戶名密碼，可以通過Lindorm寬表引擎的集群管理系統(tǒng)修改密碼，具體操作請參見修改用戶密碼。
重要修改密碼后，請通過控制臺重啟引擎。
密碼
test
連接成功將返回如下結(jié)果：
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程序，執(zhí)行以下語句：
connect <jdbc url> <用戶名> <密碼>連接成功無結(jié)果返回。
步驟三：使用Lindorm寬表引擎
創(chuàng)建數(shù)據(jù)庫
執(zhí)行以下語句創(chuàng)建名為test的數(shù)據(jù)庫。
CREATE DATABASE test;執(zhí)行以下語句使用test數(shù)據(jù)庫。
USE test;
建表
在test數(shù)據(jù)庫中創(chuàng)建名為tb的數(shù)據(jù)表。
CREATE TABLE tb (id varchar, name varchar, address varchar, primary key(id, name)) ; 數(shù)據(jù)寫入
UPSERT INTO tb (id, name, address) values ('001', 'jack', 'hz'); 數(shù)據(jù)查詢
數(shù)據(jù)有多種輸出格式，包括表格輸出、CSV格式輸出以及每一行中的列豎直輸出。您可以通過format命令自定義數(shù)據(jù)的輸出格式，修改數(shù)據(jù)的輸出格式后，通過SELECT語句查詢的數(shù)據(jù)將按指定格式輸出。如果未指定輸出格式，默認(rèn)以表格形式輸出結(jié)果。
format命令僅支持在Lindorm-cli工具中使用。
表格輸出（默認(rèn)）
查詢語句如下：
format table;
SELECT * FROM tb;執(zhí)行效果等效于以下語句：
SELECT * FROM tb;數(shù)據(jù)輸出效果如下：
+-----+-------+---------+
| id | name | address |
+-----+-------+---------+
| 001 | jack | hz |
+-----+-------+---------+CSV格式輸出
format csv;
SELECT * FROM tb;數(shù)據(jù)輸出效果如下：
id,name,address
001,jack,hz每一行中的列豎直輸出
format vertical;
SELECT * FROM tb;數(shù)據(jù)輸出效果如下：
********************* 1. row *********************
id: 001
name: jack
address: hz