文档

TDengine文档 - 《TDengine v2.0 数据库文档》 - 书栈网 · BookStack

说明

  • TDengine是一款国产的开源物联网时序型数据库

  • 端口： 6041

    1
    2
    3
    4
    5
    6
    7
    8
    warehouse:
      store:
        td-engine:
          enabled: true
          driver-class-name: com.taosdata.jdbc.rs.RestfulDriver
          url: jdbc:TAOS-RS://localhost:6041/hertzbeat
          username: root
          password: taosdata

Docker方式安装TDengine

可参考官方网站安装教程

  • Docker环境

    1
    2
    $ docker -v
    Docker version 20.10.12, build e91ed57

  • Docker安装TDengine

    1
    2
    3
    4
    $ docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp --name tdengine tdengine/tdengine:2.4.0.12

    # -v /opt/taosdata:/var/lib/taos 为tdengine数据目录本地持久化挂载，需将/opt/taosdata替换为实际本地存在的目录
    $ docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp -v /opt/taosdata:/var/lib/taos --name tdengine tdengine/tdengine:2.4.0.12

  • 查看数据库是否启动成功

    1
    docker ps

创建数据库实例

  1. 进入数据库Docker容器

    1
    2
    $ docker exec -it tdengine /bin/bash
    root@tdengine-server:~/TDengine-server-2.4.0.4#

  2. 进入容器后，执行 taos shell 客户端程序

    1
    2
    3
    4
    root@tdengine-server:~/TDengine-server-2.4.0.4# taos
    Welcome to the TDengine shell from Linux, Client Version:2.4.0.4
    Copyright (c) 2020 by TAOS Data, Inc. All rights reserved.
    taos>

    执行创建数据库命令

    1
    2
    3
    taos> show databases;
    taos> CREATE DATABASE hertzbeat KEEP 90 DAYS 10 BLOCKS 6 UPDATE 1;  #创建名称为 hertzbeat 的数据库
    # 上述语句将创建一个名为 hertzbeat 的库，这个库的数据将保留90天（超过90天将被自动删除），每 10 天一个数据文件，内存块数为 6，允许更新数据

  3. 查看hertzbeat数据库是否成功创建

    1
    2
    taos> show databases;
    taos> use hertzbeat;

  4. root 用户的默认密码为 taosdata 修改密码如下：

    1
    alter user root pass 123456;

  5. 连接数据库

    1
    taos -uroot -p123456;

注意⚠️若是【安装包】安装的TDengine2.3+版本

除了启动server外，还需执行 systemctl start taosadapter 启动 adapter

用户管理

系统管理员可以在CLI界面里添加、删除用户，也可以修改密码。CLI里SQL语法如下：

1
CREATE USER <user_name> PASS <'password'>;

创建用户，并指定用户名和密码，密码需要用单引号引起来，单引号为英文半角

1
DROP USER <user_name>;

删除用户，限root用户使用

1
ALTER USER <user_name> PASS <'password'>;

修改用户密码，为避免被转换为小写，密码需要用单引号引用，单引号为英文半角

1
ALTER USER <user_name> PRIVILEGE <write|read>;

修改用户权限为：write 或 read，不需要添加单引号

说明：系统内共有 super/write/read 三种权限级别，但目前不允许通过 alter 指令把 super 权限赋予用户。

1
2
# 显示所有用户
SHOW USERS;