TDengine数据库快速入门

简介

1. 官方文档：TDengine 文档 | TDengine 文档 | 涛思数据
2. 相对于iotdb的优点：
   1. iotdb官网：https://iotdb.apache.org/zh/UserGuide/latest/QuickStart/QuickStart_apache.html
   2. 有DBeaver的直接支持
   3. 有mysql-plus的直接支持（更好支持字段映射关系和多组合下数据库的映射）
   4. 能够进行关联查询
   5. ....
3. 缺点：
   1.  TDengine 目前不支持针对单条数据记录的删除操作，即不能通过where 条件（除了timeStamp字段外的其他字段）进行删除。
   2. 目前不支持事务操作。

window安装

1. 注意：从 TDengine 3.1.0.0 开始，只提供 Windows 客户端安装包。如果需要 Windows 服务端安装包，请联系 TDengine 销售团队升级为企业版。
2. 历史版本：https://docs.taosdata.com/3.3.0/releases/tdengine/#!，找到 3.0.7.1 版本（这个版本是距离3.1.0.0最近的版本）下载 TDengine-server-3.0.7.1-Windows-x64.exe (21.6 M) ，填写邮箱，在邮箱中获取的连接放到浏览器中下载即可（ps: 不需要下载TDengine-client，因为server报中包含client了）
3. 打开安装包，一键安装即可（没有可选的安装路径）
4. 启动&停止
   1. 命令行（拥有管理员权限的 cmd 窗口）
      1. 启动：
         1. 启动taosd服务，执行命令：sc start taosd
         2. 使用 http/REST 服务，执行命令：sc start taosadapter
      2. 停止：
         1. 关闭taosd服务，执行命令：sc stoptaosd
         2. 关闭使用 http/REST 服务，执行命令： sc stop taosadapter
   2. 应用启动（找到安装的TDengine目录，默认是在C:/TDengine）
      1. 启动taosd服务，点击taosd.exe
      2. 使用 http/REST 服务，点击taosdapter.exe
   3. 配置开机自启动（非必须）
      1. 直接全局搜“服务”，找到要启动的两个服务（taosd、taosadapter）
      2. 右击服务，先停止运行，修改属性的启动类型为自动，再启动并应用，点击确定即可
   4. 验证：
      1. 点击桌面生成的Taos Shell，输入命令 taos，即可进入命令行界面
      2. 在安装目录找到taos.exe，启动进入命令行界面
      3. 进入后类比mysql操作命令界面
      4. 默认ip: localhost，端口：taosd(6030) / taosAdapter(6041)，用户名root， 密码taosdata （可以在cfg/taosadapter.toml 中修改）

其他

1. 集成连接工具
   1. 官方的client：https://docs.taosdata.com/releases/tdengine/ 下载对应的client，安装即可
   2. 第三方的工具（https://docs.taosdata.com/3.3.0/third-party/）
      1. DBeaver: https://docs.taosdata.com/3.3.0/third-party/dbeaver/ （推荐：集成了很多数据库）
         1. taosAdapter(6041)：DBeaver中TDengine图标默认的数据库连接
         2. taosd(6030)：需要复制出一个新的数据库连接才行。
            1. 步骤：在工具栏 -》数据库 -》 驱动管理器 -》点击TDengine图标 -> 右侧点击复制 -》 修改驱动名称（自定义名称）、类名（com.taosdata.jdbc.TSDBDriver），urL模板（jdbc://TAOS://{host}:{port}/[{db}]）-> 最后点击确定即可
            2. 重新点击新建数据库连接，搜索自定义的驱动名称即可，后续就是配置相应的ip，端口，用户和密码即可
      2. qStudio：https://docs.taosdata.com/3.3.0/third-party/qstudio/
   3. 可视化组件：https://docs.taosdata.com/operation/gui/
   4. 运行监控：https://docs.taosdata.com/operation/monitor/
   5. taosdump 是 TDengine 集群的数据备份、还原工具
2.   连接器：https://docs.taosdata.com/reference/connector/java/
   1. TDengine 的 JDBC URL 规范格式为： jdbc:[TAOS|TAOS-WS|TAOS-RS]://[host_name]:[port]/[database_name]?[user={user}|&password={password}|&charset={charset}|&cfgdir={config_dir}|&locale={locale}|&timezone={timezone}|&batchfetch={batchfetch}]
   2. 驱动类：
      1. WebSocket 连接使用驱动类 com.taosdata.jdbc.ws.WebSocketDriver。
      2. 原生连接使用 com.taosdata.jdbc.TSDBDriver。
      3. REST 连接使用驱动类 com.taosdata.jdbc.rs.RestfulDriver。
   3. 连接：
      1. websocket: "jdbc:TAOS-WS://localhost:6041?user=root&password=taosdata"
      2. jdbc:TAOS://localhost:6030?user=root&password=taosdata
      3. REST 连接："jdbc:TAOS-RS://localhost:6041?user=root&password=taosdata"
3.   taosd(6030) & taosAdapter(6041)
   1. taosd是核心的服务端，而taosAdapter是适配器，两个端口都可以正常访问，但当客户端和服务端的版本不一致时，需要使用taosAdapter进行转换，即访问6041端口，但是使用taosAdapter效率会减低，但是无法体验数据订阅和二进制数据类型等功能
   2. TDengine 客户端驱动的版本号与 TDengine 服务端的版本号是一一对应的强对应关系，建议使用与 TDengine 服务端完全相同的客户端驱动。虽然低版本的客户端驱动在前三段版本号一致（即仅第四段版本号不同）的情况下也能够与高版本的服务端相兼容，但这并非推荐用法。强烈不建议使用高版本的客户端驱动访问低版本的服务端。
   3. 适配版本参考：https://docs.taosdata.com/reference/connector/ 的版本支持，查看TDengine 版本和对应语言的版本
   4.  java版本看：https://docs.taosdata.com/reference/connector/java/ 的历史版本做到 maven的taos-jdbcdriver 版本 和 TDengine 版本 版本匹配
   5.   错误码：https://docs.taosdata.com/reference/error-code/
4.   集成springboot使用参考：
   1. 最好确保maven的版本和TDengine版本一致，若是跨太大的版本，则最好使用taosAdapter(6041)
   2. 所创建的表的第一个列为必须为Timestamp，否则会报错，同时实体中对应的字段类型也是 java.sql.Timestamp（可以当作主键）
   3. 可以集成mybatis-plus，但部分api使用会报异常，如更新语句，时间序列好像不允许更新
   4. 集成参考：https://blog.csdn.net/weixin_43564627/article/details/143187230、https://blog.csdn.net/weixin_43296313/article/details/124175619