TDengine

High-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios

taosdata
23592
4886
C

TDengine

简体中文 | English | TDengine 云服务 | 很多职位正在热招中，请看这里

目录

  1. TDengine 简介
  2. 文档
  3. 必备工具
  4. 构建
  5. 打包
  6. 安装
  7. 快速运行
  8. 测试
  9. 版本发布
  10. 工作流
  11. 覆盖率
  12. 成为社区贡献者

1. 简介

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

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

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

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

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

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

  • 核心开源：TDengine 的核心代码包括集群功能全部开源，截止到2022年8月1日，全球超过 135.9k 个运行实例，GitHub Star 18.7k，Fork 4.4k，社区活跃。

了解TDengine高级功能的完整列表，请 点击。体验TDengine最简单的方式是通过TDengine云平台。

2. 文档

关于完整的使用手册，系统架构和更多细节，请参考 TDengine 或者 TDengine 官方文档。

用户可根据需求选择通过容器、安装包、Kubernetes来安装或直接使用无需安装部署的云服务。本快速指南是面向想自己编译、打包、测试的开发者的。

如果想编译或测试TDengine连接器，请访问以下仓库: JDBC连接器, Go连接器, Python连接器, Node.js连接器, C#连接器, Rust连接器.

3. 前置条件

TDengine 目前可以在 Linux、 Windows、macOS 等平台上安装和运行。任何 OS 的应用也可以选择 taosAdapter 的 RESTful 接口连接服务端 taosd。CPU 支持 X64/ARM64，后续会支持 MIPS64、Alpha64、ARM32、RISC-V 等 CPU 架构。目前不支持使用交叉编译器构建。

如果你想要编译 taosAdapter 或者 taosKeeper，需要安装 Go 1.18 及以上版本。

3.1 Linux系统

安装Linux必备工具

Ubuntu 18.04、20.04、22.04

sudo apt-get udpate
sudo apt-get install -y gcc cmake build-essential git libjansson-dev \
  libsnappy-dev liblzma-dev zlib1g-dev pkg-config

CentOS 8

sudo yum update
yum install -y epel-release gcc gcc-c++ make cmake git perl dnf-plugins-core 
yum config-manager --set-enabled powertools
yum install -y zlib-static xz-devel snappy-devel jansson-devel pkgconfig libatomic-static libstdc++-static

3.2 macOS系统

安装macOS必备工具

根据提示安装依赖工具 brew.

brew install argp-standalone gflags pkgconfig

3.3 Windows系统

安装Windows必备工具

进行中。

3.4 克隆仓库

通过如下命令将TDengine仓库克隆到指定计算机:

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

4. 构建

TDengine 还提供一组辅助工具软件 taosTools，目前它包含 taosBenchmark（曾命名为 taosdemo）和 taosdump 两个软件。默认 TDengine 编译不包含 taosTools, 您可以在编译 TDengine 时使用cmake .. -DBUILD_TOOLS=true 来同时编译 taosTools。

为了构建TDengine, 请使用 CMake 3.13.0 或者更高版本。

4.1 Linux系统上构建

Linux系统上构建步骤

可以通过以下命令使用脚本 build.sh 编译TDengine和taosTools，包括taosBenchmark和taosdump:

./build.sh

也可以通过以下命令进行构建:

mkdir debug && cd debug
cmake .. -DBUILD_TOOLS=true -DBUILD_CONTRIB=true
make

如果你想要编译 taosAdapter，需要添加 -DBUILD_HTTP=false 选项。

如果你想要编译 taosKeeper，需要添加 --DBUILD_KEEPER=true 选项。

可以使用Jemalloc作为内存分配器，而不是使用glibc:

cmake .. -DJEMALLOC_ENABLED=true

TDengine构建脚本可以自动检测x86、x86-64、arm64平台上主机的体系结构。
您也可以通过CPUTYPE选项手动指定架构:

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

4.2 macOS系统上构建

macOS系统上构建步骤

请安装XCode命令行工具和cmake。使用XCode 11.4+在Catalina和Big Sur上完成验证。

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

如果你想要编译 taosAdapter，需要添加 -DBUILD_HTTP=false 选项。

