Apache Ignite SQLLine工具使用指南

Apache Ignite SQLLine工具使用指南

ignite Apache Ignite 项目地址: https://gitcode.com/gh_mirrors/ignite15/ignite

概述

Apache Ignite作为一个高性能的内存计算平台，提供了完整的SQL功能支持。为了方便开发者与Ignite集群进行SQL交互，Ignite内置了SQLLine工具——这是一个基于命令行的SQL客户端工具，专门用于连接关系型数据库并执行SQL命令。

SQLLine不仅支持标准SQL操作，还提供了丰富的元数据查询功能，是开发者和DBA管理Ignite数据库的理想工具。

连接Ignite集群

基本连接方式

要连接到Ignite集群，需要从Ignite安装目录的bin文件夹下运行SQLLine脚本：

Linux/Unix系统：

./sqlline.sh --verbose=true -u jdbc:ignite:thin://127.0.0.1/

Windows系统：

sqlline.bat --verbose=true -u jdbc:ignite:thin://127.0.0.1/

其中127.0.0.1应替换为实际的Ignite节点地址。--verbose=true参数会启用详细输出模式，有助于调试连接问题。

查看帮助信息

对于初次使用SQLLine的用户，可以通过以下命令查看所有可用选项：

Linux/Unix系统：

./sqlline.sh -h

Windows系统：

sqlline.bat -h

认证连接

如果Ignite集群启用了安全认证，连接时需要提供用户名和密码：

Linux/Unix系统：

./sqlline.sh --verbose=true -u "jdbc:ignite:thin://127.0.0.1:10800;user=ignite;password=ignite"

Windows系统：

sqlline.bat --verbose=true -u "jdbc:ignite:thin://127.0.0.1:10800;user=ignite;password=ignite"

注意在bash环境下，必须将整个JDBC连接URL用双引号括起来，以避免特殊字符被shell解释。

核心命令详解

SQLLine提供了丰富的命令来操作和管理数据库，以下是最常用的命令分类说明：

数据库操作命令

1. !tables - 列出当前数据库中的所有表
2. !columns <表名> - 显示指定表的所有列信息
3. !indexes <表名> - 显示指定表的所有索引
4. !primarykeys <表名> - 显示指定表的主键列
5. !dbinfo - 显示当前连接的数据库元数据信息

连接管理命令

1. !connect <JDBC URL> - 连接到新的数据库
2. !list - 显示所有活动连接
3. !go <连接号> - 切换到不同的活动连接
4. !closeall - 关闭所有当前打开的连接
5. !reconnect - 重新连接到当前数据库

实用工具命令

1. !sql <SQL语句> - 执行SQL语句
2. !batch - 开始或执行SQL批处理
3. !run <脚本文件> - 执行SQL脚本文件
4. !script <输出文件> - 将执行的命令保存到文件
5. !history - 显示命令历史记录
6. !outputformat - 更改SQL结果显示格式

实战示例

创建表和索引

-- 创建复制表City
CREATE TABLE City (id LONG PRIMARY KEY, name VARCHAR) WITH "template=replicated";

-- 创建分区表Person，设置备份和关联键
CREATE TABLE Person (id LONG, name VARCHAR, city_id LONG, PRIMARY KEY (id, city_id)) WITH "backups=1, affinityKey=city_id";

-- 查看所有表
!tables

-- 在City表上创建索引
CREATE INDEX idx_city_name ON City (name);

-- 在Person表上创建索引
CREATE INDEX idx_person_name ON Person (name);

-- 查看所有索引
!indexes

数据操作示例

-- 插入数据
INSERT INTO City (id, name) VALUES (1, '北京');
INSERT INTO City (id, name) VALUES (2, '上海');

INSERT INTO Person (id, name, city_id) VALUES (1, '张三', 1);
INSERT INTO Person (id, name, city_id) VALUES (2, '李四', 2);

-- 查询数据
SELECT p.name AS person_name, c.name AS city_name 
FROM Person p JOIN City c ON p.city_id = c.id;

-- 查看表结构
!columns Person

使用技巧

1. 批量执行：使用!batch命令可以批量执行多条SQL语句，提高效率
2. 结果格式化：使用!outputformat可以改变查询结果的显示格式，如表格、CSV等
3. 脚本自动化：通过!run命令可以执行预编写的SQL脚本，实现自动化操作
4. 历史记录：!history命令可以查看之前执行过的命令，方便重复操作
5. 元数据查询：善用!dbinfo、!tables等命令可以快速了解数据库结构

注意事项

1. 在bash环境下连接时，确保JDBC URL用双引号括起来
2. 对于生产环境，建议使用认证连接以提高安全性
3. 复杂的SQL查询可能需要优化，可以利用Ignite的查询分析功能
4. 某些SQLLine命令可能在Ignite中不完全支持，使用时需注意兼容性

SQLLine作为Apache Ignite的SQL交互工具，为开发者提供了便捷的数据库操作方式。通过熟练掌握这些命令和技巧，可以大大提高开发和运维效率。

ignite Apache Ignite 项目地址: https://gitcode.com/gh_mirrors/ignite15/ignite