英文 | 简体中文

TDengine是什么？

TDengine是一个为传统行业克服工业4.0和工业物联网挑战而设计的时序数据库。它能够实时摄取、存储、分析和分发每天数十亿传感器和数据采集器生成的PB级数据。通过让大数据变得易于访问和负担得起，TDengine帮助所有人——从独立开发者和初创公司到行业巨头和跨国公司——充分发掘数据的真正价值。

本仓库包含TDengine开源版，这是我们的开源产品。主要特点包括：

• 通过SQL或无模式写入实现快速数据摄取
• 高效的SQL查询，包括嵌套查询和UDF
• 窗口查询和针对时序数据的SQL扩展
• 支持集群，具有云原生可扩展性
• 内置缓存、流处理和数据订阅
• 主流编程语言的客户端库

TDengine还为企业客户提供基于TDengine开源代码构建的本地部署TDengine企业版和全托管TDengine云。除了TDengine开源版的所有功能外，这些版本还包括：

• 从OPC、MQTT、PI System和Wonderware Historian等工业数据源摄取数据
• 与Seeq等行业特定分析和可视化工具集成
• 具有权限管理的数据共享
• 自动数据复制和备份
• 企业级安全和运维功能

文档

有关使用和管理TDengine开源版的更多信息，请参阅TDengine文档。

构建

目前，TDengine服务器支持在Linux/Windows/macOS系统上运行。任何应用程序也可以选择taosAdapter提供的RESTful接口来连接taosd服务。TDengine支持X64/ARM64 CPU，未来将支持MIPS64、Alpha64、ARM32、RISC-V等CPU架构。目前我们不支持使用交叉编译环境进行构建。

您可以选择通过源代码、容器、安装包或Kubernetes进行安装。本快速指南仅适用于从源代码安装。

TDengine提供了一些有用的工具，如taosBenchmark（曾命名为taosdemo）和taosdump。它们曾是TDengine的一部分。默认情况下，TDengine的编译不包括taosTools。您可以使用cmake .. -DBUILD_TOOLS=true来使它们与TDengine一起编译。

要构建TDengine，请在项目目录中使用CMake 3.13.0或更高版本。

安装构建工具

Ubuntu 18.04及以上版本或Debian

sudo apt-get install -y gcc cmake build-essential git libssl-dev libgflags2.2 libgflags-dev libexpat1-dev libapr1-dev libaprutil1-dev libmxml-dev  libgeos-dev 

安装taosTools的构建依赖

要在Ubuntu/Debian上构建taosTools，需要安装以下包。

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

CentOS 7.9

sudo yum install epel-release
sudo yum update
sudo yum install -y gcc gcc-c++ make cmake3 gflags git openssl-devel expat-devel geos-devel 
sudo ln -sf /usr/bin/cmake3 /usr/bin/cmake

CentOS 8/Fedora/Rocky Linux

sudo dnf install -y gcc gcc-c++ make cmake epel-release gflags git openssl-devel

在CentOS上安装taosTools的构建依赖

CentOS 7.9

sudo yum install -y zlib-devel zlib-static xz-devel snappy-devel jansson jansson-devel pkgconfig libatomic libatomic-static libstdc++-static openssl-devel

CentOS 8/Fedora/Rocky Linux

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 zlib-static xz-devel snappy-devel jansson jansson-devel pkgconfig libatomic libatomic-static libstdc++-static openssl-devel

注意：由于snappy缺乏pkg-config支持(参见链接)，导致cmake提示找不到libsnappy。但snappy仍能正常工作。

如果PowerTools安装失败，可以尝试使用：

sudo yum config-manager --set-enabled powertools

CentOS + devtoolset

除上述依赖外，请运行以下命令：

sudo yum install centos-release-scl
sudo yum install devtoolset-9 devtoolset-9-libatomic-devel
scl enable devtoolset-9 -- bash

macOS

brew install argp-standalone gflags pkgconfig

设置golang环境

TDengine包含一些由Go语言开发的组件，如taosAdapter。请参考golang.org官方文档进行golang环境设置。

请使用1.20+版本。对于中国用户，我们建议使用代理来加速包下载。

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

默认情况下不会构建taosAdapter，但你可以使用以下命令来构建taosAdapter作为RESTful接口的服务。

cmake .. -DBUILD_HTTP=false

设置rust环境

TDengine包含一些由Rust语言开发的组件。请参考rust-lang.org官方文档进行rust环境设置。

获取源代码

首先，你可以从GitHub克隆源代码：

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

你可以修改~/.gitconfig文件，使用ssh协议代替https以获得更好的下载速度。你需要先将ssh公钥上传到GitHub。详情请参考GitHub官方文档。

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

特别说明

JDBC连接器、Go连接器、Python连接器、Node.js连接器、C#连接器、Rust连接器和Grafana插件已移至独立仓库。

构建TDengine

在Linux平台上

你可以运行bash脚本build.sh来同时构建TDengine和taosTools（包括taosBenchmark和taosdump），如下所示：

./build.sh

这等同于执行以下命令：

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

你可以使用Jemalloc作为内存分配器来代替glibc：

apt install autoconf
cmake .. -DJEMALLOC_ENABLED=true

TDengine构建脚本可以在X86-64、X86、arm64平台上检测主机的架构。 如果检测结果不正确，你也可以指定CPUTYPE选项，比如aarch64：

aarch64:

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

在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 Native Tools Command Prompt for VS < 2019 | 2017 >"或"x86 Native Tools Command Prompt for VS < 2019 | 2017 >"（取决于你的Windows架构）来打开命令窗口，然后执行以下命令：

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

在macOS平台上

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

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

安装

在Linux平台上

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

sudo make install

用户可以在目录和文件章节中找到有关系统上安装目录的更多信息。

从源代码安装也会为TDengine配置服务管理。用户也可以选择从软件包安装。

安装后要启动服务，在终端中使用：

sudo systemctl start taosd

然后用户可以使用TDengine命令行界面连接TDengine服务器。在终端中使用:

taos

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

在Windows平台上

成功构建后，可以通过以下方式安装TDengine:

nmake install

在macOS平台上

成功构建后，可以通过以下方式安装TDengine:

sudo make install

用户可以在目录和文件部分找到有关系统上安装目录的更多信息。

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

安装后启动服务，双击/applications/TDengine启动程序，或在终端中使用:

sudo launchctl start com.tdengine.taosd

然后用户可以使用TDengine命令行界面连接TDengine服务器。在终端中使用:

taos

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

快速运行

如果您不想将TDengine作为服务运行，可以在当前shell中运行。例如，在构建后快速启动TDengine服务器，在终端中运行以下命令:(我们以Linux为例，Windows上的命令将是taosd.exe)

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

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

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

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

尝试TDengine

从TDengine命令行界面运行SQL命令很容易，与其他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;
          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)

使用TDengine进行开发

客户端库

TDengine提供客户端库，您可以使用这些库开发TDengine应用程序。这些库的文档列表如下:

• Java
• C/C++
• Python
• Go
• Node.js
• Rust
• C#

TDengine还提供REST API，通过它您的应用程序可以连接到TDengine。

为TDengine做贡献

如果您想为TDengine做出贡献，我们请您查看我们的贡献指南。

加入TDengine社区

要了解有关TDengine的更多信息，您可以在社交媒体上关注我们并加入我们的Discord服务器:

• Discord
• Twitter
• LinkedIn
• YouTube