这篇文档面向第一次使用 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（可整段复制，逐条执行）：
-- 1) 创建一个用于体验的数据库createdatabaseifnotexistsquickstart;-- 2) 创建超级表（带标签）createstableifnotexistsquickstart.meters(tstimestamp,currentfloat,voltageint)tags(locationbinary(64));-- 3) 创建子表并写入几条数据createtableifnotexistsquickstart.d1001usingquickstart.meters tags('shanghai');insertintoquickstart.d1001values(now,10.3,220);insertintoquickstart.d1001values(now+1s,10.4,221);-- 4) 查询验证select*fromquickstart.d1001orderbytsdesclimit5;selectlocation,avg(current)fromquickstart.metersgroupbylocation;看到查询结果就代表：实例可用、权限没问题、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）字段的完整内容，然后直接粘贴到命令行。
# 交互式进入 taos CLI（推荐把 DSN 用引号包起来，避免 ? & 等字符被 shell 误解析）taos --cloud-dsn"<cloud_dsn_from_console>"# 或者taos -E"<cloud_dsn_from_console>"也可以配合-s以“非交互”方式执行 SQL（便于一次体验成功/写脚本）：
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 形如：
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 提供实时分析、可视化、事件管理与报警等功能。
