TDengine的客户端安装和连接

已于 2023-12-28 14:30:21 修改
阅读量3.7k 收藏 24
点赞数 22
分类专栏： 其它 文章标签： tdengine 时序数据库
于 2023-12-12 15:44:11 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_48136911/article/details/134947464
版权

0、环境

TDengine服务器版本：Version:2.6.0.14

[root@dev-sthx ~]# taos

Welcome to the TDengine shell from Linux, Client Version:2.6.0.14
Copyright (c) 2022 by TAOS Data, Inc. All rights reserved.

   *********************  How to Use TAB in TAOS Shell ******************************
   *   Taos shell supports pressing TAB key to complete word. You can try it.       *
   *   Press TAB key anywhere, You'll get surprise.                                 *
   *   KEYBOARD SHORTCUT:                                                           *
   *    [ TAB ]        ......  Complete the word or show help if no input           *
   *    [ Ctrl + A ]   ......  move cursor to [A]head of line                       *
   *    [ Ctrl + E ]   ......  move cursor to [E]nd of line                         *
   *    [ Ctrl + W ]   ......  move cursor to line of middle                        *
   *    [ Ctrl + L ]   ......  clean screen                                         *
   *    [ Ctrl + K ]   ......  clean after cursor                                   *
   *    [ Ctrl + U ]   ......  clean before cursor                                  *
   *                                                                                *
   **********************************************************************************

taos>

官方相关文档：

建立连接 | TDengine 文档 | 涛思数据

1、介绍

连接器建立连接的方式，TDengine 提供两种:

  1. 通过 taosAdapter 组件提供的 REST API 建立与 taosd 的连接，这种连接方式下文中简称“REST 连接”
  2. 通过客户端驱动程序 taosc 直接与服务端程序 taosd 建立连接，这种连接方式下文中简称“原生连接”。

无论使用何种方式建立连接，连接器都提供了相同或相似的 API 操作数据库，都可以执行 SQL 语句，只是初始化连接的方式稍有不同，用户在使用上不会感到什么差别。

关键不同点在于：

  1. 使用 REST 连接，用户无需安装客户端驱动程序 taosc，具有跨平台易用的优势，但性能要下降 30%左右。
  2. 使用原生连接可以体验 TDengine 的全部功能，如参数绑定接口、订阅等等。

 2、REST API 连接TDengine

无需安装客户端，直接连接使用即可。

2.1、导入依赖

如果使用 maven 管理项目，只需在 pom.xml 中加入以下依赖。

<dependency>
  <groupId>com.taosdata.jdbc</groupId>
  <artifactId>taos-jdbcdriver</artifactId>
  <version>2.0.38</version>
</dependency>

2.2、样例

package com.taos.example;

import java.sql.*;
import java.util.Properties;

import com.taosdata.jdbc.TSDBDriver;

public class RestConnectExample {
    public static void main(String[] args) throws SQLException {
        // 这里用的是TAOS-RS，端口为6041
        String jdbcUrl = "jdbc:TAOS-RS://192.168.xx.xx:6041/test_data?&timezone=UTC-8&charset=UTF-8&locale=en_US.UTF-8&druid.stat.mergeSql=false";

        Properties connProps = new Properties();
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_USER, "root");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_PASSWORD, "taosdata");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_BATCH_LOAD, "false");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_CHARSET, "UTF-8");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_LOCALE, "en_US.UTF-8");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_TIME_ZONE, "UTC-8");

        String sql = "SELECT tbname,value,TIMEDIFF(ts,0) as ts_long FROM test_data.meters WHERE tbname IN ('73654') order by ts limit 5";

        Connection restConn =null;
        Statement stmt = null;
        try {
            // 驱动
            Class.forName("com.taosdata.jdbc.rs.RestfulDriver");
            restConn = DriverManager.getConnection(jdbcUrl, connProps);
            stmt = restConn.createStatement();

            // query data
            ResultSet resultSet = stmt.executeQuery(sql);

            while(resultSet.next()){
                System.out.println("tbname:"+resultSet.getString(1)+",value:"+resultSet.getString(2)+",ts:"+resultSet.getString(3));
            }
        }catch (Exception e){
            e.printStackTrace();
        } finally {
            if (stmt != null){
                stmt.close();
            }
            if (restConn != null) {
                restConn.close();
            }
        }
    }
}

