通过Lindorm-cli连接并使用宽表引擎

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:连接服务器命令。

  • exitquitctrl+d:退出当前连接。

操作步骤

步骤一:安装Lindorm-cli

  1. 根据您的操作系统,下载对应的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

  2. 解压Lindorm-cli压缩包。

    以Linux操作系统为例,执行以下命令解压。

    tar zxvf lindorm-cli-linux-latest.tar.gz

    解压后lindorm-cli-linux-latest文件夹中为lindorm-cli.exe文件。

步骤二:连接Lindorm宽表引擎

客户端部署在Linux或Mac系统

  1. 跳转至Lindorm-cli.exe所在目录。

    cd <Lindorm-cli.exe所在目录>
  2. 执行以下语句连接宽表引擎。

    ./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系统

方法一

  1. 打开命令提示符(CMD),跳转至lindorm-cli.exe的所在目录下。

    cd <lindorm-cli.exe所在目录>
  2. 在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宽表引擎

创建数据库

  1. 执行以下语句创建名为test的数据库。

    CREATE DATABASE test; 
  2. 执行以下语句使用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