通过云服务快速体验 TDengine

这篇文档面向第一次使用 TDengine Cloud 的用户，目标是：不安装任何服务端组件、按步骤操作即可在 10~20 分钟内完成一次"创建实例 → 连接 → 建表写数 → 查询验证"的闭环。

连接 TDengine Cloud 必须使用 WebSocket 连接（不能用原生连接/6030 端口直连）。

新用户注册

要在 TDengine Cloud 注册新用户，请遵循以下简易步骤完成注册流程：

打开浏览器，访问 TDengine Cloud，在右边的"注册"部分，填入自己的姓名以及企业邮箱地址，点击"获取验证码"按钮。
检查企业邮箱，找到主题为"你的 TDengine Cloud 注册账户验证码"的邮件。从邮件内容中复制 6 位验证码，并将其粘贴到注册页面上的"验证码"输入框中。接着，点击"注册 TDengine Cloud"按钮，进入客户信息补全页面。
在客户信息补全页面的"手机号"输入框中输入有效的手机号码，并点击"验证"按钮完成验证。验证通过后，设置一个符合要求的密码，然后点击"继续"按钮，将进入"创建实例"部分。

创建实例

要在 TDengine Cloud 中创建 TDengine 实例，只需遵循以下 3 个步骤：

选择公共数据库。在此步骤中，TDengine Cloud 提供了可供公共访问的智能电表等数据库。通过浏览和查询这些数据库，你可以立即体验 TDengine 的各种功能和高性能。你可以根据需求在此步骤启动数据库访问，或在后续使用过程中再进行启动。若不需要此步骤，可直接点击"下一步"按钮跳过。
创建组织。在此步骤中，请输入一个具有意义的名称，代表你的公司或组织，这将有助于你和平台更好地管理云上资源。
创建实例。在此步骤中，你需要填写实例的区域、名称、是否选择高可用选项以及计费方案等必填信息。确认无误后，点击"创建"按钮。大约等待 1min，新的 TDengine 实例便会创建完成。随后，你可以在控制台中对该实例进行各种操作，如查询数据、创建订阅、创建流等。

注册后通常会获得一定的免费额度用于体验。如果你觉得现有计费方案无法满足需求，可联系 TDengine Cloud 客户支持。

获取连接参数（URL + Token）

实例创建完成后，进入该实例的详情页/连接信息页（不同版本控制台入口命名可能略有不同），你会看到一组用于客户端连接的参数。快速体验只需要记住以下两项：

WebSocket URL ：一个以 http:// 或 https:// 开头的地址（示例：https://gw.cloud.taosdata.com?token=your_token）。
Cloud Token：用于云服务认证的令牌。

:::caution 安全提示

Token 等同于账号凭证的一部分，不要把真实 Token 粘贴到工单、截图、代码仓库或聊天群里。

:::

方式一（推荐）：控制台内一次成功体验（零安装）

如果你只是想"马上跑通一次"，最稳的方式是在 TDengine Cloud 控制台中直接执行 SQL（无需配置本地网络、证书、驱动）。

打开实例的"SQL 工作台 / 查询 / 控制台"（入口名称以实际界面为准）。
执行下面这组 SQL（可整段复制，逐条执行）：

sql 复制代码

-- 1) 创建一个用于体验的数据库
create database if not exists quickstart;

-- 2) 创建超级表（带标签）
create stable if not exists quickstart.meters (
	ts timestamp,
	current float,
	voltage int
) tags (
	location binary(64)
);

-- 3) 创建子表并写入几条数据
create table if not exists quickstart.d1001 using quickstart.meters tags('shanghai');
insert into quickstart.d1001 values (now, 10.3, 220);
insert into quickstart.d1001 values (now + 1s, 10.4, 221);

-- 4) 查询验证
select * from quickstart.d1001 order by ts desc limit 5;
select location, avg(current) from quickstart.meters group by location;

看到查询结果就代表：实例可用、权限没问题、SQL 跑通。

方式二：在本地/工具中连接（WebSocket，带 Token）

当你希望在本地代码、BI 工具或数据库管理工具里连接云服务时，按参数文档的约束：连接 TDengine Cloud 必须使用 WebSocket 连接。

下面给出两条"最不容易踩坑"的做法：

2.1 直接使用控制台提供的连接串（最稳）

不同连接器对参数名会有差异（例如 token、bearerToken、useSSL 等），因此优先建议：在 TDengine Cloud 控制台里复制"编程/连接信息"页面给出的完整连接串（JDBC URL / DSN / URL），原样粘贴到你的工具里。

2.2 使用 taos 命令行通过 Cloud DSN 连接（推荐用于脚本）

taos 客户端同样支持通过 WebSocket DSN 连接云服务：

-E DSN（短参数）
--cloud-dsn=DSN（长参数）

最稳的做法是：在 TDengine Cloud 控制台的"编程/连接信息"里复制 taos CLI / Cloud DSN（或 WebSocket DSN）字段的完整内容，然后直接粘贴到命令行。

bash 复制代码

# 交互式进入 taos CLI（推荐把 DSN 用引号包起来，避免 ? & 等字符被 shell 误解析）
taos --cloud-dsn "<cloud_dsn_from_console>"
# 或者
taos -E "<cloud_dsn_from_console>"

也可以配合 -s 以"非交互"方式执行 SQL（便于一次体验成功/写脚本）：

bash 复制代码

taos --cloud-dsn "<cloud_dsn_from_console>" -s "select server_version();"
taos --cloud-dsn "<cloud_dsn_from_console>" -s "create database if not exists quickstart;"

:::tip 小贴士

如果你之前习惯用 taos -h <host> -P 6030 直连，这是原生连接 方式；连接云服务请改用 -E/--cloud-dsn（WebSocket DSN）。

:::

2.3 参考参数文档手动拼接（可脚本化）

以下示例用于理解关键参数含义；实际以你控制台中显示的 Host、端口、Token 为准。

ODBC（Windows 工具链常用，WebSocket URL 示例）

URL 示例：https://gw.cloud.taosdata.com?token=your_token

说明：该 URL 里通过查询参数携带云服务 token，用于认证；连接类型选择 WebSocket。

JDBC（Java，WebSocket 连接 + Bearer Token）

JDBC URL 形如：

text 复制代码

jdbc:TAOS-WS://<host>:<port>/<db>?useSSL=true&bearerToken=<your_token>

要点：

使用 jdbc:TAOS-WS://（WebSocket 驱动）。
bearerToken 的认证优先级高于用户名密码。
useSSL=true 通常用于云服务（若控制台给的是 https/wss）。

常见坑与快速排查

连接不上 / 超时

确认连接方式 ：云服务只支持 WebSocket 连接；不要用原生连接（6030）直连。需要用 taos 客户端时，请使用 -E/--cloud-dsn。
确认网络：公司网络/代理有时会拦截 WebSocket；可换网络（手机热点）或让网络侧放行 WebSocket/HTTPS。

认证失败（401/无权限）

Token 过期/复制不完整：重新在控制台生成/复制。
把 token 当成 password 用 ：大多数云连接应把 token 放在连接串参数（如 token/bearerToken）里，而不是用户名密码。

SQL 报"找不到表/找不到数据库"

在很多无状态/跨连接的场景下，不要依赖 use db ；建议在 SQL 中写全限定名，如 quickstart.d1001、quickstart.meters。

SSL 相关报错

优先使用控制台复制的 URL/连接串；如果工具提供 useSSL 或证书校验开关，按参数文档说明配置。

关于 TDengine

TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。

通过云服务 快速体验 TDengine