• 占用端口

• 默认用户名及密码：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>