立即開始
快捷安裝
TDengine 包括服務(wù)端、客戶端和周邊生態(tài)工具軟件,目前 2.0 版服務(wù)端僅在 Linux 系統(tǒng)上安裝和運(yùn)行,后續(xù)將支持 Windows、macOS 等系統(tǒng)??蛻舳丝梢栽?Windows 或 Linux 上安裝和運(yùn)行。在任何操作系統(tǒng)上的應(yīng)用都可以使用 RESTful 接口連接服務(wù)端程序 taosd,其中 2.4 之后版本默認(rèn)使用單獨(dú)運(yùn)行的獨(dú)立組件 taosAdapter 提供 http 服務(wù)和更多數(shù)據(jù)寫入方式。taosAdapter 需要手動(dòng)啟動(dòng)。 之前版本 TDengine 服務(wù)端,以及所有服務(wù)端lite版,均使用內(nèi)置 http 服務(wù)。
TDengine 支持 X64/ARM64/MIPS64/Alpha64 硬件平臺(tái),后續(xù)將支持 ARM32、RISC-V 等 CPU 架構(gòu)。
通過 Docker 容器安裝
docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp tdengine/tdengine
詳細(xì)操作方法請參照 通過 Docker 快速體驗(yàn) TDengine。
注:暫時(shí)不建議生產(chǎn)環(huán)境采用 Docker 來部署 TDengine 的客戶端或服務(wù)端,但在開發(fā)環(huán)境下或初次嘗試時(shí),使用 Docker 方式部署是十分方便的。特別是,利用 Docker,可以方便地在 macOS 和 Windows 環(huán)境下嘗試 TDengine。
從 2.4.0.10 開始,除 taosd 以外,Docker 鏡像還包含:taos、taosAdapter、taosdump、taosBenchmark、TDinsight 安裝腳本和示例代碼。啟動(dòng) Docker 容器時(shí),將同時(shí)啟動(dòng) taosAdapter 和 taosd,實(shí)現(xiàn)對 RESTful 的支持。
通過安裝包安裝
TDengine 的安裝非常簡單,從下載到安裝成功僅僅只要幾秒鐘。
為方便使用,從 2.4.0.10 開始,標(biāo)準(zhǔn)的服務(wù)端安裝包包含了 taos、taosd、taosAdapter、taosdump、taosBenchmark、TDinsight 安裝腳本和示例代碼;如果您只需要用到服務(wù)端程序和客戶端連接的 C/C++ 語言支持,也可以僅下載 lite 版本的安裝包。
在安裝包格式上,我們提供 tar.gz, rpm 和 deb 格式,為企業(yè)客戶提供 tar.gz 格式安裝包,以方便在特定操作系統(tǒng)上使用。需要注意的是,rpm 和 deb 包不含 taosdump、taosBenchmark 和 TDinsight 安裝腳本,這些工具需要通過安裝 taosTool 包獲得。
發(fā)布版本包括穩(wěn)定版和 Beta 版,Beta 版含有更多新功能。正式上線或測試建議安裝穩(wěn)定版。您可以根據(jù)需要選擇下載:
具體的安裝方法,請參見 TDengine 多種安裝包的安裝和卸載 以及 視頻教程。
下載其他組件、最新 Beta 版及之前版本的安裝包,請點(diǎn)擊 這里
請點(diǎn)擊 這里 查看 Release Notes。
使用 apt-get 安裝
如果使用 Debian 或 Ubuntu 系統(tǒng),也可以使用 apt-get 工具從官方倉庫安裝,設(shè)置方法為:
wget -qO - http://repos.taosdata.com/tdengine.key | sudo apt-key add -
echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-stable stable main" | sudo tee /etc/apt/sources.list.d/tdengine-stable.list
[ 如果安裝 Beta 版需要安裝包倉庫 ] echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-beta beta main" | sudo tee /etc/apt/sources.list.d/tdengine-beta.list
sudo apt-get update
apt-cache policy tdengine
sudo apt-get install tdengine
僅安裝客戶端
如果客戶端和服務(wù)端運(yùn)行在不同的電腦上,可以單獨(dú)安裝客戶端。下載時(shí)請注意,所選擇的客戶端版本號(hào)應(yīng)該和在上面下載的服務(wù)端版本號(hào)嚴(yán)格匹配。Linux 和 Windows 安裝包如下(其中 lite 版本的安裝包僅帶有 C/C++ 語言的連接支持,而標(biāo)準(zhǔn)版本的安裝包還包含和示例代碼):
通過源碼安裝
如果您希望對 TDengine 貢獻(xiàn)代碼或?qū)?nèi)部實(shí)現(xiàn)感興趣,請參考我們的 TDengine GitHub 主頁 下載源碼構(gòu)建和安裝.
輕松啟動(dòng)
安裝成功后,用戶可使用 systemctl 命令來啟動(dòng) TDengine 的服務(wù)進(jìn)程。
systemctl start taosd
檢查服務(wù)是否正常工作:
systemctl status taosd
如果 TDengine 服務(wù)正常工作,那么您可以通過 TDengine 的命令行程序 taos 來訪問并體驗(yàn) TDengine。
注意:
- systemctl 命令需要 root 權(quán)限來運(yùn)行,如果您非 root 用戶,請?jiān)诿钋疤砑?sudo 。
- 為更好的獲得產(chǎn)品反饋,改善產(chǎn)品,TDengine 會(huì)采集基本的使用信息,但您可以修改系統(tǒng)配置文件 taos.cfg 里的配置參數(shù) telemetryReporting,將其設(shè)為 0,就可將其關(guān)閉。
- TDengine 采用 FQDN(一般就是 hostname)作為節(jié)點(diǎn)的 ID,為保證正常運(yùn)行,需要給運(yùn)行 taosd 的服務(wù)器配置好 hostname,在客戶端應(yīng)用運(yùn)行的機(jī)器配置好 DNS 服務(wù)或 hosts 文件,保證 FQDN 能夠解析。
systemctl stop taosd指令在執(zhí)行后并不會(huì)馬上停止 TDengine 服務(wù),而是會(huì)等待系統(tǒng)中必要的落盤工作正常完成。在數(shù)據(jù)量很大的情況下,這可能會(huì)消耗較長時(shí)間。
TDengine 支持在使用 systemd 做進(jìn)程服務(wù)管理的 Linux 系統(tǒng)上安裝,用 which systemctl 命令來檢測系統(tǒng)中是否存在 systemd 包:
which systemctl
如果系統(tǒng)中不支持 systemd,也可以用手動(dòng)運(yùn)行 /usr/local/taos/bin/taosd 方式啟動(dòng) TDengine 服務(wù)。
使用 TDengine 客戶端程序
執(zhí)行 TDengine 客戶端程序,您只要在 Linux 終端執(zhí)行 taos 即可。
taos
如果連接服務(wù)成功,將會(huì)打印出歡迎消息和版本信息。如果失敗,則會(huì)打印錯(cuò)誤消息出來(請參考 FAQ 來解決終端連接服務(wù)端失敗的問題)。客戶端的提示符號(hào)如下:
taos>
在 TDengine 客戶端中,用戶可以通過 SQL 命令來創(chuàng)建/刪除數(shù)據(jù)庫、表等,并進(jìn)行插入查詢操作。在終端中運(yùn)行的 SQL 語句需要以分號(hào)結(jié)束來運(yùn)行。示例:
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 |
========================================
2019-07-15 00:00:00.000 | 10 |
2019-07-15 01:00:00.000 | 20 |
Query OK, 2 row(s) in set (0.003128s)
除執(zhí)行 SQL 語句外,系統(tǒng)管理員還可以從 TDengine 客戶端進(jìn)行檢查系統(tǒng)運(yùn)行狀態(tài)、添加刪除用戶賬號(hào)等操作。
命令行參數(shù)
您可通過配置命令行參數(shù)來改變 TDengine 客戶端的行為。以下為常用的幾個(gè)命令行參數(shù):
- -c, --config-dir: 指定配置文件目錄,默認(rèn)為
/etc/taos - -h, --host: 指定服務(wù)的 FQDN 地址或 IP 地址,默認(rèn)為連接本地服務(wù)
- -s, --commands: 在不進(jìn)入終端的情況下運(yùn)行 TDengine 命令
- -u, --user: 連接 TDengine 服務(wù)端的用戶名,缺省為 root
- -p, --password: 連接 TDengine 服務(wù)端的密碼,缺省為 taosdata
- -?, --help: 打印出所有命令行參數(shù)
示例:
taos -h h1.taos.com -s "USE db; SHOW TABLES;"
運(yùn)行 SQL 命令腳本
TDengine 終端可以通過 SOURCE 命令來運(yùn)行 SQL 命令腳本。
taos> SOURCE <filename>;
taos shell 小技巧
- 可以使用上下光標(biāo)鍵查看歷史輸入的指令
- 修改用戶密碼:在 shell 中使用
ALTER USER命令,缺省密碼為 taosdata - Ctrl+C 中止正在進(jìn)行中的查詢
- 執(zhí)行
RESET QUERY CACHE可清除本地緩存的表 schema - 批量執(zhí)行 SQL 語句??梢詫⒁幌盗械?shell 命令(以英文 ; 結(jié)尾,每個(gè) SQL 語句為一行)按行存放在文件里,在 shell 里執(zhí)行命令
SOURCE <file-name>自動(dòng)執(zhí)行該文件里所有的 SQL 語句 - 輸入 q 回車,退出 taos shell
TDengine 極速體驗(yàn)
使用 taosBenchmark 體驗(yàn)寫入速度
啟動(dòng) TDengine 的服務(wù),在 Linux 終端執(zhí)行 taosBenchmark (曾命名為 taosdemo)。taosBenchmark 在 TDengine 2.4.0.7 和之前發(fā)布版本在 taosTools 安裝包中發(fā)布提供,在后續(xù)版本中 taosBenchmark 將在 TDengine 標(biāo)準(zhǔn)安裝包中發(fā)布。
taosBenchmark
該命令將在數(shù)據(jù)庫 test 下面自動(dòng)創(chuàng)建一張超級表 meters,該超級表下有 1 萬張表,表名為 "d0" 到 "d9999",每張表有 1 萬條記錄,每條記錄有 (ts, current, voltage, phase) 四個(gè)字段,時(shí)間戳從 "2017-07-14 10:40:00 000" 到 "2017-07-14 10:40:09 999",每張表帶有標(biāo)簽 location 和 groupId,groupId 被設(shè)置為 1 到 10, location 被設(shè)置為 "beijing" 或者 "shanghai"。
這條命令很快完成 1 億條記錄的插入。具體時(shí)間取決于硬件性能,即使在一臺(tái)普通的 PC 服務(wù)器往往也僅需十幾秒。
taosBenchmark 詳細(xì)功能列表
taosBenchmark 命令本身帶有很多選項(xiàng),配置表的數(shù)目、記錄條數(shù)等等,請執(zhí)行 taosBenchmark --help 詳細(xì)列出。您可以設(shè)置不同參數(shù)進(jìn)行體驗(yàn)。
taosBenchmark 詳細(xì)使用方法請參照 如何使用 taosBenchmark 進(jìn)行性能測試。
使用 taos shell 體驗(yàn)查詢速度
在 TDengine 客戶端輸入查詢命令,體驗(yàn)查詢速度。
- 查詢超級表下記錄總條數(shù):
taos> SELECT COUNT(*) FROM test.meters;
- 查詢 1 億條記錄的平均值、最大值、最小值等:
taos> SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters;
- 查詢 location="beijing" 的記錄總條數(shù):
taos> SELECT COUNT(*) FROM test.meters WHERE location="beijing";
- 查詢 groupId=10 的所有記錄的平均值、最大值、最小值等:
taos> SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.meters WHERE groupId=10;
- 對表 d10 按 10s 進(jìn)行平均值、最大值和最小值聚合統(tǒng)計(jì):
taos> SELECT AVG(current), MAX(voltage), MIN(phase) FROM test.d10 INTERVAL(10s);
支持平臺(tái)列表
TDengine 服務(wù)端支持的平臺(tái)列表
| CentOS 7/8 | Ubuntu 16/18/20 | Other Linux | 統(tǒng)信 UOS | 銀河/中標(biāo)麒麟 | 凝思 V60/V80 | 華為 EulerOS | |
|---|---|---|---|---|---|---|---|
| X64 | ● | ● | ○ | ● | ● | ● | |
| 龍芯 MIPS64 | ● | ||||||
| 鯤鵬 ARM64 | ○ | ○ | ● | ||||
| 申威 Alpha64 | ○ | ● | |||||
| 飛騰 ARM64 | ○ 優(yōu)麒麟 | ||||||
| 海光 X64 | ● | ● | ● | ○ | ● | ● | |
| 瑞芯微 ARM64 | ○ | ||||||
| 全志 ARM64 | ○ | ||||||
| 炬力 ARM64 | ○ | ||||||
| 華為云 ARM64 | ● |
注: ● 表示經(jīng)過官方測試驗(yàn)證, ○ 表示非官方測試驗(yàn)證。
TDengine 客戶端和連接器支持的平臺(tái)列表
目前 TDengine 的連接器可支持的平臺(tái)廣泛,目前包括:X64/X86/ARM64/ARM32/MIPS/Alpha 等硬件平臺(tái),以及 Linux/Win64/Win32 等開發(fā)環(huán)境。
對照矩陣如下:
| CPU | X64 64bit | X86 32bit | ARM64 | ARM32 | MIPS 龍芯 | Alpha 申威 | X64 海光 | ||
|---|---|---|---|---|---|---|---|---|---|
| OS | Linux | Win64 | Win32 | Win32 | Linux | Linux | Linux | Linux | Linux |
| C/C++ | ● | ● | ● | ○ | ● | ● | ● | ● | ● |
| JDBC | ● | ● | ● | ○ | ● | ● | ● | ● | ● |
| Python | ● | ● | ● | ○ | ● | ● | ● | -- | ● |
| Go | ● | ● | ● | ○ | ● | ● | ○ | -- | -- |
| Node.js | ● | ● | ○ | ○ | ● | ● | ○ | -- | -- |
| C# | ● | ● | ○ | ○ | ○ | ○ | ○ | -- | -- |
| RESTful | ● | ● | ● | ● | ● | ● | ● | ● | ● |
注:● 表示官方測試驗(yàn)證通過,○ 表示非官方測試驗(yàn)證通過,-- 表示未經(jīng)驗(yàn)證。
請?zhí)D(zhuǎn)到 連接器 查看更詳細(xì)的信息。

