说明：
预计用时：5 分钟
学习目标：从零进入 DataBuddy，跑通一条 SQL 查询，建立对平台的最小可用心智。
本教程是 DataBuddy 的“开机第一课”。只需要满足下方前提条件，就能在 5 分钟内看到第一条 SQL 的运行结果。
场景介绍
无论您是数据分析师、数据工程师还是数据科学家，第一次进入 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;
2. 按
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 一直卡在“启动中”？
等待 2-3 分钟。如仍未启动，刷新页面重新进入。如果问题持续，可能是个人环境配额用尽，联系空间管理员协助。
SQL 执行没有数据源、引擎可选？
总结
在本教程中，您完成了：
登录腾讯云并进入 DataBuddy 工作空间。
启动 Studio 个人运行环境。
创建 SQL 文件、配置执行环境、运行第一条 SQL。
理解了结果、日志、代码信息 三个面板的用途。
