Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
adminstrot
TDengine
提交
cb4288de
TDengine
项目概览
adminstrot
/
TDengine
与 Fork 源项目一致
Fork自
taosdata / TDengine
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
cb4288de
编写于
8月 18, 2021
作者:
E
Elias Soong
提交者:
GitHub
8月 18, 2021
浏览文件
操作
浏览文件
下载
差异文件
Merge pull request #7429 from taosdata/docs/Update-Latest-Feature
Docs/update latest feature
上级
3aa302e7
858be72d
变更
7
展开全部
显示空白变更内容
内联
并排
Showing
7 changed file
with
122 addition
and
93 deletion
+122
-93
documentation20/cn/01.evaluation/docs.md
documentation20/cn/01.evaluation/docs.md
+2
-2
documentation20/cn/02.getting-started/docs.md
documentation20/cn/02.getting-started/docs.md
+19
-17
documentation20/cn/03.architecture/docs.md
documentation20/cn/03.architecture/docs.md
+89
-60
documentation20/cn/04.model/docs.md
documentation20/cn/04.model/docs.md
+2
-2
documentation20/cn/08.connector/01.java/docs.md
documentation20/cn/08.connector/01.java/docs.md
+1
-1
documentation20/cn/08.connector/docs.md
documentation20/cn/08.connector/docs.md
+8
-8
documentation20/cn/12.taos-sql/docs.md
documentation20/cn/12.taos-sql/docs.md
+1
-3
未找到文件。
documentation20/cn/01.evaluation/docs.md
浏览文件 @
cb4288de
...
...
@@ -10,8 +10,8 @@ TDengine的模块之一是时序数据库。但除此之外,为减少研发的
*
__硬件或云服务成本降至1/5__:由于超强性能,计算资源不到通用大数据方案的1/5;通过列式存储和先进的压缩算法,存储空间不到通用数据库的1/10。
*
__全栈时序数据处理引擎__:将数据库、消息队列、缓存、流式计算等功能融为一体,应用无需再集成Kafka/Redis/HBase/Spark/HDFS等软件,大幅降低应用开发和维护的复杂度成本。
*
__强大的分析功能__:无论是十年前还是一秒钟前的数据,指定时间范围即可查询。数据可在时间轴上或多个设备上进行聚合。即席查询可通过Shell, Python, R, MATLAB随时进行。
*
__与第三方工具无缝连接__:不用一行代码,即可与Telegraf, Grafana, EMQ, HiveMQ, Prometheus, MATLAB, R等集成。后续将支持OPC, Hadoop, Spark等
,
BI工具也将无缝连接。
*
__零运维成本、零学习成本__:安装集群简单快捷,无需分库分表,实时备份。类
似标准SQL,支持RESTful,
支持Python/Java/C/C++/C#/Go/Node.js, 与MySQL相似,零学习成本。
*
__与第三方工具无缝连接__:不用一行代码,即可与Telegraf, Grafana, EMQ, HiveMQ, Prometheus, MATLAB, R等集成。后续将支持OPC, Hadoop, Spark等
,
BI工具也将无缝连接。
*
__零运维成本、零学习成本__:安装集群简单快捷,无需分库分表,实时备份。类
标准SQL,支持RESTful,
支持Python/Java/C/C++/C#/Go/Node.js, 与MySQL相似,零学习成本。
采用TDengine,可将典型的物联网、车联网、工业互联网大数据平台的总拥有成本大幅降低。但需要指出的是,因充分利用了物联网时序数据的特点,它无法用来处理网络爬虫、微博、微信、电商、ERP、CRM等通用型数据。
...
...
documentation20/cn/02.getting-started/docs.md
浏览文件 @
cb4288de
...
...
@@ -22,7 +22,8 @@ TDengine 的安装非常简单,从下载到安装成功仅仅只要几秒钟
具体的安装过程,请参见
[
TDengine 多种安装包的安装和卸载
](
https://www.taosdata.com/blog/2019/08/09/566.html
)
以及
[
视频教程
](
https://www.taosdata.com/blog/2020/11/11/1941.html
)
。
## <a class="anchor" id="start"></a>轻松启动
<a
class=
"anchor"
id=
"start"
></a>
## 轻松启动
安装成功后,用户可使用
`systemctl`
命令来启动 TDengine 的服务进程。
...
...
@@ -30,7 +31,7 @@ TDengine 的安装非常简单,从下载到安装成功仅仅只要几秒钟
$
systemctl start taosd
```
检查服务是否正常工作
。
检查服务是否正常工作
:
```
bash
$
systemctl status taosd
```
...
...
@@ -40,20 +41,20 @@ $ systemctl status taosd
**注意:**
-
systemctl 命令需要 _root_ 权限来运行,如果您非 _root_ 用户,请在命令前添加 sudo 。
-
为更好的获得产品反馈,改善产品,TDengine 会采集基本的使用信息,但您可以修改系统配置文件 taos.cfg 里的配置参数 telemetryReporting
,
将其设为 0,就可将其关闭。
-
为更好的获得产品反馈,改善产品,TDengine 会采集基本的使用信息,但您可以修改系统配置文件 taos.cfg 里的配置参数 telemetryReporting
,
将其设为 0,就可将其关闭。
-
TDengine 采用 FQDN (一般就是 hostname )作为节点的 ID,为保证正常运行,需要给运行 taosd 的服务器配置好 hostname,在客户端应用运行的机器配置好 DNS 服务或 hosts 文件,保证 FQDN 能够解析。
-
`systemctl stop taosd`
指令在执行后并不会马上停止 TDengine 服务,而是会等待系统中必要的落盘工作正常完成。在数据量很大的情况下,这可能会消耗较长时间。
*
TDengine 支持在使用
[
`systemd`
](
https://en.wikipedia.org/wiki/Systemd
)
做进程服务管理的
l
inux 系统上安装,用
`which systemctl`
命令来检测系统中是否存在
`systemd`
包:
*
TDengine 支持在使用
[
`systemd`
](
https://en.wikipedia.org/wiki/Systemd
)
做进程服务管理的
L
inux 系统上安装,用
`which systemctl`
命令来检测系统中是否存在
`systemd`
包:
```
bash
$
which systemctl
```
如果系统中不支持
systemd
,也可以用手动运行 /usr/local/taos/bin/taosd 方式启动 TDengine 服务。
如果系统中不支持
`systemd`
,也可以用手动运行 /usr/local/taos/bin/taosd 方式启动 TDengine 服务。
##
<a class="anchor" id="console"></a>
TDengine 命令行程序
<a
class=
"anchor"
id=
"console"
></a>
## TDengine 命令行程序
执行 TDengine 命令行程序,您只要在 Linux 终端执行
`taos`
即可。
...
...
@@ -83,14 +84,14 @@ select * from t;
Query OK, 2 row(s) in set (0.003128s)
```
除执行 SQL 语句外,系统管理员还可以从 TDengine 终端
检查系统运行状态,添加删除用户账号等
。
除执行 SQL 语句外,系统管理员还可以从 TDengine 终端
进行检查系统运行状态、添加删除用户账号等操作
。
### 命令行参数
**命令行参数**
您可通过配置命令行参数来改变 TDengine 终端的行为。以下为常用的几个命令行参数:
-
-c, --config-dir: 指定配置文件目录,默认为
_/etc/taos_
-
-h, --host: 指定服务的 FQDN 地址
(也可以使用 IP)
,默认为连接本地服务
-
-c, --config-dir: 指定配置文件目录,默认为
`/etc/taos`
-
-h, --host: 指定服务的 FQDN 地址
或 IP 地址
,默认为连接本地服务
-
-s, --commands: 在不进入终端的情况下运行 TDengine 命令
-
-u, --user: 连接 TDengine 服务器的用户名,缺省为 root
-
-p, --password: 连接TDengine服务器的密码,缺省为 taosdata
...
...
@@ -99,10 +100,10 @@ Query OK, 2 row(s) in set (0.003128s)
示例:
```
bash
$
taos
-h
192.168.0.1
-s
"use db; show tables;"
$
taos
-h
h1.taos.com
-s
"use db; show tables;"
```
### 运行 SQL 命令脚本
**运行 SQL 命令脚本**
TDengine 终端可以通过
`source`
命令来运行 SQL 命令脚本.
...
...
@@ -110,13 +111,14 @@ TDengine 终端可以通过 `source` 命令来运行 SQL 命令脚本.
taos> source <filename>;
```
### Shell 小技巧
**Shell 小技巧**
-
可以使用上下光标键查看历史输入的指令
-
修改用户密码
,在 shell 中使用 alter user 指令
-
修改用户密码
:在 shell 中使用
`alter user`
命令,缺省密码为 taosdata
-
ctrl+c 中止正在进行中的查询
-
执行
`RESET QUERY CACHE`
清空本地缓存的表 schema
-
执行
`RESET QUERY CACHE`
可清除本地缓存的表 schema
-
批量执行 SQL 语句。可以将一系列的 shell 命令(以英文 ; 结尾,每个 SQL 语句为一行)按行存放在文件里,在 shell 里执行命令
`source <file-name>`
自动执行该文件里所有的 SQL 语句
-
输入 q 回车,退出 taos shell
## <a class="anchor" id="demo"></a>TDengine 极速体验
...
...
documentation20/cn/03.architecture/docs.md
浏览文件 @
cb4288de
此差异已折叠。
点击以展开。
documentation20/cn/04.model/docs.md
浏览文件 @
cb4288de
...
...
@@ -31,7 +31,7 @@ USE power;
## <a class="anchor" id="create-stable"></a>创建超级表
一个物联网系统,往往存在多种类型的设备,比如对于电网,存在智能电表、变压器、母线、开关等等。为便于多表之间的聚合,使用TDengine, 需要对每个类型的数据采集点创建一个超级表。以
表1
中的智能电表为例,可以使用如下的SQL命令创建超级表:
一个物联网系统,往往存在多种类型的设备,比如对于电网,存在智能电表、变压器、母线、开关等等。为便于多表之间的聚合,使用TDengine, 需要对每个类型的数据采集点创建一个超级表。以
[
表1
](
https://www.taosdata.com/cn/documentation/architecture#model_table1
)
中的智能电表为例,可以使用如下的SQL命令创建超级表:
```
mysql
CREATE STABLE meters (ts timestamp, current float, voltage int, phase float) TAGS (location binary(64), groupId int);
...
...
@@ -47,7 +47,7 @@ CREATE STABLE meters (ts timestamp, current float, voltage int, phase float) TAG
## <a class="anchor" id="create-table"></a>创建表
TDengine对每个数据采集点需要独立建表。与标准的关系型数据库一样,一张表有表名,Schema,但除此之外,还可以带有一到多个标签。创建时,需要使用超级表做模板,同时指定标签的具体值。以
表1
中的智能电表为例,可以使用如下的SQL命令建表:
TDengine对每个数据采集点需要独立建表。与标准的关系型数据库一样,一张表有表名,Schema,但除此之外,还可以带有一到多个标签。创建时,需要使用超级表做模板,同时指定标签的具体值。以
[
表1
](
https://www.taosdata.com/cn/documentation/architecture#model_table1
)
中的智能电表为例,可以使用如下的SQL命令建表:
```
mysql
CREATE TABLE d1001 USING meters TAGS ("Beijing.Chaoyang", 2);
...
...
documentation20/cn/08.connector/01.java/docs.md
浏览文件 @
cb4288de
...
...
@@ -88,7 +88,7 @@ TDengine 的 JDBC 驱动实现尽可能与关系型数据库驱动保持一致
### JDBC-JNI和JDBC-RESTful的对比
<table
>
<table>
<tr
align=
"center"
><th>
对比项
</th><th>
JDBC-JNI
</th><th>
JDBC-RESTful
</th></tr>
<tr
align=
"center"
>
<td>
支持的操作系统
</td>
...
...
documentation20/cn/08.connector/docs.md
浏览文件 @
cb4288de
...
...
@@ -189,7 +189,7 @@ C/C++的API类似于MySQL的C API。应用程序使用时,需要包含TDengine
-
`int taos_options(TSDB_OPTION option, const void * arg, ...)`
设置客户端选项,目前
只支持时区设置(_TSDB_OPTION_TIMEZONE_)和编码设置(_TSDB_OPTION_LOCALE_)。时区和编码
默认为操作系统当前设置。
设置客户端选项,目前
支持区域设置(
`TSDB_OPTION_LOCALE`
)、字符集设置(
`TSDB_OPTION_CHARSET`
)、时区设置(
`TSDB_OPTION_TIMEZONE`
)、配置文件路径设置(
`TSDB_OPTION_CONFIGDIR`
)。区域设置、字符集、时区
默认为操作系统当前设置。
-
`char *taos_get_client_info()`
...
...
@@ -287,7 +287,7 @@ typedef struct taosField {
异步API都需要应用提供相应的回调函数,回调函数参数设置如下:前两个参数都是一致的,第三个参数依不同的API而定。第一个参数param是应用调用异步API时提供给系统的,用于回调时,应用能够找回具体操作的上下文,依具体实现而定。第二个参数是SQL操作的结果集,如果为空,比如insert操作,表示没有记录返回,如果不为空,比如select操作,表示有记录返回。
异步API对于使用者的要求相对较高,用户可根据具体应用场景选择性使用。下面是
三
个重要的异步API:
异步API对于使用者的要求相对较高,用户可根据具体应用场景选择性使用。下面是
两
个重要的异步API:
-
`void taos_query_a(TAOS *taos, const char *sql, void (*fp)(void *param, TAOS_RES *, int code), void *param);`
...
...
@@ -903,7 +903,7 @@ C#连接器支持的系统有:Linux 64/Windows x64/Windows x86
### 安装准备
*
应用驱动安装请参考
[
安装连接器驱动步骤
](
https://www.taosdata.com/cn/documentation/connector#driver
)
。
*
.NET
接口文件TDengineDrivercs.cs和参考程序示例TDengineTest.cs均位于Windows客户端install_directory/examples/C#目录下。
*
接口文件TDengineDrivercs.cs和参考程序示例TDengineTest.cs均位于Windows客户端install_directory/examples/C#目录下。
*
在Windows系统上,C#应用程序可以使用TDengine的原生C接口来执行所有数据库操作,后续版本将提供ORM(Dapper)框架驱动。
### 示例程序
...
...
@@ -924,17 +924,17 @@ C#Checker.exe -h <fqdn>
### C#连接器的使用
在Windows系统上,
.NET应用程序可以使用TDengine的.NET接口来执行所有数据库的操作。使用.NET接口的
步骤如下所示:
在Windows系统上,
C#应用程序可以使用TDengine的C#连接器接口来执行所有数据库的操作。使用的具体
步骤如下所示:
1.
将
.NET接口文件TDengineDrivercs.cs加入到应用程序所在.NET项目
中。
1.
将
接口文件TDengineDrivercs.cs加入到应用程序所在的项目空间
中。
2.
用户可以参考TDengineTest.cs来定义数据库连接参数,以及如何执行数据插入、查询等操作;
此
.NET接口需要用到taos.dll文件,所以在执行应用程序前,拷贝Windows客户端install_directory/driver目录中的taos.dll文件到.NET项目最后生成.exe可执行文件所在
文件夹。之后运行exe文件,即可访问TDengine数据库并做插入、查询等操作。
此
接口需要用到taos.dll文件,所以在执行应用程序前,拷贝Windows客户端install_directory/driver目录中的taos.dll文件到项目最后生成.exe可执行文件所在的
文件夹。之后运行exe文件,即可访问TDengine数据库并做插入、查询等操作。
**注意:**
1.
TDengine V2.0.3.0之后同时支持32位和64位Windows系统,所以
.NET
项目在生成.exe文件时,“解决方案”/“项目”的“平台”请选择对应的“X86” 或“x64”。
2.
此
.NET
接口目前已经在Visual Studio 2015/2017中验证过,其它VS版本尚待验证。
1.
TDengine V2.0.3.0之后同时支持32位和64位Windows系统,所以
C#
项目在生成.exe文件时,“解决方案”/“项目”的“平台”请选择对应的“X86” 或“x64”。
2.
此接口目前已经在Visual Studio 2015/2017中验证过,其它VS版本尚待验证。
### 第三方驱动
...
...
documentation20/cn/12.taos-sql/docs.md
浏览文件 @
cb4288de
...
...
@@ -1230,7 +1230,7 @@ TDengine支持针对数据的聚合查询。提供支持的聚合和选择函数
- **INTERP**
```mysql
SELECT INTERP(field_name) FROM { tb_name | stb_name } WHERE ts='timestamp' [FILL ({ VALUE | PREV | NULL | LINEAR})];
SELECT INTERP(field_name) FROM { tb_name | stb_name } WHERE ts='timestamp' [FILL ({ VALUE | PREV | NULL | LINEAR
| NEXT
})];
```
功能说明:返回表/超级表的指定时间截面、指定字段的记录。
...
...
@@ -1242,8 +1242,6 @@ TDengine支持针对数据的聚合查询。提供支持的聚合和选择函数
说明:(从 2.0.15.0 版本开始新增此函数)INTERP 必须指定时间断面,如果该时间断面不存在直接对应的数据,那么会根据 FILL 参数的设定进行插值。其中,条件语句里面可以附带更多的筛选条件,例如标签、tbname。
限制:INTERP 目前不支持 FILL(NEXT)。
示例:
```mysql
taos> select interp(*) from meters where ts='2017-7-14 10:42:00.005' fill(prev);
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录