数据接入
一、入口
有两种方式可以开始接入数据：
1）数据集面板顶部：点击右侧"数据集"面板顶部的 「添加数据」 按钮，弹出「新建数据集」窗口，按分类选择数据源。
2）新建对话页：在左侧"今天想分析什么？"页面，下方 「连接新数据」 区域直接点击数据源图标快速接入。
二、数据源类型
「新建数据集」窗口按场景将数据源分为 4 大类、共 8 种：
1、文件与本地（2 种）
- 本地文件：上传 Excel / CSV，自动识别字段。
- 腾讯文档：授权后直接接入在线表格，适合团队协作文档。
2、数据库与数仓（4 种）
- MySQL：接入表查询上云数据库。
- StarRocks：高性能 OLAP 分析引擎。
- PgSQL：接入 PostgreSQL 表。
- ClickHouse：列式存储，实时 OLAP。
3、计算视图（1 种）
- SQL 视图：自定义 SQL 定义虚拟表，不落地，直接基于已有数据集出结果。
4、数据加工（1 种）
- 数据处理：对已有数据做清洗、关联、聚合，产出新表。
三、创建流程
1. 数据库类（MySQL / StarRocks / PgSQL / ClickHouse）
- 配置数据连接
- 已有连接：直接选用
- 新建连接：填写 Host / Port / 数据库名 / 用户名 / 密码 → 点击「测试连接」确认通过
- 选择数据表：支持多选，多选时自动进入批量模式
- 配置字段语义：为关键字段设置显示名、数据类型、业务意义（如"维度 / 指标 / 时间维度 / 用户ID"等）
- 确认创建：完成建表，可在数据集列表中看到结果
2. 本地文件
- 拖拽文件到上传区，或点击选择本地 Excel / CSV 文件
- 系统自动完成上传 → 识别字段 → 建表全流程，无需手动配置
3. 腾讯文档
- 点击「腾讯文档」后，按提示完成账号授权
- 选择要接入的在线表格，授权后即可作为数据集使用
4. 计算视图（SQL 视图）
- 编写 SQL 直接定义虚拟表
- 不生成物理表，结果在查询时实时计算
- 适合做轻量派生、口径固定的中间层
5. 数据加工（DataPrep）
对已有数据集做数据处理 / 转换，把散落在各处的数据像"搭积木"一样拼在一起，进行清洗、计算、合并，最后生成一张干净、好用的新数据表。
- 入口：数据集详情页 → 「数据处理」Tab
- 支持数据源：StarRocks、THive、MySQL
- 可视化画布式操作，支持多源数据关联
常见操作
- 添加节点：从节点列表中找到你需要的节点，添加到画布上。
- 连线：把鼠标放在一个节点的右侧 / 底部圆点上，拉出一条线，连到下一个节点的左侧圆点。
- 配置：点击画布上的任意节点，右侧会弹出「配置面板（Panel）」，告诉节点具体要做什么。
- 预览：每做一步，都可以在底部的表格区域看到这一步处理完的结果。
四、常见问题
- 数据库连接测试失败？ 检查 Host / Port / 账号密码是否正确，并确认数据库是否允许当前 IP 访问。
- 本地文件支持哪些格式？ 当前以 Excel (.xlsx / .xls) 和 CSV 为主，建议单文件不超过 10MB。