当前位置:

首页 > 系统应用 > 借助RESTful接口,TDengine的JDBC驱动可跨平台,而且不用为升级发愁了

借助RESTful接口,TDengine的JDBC驱动可跨平台,而且不用为升级发愁了

在TDengine-2.0.14.0版本发布之际,我们为JDBC Connector增添了一种全新的实现方式:JDBC-RESTful。它通过内部使用RESTful接口,而非taosc来连接TDengine服务器,从而实现了跨平台的功能。这意味着,无论是在Linux、Windows,还是Mac系统上

本文目录

    在TDengine-2.0.14.0版本发布之际,我们为JDBC Connector增添了一种全新的实现方式:JDBC-RESTful。它通过内部使用RESTful接口,而非taosc来连接TDengine服务器,从而实现了跨平台的功能。这意味着,无论是在Linux、Windows,还是Mac系统上,都能够开发TDengine应用。更值得一提的是,升级TDengine时,您再也无需同步升级客户端了。

    01 使用JDBC-RESTful的好处

    1.实现TDengine跨平台应用开发

    之前,由于TDengine的JDBC驱动依赖本地动态库(linux上为libtaos.so,windows上为taos.dll),开发者需要先在本地安装客户端。否则,应用程序会报错:

    no taos in ja va.library.path

    截至2026年8月,TDengine的客户端安装包仅支持Linux和Windows操作系统,并且其源码无法在其他操作系统上编译。这意味着使用macOS的用户必须先在macOS上编写代码,然后将代码部署到Linux服务器上进行调试,或者使用VS code等支持远程代码开发的IDE工具。这些额外的步骤和工具使用,无疑增加了使用TDengine的开发成本。这正是我们开发JDBC-RESTful的重要原因。使用JDBC-RESTful后,无需安装客户端,也无需使用远程代码开发的IDE工具,在MacBook上即可轻松进行开发。

    2.无需安装和升级TDengine客户端

    使用JDBC-RESTful后,不需要安装TDengine的客户端,也不需要跟随服务端升级客户端。对企业应用开发来说,由专门的运维人员来负责TDengine的维护和升级,服务端升级后,应用不需要升级客户端。

    3.可忽略不计的迁移和使用成本

    使用JDBC-RESTful,只需要修改一下driverClass和URL即可。这对于大部分的Ja va应用来说,只是修改一下配置文件即可。

    下面,详细描述一下JDBC-RESTful的相关概念和使用方法。

    02 JDBC-RESTful的实现原理

    目前,JDBC Connector的实现包括2种形式:JDBC-JNI 和 JDBC-RESTful。

    • JDBC-JNI :使用JNI调用客户端 libtaos.so(或 taos.dll )的本地方法,通过socket与taosd通信。

    • JDBC-RESTful :在内部封装了 TDengine的RESTful 接口,将SQL封装成HTTP请求发送给server端的taosd示例。

    上图显示了 3 种 Ja va 应用使用连接器访问 TDengine 的方式:

    • JDBC-JNI:Ja va 应用在物理节点1(pnode1)上使用 JDBC-JNI 的 API ,直接调用客户端 API(libtaos.so 或 taos.dll)将写入和查询请求发送到位于物理节点2(pnode2)上的 taosd 实例。

    • RESTful:应用将 SQL 发送给位于物理节点2(pnode2)上的 RESTful 连接器,再调用客户端 API(libtaos.so)。

    • JDBC-RESTful:Ja va 应用通过 JDBC-RESTful 的 API ,将 SQL 封装成一个 RESTful 请求,发送给物理节点2的 RESTful 连接器。

    03 JDBC-RESTful的使用示例

    使用 JDBC-RESTful 接口,与之前的 JDBC-JNI 相比,仅需要:

    1. driverClass 指定为“com.taosdata.jdbc.rs.RestfulDriver”;

    2. jdbcUrl 以“jdbc:TAOS-RS://”开头;

    3. 使用 6041 作为连接端口。

    下面,展示一个完整的使用JDBC-RESTful的示例。

    1.在pom.xml中引入taos-jdbcdriver依赖


    com.taosdata.jdbc
    taos-jdbcdriver
    2.0.18

    2.示例代码

    public class JdbcRestfulDemo {
    private static final String host = "taos-server";
    public static void main(String[] args) {
    try {
    // load JDBC-restful driver
    Class.forName("com.taosdata.jdbc.rs.RestfulDriver");
    // use port 6041 in url when use JDBC-restful
    String url = "jdbc:TAOS-RS://" + host + ":6041/?user=root&password=taosdata";
    Properties properties = new Properties();
    properties.setProperty("charset", "UTF-8");
    properties.setProperty("locale", "en_US.UTF-8");
    properties.setProperty("timezone", "UTC-8");
    Connection conn = DriverManager.getConnection(url, properties);
    Statement stmt = conn.createStatement();
    stmt.execute("create database if not exists restful_test");
    stmt.execute("use restful_test");
    stmt.execute("create table restful_test.weather(ts timestamp, temperature float) tags(location nchar(64))");
    stmt.executeUpdate("insert into t1 using restful_test.weather tags('北京') values(now, 18.2)");
    ResultSet rs = stmt.executeQuery("select * from restful_test.weather");
    ResultSetMetaData meta = rs.getMetaData();
    while (rs.next()) {
    for (int i = 1; i <= meta.getColumnCount(); i++) {
    System.out.print(meta.getColumnLabel(i) + ": " + rs.getString(i) + "t");
    }
    System.out.println();
    }
    rs.close();

    stmt.close();
    conn.close();
    } catch (ClassNotFoundException e) {
    e.printStackTrace();
    } catch (SQLException e) {
    e.printStackTrace();
    }
    }
    }

    04 JDBC-RESTful的性能

    从上面JDBC-RESTful的实现原理看到,JDBC-RESTful方式相当于对libtaos.so的C方法进行了两次封装,第一次是RESTful对libtaos.so中的方法进行了封装,第二次是taos-jdbcdriver对RESTful接口进行了封装。并且,使用JDBC-RESTful,意味着将数据库的访问请求全部发送给了server,server端需要做所有由client负责的SQL解析、结果集聚合等工作。那么使用JDBC-RESTful接口是否会造成性能下降呢?我们内部对JDBC-RESTful接口进行了性能测试。

    测试环境:CPU:mac pro(6核,Intel Core i7),内存:16 GB ,硬盘:SSD(500GB)

    测试记录:

    测试结论:

    1. 在每条SQL中插入的记录数少的情况下,JDBC-RESTful的写入性能是JDBC-JNI的50%左右;

    2. 在每条SQL中插入的记录数多的情况下,JDBC-RESTful的写入性能是JDBC-JNI性能的90%左右;

    3. JDBC-RESTful与JDBC-JNI在查询性能上,没有明显差异。

    注意:以上测试的写入性能和查询性能与具体测试环境和配置有关,在不同的测试环境在性能差异上略有不同。

    总结

    这里,给使用JDBC-RESTful的Ja va开发者一些使用建议:

    1. JDBC-RESTful提供了跨平台开发的特性,可以在开发环境中使用。

    2. JDBC-JNI相比JDBC-RESTful有一定的性能优势,如果在生产环境中希望最大化发挥TDengine的性能,可以使用JDBC-JNI的方式。

    3. JDBC-RESTful到JDBC-JNI的切换十分简单,一般只需要修改配置文件即可。

    点击这里,试一试JDBC-RESTful吧。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    系统应用
    相关文章 更多
    Sublime开发RESTful API调试工具_实现Header自定义与鉴权模拟功能
    Sublime开发RESTful API调试工具_实现Header自定义与鉴权模拟功能

    使用HTTPRequester插件在SublimeText中调试API时,Header必须严格遵循Key:Value格式,且必须显式声明Content-Type和Authorization;变量定义需在文件顶部使用@token,引用时使用{{token}},变量名中不能包含点号或斜杠;JSONbody必须符合RFC8259规范,且在body前需要空行;若响应

    PHP怎样通过CURL调用第三方RESTfulAPI接口
    PHP怎样通过CURL调用第三方RESTfulAPI接口

    PHP调用第三方RESTfulAPI需经过初始化、配置、执行和释放四步,注意设置CURLOPT_RETURNTRANSFER为true及正确Content-Type头。POST提交JSON时数据需转为字符串并指定application/json。错误排查重点检查返回传输、SSL验证和超时设置,响应需先验证JSON有效性再处理。

    ThinkPHP 6.0 开发 RESTful API 全流程【新手】
    ThinkPHP 6.0 开发 RESTful API 全流程【新手】

    ThinkPHP6.0开发RESTfulAPI需手动完成四个步骤:控制器按命名空间创建,资源路由在app.php显式注册,方法名严格对应且手动返回json(),前端PUT/DELETE请求需加X-HTTP-Method-Override头,以上步骤缺一不可。

    如何在VSCode中配置Node环境调试基于Fastify的后台RESTful接口
    如何在VSCode中配置Node环境调试基于Fastify的后台RESTful接口

    VSCode调试Fastify断点不触发因V8Inspector未激活。需显式添加--inspect=0.0.0.0:9229,采用attach模式配置端口、sourceMap和outFiles,确保参数在最前面且不被npm脚本吞掉。

    Yii框架RESTful接口404怎么解_Yii框架路由匹配失败排查【方法】
    Yii框架RESTful接口404怎么解_Yii框架路由匹配失败排查【方法】

    Yii框架RESTful接口返回404的常见原因有三个:首先,请求未进入框架,需检查重写规则与入口脚本是否正确;其次,urlManager配置不当,需同时启用enablePrettyUrl和showScriptName,并正确配置路由规则;最后,异常处理器未捕获NotFoundHttpException,需确认errorHandler组件有效,并在Nginx

    ThinkPHP 8.0新特性实战:如何快速搭建高性能RESTful API【方法】
    ThinkPHP 8.0新特性实战:如何快速搭建高性能RESTful API【方法】

    构建高性能RESTfulAPI需开启`rest_action_as_method`,用`Route::resource`生成标准路由,控制器方法严格对应`read`、`save`等。推荐`--api`生成控制器,统一`param()`接收数据,强制返回JSON。部署前路由缓存,注意Nginx不拦截PUT/DELETE。

    Golang开发RESTful微服务教程
    Golang开发RESTful微服务教程

    使用Gin框架开发RESTful微服务时,应采用分层项目结构,通过路由分组定义接口,利用数据绑定与校验处理请求,结合service层封装业务逻辑,并通过中间件扩展功能,最终构建清晰、可维护的高性能服务,完整实践包括模型定义、路由注册、错误处理及测试验证,且应结合数据库实现持久化,以构建生产级应用。

    Java RESTful API 精要:问题解决与最佳实践
    Java RESTful API 精要:问题解决与最佳实践

    JavaRESTfulAPI开发中常见的三个问题及最佳实践:处理API请求验证:使用Java框架和注解,实现自定义验证规则。优化响应时间:采用对象映射器,启用缓存,使用异步编程。确保API安全性:采用安全协议,实施身份验证和授权,使用安全框架。

    Flask-Restful: Python构建RESTful API的最佳实践
    Flask-Restful: Python构建RESTful API的最佳实践

    Flask-Restful是一种使用Flask框架构建RESTfulAPI的最佳实践。它可以帮助开发者在不牺牲性能和可扩展性的情况下快速构建RESTfulAPI。本文将介绍Flask-Restful的优势、基本用法和常见实践。什么是Flask-RestfulFlask-Restful是Flask框架的一个扩展库,它提供了一组工具和

    如何在PHP中使用RESTful架构
    如何在PHP中使用RESTful架构

    随着互联网技术的发展,RESTful架构已经成为了一种主流的WebAPI设计风格。与传统的Web服务相比,RESTful架构更加灵活、可扩展、易于维护,因此越来越多的Web开发人员开始使用它来设计和开发前后端交互的API。本文将介绍如何在PHP中使用RESTful架构,包括设计API、实现API以及API的测试和调试等方面。设计API在使用RESTful架

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。