3.6 KiB
| title | sidebar_label | description |
|---|---|---|
| TDengine 命令行 (CLI) | TDengine CLI | TDengine CLI 的使用说明和技巧 |
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
TDengine 命令行程序（以下简称 TDengine CLI）是用户操作 TDengine 实例并与之交互的最简洁最常用的方式。
安装
运行 TDengine CLI 来访问 TDengine Cloud，请首先下载和安装最新的 TDengine 客户端安装包。
配置
在您的 Linux 终端里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：
export TDENGINE_CLOUD_DSN="<DSN>"
在您的 Windows CMD 里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：
set TDENGINE_CLOUD_DSN=<DSN>
或者在您的 Windows PowerShell 里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：
$env:TDENGINE_CLOUD_DSN='<DSN>'
在您的 Mac 里面执行下面的命令设置 TDengine Cloud 的 DSN 为环境变量：
export TDENGINE_CLOUD_DSN="<DSN>"
:::note 非常重要
获取真实的 DSN 的值，请登录TDengine Cloud 后点击左边的”工具“菜单，然后选择”TDengine CLI“。
:::
建立连接
如果您已经设置了环境变量，您只需要立即执行 taos 命令就可以访问 TDengine Cloud 实例。
taos
如果您没有设置 TDengine Cloud 实例的环境变量，或者您想访问其他 TDengine Cloud 实例，您可以使用下面的命令 taos -E <DSN>来执行：
taos -E $TDENGINE_CLOUD_DSN
如果您已经设置了环境变量，您只需要立即执行 taos 命令就可以访问 TDengine Cloud 实例。
taos.exe
如果您没有设置 TDengine Cloud 实例的环境变量，或者您想访问其他 TDengine Cloud 实例，您可以使用下面的命令 taos -E <DSN>来执行：
taos.exe -E %TDENGINE_CLOUD_DSN%
如果您已经设置了环境变量，您只需要立即执行 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 命令来进行插入，查询或者进行管理。详情请参考官方文档。