homework-jianmu/README-CN.md

9.2 KiB
Raw Blame History

Build Status Build status Coverage Status CII Best Practices tdengine

TDengine

简体中文 | English

TDengine 简介

TDengine是涛思数据专为物联网、车联网、工业互联网、IT运维等设计和优化的大数据平台。除核心的快10倍以上的时序数据库功能外还提供缓存、数据订阅、流式计算等功能最大程度减少研发和运维的复杂度且核心代码包括集群功能全部开源开源协议AGPL v3.0)。

  • 10 倍以上性能提升。定义了创新的数据存储结构单核每秒就能处理至少2万次请求插入数百万个数据点读出一千万以上数据点比现有通用数据库快了十倍以上。
  • 硬件或云服务成本降至1/5。由于超强性能计算资源不到通用大数据方案的1/5通过列式存储和先进的压缩算法存储空间不到通用数据库的1/10。
  • 全栈时序数据处理引擎。将数据库、消息队列、缓存、流式计算等功能融合一起应用无需再集成Kafka/Redis/HBase/Spark等软件大幅降低应用开发和维护成本。
  • 强大的分析功能。无论是十年前还是一秒钟前的数据指定时间范围即可查询。数据可在时间轴上或多个设备上进行聚合。即席查询可通过Shell/Python/R/Matlab随时进行。
  • 与第三方工具无缝连接。不用一行代码即可与Telegraf, Grafana, EMQ X, Prometheus, Matlab, R集成。后续还将支持MQTT, OPC, HadoopSpark等, BI工具也将无缝连接。
  • 零运维成本、零学习成本。安装、集群一秒搞定无需分库分表实时备份。标准SQL支持JDBC,RESTful支持Python/Java/C/C++/Go/Node.JS, 与MySQL相似零学习成本。

文档

TDengine是一个高效的存储、查询、分析时序大数据的平台专为物联网、车联网、工业互联网、运维监测等优化而设计。您可以像使用关系型数据库MySQL一样来使用它但建议您在使用前仔细阅读一遍下面的文档特别是 数据模型数据建模。除本文档之外,欢迎 下载产品白皮书

生成

TDengine目前2.0版服务器仅能在Linux系统上安装和运行后续会支持Windows、macOS等系统。客户端可以在Windows或Linux上安装和运行。任何OS的应用也可以选择RESTful接口连接服务器taosd。CPU支持X64/ARM64/MIPS64/Alpha64后续会支持ARM32、RISC-V等CPU架构。用户可根据需求选择通过源码或者安装包来安装。本快速指南仅适用于通过源码安装。

安装工具

Ubuntu 16.04 及以上版本 & Debian

sudo apt-get install -y gcc cmake build-essential git

Ubuntu 14.04

sudo apt-get install -y gcc cmake3 build-essential git binutils-2.26
export PATH=/usr/lib/binutils-2.26/bin:$PATH

编译或打包 JDBC 驱动源码,需安装 Java JDK 8 或以上版本和 Apache Maven 2.7 或以上版本。

安装 OpenJDK 8

sudo apt-get install -y openjdk-8-jdk

安装 Apache Maven

sudo apt-get install -y  maven

CentOS 7

sudo yum install -y gcc gcc-c++ make cmake git

安装 OpenJDK 8

sudo yum install -y java-1.8.0-openjdk

安装 Apache Maven

sudo yum install -y maven

CentOS 8 & Fedora:

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

安装 OpenJDK 8

sudo dnf install -y java-1.8.0-openjdk

安装 Apache Maven

sudo dnf install -y maven

获取源码

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

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

Go 连接器和 Grafana 插件在其他独立仓库,如果安装它们的话,需要在 TDengine 目录下通过此命令安装:

git submodule update --init --recursive

生成 TDengine

Linux 系统

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

在X86-64、X86、arm64 和 arm32 平台上TDengine 生成脚本可以自动检测机器架构。也可以手动配置 CPUTYPE 参数来指定 CPU 类型,如 aarch64 或 aarch32 等。

aarch64

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

aarch32

cmake .. -DCPUTYPE=aarch32 && cmake --build .

Windows 系统

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

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

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 版本:

打开cmd.exe执行 vcvarsall.bat 时,为 64 位操作系统指定“x64”为 32 位操作系统指定“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

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

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

Mac OS X 系统

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

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

安装

如果你不想安装可以直接在shell中运行。生成完成后安装 TDengine

make install

用户可以在文件目录结构中了解更多在操作系统中生成的目录或文件。

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

taosd

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

taos

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

快速运行

TDengine 生成后,在终端执行以下命令:

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

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

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

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

体验 TDengine

在TDengine终端中用户可以通过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 提供了丰富的应用程序开发接口其中包括C/C++、Java、Python、Go、Node.js、C# 、RESTful 等,便于用户快速开发应用:

  • Java

  • C/C++

  • Python

  • Go

  • RESTful API

  • Node.js

第三方连接器

TDengine 社区生态中也有一些非常友好的第三方连接器,可以通过以下链接访问它们的源码。

运行和添加测试例

TDengine 的测试框架和所有测试例全部开源。

点击这里,了解如何运行测试例和添加新的测试例。

成为社区贡献者

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

加入技术交流群

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

谁在使用TDengine

欢迎所有TDengine用户及贡献者在这里下分享您在当前工作中开发/使用TDengine的故事。