如果你想要编译 taosKeeper，需要添加 --DBUILD_KEEPER=true 选项。

4.3 Windows系统上构建

Windows系统上构建步骤

如果您使用的是Visual Studio 2013，请执行“cmd.exe”打开命令窗口执行如下命令。
执行vcvarsall.bat时，64位的Windows请指定“amd64”，32位的Windows请指定“x86”。

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

如果您使用Visual Studio 2019或2017:

请执行“cmd.exe”打开命令窗口执行如下命令。
执行vcvarsall.bat时，64位的Windows请指定“x64”，32位的Windows请指定“x86”。

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

或者，您可以通过点击Windows开始菜单打开命令窗口->“Visual Studio < 2019 | 2017 >”文件夹->“x64原生工具命令提示符VS < 2019 | 2017 >”或“x86原生工具命令提示符VS < 2019 | 2017 >”取决于你的Windows是什么架构，然后执行命令如下：

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

5. 打包

由于一些组件依赖关系，TDengine社区安装程序不能仅由该存储库创建。我们仍在努力改进。

6. 安装

6.1 Linux系统上安装

Linux系统上安装详细步骤

构建成功后，TDengine可以通过以下命令进行安装:

sudo make install

从源代码安装还将为TDengine配置服务管理。用户也可以使用TDengine安装包进行安装。

6.2 macOS系统上安装

macOS系统上安装详细步骤

构建成功后，TDengine可以通过以下命令进行安装:

sudo make install

6.3 Windows系统上安装

Windows系统上安装详细步骤

构建成功后，TDengine可以通过以下命令进行安装:

nmake install

7. 快速运行

7.1 Linux系统上运行

Linux系统上运行详细步骤

在Linux系统上安装TDengine完成后，在终端运行如下命令启动服务:

sudo systemctl start taosd

然后用户可以通过如下命令使用TDengine命令行连接TDengine服务:

taos

如果TDengine 命令行连接服务器成功，系统将打印欢迎信息和版本信息。否则，将显示连接错误信息。

如果您不想将TDengine作为服务运行，您可以在当前终端中运行它。例如，要在构建完成后快速启动TDengine服务器，在终端中运行以下命令：（我们以Linux为例，Windows上的命令为 taosd.exe）

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

在另一个终端上，使用TDengine命令行连接服务器:

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

选项 -c test/cfg 指定系统配置文件的目录。

7.2 macOS系统上运行

macOS系统上运行详细步骤

在macOS上安装完成后启动服务，双击/applications/TDengine启动程序，或者在终端中执行如下命令：

sudo launchctl start com.tdengine.taosd

然后在终端中使用如下命令通过TDengine命令行连接TDengine服务器:

taos

如果TDengine命令行连接服务器成功，系统将打印欢迎信息和版本信息。否则，将显示错误信息。

7.3 Windows系统上运行

Windows系统上运行详细步骤

您可以使用以下命令在Windows平台上启动TDengine服务器:

.\build\bin\taosd.exe -c test\cfg

在另一个终端上，使用TDengine命令行连接服务器:

.\build\bin\taos.exe -c test\cfg

选项 -c test/cfg 指定系统配置文件的目录。

8. 测试

有关如何在TDengine上运行不同类型的测试，请参考 TDengine测试

9. 版本发布

TDengine发布版本的完整列表，请参考 版本列表

10. 工作流

TDengine构建检查工作流可以在参考 Github Action, 更多的工作流正在创建中，将很快可用。

11. 覆盖率

最新的TDengine测试覆盖率报告可参考 coveralls.io

如何在本地运行测试覆盖率报告？

在本地创建测试覆盖率报告（HTML格式），请运行以下命令:

cd tests
bash setup-lcov.sh -v 1.16 && ./run_local_coverage.sh -b main -c task 
# on main branch and run cases in longtimeruning_cases.task 
# for more infomation about options please refer to ./run_local_coverage.sh -h

注意:
请注意，-b和-i选项将使用-DCOVER=true选项重新编译TDengine，这可能需要花费一些时间。

12. 成为社区贡献者

点击 这里，了解如何成为 TDengine 的贡献者。