运行

[admin@kingjw33 module]$ java -jar demo-1.0-SNAPSHOT-jar-with-dependencies.jar com.taos.example.RestConnectExample

tbname:73654,value:0.0,ts:1672502400000
tbname:73654,value:0.0,ts:1672502403000
tbname:73654,value:0.0,ts:1672506001000
tbname:73654,value:0.0,ts:1672509601000
tbname:73654,value:0.0,ts:1672513202000

3、原生JDBC连接TDengine

这里以Linux为例

3.1、下载客户端安装包

这里要按照需要连接的TDengine的服务器的版本进行客户端的选择，我这里的TDengine版本为2.6.0.14，所以选择如下

 全部的Linux版本的TDengine客户端下载地址：

所有下载链接 - TDengine | 涛思数据

3.2、上传解压安装

3.2.1、上传到Linux服务器

[admin@kingjw33 software]$ ll

-rw-rw-r--. 1 admin admin 16465198 12月 12 13:25 TDengine-server-2.6.0.14-Linux-x64.tar.gz

3.2.2、解压

[admin@kingjw33 software]$ tar -zxvf TDengine-server-2.6.0.14-Linux-x64.tar.gz -C /opt/module/

解压软件包之后，会在解压目录下看到以下文件(目录)：

  • install_client.sh：安装脚本，用于应用驱动程序
  • taos.tar.gz：应用驱动安装包
  • driver：TDengine 应用驱动 driver
  • examples: 各种编程语言的示例程序(c/C#/go/JDBC/MATLAB/python/R) 运行 install_client.sh 进行安装。

3.2.3、安装TDengine客户端

[admin@kingjw33 TDengine-server-2.6.0.14]$ /opt/module/TDengine-server-2.6.0.14/install.sh

Start to install TDengine...
Created symlink from /etc/systemd/system/multi-user.target.wants/taosd.service to /etc/systemd/system/taosd.service.

System hostname is: kingjw33

Enter FQDN:port (like h1.taosdata.com:6030) of an existing TDengine cluster node to join
OR leave it blank to build one:

Enter your email address for priority support or enter empty to skip: 

To configure TDengine : edit /etc/taos/taos.cfg
To configure taosadapter (if has) : edit /etc/taos/taosadapter.toml
To start TDengine     : sudo systemctl start taosd
To access TDengine    : taos -h kingjw33 to login into TDengine server

TDengine is installed successfully!

3.3、配置 taos.cfg

编辑 taos.cfg 文件（默认路径/etc/taos/taos.cfg），将 firstEp 修改为 TDengine 服务器的 End Point，例如：h1.tdengine.com:6030

[admin@kingjw33 TDengine-server-2.6.0.14]$ sudo vim /etc/taos/taos.cfg

修改如下内容：

# first fully qualified domain name (FQDN) for TDengine system
# firstEp                   hostname:6030
firstEp                   dev-sthx:6030

# local fully qualified domain name (FQDN)
# fqdn                      hostname
fqdn                      dev-sthx

注：其中的 dev-sthx 为TDengine服务器的名称

添加服务器信息到hosts文件

[admin@kingjw33 TDengine-server-2.6.0.14]$ sudo vim /etc/hosts

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
# 本机
192.168.xx.33 kingjw33
# TDengine服务器
192.168.xx.xx dev-sthx

3.4、安装验证

以上安装和配置完成后，并确认 TDengine 服务已经正常启动运行，此时可以执行安装包里带有的 TDengine 命令行程序 taos 进行登录。

3.4.1、进入shell客户端

在 Linux shell 下直接执行 taos 连接到 TDengine 服务，进入到 TDengine CLI 界面，示例如下：

[admin@kingjw33 TDengine-server-2.6.0.14]$ taos

Welcome to the TDengine shell from Linux, Client Version:2.6.0.14
Copyright (c) 2022 by TAOS Data, Inc. All rights reserved.

   *********************  How to Use TAB in TAOS Shell ******************************
   *   Taos shell supports pressing TAB key to complete word. You can try it.       *
   *   Press TAB key anywhere, You'll get surprise.                                 *
   *   KEYBOARD SHORTCUT:                                                           *
   *    [ TAB ]        ......  Complete the word or show help if no input           *
   *    [ Ctrl + A ]   ......  move cursor to [A]head of line                       *
   *    [ Ctrl + E ]   ......  move cursor to [E]nd of line                         *
   *    [ Ctrl + W ]   ......  move cursor to line of middle                        *
   *    [ Ctrl + L ]   ......  clean screen                                         *
   *    [ Ctrl + K ]   ......  clean after cursor                                   *
   *    [ Ctrl + U ]   ......  clean before cursor                                  *
   *                                                                                *
   **********************************************************************************

taos>

3.4.2、查询测试

查询数据库

taos> show databases;
              name              |      created_time       |   ntables   |   vgroups   | replica | quorum |  days  |           keep           |  cache(MB)  |   blocks    |   minrows   |   maxrows   | wallevel |    fsync    | comp | cachelast | precision | update |   status   |
====================================================================================================================================================================================================================================================================================
 test                           | 2022-09-20 11:23:40.842 |         125 |           1 |       1 |      1 |     10 | 3650                     |          16 |           6 |         100 |        4096 |        1 |        3000 |    2 |         0 | ms        |      0 | ready      |
 log                            | 2022-09-19 10:46:08.149 |         552 |           1 |       1 |      1 |     10 | 30                       |           1 |           3 |         100 |        4096 |        1 |        3000 |    2 |         0 | us        |      0 | ready      |
 test_data                        | 2023-02-27 19:40:58.600 |      408827 |           4 |       1 |      1 |     10 | 3650                     |          16 |           6 |         100 |        4096 |        1 |        3000 |    2 |         0 | ms        |      1 | ready      |
Query OK, 3 row(s) in set (0.016741s)

taos>

查表数据

taos> use test_data;
Database changed.

taos> select * from `73654` limit 5;
           ts            |        value         |
=================================================
 2023-01-01 00:00:00.000 |              0.00000 |
 2023-01-01 00:00:03.000 |              0.00000 |
 2023-01-01 01:00:01.000 |              0.00000 |
 2023-01-01 02:00:01.000 |              0.00000 |
 2023-01-01 03:00:02.000 |              0.00000 |
Query OK, 5 row(s) in set (0.124132s)

taos>

注意：这里验证是否成功，一定要到成功查询到数据，有时候客户端版本和服务器的版本不对的时候，前面的安装到连接show databases； 之前都是正常的，但是一查询数据就会有如下的报错：

报错信息：TDengine ERROR (80000216): syntax error near 'unrecognized token: ") order by ts asc ;"'

3.5、样例

导入pom依赖

<dependency>
  <groupId>com.taosdata.jdbc</groupId>
  <artifactId>taos-jdbcdriver</artifactId>
  <version>2.0.38</version>
</dependency>

java代码

package com.taos.example;

import com.taosdata.jdbc.TSDBDriver;

import java.sql.*;
import java.util.Properties;

public class JDBCConnectExample {
    public static void main(String[] args) throws SQLException {
        // 这里用的是TAOS，端口为6030
        String jdbcUrl = "jdbc:TAOS://192.168.xx.xx:6030/test_data?&timezone=UTC-8&charset=UTF-8&locale=en_US.UTF-8&druid.stat.mergeSql=false";

        Properties connProps = new Properties();
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_USER, "root");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_PASSWORD, "taosdata");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_BATCH_LOAD, "false");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_CHARSET, "UTF-8");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_LOCALE, "en_US.UTF-8");
        connProps.setProperty(TSDBDriver.PROPERTY_KEY_TIME_ZONE, "UTC-8");

        String sql = "SELECT tbname,value,TIMEDIFF(ts,0) as ts_long FROM test_data.meters WHERE tbname IN ('73654') order by ts limit 5";

        Connection restConn =null;
        Statement stmt = null;
        try {
            // 驱动
            Class.forName("com.taosdata.jdbc.TSDBDriver");
            restConn = DriverManager.getConnection(jdbcUrl, connProps);
            stmt = restConn.createStatement();

            // query data
            ResultSet resultSet = stmt.executeQuery(sql);

            while(resultSet.next()){
                System.out.println("tbname:"+resultSet.getString(1)+",value:"+resultSet.getString(2)+",ts:"+resultSet.getString(3));
            }
        }catch (Exception e){
            e.printStackTrace();
        } finally {
            if (stmt != null){
                stmt.close();
            }
            if (restConn != null) {
                restConn.close();
            }
        }
    }
}

