-
占用端口
- 默认用户名及密码:root taosdata
- RESTful 接口默认端口:6041
- 客户端端口:6030
-
RESTful Connector
为支持各种不同类型平台的开发,TDengine 提供符合 REST 设计标准的 API,即 RESTful API。为最大程度降低学习成本,不同于其他数据库 RESTful API 的设计方法,TDengine 直接通过 HTTP POST 请求 BODY 中包含的 SQL 语句来操作数据库,仅需要一个 URL。RESTful 连接器的使用参见视频教程。
注意:与标准连接器的一个区别是,RESTful 接口是无状态的,因此 USE db_name
指令没有效果,所有对表名、超级表名的引用都需要指定数据库名前缀。(从 2.2.0.0 版本开始,支持在 RESTful url 中指定 db_name,这时如果 SQL 语句中没有指定数据库名前缀的话,会使用 url 中指定的这个 db_name。)
安装
RESTful 接口不依赖于任何 TDengine 的库,因此客户端不需要安装任何 TDengine 的库,只要客户端的开发语言支持 HTTP 协议即可。
验证
在已经安装 TDengine 服务器端的情况下,可以按照如下方式进行验证。
下面以 Ubuntu 环境中使用 curl 工具(确认已经安装)来验证 RESTful 接口的正常。
下面示例是列出所有的数据库,请把 h1.taosdata.com 和 6041(缺省值)替换为实际运行的 TDengine 服务 fqdn 和端口号:
curl -H 'Authorization: Basic cm9vdDp0YW9zZGF0YQ==' -d 'show databases;' h1.taosdata.com:6041/rest/sql
返回值结果如下表示验证通过:
{
"status": "succ",
"head": ["name","created_time","ntables","vgroups","replica","quorum","days","keep1,keep2,keep(D)","cache(MB)","blocks","minrows","maxrows","wallevel","fsync","comp","precision","status"],
"data": [
["log","2020-09-02 17:23:00.039",4,1,1,1,10,"30,30,30",1,3,100,4096,1,3000,2,"us","ready"],
],
"rows": 1
}
上述摘自:https://www.taosdata.com/cn/documentation/connector#restful
-
Widnows客户端连接失败
C:\TDengine>taos -h www.summergao.com -s "use summergao; show tables;"
Welcome to the TDengine shell from Linux, Client Version:2.2.1.3
Copyright (c) 2020 by TAOS Data, Inc. All rights reserved.
taos connect failed, reason: Unable to establish connection.
问题原因:在服务器端只开放了6030的TCP端口。
解决办法:在服务器端同时开放6030的TCP和UDP端口。
firewall-cmd --zone=public --add-port=6030/tcp --permanent
firewall-cmd --zone=public --add-port=6030/udp --permanent
firewall-cmd --reload
再次执行成功:
C:\TDengine>taos -h www.summergao.com -s "use summergao; show tables;"
Welcome to the TDengine shell from Linux, Client Version:2.2.1.3
Copyright (c) 2020 by TAOS Data, Inc. All rights reserved.
taos> use summergao; show tables;
Query OK, 0 of 0 row(s) in database (0.021000s)
table_name | created_time | columns | stable_name | uid | tid | vgId |
==========================================================================================================================================================
t | 2021-11-04 14:07:46.124 | 2 | | 844424946914061 | 1 | 3 |
Query OK, 1 row(s) in set (0.304000s)
C:\TDengine>