docs.md 11.7 KB
Newer Older
X
Xiaxin Li 已提交
1 2
# 立即开始

3
## <a class="anchor" id="install"></a>快捷安装
X
Xiaxin Li 已提交
4

5
TDengine软件分为服务器、客户端和报警模块三部分,目前2.0版服务器仅能在Linux系统上安装和运行,后续会支持Windows、mac OS等系统。客户端可以在Windows或Linux上安装和运行。任何OS的应用也可以选择RESTful接口连接服务器taosd。CPU支持X64/ARM64/MIPS64/Alpha64,后续会支持ARM32、RISC-V等CPU架构。用户可根据需求选择通过[源码](https://www.taosdata.com/cn/getting-started/#通过源码安装)或者[安装包](https://www.taosdata.com/cn/getting-started/#通过安装包安装)来安装。
X
Xiaxin Li 已提交
6

7
### <a class="anchor" id="source-install"></a>通过源码安装
X
Xiaxin Li 已提交
8 9 10 11 12 13 14

请参考我们的[TDengine github主页](https://github.com/taosdata/TDengine)下载源码并安装.

### 通过Docker容器运行

请参考[TDengine官方Docker镜像的发布、下载和使用](https://www.taosdata.com/blog/2020/05/13/1509.html)

15
### <a class="anchor" id="package-install"></a>通过安装包安装
X
Xiaxin Li 已提交
16

17
TDengine的安装非常简单,从下载到安装成功仅仅只要几秒钟。服务端安装包包含客户端和连接器,我们提供三种安装包,您可以根据需要选择:
X
Xiaxin Li 已提交
18

19
安装包下载在[这里](https://www.taosdata.com/cn/getting-started/#通过安装包安装)
X
Xiaxin Li 已提交
20

21
具体的安装过程,请参见[TDengine多种安装包的安装和卸载](https://www.taosdata.com/blog/2019/08/09/566.html)以及[视频教程](https://www.taosdata.com/blog/2020/11/11/1941.html)
X
Xiaxin Li 已提交
22

23
## <a class="anchor" id="start"></a>轻松启动
X
Xiaxin Li 已提交
24 25 26

安装成功后,用户可使用`systemctl`命令来启动TDengine的服务进程。

27 28
```bash
$ systemctl start taosd
X
Xiaxin Li 已提交
29 30 31
```

检查服务是否正常工作。
32 33
```bash
$ systemctl status taosd
X
Xiaxin Li 已提交
34 35
```

Y
Yiqing Liu 已提交
36
如果TDengine服务正常工作,那么您可以通过TDengine的命令行程序`taos`来访问并体验TDengine。  
37

Y
Yiqing Liu 已提交
38
**注意:**  
39

Y
Yiqing Liu 已提交
40 41
- systemctl命令需要 _root_ 权限来运行,如果您非 _root_ 用户,请在命令前添加 sudo
- 为更好的获得产品反馈,改善产品,TDengine会采集基本的使用信息,但您可以修改系统配置文件taos.cfg里的配置参数telemetryReporting, 将其设为0,就可将其关闭。
42 43 44 45 46 47 48 49 50
- TDengine采用FQDN(一般就是hostname)作为节点的ID,为保证正常运行,需要给运行taosd的服务器配置好hostname,在客户端应用运行的机器配置好DNS服务或hosts文件,保证FQDN能够解析。

* TDengine 支持在使用[`systemd`](https://en.wikipedia.org/wiki/Systemd)做进程服务管理的linux系统上安装,用`which systemctl`命令来检测系统中是否存在`systemd`包:

  ```bash
  $ which systemctl
  ```

  如果系统中不支持systemd,也可以用手动运行 /usr/local/taos/bin/taosd 方式启动 TDengine 服务。
X
Xiaxin Li 已提交
51

52
  
53
## <a class="anchor" id="console"></a>TDengine命令行程序
X
Xiaxin Li 已提交
54

陶建辉(Jeff)'s avatar
陶建辉(Jeff) 已提交
55
执行TDengine命令行程序,您只要在Linux终端执行`taos`即可。
X
Xiaxin Li 已提交
56

57 58
```bash
$ taos
X
Xiaxin Li 已提交
59 60
```

61
如果TDengine终端连接服务成功,将会打印出欢迎消息和版本信息。如果失败,则会打印错误消息出来(请参考[FAQ](https://www.taosdata.com/cn/documentation/faq/)来解决终端连接服务端失败的问题)。TDengine终端的提示符号如下:
X
Xiaxin Li 已提交
62 63 64 65 66 67 68 69

```cmd
taos>
```

在TDengine终端中,用户可以通过SQL命令来创建/删除数据库、表等,并进行插入查询操作。在终端中运行的SQL语句需要以分号结束来运行。示例:

```mysql
陶建辉(Jeff)'s avatar
陶建辉(Jeff) 已提交
70 71 72
create database demo;
use demo;
create table t (ts timestamp, speed int);
X
Xiaxin Li 已提交
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
insert into t values ('2019-07-15 00:00:00', 10);
insert into t values ('2019-07-15 01:00:00', 20);
select * from t;
          ts          |   speed   |
===================================
 19-07-15 00:00:00.000|         10|
 19-07-15 01:00:00.000|         20|
Query OK, 2 row(s) in set (0.001700s)
```

除执行SQL语句外,系统管理员还可以从TDengine终端检查系统运行状态,添加删除用户账号等。

### 命令行参数

您可通过配置命令行参数来改变TDengine终端的行为。以下为常用的几个命令行参数:

- -c, --config-dir: 指定配置文件目录,默认为_/etc/taos_
- -h, --host: 指定服务的IP地址,默认为本地服务
- -s, --commands: 在不进入终端的情况下运行TDengine命令
92 93
- -u, -- user:  连接TDengine服务器的用户名,缺省为root
- -p, --password: 连接TDengine服务器的密码,缺省为taosdata
X
Xiaxin Li 已提交
94 95 96 97
- -?, --help: 打印出所有命令行参数

示例:

98 99
```bash
$ taos -h 192.168.0.1 -s "use db; show tables;"
X
Xiaxin Li 已提交
100 101 102 103
```

### 运行SQL命令脚本

E
Elias Soong 已提交
104
TDengine 终端可以通过 `source` 命令来运行 SQL 命令脚本.
X
Xiaxin Li 已提交
105

106
```mysql
X
Xiaxin Li 已提交
107 108 109 110 111
taos> source <filename>;
```

### Shell小技巧

E
Elias Soong 已提交
112 113
- 可以使用上下光标键查看历史输入的指令
- 修改用户密码。在 shell 中使用 alter user 指令
X
Xiaxin Li 已提交
114
- ctrl+c 中止正在进行中的查询
E
Elias Soong 已提交
115
- 执行 `RESET QUERY CACHE` 清空本地缓存的表 schema
X
Xiaxin Li 已提交
116

117 118

## <a class="anchor" id="demo"></a>TDengine 极速体验
X
Xiaxin Li 已提交
119 120 121

启动TDengine的服务,在Linux终端执行taosdemo

122 123
```bash
$ taosdemo
X
Xiaxin Li 已提交
124 125 126 127 128 129 130 131 132 133
```

该命令将在数据库test下面自动创建一张超级表meters,该超级表下有1万张表,表名为"t0" 到"t9999",每张表有10万条记录,每条记录有 (f1, f2, f3)三个字段,时间戳从"2017-07-14 10:40:00 000" 到"2017-07-14 10:41:39 999",每张表带有标签areaid和loc, areaid被设置为1到10, loc被设置为"beijing"或者“shanghai"。

执行这条命令大概需要10分钟,最后共插入10亿条记录。

在TDengine客户端输入查询命令,体验查询速度。

- 查询超级表下记录总条数:

134 135
```mysql
taos> select count(*) from test.meters;
X
Xiaxin Li 已提交
136 137 138 139
```

- 查询10亿条记录的平均值、最大值、最小值等:

140 141
```mysql
taos> select avg(f1), max(f2), min(f3) from test.meters;
X
Xiaxin Li 已提交
142 143 144 145
```

- 查询loc="beijing"的记录总条数:

146 147
```mysql
taos> select count(*) from test.meters where loc="beijing";
X
Xiaxin Li 已提交
148 149 150 151
```

- 查询areaid=10的所有记录的平均值、最大值、最小值等:

152 153
```mysql
taos> select avg(f1), max(f2), min(f3) from test.meters where areaid=10;
X
Xiaxin Li 已提交
154 155 156 157
```

- 对表t10按10s进行平均值、最大值和最小值聚合统计:

158 159
```mysql
taos> select avg(f1), max(f2), min(f3) from test.t10 interval(10s);
X
Xiaxin Li 已提交
160 161 162 163
```

**Note:** taosdemo命令本身带有很多选项,配置表的数目、记录条数等等,请执行 `taosdemo --help`详细列出。您可以设置不同参数进行体验。

164 165 166 167 168 169 170 171 172 173 174 175 176 177

## 客户端和报警模块

如果客户端和服务端运行在不同的电脑上,可以单独安装客户端。Linux和Windows安装包如下:

- TDengine-client-2.0.10.0-Linux-x64.tar.gz(3.0M)
- TDengine-client-2.0.10.0-Windows-x64.exe(2.8M)
- TDengine-client-2.0.10.0-Windows-x86.exe(2.8M)

报警模块的Linux安装包如下(请参考[报警模块的使用方法](https://github.com/taosdata/TDengine/blob/master/alert/README_cn.md)):

- TDengine-alert-2.0.10.0-Linux-x64.tar.gz (8.1M)

  
178
## <a class="anchor" id="platforms"></a>支持平台列表
179 180 181

### TDengine服务器支持的平台列表

E
Elias Soong 已提交
182
|                | **CentOS 6/7/8** | **Ubuntu 16/18/20** | **Other Linux** | **统信 UOS** | **银河/中标麒麟** | **凝思 V60/V80** | **华为 EulerOS** |
183 184 185 186 187 188 189 190 191 192 193 194 195
| -------------- | --------------------- | ------------------------ | --------------- | --------------- | ------------------------- | --------------------- | --------------------- |
| X64            | ●                     | ●                        |                 | ○               | ●                         | ●                     | ●                     |
| 树莓派 ARM32    |                       | ●                        | ●               |                 |                           |                       |                       |
| 龙芯 MIPS64     |                       |                          | ●               |                 |                           |                       |                       |
| 鲲鹏 ARM64    |                       | ○                        | ○               |                 | ●                         |                       |                       |
| 申威 Alpha64  |                       |                          | ○               | ●               |                           |                       |                       |
| 飞腾 ARM64      |                       | ○ 优麒麟                  |                 |                 |                           |                       |                       |
| 海光 X64        | ●                     | ●                        | ●               | ○               | ●                         | ●                     |                       |
| 瑞芯微 ARM64/32 |                       |                          | ○               |                 |                           |                       |                       |
| 全志 ARM64/32   |                       |                          | ○               |                 |                           |                       |                       |
| 炬力 ARM64/32   |                       |                          | ○               |                 |                           |                       |                       |
| TI ARM32       |                       |                          | ○               |                 |                           |                       |                       |
| 华为云 ARM64   |                       |                          |                 |                 |                           |                       | ●                     |
196 197 198 199 200 201 202 203 204 205 206

注: ● 表示经过官方测试验证, ○ 表示非官方测试验证。



### TDengine客户端和连接器支持的平台列表

目前TDengine的连接器可支持的平台广泛,目前包括:X64/X86/ARM64/ARM32/MIPS/Alpha等硬件平台,以及Linux/Win64/Win32等开发环境。

对照矩阵如下:

207
| **CPU**     | **X64 64bit** |           |           | **X86 32bit** | **ARM64** | **ARM32** | **MIPS 龙芯** | **Alpha 申威** | **X64 海光** |
208 209 210 211 212 213 214 215 216 217 218 219
| ----------- | --------------- | --------- | --------- | --------------- | --------- | --------- | ------------------- | -------------------- | ------------------ |
| **OS**      | **Linux**       | **Win64** | **Win32** | **Win32**       | **Linux** | **Linux** | **Linux**           | **Linux**            | **Linux**          |
| **C/C++**   | ●               | ●         | ●         | ○               | ●         | ●         | ●                   | ●                    | ●                  |
| **JDBC**    | ●               | ●         | ●         | ○               | ●         | ●         | ●                   | ●                    | ●                  |
| **Python**  | ●               | ●         | ●         | ○               | ●         | ●         | ●                   | --                   | ●                  |
| **Go**      | ●               | ●         | ●         | ○               | ●         | ●         | ○                   | --                   | --                 |
| **NodeJs**  | ●               | ●         | ○         | ○               | ●         | ●         | ○                   | --                   | --                 |
| **C#**      | ○               | ●         | ●         | ○               | ○         | ○         | ○                   | --                   | --                 |
| **RESTful** | ●               | ●         | ●         | ●               | ●         | ●         | ●                   | ●                    | ●                  |

注: ● 表示经过官方测试验证, ○ 表示非官方测试验证。

220
请跳转到 [连接器](https://www.taosdata.com/cn/documentation/connector)查看更详细的信息。
221