如何通过Lindorm-cli连接并使用宽表引擎_云原生多模数据库Lindorm-阿里云帮助中心

本文介绍通过Lindorm-cli连接宽表引擎的具体操作和使用示例。

前提条件

已获取Lindorm宽表SQL的连接地址并配置白名单，具体操作，请参见访问实例。

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


网络类型	说明
专有网络（推荐）	专有网络VPC（Virtual Private Cloud）是您自己的云上私有网络，不同的专有网络之间二层逻辑隔离，具有较高的安全性。Lindorm-cli部署在ECS实例上时，通过专有网络连接至Lindorm宽表，可获得更高的安全性和更低的网络延迟。
公网	公网即互联网，当本地设备需要测试或管理Lindorm宽表时，可在本地设备上部署Lindorm-cli，然后通过公网连接至Lindorm宽表。说明通过公网连接不会产生流量费用，但存在一定的安全风险，推荐通过专有网络连接以获取更高的安全性。公网地址需要在控制台开通。如何开通，请参见操作步骤。

常用命令

关于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
解压Lindorm-cli压缩包。

客户端	下载链接
Linux	lindorm-cli for linux
Mac	lindorm-cli for mac
Windows	lindorm-cli for windows-x64

获取连接信息并执行下述命令连接Lindorm宽表。

如果您的客户端部署在Linux或Mac操作系统上，请跳转至Lindorm-cli所在目录下，执行以下语句：
```
./lindorm-cli -url <jdbc url> -username <用户名> -password <密码>
```
如果您的客户端部署在Windows系统上，请跳转至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的连接地址，获取方法请参见访问实例。
用户名	root	如果您忘记用户名密码，可以通过Lindorm宽表引擎的集群管理系统修改密码，具体操作请参见修改用户密码。重要修改密码后，请通过控制台重启引擎。
密码	root

连接成功的返回如下结果：

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

访问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');

查询tb表中的数据。

select * from tb;

返回如下结果：

+-----+-------+---------+
| id  | name  | address |
+-----+-------+---------+
| 001 | jack  | hz      |
+-----+-------+---------+
1 rows in set (24 ms)

说明您可以自定义数据的输出格式，具体操作，请参见数据格式。

数据格式

数据有多种输出格式，包括表格输出、CSV格式输出以及每一行中的列竖直输出，其中表格输出为默认输出格式。您可以通过format命令自定义数据的输出格式，修改数据的输出格式后，通过SELECT语句查询的数据将按指定格式输出。

重要 format命令仅支持在Lindorm-cli工具中使用。

表格输出

format table;

数据输出效果如下：

+-----+-------+---------+
| id  | name  | address |
+-----+-------+---------+
| 001 | jack  | hz      |
+-----+-------+---------+
1 rows in set (99 ms)

CSV格式输出

format csv;

数据输出效果如下：

id,name,address
001,jack,hz

每一行中的列竖直输出

format vertical;

数据输出效果如下：

********************* 1. row *********************
id:      001
name:    jack
address: hz
1 rows in set (99 ms)