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
Mac
Windows
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