这篇文档面向第一次使用 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?tokenyour_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(now1s,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-dsnDSN长参数最稳的做法是在 TDengine Cloud 控制台的“编程/连接信息”里复制taos CLI / Cloud DSN或 WebSocket DSN字段的完整内容然后直接粘贴到命令行。# 交互式进入 taos CLI推荐把 DSN 用引号包起来避免 ? 等字符被 shell 误解析taos --cloud-dsncloud_dsn_from_console# 或者taos -Ecloud_dsn_from_console也可以配合-s以“非交互”方式执行 SQL便于一次体验成功/写脚本taos --cloud-dsncloud_dsn_from_console-sselect server_version();taos --cloud-dsncloud_dsn_from_console-screate database if not exists quickstart;:::tip 小贴士如果你之前习惯用taos -h host -P 6030直连这是原生连接方式连接云服务请改用-E/--cloud-dsnWebSocket DSN。:::2.3 参考参数文档手动拼接可脚本化以下示例用于理解关键参数含义实际以你控制台中显示的 Host、端口、Token 为准。ODBCWindows 工具链常用WebSocket URL 示例URL 示例https://gw.cloud.taosdata.com?tokenyour_token说明该 URL 里通过查询参数携带云服务 token用于认证连接类型选择 WebSocket。JDBCJavaWebSocket 连接 Bearer TokenJDBC URL 形如jdbc:TAOS-WS://host:port/db?useSSLtruebearerTokenyour_token要点使用jdbc:TAOS-WS://WebSocket 驱动。bearerToken的认证优先级高于用户名密码。useSSLtrue通常用于云服务若控制台给的是 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或证书校验开关按参数文档说明配置。关于TDengineTDengine 专为物联网IoT平台、工业大数据平台设计。其中TDengine TSDB 是一款高性能、分布式的时序数据库Time Series Database同时它还带有内建的缓存、流式计算、数据订阅等系统功能TDengine IDMP 是一款AI原生工业数据管理平台它通过树状层次结构建立数据目录对数据进行标准化、情景化并通过 AI 提供实时分析、可视化、事件管理与报警等功能。