# TD-studio

**Repository Path**: lancemorii-git/td-studio

## Basic Information

- **Project Name**: TD-studio
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
	<img alt="logo" src="tdengine/src/main/resources/images/logo.jpg" width="150" height="150">
</p>

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">TD Studio v1.0.0</h1>
<p align="center">免费开源的 TDengine 时序数据库图形化管理工具，提供直观、易用的数据库管理与操作体验。</p>

----

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

## 介绍

**TD Studio** 是一款功能全面、操作简便的 TDengine 时序数据库图形界面工具。当前版本支持的 TDengine Server 版本如下：

1. TDengine 2.x（2.6.0.34 已测试）
2. TDengine 3.x（3.2.3.0 已测试）

### 主要功能

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

## 软件架构

基于 JavaFX 实现 UI 功能，通过 TDengine REST API 与数据库通信。

## 安装与运行

### 方式一：下载发行版

从 [Releases](https://gitee.com/lancemorii-git/td-studio/releases) 下载最新版本，解压后运行可执行文件。

### 方式二：源码构建

```bash
mvn clean package
java -jar tdengine/target/tdengine-1.0.0.jar
```

**环境要求：** JDK 8+

## 使用说明

1. 初始界面  
![初始界面](tdengine/src/main/resources/images/readme/start.png)

2. 创建连接（输入连接名称、IP、端口、用户名、密码）  
![创建连接](tdengine/src/main/resources/images/readme/createConnection.png)

3. 创建数据库  
![创建数据库](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. 新增数据  
![新增数据](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](tdengine/src/main/resources/images/readme/executeSQL.png)

10. 资源监控  
![资源监控](tdengine/src/main/resources/images/resourceMonitor.png)

11. 导出库表 DDL  
![导出 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. 查询监控  
![查询监控](tdengine/src/main/resources/images/readme/querymonitor.png)

## 参与贡献

1. Fork 本仓库
2. 新建功能分支（如 `feat/xxx`）
3. 提交代码
4. 新建 Pull Request

## 作者

**Somirk**

- 仓库地址：https://gitee.com/lancemorii-git/td-studio

## 致谢

本项目基于开源项目 [Td-Genie](https://gitee.com/dbquery/td-genie) 进行二次开发，感谢原作者的贡献。

## 许可证

本项目采用 [Apache License 2.0](LICENSE) 开源协议。