帮助中心

Appearance

命令行客户端 ​

命令行客户端，Lightning System 的命令行操作工具
./lightningCli [command]

📋 基本用法 ​

命令行客户端的基本使用格式：

bash
./lightningCli [command] [options]

🔐 认证配置 ​

使用命令行接口前必须先进行认证：

bash
./lightningCli auth \
  --host <host> \
  --port <port> \
  --username <username> \
  --password <password> \
  --dataBase <dataBase> \
  --cluster <cluster>

参数说明 ​

参数说明示例值
hostLDB 的 IP 地址192.168.1.100
portLDB 的 OPIO 端口8080
username用户名root
password密码root
dataBase数据库名db
cluster集群名default

📊 数据导出 ​

支持将查询结果导出为多种格式：

bash
./lightningCli export \
  --sql '<sql>' \
  --format <format>

参数说明 ​

参数说明可选值
sql需要导出数据的 SQL 语句SELECT 语句
format导出格式json/csv/sql

导出格式说明 ​

格式说明适用场景
jsonJSON 格式输出数据分析和处理
csvCSV 格式输出表格软件导入
sqlSQL 插入语句数据迁移和备份

🔍 数据查询 ​

直接执行 SQL 查询并输出结果：

bash
./lightningCli query -q <sql>

参数说明 ​

参数说明示例
sqlSQL 查询语句SELECT * FROM table LIMIT 10

💻 交互式命令行 ​

提供交互式 SQL 执行环境：

bash
./lightningCli

支持的命令 ​

命令类型说明示例
SHOW显示数据库信息SHOW TABLES
SELECT数据查询SELECT * FROM table
ALTER TABLE修改表结构ALTER TABLE table ADD COLUMN col
CREATE TABLE创建新表CREATE TABLE table (col1 type1)
DROP TABLE删除表DROP TABLE table

显示设置 ​

可以设置查询结果的显示行数：

sql
set outputLimit=20;

📝 使用示例 ​

1. 认证并连接 ​

bash
./lightningCli auth \
  --host 192.168.1.100 \
  --port 8080 \
  --username root \
  --password root \
  --dataBase db \
  --cluster default

2. 导出数据 ​

bash
./lightningCli export \
  --sql 'SELECT * FROM table LIMIT 100' \
  --format csv

3. 执行查询 ​

bash
./lightningCli query -q 'SELECT * FROM table LIMIT 10'

4. 交互式操作 ​

bash
./lightningCli
> SHOW TABLES;
> SELECT * FROM table LIMIT 10;
> set outputLimit=20;

🔧 常见问题 ​

  1. 认证失败

    • 检查网络连接
    • 确认用户名密码
    • 验证数据库名称

  2. 查询超时

    • 优化查询语句
    • 调整超时设置
    • 检查系统负载

  3. 导出失败

    • 检查磁盘空间
    • 确认文件权限
    • 验证导出格式

📚 最佳实践 ​

  1. 查询优化

    • 使用适当的 LIMIT
    • 添加必要的索引
    • 优化查询条件

  2. 数据导出

    • 分批导出大数据
    • 选择合适的格式
    • 注意文件大小

  3. 交互式操作

    • 使用分号结束语句
    • 合理设置显示限制
    • 注意命令大小写