taosdata / TDengine

High-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios
https://tdengine.com
GNU Affero General Public License v3.0
23.36k stars 4.85k forks source link

【文档吐槽专用】WE HATE BAD DOCUMENTATIONS!!! (Welcome to comment on our documents) #690

Closed johnnyhou327 closed 4 years ago

johnnyhou327 commented 4 years ago

世界上没有完美的文档。这个置顶问题是吐槽TDengine文档的最好地方。 问卷调查传送门:你对TDengine的文档满意吗 请填花1分钟填写一下传送门中的问题,然后在楼下开始吐槽吧!

There is no perfect documentation in the world. This pinned issue is the best place that everyone criticize TDengine's documentation. Gate to the questionnaire: Let's be mean to TDengine's documentation Please fill out the questionnaire for real quick and then share your opinions below!

lst789 commented 4 years ago

程序示例太少; 对一些运行中的异常,解释说明不够; 文档不够详细。应该想国外的文档一样不厌其详,毕竟用户水平不一。

zhuchunwu commented 4 years ago

数据导入能不能写个demo,这个导入应该有一些需要注意的细节,现在的文档没有说明,导入不成功也不知道为什么

Tyxiang commented 4 years ago

建议按这个: https://github.com/ruanyf/document-style-guide/blob/master/docs/structure.md 重新组织下文档的结构。 现在有点不知道吐哪的感觉。

Tyxiang commented 4 years ago

关于 RESTful Connector 章节,内容基本上跟 RESTful 没有一毛钱关系,应该改为 HTTP Connector 。

Tyxiang commented 4 years ago

再吐槽个看完文档以后感觉最棘手的问题:“到底咋安装呢?”

lmastercn commented 4 years ago

是, JAVA 的示例在 win10 上就跑不了

JAVA Sample failed in win10 #775

===================
2019-11-27 update
现在 taos 数据是不是没有远程访问这个功能啊?

lmastercn commented 4 years ago

先把他们官网上的文档看了 tdengine 在 sql 语句上有点想 mysql,但注意这个不是 mysql 超级表就没有关联查询,普通表有 (join 查询) 还有就是可以看下他们官网上的实例 实例列表 使用TDengine快速搭建车联网平台(强烈推荐)

------------------ 原始邮件 ------------------ 发件人: "hello mars"<notifications@github.com>; 发送时间: 2019年11月28日(星期四) 下午2:38 收件人: "taosdata/TDengine"<TDengine@noreply.github.com>; 抄送: "lmaster"<407987823@qq.com>;"Comment"<comment@noreply.github.com>; 主题: Re: [taosdata/TDengine] 【文档吐槽专用】WE HATE BAD DOCUMENTATIONS!!! (Welcome to comment on our documents) (#690)

怎么建表,引擎支持什么index,不支持什么,从哪找?毫无头绪。

— You are receiving this because you commented. Reply to this email directly, view it on GitHub, or unsubscribe.

genelet commented 4 years ago

There is a GOLANG package for TDengine: https://github.com/genelet/taodbi 我的一个GO语言package,放在 GitHub上,欢迎大家使用。其中有不少使用说明。

JulianZhao commented 4 years ago

是否可以在文档中增加一些JOIN的说明,搜索整个文档就在一个地方提了一下。

在Join查询中,带前缀的*和不带前缀*返回的结果有差别, *返回全部表的所有列数据(不包含标签),带前缀的通配符,则只返回该表的列数据。

实际试用JOIN遇到很多错误提示,看来有很多限制,没有文档摸不着头脑:

DB error: invalid SQL: not support ordinary column join
DB error: invalid SQL: illegal column name
DB error: invalid SQL: tags in join condition not support binary/nchar types
DB error: invalid SQL: timestamp join condition missing
DB error: invalid SQL: = is expected in join expression
zhuangQingGuang commented 4 years ago

文档超级表页面,上面提到标签不能超过32个,下面又说标签总数不能超过6个?

sangshuduo commented 4 years ago

 2.0 文档 https://www.taosdata.com/cn/documentation/ 请针对每个问题提交 issue