打包到linux上测试

[admin@kingjw33 module]$ java -jar demo-1.0-SNAPSHOT-jar-with-dependencies.jar com.taos.example.JDBCConnectExample

tbname:73654,value:0.0,ts:1672502400000
tbname:73654,value:0.0,ts:1672502403000
tbname:73654,value:0.0,ts:1672506001000
tbname:73654,value:0.0,ts:1672509601000
tbname:73654,value:0.0,ts:1672513202000

4、总结

        一般的TDengine客户端测试的时候使用REST API就可以了，毕竟安装TDengine的客户端还是挺麻烦的。

        还有就是在Linux上安装TDengine客户端的时候要慎重点，装错了版本不好卸载。

        有帮助的话帮忙点个赞吧！

TDengine-client-2.0.16.0-Linux-x64.tar.gz
03-12
TDengine-client-2.0.16.0-Linux-x64.tar.gz
TDengine使用客户端DbVisualizer Pro9.2.8
专注技术交流、咨询
08-16 1923
说明：TDengine官方未提供可视化的客户端，只提供了命令行的客户端，命令行操作太难用，所以我们选择使用Dbvis9.2.8作为可视化的客户端，下关配置如下： 一、下载Dbvis9.2.8以及相关驱动包 1、为了大家方便，我将Dbvis9.2.8与相关驱动包合成了一个压缩包，相关驱动包一个都不能少（官方没有打在一起，差评），供大家使用 下载地址为： 2、Dbvis9.2.8安装，直接双击dbvis_windows-x64_9_2_8.zip里面的dbvis_windows-x64_9_2_8.exe即
数据库管理工具实战：IDEA 与 DBeaver 连接 TDengine（二）
最新发布
qq_42190530的博客
04-08 1616
数据库管理工具实战：IDEA 与 DBeaver 连接 TDengine（二）
TDengine-client-windows-x64-1.6.4.5.exe
04-21
tdengine的windows客户端
2-TDengine客户端连接，RESTful，JDBC(1)
2401_84048445的博客
04-29 1137
针对以上面试题，小编已经把面试题+答案整理好了。
TDengine 客户端连接工具 taos-Cli
TDengine(老段）专注时序数据库领域
02-13 1930
TDengine 命令行工具（以下简称 TDengine CLI）是用户操作 TDengine 实例并与之交互最简洁常用工具。
TDengine服务器与客户端安装
AnnieRabbit的博客
06-07 5729
TDEngine
TDengine-client-2.0.9.0-Windows-x64.exe
12-10
TDengine客户端安装包
TDengine Windows客户端和服务器
04-26
在Windows平台上部署TDengine客户端和服务器，可以充分利用其优势来支持各种应用场景，如工业监控、智能运维、车联网等。 首先，了解TDengine的基本架构至关重要。TDengine由两部分组成：Server端和Client端。...
Windows系统TDengine客户端下载及安装
m0_73100347的博客
11-18 849
自己也记录一下过程：将hosts文件拖到桌面，以记事本方式打开后进行修改保存，然后再拖拽回C:\Windows\System32\drivers\etc文件夹下，拖拽过程会有以下提示，点击继续即可。本次教程的前提是已经安装好TDengine服务端了，假设TDengine服务端设置的hostname为td01，TDengine服务端ip为127.0.0.1。双击TDengine-client-2.0.20.9-Windows-x64.exe进行安装，如下所示，点击next即可。
连接TDengine客户端
10-21
连接TDengine客户端
TDengine初试 | TD服务器安装与参数配置 | TD客户端安装与配置 | 使用DBeaver工具连接到TDengine服务器端
zwcslj的博客
11-03 3852
安装 TDengine Server，解压到server/soft目录下，并在目录server/soft/TDengine-server-3.0.2.6/执行安装命令。编辑 taos.cfg 文件（默认路径 C:\TDengine\cfg\taos.cfg），将 firstEP 修改为 TDengine 服务器的节点。由于使用的是 FQDN 连接服务器，必须确认本机网络环境 DNS 已配置好，在 hosts 文件中添加 FQDN 寻址记录, 如编辑。，如果无法编辑，先在属性里把只读去掉。
TDEngine环境安装、配置及使用经验总结
热门推荐
weixin_44462773的博客
06-02 2万+
TDEngine Server \ clent \ taostools环境下载、安装及配置
第四章：TDengine 的客户端管理工具 DBeaver
RodJohnsonDoctor的专栏
11-06 783
DBeaver 是一款流行的跨平台数据库管理工具，方便开发者、数据库管理员、数据分析师等用户管理数据。DBeaver 从 23.1.1 版本开始内嵌支持 TDengine。
Tdengine 时序数据库-安装与客户端连接
daqu1314的博客
06-27 1656
注意BUG:安装的版本是2.x 就用驱动2.x版本,3.x版 就用3.x版本的驱动,不然会出现,配置完成了,连接数据库很慢.第一次是没有驱动的,就点击下载/更新,驱动列表中选择好驱动的版本,当然你也可以官网下载好,自己编译,我这边已经配置完成,RPM安装比较简单,需要的依赖在安装时自己就连网下载,3.0版本也可以这样安装.首先下载 dbeaver 社区版的,不建议官网下载,真的很慢很慢;点击finish 结束, 双击你的数据库,就可以看到连接成功了!使用的安装RPM的安装方便安装。
TDengine 产品组件: 客户端 taosc
TDengine(老段）专注时序数据库领域
02-21 1170
TDengine 客户端驱动提供了应用编程所需要的全部 API，并且在整个集群的分布式计算中扮演着重要角色。客户端驱动的行为除了 API 及其具体参数以外，也可以通过配置文件的形式进行全局控制，本节列举 TDengine 客户端可以使用的配置参数。
涛思数据TDengine征稿 — 保姆级教程TDengine客户端服务器安装教程
陈言必行 -- Unity游戏开发领域优质博主
06-27 2575
还在一边挠头一边看官方教程？那还不点进来看看，我一步步教你完成安装。绝对的保姆级教程，让安装变得更简单~
DBeaver 连接 Taos
01-16
### 如何配置 DBeaver 连接到 TDengine 数据库 #### 创建新的数据库连接 在DBeaver中创建一个新的数据库连接，选择通用JDBC连接[^2]。 #### 添加TDengine JDBC驱动程序 为了使DBeaver能够识别并连接到TDengine数据库，需要添加特定于TDengine的JDBC驱动程序。可以从官方资源下载`taos-jdbcdriver-3.0.0-dist.jar`文件[^1]。完成下载后，在DBeaver内设置此jar作为自定义驱动的一部分： 1. 打开DBeaver中的“Driver Manager”，点击右上角的新建按钮来增加新驱动； 2. 输入名称如'TDengine'，并将之前下载好的`.jar`文件路径填入URL字段； 3. 设置默认端口号为6030（这是TDengine的标准服务端口），同时指定正确的类名：`com.taosdata.jdbc.TSDBDriver`[^4]； #### 配置连接属性 当一切准备就绪时，返回至新建连接界面填写必要的参数，比如服务器IP地址、端口、用户名以及密码等信息。确保这些细节无误后再尝试建立链接，并利用提供的测试功能验证能否顺利抵达目标数据库实例。 ```sql -- 测试SQL语句用于确认连接正常工作 SELECT * FROM information_schema.tables LIMIT 5; ``` 如果遇到任何问题或错误提示，请参照相关文档排查可能存在的配置失误之处[^3]。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值