TDengine 命令行(CLI)

TDengine 命令行程序(以下简称 TDengine CLI)是用户操作 TDengine 实例并与之交互的最简洁最常用的方式。

安装

如果在 TDengine 服务器端执行,无需任何安装,已经自动安装好 TDengine CLI。如果要在非 TDengine 服务器端运行,需要安装 TDengine 客户端驱动安装包,具体安装,请参考 连接器

执行

要进入 TDengine CLI,您只要在终端执行 taos 即可。

  1. taos

如果连接服务成功,将会打印出欢迎消息和版本信息。如果失败,则会打印错误消息。(请参考 FAQ 来解决终端连接服务端失败的问题)。TDengine CLI 的提示符号如下:

  1. taos>

进入 TDengine CLI 后,你可执行各种 SQL 语句,包括插入、查询以及各种管理命令。

执行 SQL 脚本

在 TDengine CLI 里可以通过 source 命令来运行脚本文件中的多条 SQL 命令。

  1. taos> source <filename>;

在线修改显示字符宽度

可以在 TDengine CLI 里使用如下命令调整字符显示宽度

  1. taos> SET MAX_BINARY_DISPLAY_WIDTH <nn>;

如显示的内容后面以 … 结尾时,表示该内容已被截断,可通过本命令修改显示字符宽度以显示完整的内容。

命令行参数

您可通过配置命令行参数来改变 TDengine CLI 的行为。以下为常用的几个命令行参数:

  • -h HOST: 要连接的 TDengine 服务端所在服务器的 FQDN, 默认为连接本地服务
  • -P PORT: 指定服务端所用端口号
  • -u USER: 连接时使用的用户名
  • -p PASSWORD: 连接服务端时使用的密码
  • -?, —help: 打印出所有命令行参数

还有更多其他参数:

  • -a AUTHSTR: 连接服务端的授权信息
  • -A: 通过用户名和密码计算授权信息
  • -c CONFIGDIR: 指定配置文件目录,Linux 环境下默认为 /etc/taos,该目录下的配置文件默认名称为 taos.cfg
  • -C: 打印 -c 指定的目录中 taos.cfg 的配置参数
  • -d DATABASE: 指定连接到服务端时使用的数据库
  • -f FILE: 以非交互模式执行 SQL 脚本文件。文件中一个 SQL 语句只能占一行
  • -k: 测试服务端运行状态,0: unavailable,1: network ok,2: service ok,3: service degraded,4: exiting
  • -l PKTLEN: 网络测试时使用的测试包大小
  • -n NETROLE: 网络连接测试时的测试范围,默认为 client, 可选值为 clientserver
  • -N PKTNUM: 网络测试时使用的测试包数量
  • -r: 将时间输出出无符号 64 位整数类型(即 C 语音中 uint64_t)
  • -s COMMAND: 以非交互模式执行的 SQL 命令
  • -t: 测试服务端启动状态,状态同-k
  • -w DISPLAYWIDTH: 客户端列显示宽度
  • -z TIMEZONE: 指定时区,默认为本地时区
  • -V: 打印出当前版本号

示例:

  1. taos -h h1.taos.com -s "use db; show tables;"

TDengine CLI 小技巧

  • 可以使用上下光标键查看历史输入的指令
  • 在 TDengine CLI 中使用 alter user 命令可以修改用户密码,缺省密码为 taosdata
  • Ctrl+C 中止正在进行中的查询
  • 执行 RESET QUERY CACHE 可清除本地表 Schema 的缓存
  • 批量执行 SQL 语句。可以将一系列的 TDengine CLI 命令(以英文 ; 结尾,每个 SQL 语句为一行)按行存放在文件里,在 TDengine CLI 里执行命令 source <file-name> 自动执行该文件里所有的 SQL 语句
  • 输入 qquitexit 回车,可以退出 TDengine CLI