Lindorm-cli连接宽表引擎 - 云原生多模数据库 Lindorm

Lindorm-cli是Lindorm提供的简易命令行工具，用于连接和管理Lindorm数据库。您可以通过Lindorm-cli完成基本的SQL操作，例如建表、数据查询、数据写入和导出等。本文介绍通过Lindorm-cli连接并使用云原生多模数据库 Lindorm宽表引擎的方法。

前提条件

已将客户端IP地址添加至Lindorm白名单，具体操作请参见设置白名单。

连接Lindorm宽表使用的网络类型

网络类型	说明
专有网络（推荐）	专有网络VPC（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