TDengine 命令行(CLI)

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

安装

运行 TDengine CLI 来访问 TDengine Cloud ，请首先下载和安装最新的 TDengine 客户端安装包。

配置

在Linux上面配置

在您的 Linux 终端里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：

export TDENGINE_CLOUD_DSN="<DSN>"

Config on Windows (beta)

在您的 Windows CMD 里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：

set TDENGINE_CLOUD_DSN=<DSN>

或者在您的 Windows PowerShell 里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：

$env:TDENGINE_CLOUD_DSN='<DSN>'

Config on Mac (beta)

在您的 Mac 里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：

export TDENGINE_CLOUD_DSN="<DSN>"

非常重要

获取真实的 DSN 的值，请登录TDengine Cloud 后点击左边的”工具“菜单，然后选择”TDengine CLI“。

建立连接

在 Linux 上面建立连接

如果您已经设置了环境变量，您只需要立即执行 taos 命令就可以访问 TDengine Cloud 实例。

taos

如果您没有设置 TDengine Cloud 实例的环境变量，或者您想访问其他 TDengine Cloud 实例，您可以使用下面的命令 taos -E <DSN>来执行：

taos -E $TDENGINE_CLOUD_DSN

在 Windows 上面建立连接 (测试版本)

如果您已经设置了环境变量，您只需要立即执行 taos 命令就可以访问 TDengine Cloud 实例。

taos.exe

如果您没有设置 TDengine Cloud 实例的环境变量，或者您想访问其他 TDengine Cloud 实例，您可以使用下面的命令 taos -E <DSN>来执行：

taos.exe -E %TDENGINE_CLOUD_DSN%

在 Mac 上面建立连接 (测试版本)

如果您已经设置了环境变量，您只需要立即执行 taos 命令就可以访问 TDengine Cloud 实例。

taos

如果您没有设置 TDengine Cloud 实例的环境变量，或者您想访问其他 TDengine Cloud 实例，您可以使用下面的命令 taos -E <DSN>来执行：

taos -E $TDENGINE_CLOUD_DSN

使用 TDengine CLI

如果成功连接上 TDengine 服务，TDengine CLI 会显示一个欢迎的消息和版本信息。如果失败了，TDengine CLI 会打印失败消息。TDengine CLI 打印的成功消息如下：

Welcome to the TDengine shell from Linux, Client Version:3.0.0.0
Copyright (c) 2022 by TAOS Data, Inc. All rights reserved.

Successfully connect to cloud.tdengine.com:8085 in restful mode

taos>

进入 TDengine CLI 以后，您就可以执行大量的 SQL 命令来进行插入，查询或者进行管理。详情请参考官方文档。