Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
weixin_54624550
TDengine
提交
60be6be0
T
TDengine
项目概览
weixin_54624550
/
TDengine
与 Fork 源项目一致
Fork自
taosdata / TDengine
通知
4
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
T
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
60be6be0
编写于
3月 05, 2021
作者:
E
Elias Soong
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
[TD-3158] <docs>: add column_meta in RESTful result.
上级
47e3591d
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
27 addition
and
9 deletion
+27
-9
documentation20/cn/08.connector/docs.md
documentation20/cn/08.connector/docs.md
+27
-9
未找到文件。
documentation20/cn/08.connector/docs.md
浏览文件 @
60be6be0
...
...
@@ -591,7 +591,8 @@ curl -u username:password -d '<SQL>' <ip>:<PORT>/rest/sql
```
json
{
"status"
:
"succ"
,
"head"
:
[
"Time Stamp"
,
"current"
,
…
],
"head"
:
[
"ts"
,
"current"
,
…
],
"column_meta"
:
[[
"ts"
,
9
,
8
],[
"current"
,
6
,
4
],
…
],
"data"
:
[
[
"2018-10-03 14:38:05.000"
,
10.3
,
…
],
[
"2018-10-03 14:38:15.000"
,
12.6
,
…
]
...
...
@@ -602,10 +603,23 @@ curl -u username:password -d '<SQL>' <ip>:<PORT>/rest/sql
说明:
-
status: 告知操作结果是成功还是失败
-
head: 表的定义,如果不返回结果集,仅有一列“affected_rows”
-
data: 具体返回的数据,一排一排的呈现,如果不返回结果集,仅[[affected_rows]]
-
rows: 表明总共多少行数据
-
status: 告知操作结果是成功还是失败。
-
head: 表的定义,如果不返回结果集,则仅有一列“affected_rows”。(从 2.0.17 版本开始,建议不要依赖 head 返回值来判断数据列类型,而推荐使用 column_meta。在未来版本中,有可能会从返回值中去掉 head 这一项。)
-
column_meta: 从 2.0.17 版本开始,返回值中增加这一项来说明 data 里每一列的数据类型。具体每个列会用三个值来说明,分别为:列名、列类型、类型长度。例如
`["current",6,4]`
表示列名为“current”;列类型为 6,也即 float 类型;类型长度为 4,也即对应 4 个字节表示的 float。如果列类型为 binary 或 nchar,则类型长度表示该列最多可以保存的内容长度,而不是本次返回值中的具体数据长度。当列类型是 nchar 的时候,其类型长度表示可以保存的 unicode 字符数量,而不是 bytes。
-
data: 具体返回的数据,一行一行的呈现,如果不返回结果集,那么就仅有[[affected_rows]]。data 中每一行的数据列顺序,与 column_meta 中描述数据列的顺序完全一致。
-
rows: 表明总共多少行数据。
column_meta 中的列类型说明:
*
1:BOOL
*
2:TINYINT
*
3:SMALLINT
*
4:INT
*
5:BIGINT
*
6:FLOAT
*
7:DOUBLE
*
8:BINARY
*
9:TIMESTAMP
*
10:NCHAR
### 自定义授权码
...
...
@@ -651,7 +665,8 @@ curl -H 'Authorization: Basic cm9vdDp0YW9zZGF0YQ==' -d 'select * from demo.d1001
```
json
{
"status"
:
"succ"
,
"head"
:
[
"Time Stamp"
,
"current"
,
"voltage"
,
"phase"
],
"head"
:
[
"ts"
,
"current"
,
"voltage"
,
"phase"
],
"column_meta"
:
[[
"ts"
,
9
,
8
],[
"current"
,
6
,
4
],[
"voltage"
,
4
,
4
],[
"phase"
,
6
,
4
]],
"data"
:
[
[
"2018-10-03 14:38:05.000"
,
10.3
,
219
,
0.31
],
[
"2018-10-03 14:38:15.000"
,
12.6
,
218
,
0.33
]
...
...
@@ -671,8 +686,9 @@ curl -H 'Authorization: Basic cm9vdDp0YW9zZGF0YQ==' -d 'create database demo' 19
{
"status"
:
"succ"
,
"head"
:
[
"affected_rows"
],
"column_meta"
:
[[
"affected_rows"
,
4
,
4
]],
"data"
:
[[
1
]],
"rows"
:
1
,
"rows"
:
1
}
```
...
...
@@ -691,7 +707,8 @@ curl -H 'Authorization: Basic cm9vdDp0YW9zZGF0YQ==' -d 'select * from demo.d1001
```
json
{
"status"
:
"succ"
,
"head"
:
[
"column1"
,
"column2"
,
"column3"
],
"head"
:
[
"ts"
,
"current"
,
"voltage"
,
"phase"
],
"column_meta"
:
[[
"ts"
,
9
,
8
],[
"current"
,
6
,
4
],[
"voltage"
,
4
,
4
],[
"phase"
,
6
,
4
]],
"data"
:
[
[
1538548685000
,
10.3
,
219
,
0.31
],
[
1538548695000
,
12.6
,
218
,
0.33
]
...
...
@@ -712,7 +729,8 @@ HTTP请求URL采用`sqlutc`时,返回结果集的时间戳将采用UTC时间
```
json
{
"status"
:
"succ"
,
"head"
:
[
"column1"
,
"column2"
,
"column3"
],
"head"
:
[
"ts"
,
"current"
,
"voltage"
,
"phase"
],
"column_meta"
:
[[
"ts"
,
9
,
8
],[
"current"
,
6
,
4
],[
"voltage"
,
4
,
4
],[
"phase"
,
6
,
4
]],
"data"
:
[
[
"2018-10-03T14:38:05.000+0800"
,
10.3
,
219
,
0.31
],
[
"2018-10-03T14:38:15.000+0800"
,
12.6
,
218
,
0.33
]
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录