# td-genie

**Repository Path**: dbquery/td-genie

## Basic Information

- **Project Name**: td-genie
- **Description**: 免费开源的TDengine时序数据库图形用户界面工具（GUI），为用户提供直观、易用的数据库管理和操作体验！
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 33
- **Forks**: 12
- **Created**: 2024-01-31
- **Last Updated**: 2025-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: TDengine, Javafx, GUI, TSDB, td-genie

## README

<p align="center">
	<img alt="logo" src="https://gitee.com/dbquery/td-genie/raw/master/tdengine/src/main/resources/images/logo.png" width="150" height="150">
</p>

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Td-Genie v2.1.2</h1>
<p align="center">免费开源的TDengine时序数据库图形用户界面工具，为用户提供直观、易用的数据库管理和操作体验！</p>

----

简体中文|[English](README.en.md)

#### 介绍
Td-Genie是一款功能全面、操作简便的TDengine时序数据库图形界面工具，V2.1.2目前支持的TDengine Server版本列表如下：
1. TDengine2.x版本（2.6.0.34已测试）
2. TDengine3.x版本（3.2.3.0已测试）

主要功能：
1. 数据连接维护（新增、修改、查询、删除）
2. 数据库维护（新增、修改、查询、删除）
3. 超级表维护（新增、修改、查询、删除）
4. 超级表数据查询（支持按时间查询，自动分页展示）
5. 普通表数据查看（支持按库、超级表、表名查询，支持查看普通表数据）
6. 数据操作（新增、更新、复制字段值，复制为Insert语句）
7. 自定义SQL执行(可执行更新SQL或查询SQL，可展示查询结果、执行耗时、错误信息等) 
8. 资源监控查看(可查看数据库CPU、内存、磁盘使用趋势) 
9. 库表DDL导出（数据库创建SQL、表创建SQL）
10. 集群查看（查看数据节点、管理节点）
11. 用户查看
12. 连接监控（监控已建立的连接）
13. 查询监控（监控正在执行的查询SQL）
#### 软件架构
基于JavaFX实现UI功能。


#### 安装教程

1.  从发行版中下载最新版本，解压，双击执行td-genie.exe文件即可(https://gitee.com/dbquery/td-genie/releases)

#### 使用说明

1.  初始界面
![输入图片说明](tdengine/src/main/resources/images/readme/start.png)
2.  创建连接(输入连接名称、IP、端口、用户名、密码)
![输入图片说明](tdengine/src/main/resources/images/readme/createConnection.png)
3.  创建数据库(输入数据库名、副本个数、数据保留天数、VNODE内存块数目、文件压缩标志位)
![输入图片说明](tdengine/src/main/resources/images/readme/createDB.png)
4.  创建超级表(输入表名称，字段信息)
![输入图片说明](tdengine/src/main/resources/images/readme/createSTB.png)
5. 查看超级表数据（查看连接下的所有数据库、数据库下的所有超级表，支持按时间搜索超级表中数据，分页查询，可复制表格中的查询结果）
![输入图片说明](tdengine/src/main/resources/images/readme/queryStbRecord.png)
6. 查看普通表（支持按库、超级表、表名查询，支持查看普通表数据）
![输入图片说明](tdengine/src/main/resources/images/readme/tableQuery.png)
![输入图片说明](tdengine/src/main/resources/images/readme/tableDataQuery.png)
7. 新增数据（输入字段和Tag信息）
![输入图片说明](tdengine/src/main/resources/images/readme/insertData.png)
8. 编辑数据 (输入字段信息)
![输入图片说明](tdengine/src/main/resources/images/readme/updateDataSelectItem.png)
![输入图片说明](tdengine/src/main/resources/images/readme/updateData.png)
9. 自定义SQL执行(可执行任意SQL，对于查询SQL，可展示查询结果，支持保存SQL、美化SQL)
![输入图片说明](tdengine/src/main/resources/images/readme/executeSQL.png)
10. 资源监控查看(可查看数据库CPU、内存、磁盘使用趋势)
![输入图片说明](tdengine/src/main/resources/images/resourceMonitor.png)
11. 导出库表DDL
![输入图片说明](tdengine/src/main/resources/images/readme/exportDDL.png)
12. 集群查看（查看数据节点、管理节点）
![输入图片说明](tdengine/src/main/resources/images/readme/clusterquery.png)
13. 用户查看
![输入图片说明](tdengine/src/main/resources/images/readme/userquery.png)
14. 连接监控（监控已建立的连接）
![输入图片说明](tdengine/src/main/resources/images/readme/connectionquery.png)
15. 查询监控（监控正在执行的查询SQL）
![输入图片说明](tdengine/src/main/resources/images/readme/querymonitor.png)
#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request