README-CN.md 11.0 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
<p>
<p align="center">
  <a href="https://tdengine.com" target="_blank">
  <img
    src="docs/assets/tdengine.svg"
    alt="TDengine"
    width="500"
  />
  </a>
</p>
<p>

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
13 14 15 16 17
[![Build Status](https://travis-ci.org/taosdata/TDengine.svg?branch=master)](https://travis-ci.org/taosdata/TDengine)
[![Build status](https://ci.appveyor.com/api/projects/status/kf3pwh2or5afsgl9/branch/master?svg=true)](https://ci.appveyor.com/project/sangshuduo/tdengine-2n8ge/branch/master)
[![Coverage Status](https://coveralls.io/repos/github/taosdata/TDengine/badge.svg?branch=develop)](https://coveralls.io/github/taosdata/TDengine?branch=develop)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/4201/badge)](https://bestpractices.coreinfrastructure.org/projects/4201)

18
简体中文 | [English](README.md) | 很多职位正在热招中,请看[这里](https://www.taosdata.com/cn/careers/)
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
19

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
20 21
# TDengine 简介

22
TDengine 是一款开源、高性能、云原生的时序数据库 (Time-Series Database, TSDB)。TDengine 能被广泛运用于物联网、工业互联网、车联网、IT 运维、金融等领域。除核心的时序数据库功能外,TDengine 还提供缓存、数据订阅、流式计算等功能,是一极简的时序数据处理平台,最大程度的减小系统设计的复杂度,降低研发和运营成本。TDengine 的主要优势如下:
23

24
- 高性能:通过创新的存储引擎设计,无论是数据写入还是查询,TDengine 的性能比通用数据库快 10 倍以上,也远超其他时序数据库,存储空间不及通用数据库的1/10。
25

26
- 云原生:通过原生分布式的设计,充分利用云平台的优势,TDengine 提供了水平扩展能力,具备弹性、韧性和可观测性,支持k8s部署,可运行在公有云、私有云和混合云上。
27

28
- 极简时序数据平台:TDengine 内建消息队列、缓存、流式计算等功能,应用无需再集成 Kafka/Redis/HBase/Spark 等软件,大幅降低系统的复杂度,降低应用开发和运营成本。
29

30
- 分析能力:支持 SQL,同时为时序数据特有的分析提供SQL扩展。通过超级表、存储计算分离、分区分片、预计算、自定义函数等技术,TDengine 具备强大的分析能力。
31

32
- 简单易用:无任何依赖,安装、集群几秒搞定;提供REST以及各种语言连接器,与众多第三方工具无缝集成;提供命令行程序,便于管理和即席查询;提供各种运维工具。
33

34
- 核心开源:TDengine 的核心代码包括集群功能全部开源,截止到2022年8月1日,全球超过 135.9k 个运行实例,GitHub Star 18.7k,Fork 4.4k,社区活跃。
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
35 36 37

# 文档

38
关于完整的使用手册,系统架构和更多细节,请参考 [TDengine 文档](https://docs.taosdata.com) 或者  [English Documents](https://docs.tdengine.com)
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
39

sangshuduo's avatar
sangshuduo 已提交
40
# 构建
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
41

42
TDengine 目前可以在 Linux、 Windows 等平台上安装和运行。任何 OS 的应用也可以选择 taosAdapter 的 RESTful 接口连接服务端 taosd。CPU 支持 X64/ARM64,后续会支持 MIPS64、Alpha64、ARM32、RISC-V 等 CPU 架构。
wafwerar's avatar
wafwerar 已提交
43 44

用户可根据需求选择通过[源码](https://www.taosdata.com/cn/getting-started/#通过源码安装)或者[安装包](https://www.taosdata.com/cn/getting-started/#通过安装包安装)来安装。本快速指南仅适用于通过源码安装。
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
45 46 47

## 安装工具

wafwerar's avatar
wafwerar 已提交
48
### Ubuntu 18.04 及以上版本 & Debian:
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
49 50

```bash
51
sudo apt-get install -y gcc cmake build-essential git libssl-dev
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
52 53
```

54 55 56 57 58 59 60 61 62 63 64 65
#### 为 taos-tools 安装编译需要的软件

taosTools 是用于 TDengine 的辅助工具软件集合。目前它包含 taosBenchmark(曾命名为 taosdemo)和 taosdump 两个软件。

默认 TDengine 编译不包含 taosTools。您可以在编译 TDengine 时使用`cmake .. -DBUILD_TOOLS=true` 来同时编译 taosTools。

为了在 Ubuntu/Debian 系统上编译 [taos-tools](https://github.com/taosdata/taos-tools) 需要安装如下软件:

```bash
sudo apt install build-essential libjansson-dev libsnappy-dev liblzma-dev libz-dev pkg-config
```

wafwerar's avatar
wafwerar 已提交
66
### CentOS 7.9:
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
67 68

```bash
wafwerar's avatar
wafwerar 已提交
69 70 71 72
sudo yum install epel-release
sudo yum update
sudo yum install -y gcc gcc-c++ make cmake3 git openssl-devel
sudo ln -sf /usr/bin/cmake3 /usr/bin/cmake
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
73 74
```

75
### CentOS 8 & Fedora
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
76 77

```bash
78
sudo dnf install -y gcc gcc-c++ make cmake epel-release git openssl-devel
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
79 80
```

81 82
#### 在 CentOS 上构建 taosTools 安装依赖软件

wafwerar's avatar
wafwerar 已提交
83
#### For CentOS 7/RHEL
84 85

```
wafwerar's avatar
wafwerar 已提交
86 87 88 89
sudo yum install -y zlib-devel xz-devel snappy-devel jansson jansson-devel pkgconfig libatomic libstdc++-static openssl-devel
```

#### For CentOS 8/Rocky Linux
90

wafwerar's avatar
wafwerar 已提交
91 92 93 94 95 96 97 98 99 100 101 102 103
```
sudo yum install -y epel-release
sudo yum install -y dnf-plugins-core
sudo yum config-manager --set-enabled powertools
sudo yum install -y zlib-devel xz-devel snappy-devel jansson jansson-devel pkgconfig libatomic libstdc++-static openssl-devel
```

注意:由于 snappy 缺乏 pkg-config 支持(参考 [链接](https://github.com/google/snappy/pull/86)),会导致 cmake 提示无法发现 libsnappy,实际上工作正常。

若 powertools 安装失败,可以尝试改用:
```
sudo yum config-manager --set-enabled Powertools
```
104 105 106 107 108 109 110 111 112 113 114 115

### 设置 golang 开发环境

TDengine 包含数个使用 Go 语言开发的组件,请参考 golang.org 官方文档设置 go 开发环境。

请使用 1.14 及以上版本。对于中国用户,我们建议使用代理来加速软件包下载。

```
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
```

wafwerar's avatar
wafwerar 已提交
116 117 118 119 120 121
默认情况下,内嵌的 http 服务仍然可以从 TDengine 源码构建。当然您也可以使用以下命令选择构建 taosAdapter 作为 RESTful 接口的服务。

```
cmake .. -DBUILD_HTTP=false
```

122 123 124 125
### 设置 rust 开发环境

TDengine 包含数个使用 Rust 语言开发的组件. 请参考 rust-lang.org 官方文档设置 rust 开发环境。

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
126 127 128 129 130 131 132 133 134
## 获取源码

首先,你需要从 GitHub 克隆源码:

```bash
git clone https://github.com/taosdata/TDengine.git
cd TDengine
```

wafwerar's avatar
wafwerar 已提交
135
Go 连接器和 Grafana 插件已移到其他独立仓库。
136 137 138 139 140 141 142
如果使用 https 协议下载比较慢,可以通过修改 ~/.gitconfig 文件添加以下两行设置使用 ssh 协议下载。需要首先上传 ssh 密钥到 GitHub,详细方法请参考 GitHub 官方文档。

```
[url "git@github.com:"]
    insteadOf = https://github.com/
```

sangshuduo's avatar
sangshuduo 已提交
143
## 构建 TDengine
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
144 145 146

### Linux 系统

147 148
可以运行代码仓库中的 `build.sh` 脚本编译出 TDengine 和 taosTools(包含 taosBenchmark 和 taosdump)。

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
149
```bash
150
./build.sh
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
151 152
```

153 154 155 156 157 158 159 160 161 162 163
这个脚本等价于执行如下命令:

```bash
mkdir debug
cd debug
cmake .. -DBUILD_TOOLS=true
make
```

您也可以选择使用 jemalloc 作为内存分配器,替代默认的 glibc:

sangshuduo's avatar
sangshuduo 已提交
164 165 166 167 168
```bash
apt install autoconf
cmake .. -DJEMALLOC_ENABLED=true
```

wafwerar's avatar
wafwerar 已提交
169
在 X86-64、X86、arm64 平台上,TDengine 生成脚本可以自动检测机器架构。也可以手动配置 CPUTYPE 参数来指定 CPU 类型,如 aarch64 等。
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191

aarch64:

```bash
cmake .. -DCPUTYPE=aarch64 && cmake --build .
```

### Windows 系统

如果你使用的是 Visual Studio 2013 版本:

打开 cmd.exe,执行 vcvarsall.bat 时,为 64 位操作系统指定“x86_amd64”,为 32 位操作系统指定“x86”。

```bash
mkdir debug && cd debug
"C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvarsall.bat" < x86_amd64 | x86 >
cmake .. -G "NMake Makefiles"
nmake
```

如果你使用的是 Visual Studio 2019 或 2017 版本:

192
打开 cmd.exe,执行 vcvarsall.bat 时,为 64 位操作系统指定“x64”,为 32 位操作系统指定“x86”。
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208

```bash
mkdir debug && cd debug
"c:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" < x64 | x86 >
cmake .. -G "NMake Makefiles"
nmake
```

你也可以从开始菜单中找到"Visual Studio < 2019 | 2017 >"菜单项,根据你的系统选择"x64 Native Tools Command Prompt for VS < 2019 | 2017 >"或"x86 Native Tools Command Prompt for VS < 2019 | 2017 >",打开命令行窗口,执行:

```bash
mkdir debug && cd debug
cmake .. -G "NMake Makefiles"
nmake
```

209
### macOS 系统
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
210 211 212 213 214 215 216 217 218 219

安装 Xcode 命令行工具和 cmake. 在 Catalina 和 Big Sur 操作系统上,需要安装 XCode 11.4+ 版本。

```bash
mkdir debug && cd debug
cmake .. && cmake --build .
```

# 安装

220 221 222
## Linux 系统

生成完成后,安装 TDengine:
223

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
224
```bash
225
sudo make install
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
226 227
```

228
用户可以在[文件目录结构](https://www.taosdata.com/cn/documentation/administrator#directories)中了解更多在操作系统中生成的目录或文件。
229 230
从 2.0 版本开始, 从源代码安装也会为 TDengine 配置服务管理。
用户也可以选择[从安装包中安装](https://www.taosdata.com/en/getting-started/#Install-from-Package)
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
231 232 233 234

安装成功后,在终端中启动 TDengine 服务:

```bash
235
sudo systemctl start taosd
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
236 237 238 239 240 241 242 243 244 245
```

用户可以使用 TDengine Shell 来连接 TDengine 服务,在终端中,输入:

```bash
taos
```

如果 TDengine Shell 连接服务成功,将会打印出欢迎消息和版本信息。如果失败,则会打印出错误消息。

246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261
## Windows 系统

生成完成后,安装 TDengine:

```cmd
nmake install
```

## macOS 系统

生成完成后,安装 TDengine:

```bash
sudo make install
```

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
262 263
## 快速运行

264
如果不希望以服务方式运行 TDengine,也可以在终端中直接运行它。也即在生成完成后,执行以下命令(在 Windows 下,生成的可执行文件会带有 .exe 后缀,例如会名为 taosd.exe ):
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
265 266 267 268 269 270 271 272 273 274 275 276 277 278 279

```bash
./build/bin/taosd -c test/cfg
```

在另一个终端,使用 TDengine shell 连接服务器:

```bash
./build/bin/taos -c test/cfg
```

"-c test/cfg"指定系统配置文件所在目录。

# 体验 TDengine

280
在 TDengine 终端中,用户可以通过 SQL 命令来创建/删除数据库、表等,并进行插入查询操作。
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
281

282 283 284 285 286 287 288
```sql
CREATE DATABASE demo;
USE demo;
CREATE TABLE t (ts TIMESTAMP, speed INT);
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;
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
289 290 291 292 293 294 295 296 297 298 299
          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)
```

# 应用开发

## 官方连接器

300 301
TDengine 提供了丰富的应用程序开发接口,其中包括 C/C++、Java、Python、Go、Node.js、C# 、RESTful 等,便于用户快速开发应用:

302
- [Java](https://docs.taosdata.com/reference/connector/java/)
303
- [C/C++](https://www.taosdata.com/cn/documentation/connector#c-cpp)
304 305 306 307 308 309
- [Python](https://docs.taosdata.com/reference/connector/python/)
- [Go](https://docs.taosdata.com/reference/connector/go/)
- [Node.js](https://docs.taosdata.com/reference/connector/node/)
- [Rust](https://docs.taosdata.com/reference/connector/rust/)
- [C#](https://docs.taosdata.com/reference/connector/csharp/)
- [RESTful API](https://docs.taosdata.com/reference/rest-api/)
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
310 311

# 成为社区贡献者
E
Elias Soong 已提交
312 313

点击 [这里](https://www.taosdata.com/cn/contributor/),了解如何成为 TDengine 的贡献者。
涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
314

涛思数据(TDengine)'s avatar
涛思数据(TDengine) 已提交
315
# 加入技术交流群
E
Elias Soong 已提交
316

317
TDengine 官方社群「物联网大数据群」对外开放,欢迎您加入讨论。搜索微信号 "tdengine",加小 T 为好友,即可入群。