一、场景介绍
无论你是数据分析师、数据工程师还是数据科学家，第一次进入 DataBuddy 的体验都应该是平滑的：登录、进入 Studio、写一行 SQL、看到结果。本教程把这个最小路径走通，为后续的角色化教程（数据工程师、数据分析师、数据治理、运维）提供一致的起点。
二、前提条件
·拥有一个 腾讯云账号 ，并已开通 DataBuddy 服务。
·当前账号在某个工作空间中至少拥有 空间成员 及以上角色（无权限时可联系工作空间管理员添加，详情请参见 成员与权限管理）。
·当前工作空间已绑定一个可用的 交互式集群 或 作业集群 （如工作空间还未绑定，请管理员参考 创建计算资源）。
注意：如果你是工作空间管理员，本教程同时验证了“账号、工作空间、计算资源”三件套是否就绪，可作为工作空间初始化完成的烟雾测试。
三、步骤 1：进入 DataBuddy 控制台
1. 浏览器访问 DataBuddy 工作台入口，使用腾讯云账号登录后将直接进入 DataBuddy 工作台。
2. 选择目标工作空间，单击进入工作空间 。
四、步骤 2：进入 Studio
1. 在左侧导航栏中打开 开发工作台 ，进入目标 studio。
2. 在页面右上侧单击 +创建 ，创建一个新的文件夹，用于存储后续的文件，命名为 <你的英文名>_quickstart（如 alice_quickstart）。
五、步骤 3：创建 SQL 文件
1. 进入该文件夹，在右上角单击 +创建 ，选择 新建 SQL ，命名为 hello.sql。
2. 双击 hello.sql 在编辑器中打开。
六、步骤 4：完成执行配置
SQL 编辑器顶部工具栏的 3 个下拉是运行前必填项：
| 字段 | 取值 |
| 默认 Catalog | 选择目标 Catalog（默认会带出你工作空间绑定的 Catalog） |
| 默认 Schema | 在所选 Catalog 下选择一个可用的 Schema |
| 计算资源 | 选择一个运行中的计算资源（如 default-spark-engine） |
注意：三项任一未配置都无法运行 SQL。如果下拉为空，说明工作空间尚未绑定计算资源，请联系空间管理员。
七、步骤 5：写第一条 SQL 并运行
1. 在编辑器中输入以下内容：
— 验证连通性SELECT 1 AS hello, current_timestamp() AS now;
1. 按 Ctrl + Enter（Mac 用户为 ⌘ + Enter），或单击工具栏 运行 按钮。
页面下方会出现执行进度，几秒后切换到 结果 标签页，看到一行返回值：
| hello | now |
| 1 | 2026-06-10 16:05:00 |
恭喜，你的第一条 SQL 已经在计算引擎中执行完成。
八、步骤 6：理解结果面板
底部面板包含三个标签页：
| 标签页 | 用途 |
| 结果 | 表格式呈现查询结果，支持搜索、排序、列锁定、字段设置、复制、下载 |
| 日志 | 完整的执行日志，便于定位失败原因，支持关键字搜索和下载 |
| 代码 | 实际提交给引擎的 SQL（参数已展开）、查询 ID、运行时长、扫描行数等元数据，便于排查参数问题 |
九、验证结果
完成全部步骤后，你应该能看到：
·左侧文件树中存在 <英文名>_quickstart/hello.sql 文件。
·编辑器顶部 默认 Catalog、默认 Schema、计算资源 已配置完成。
·结果 标签页有 1 行返回值。
·日志 标签页能看到 SQL 提交、执行、完成三个阶段的日志。
十、执行 SQL 时提示“计算资源未绑定到工作空间”？
当前工作空间没有绑定计算资源。请联系工作空间管理员在创建计算资源中绑定一个交互式集群，再重新进入 Studio。
十一、进入 Studio 一直卡在“启动中”？
等待 2-3 分钟。如仍未启动，刷新页面重新进入。如果问题持续，可能是个人环境配额用尽，联系空间管理员协助。
十二、SQL 执行没有数据源、引擎可选？
表示当前账号在工作空间中权限不足，或工作空间未绑定任何计算资源。请检查你的角色（请参考成员与权限管理）。
十三、总结
在本教程中，你完成了：
·登录腾讯云并进入 DataBuddy 工作空间。
·启动 Studio 个人运行环境。
·创建 SQL 文件、配置执行环境、运行第一条 SQL。
·理解了结果、日志、代码信息 三个面板的用途。