3.4.2 数据集

数据集将来源表和SQL、字段定义等组织成可复用的数据对象。入口：数据服务 → 数据集。开始前确认顶部当前项目，准备好可查询的数据源和表。

3.4.2.1 浏览与查找数据集

1. 在左侧展开文件夹，点击目标数据集名称。
2. 数据集较多时，在“搜索文件夹或数据集”中输入名称关键词，按显示结果定位；清空关键词恢复浏览。
3. 在右侧检查标题及启用状态，再切换“数据预览”“字段结构”“基础信息”。
4. 切换其他数据集时重新核对标题，不要在旧结果上误读新选择。

页面说明：左侧管理文件夹和数据集，右侧展示当前对象。树节点右侧更多菜单可执行编辑、复制、移动到、重命名、启停和删除等操作，具体入口受权限及对象状态限制。

3.4.2.2 创建与维护文件夹

1. 点击左侧标题旁“新建文件夹”，输入文件夹名称。
2. 在“父文件夹”中选择根目录或已有文件夹，确认层级和位置。
3. 点击“确定”，成功后检查左侧树中的新文件夹。
4. 维护已有文件夹时打开该节点的更多菜单，按需选择重命名、移动或新建子文件夹等入口，核对目标后确认。
5. 删除前先处理下级数据集和子文件夹；系统提示非空时，不应直接连带删除仍需使用的对象。

填写说明：同一父目录下使用可区分的名称。文件夹用于组织对象，移动文件夹前先确认使用者能理解新的路径。

3.4.2.3 新建数据集并选择来源

1. 在左侧选定需要存放的文件夹，点击标题旁“新建数据集”。
2. 等待“数据库与数据表”加载完成。来源较多时不要在加载过程中把“0张表”直接判断为无权限或没有表。
3. 展开来源、数据库以及适用的Schema，找到目标表；也可在“通过表名称搜索”中输入表名。
4. 选择一张表，检查页面显示的来源路径，以及右侧生成或回显的SQL。
5. 使用“一键收起”整理较长的树，或点击“折叠数据库与数据表”扩大编辑区域。
6. 按后续小节配置SQL、预览及字段，最后保存数据集。

注意事项：一个数据集按单表配置使用。切换来源表会影响SQL、预览和字段配置；已完成大量配置时应先确认是否需要更换，离开编辑页面前先处理未保存内容。

3.4.2.4 编写SQL与运行预览

1. 在“SQL编辑”区域核对当前来源表。只需要全部字段时可使用系统生成的查询。
2. 按当前选定单表编写SELECT或WITH查询；需要字段别名、条件或聚合时，遵循来源数据库语法。
3. 点击“格式化”整理排版，随后点击“校验”，根据提示修正语法或引用问题。
4. 点击“运行预览”，等待查询完成；检查执行行数、耗时和结果列。
5. 修改SQL或字段配置后，重新运行预览或点击“刷新数据”，再判断结果是否符合预期。
6. 查询失败时保留配置，按错误信息检查表、字段、权限和语法；不要把失败当作返回0行。

SQL示例：本次页面使用“SELECT * FROM `system`.`aggregate_function_combinators`”，预览字段为“name”和“is_internal”。该示例用于理解操作顺序；业务使用时替换为自己选定的表和合法字段。

注意事项：数据预览展示前50行，不能据此判断全量数据只有这些记录。不要在数据集SQL中输入写入、删除或建表语句；需要复杂多表加工时先在相应数据开发流程处理。

3.4.2.5 管理字段名称 类型 角色与单位

1. 运行预览后切换“字段管理”。
2. 展开“维度”“指标”或“未加入数据集”，核对各分类字段数量。
3. 在“显示名称”输入框中修改面向使用者的名称；“原始字段名”用于核对来源，不在此改写。
4. 在“字段类型”中选择支持的类型，结合“原始字段类型”判断转换是否合理；日期等转换有额外要求时按当前页面补齐。
5. 在数字指标的“单位”中填写需要展示的单位，例如“元”；维度行无单位输入时无需填写。
6. 在备注中补充字段口径。名称、类型或备注修改后，再次检查所在行，避免改错字段。
7. 打开字段行右侧更多菜单，按需“移出数据集”“切换为指标”“切换为维度”或“复制”。
8. 被移出的字段进入“未加入数据集”，需要时从其菜单重新加入；修改完成后刷新预览并检查输出。

项目	操作与含义
原始字段名	核对来源字段；与可编辑的显示名称区分
显示名称	数据集输出的可读名称，应非空且与其他字段区分
字段类型	数据集使用的逻辑类型；修改后需检查实际转换结果
原始字段类型	来源引擎读取的类型，例如STRING、UINT8
字段来源	区分来源字段、计算字段或分组字段
单位	需要时填写数字指标单位；不替代对实际数值换算的配置
备注	对字段业务口径进行说明

左右滑动查看完整表格

填写说明：分类已经表达字段角色，不需要另找“角色”列。字段移出仅调整数据集输出，不删除来源表中的字段。不要把文本名称直接作为可求和的业务指标。

3.4.2.6 新建计算字段

1. 在数据集编辑页点击“计算字段”，打开“新建计算字段”。
2. 填写字段名称，选择“指标”或“维度”，再选择字段类型。
3. 在“字段表达式”中输入表达式；可以在右侧搜索并点击可引用字段，避免手工输入错误名称。
4. 按需填写备注，说明单位或计算口径。
5. 点击“校验”。失败时按提示修改；通过后出现“校验通过，可以保存”，并可点击“确认”。
6. 点击“确认”将字段加入当前编辑配置，再检查字段管理分类和预览结果。
7. 最后在页面顶部保存整个数据集；仅确认字段弹窗不等于数据集已保存。

示例：图中字段“内部标记加一”使用“is_internal + 1”，角色为指标，类型为数字。此示例只演示表达式校验，不代表真实业务指标口径。

注意事项：表达式、角色或类型调整后重新校验。计算字段按来源支持的表达式语法填写，引用其他字段时检查依赖，避免循环引用；删除或改动被引用字段前应先处理依赖。

3.4.2.7 新建分组字段

1. 点击“分组字段”，打开“新建分组字段”。
2. 填写新字段名称，在“分组字段”中选择需要归类的来源维度。
3. 在“分组设置”输入分组名称，打开原始值选择框，勾选需要归入该组的值。
4. 点击“+ 添加分组”创建更多组，分别命名并分配原始值；不需要的组使用其右侧“删除”。
5. 核对同一个原始值没有被重复分配。未分组的值自动进入“其他”。
6. 至少保留一组完整配置，点击“确认”；返回字段管理检查新增维度，再刷新预览。
7. 完成后保存整个数据集；放弃本次分组时点击弹窗“取消”。

示例：图中“函数分类”以“name”为分组字段，将“Distinct”归入“常用函数”，其余值进入“其他”。业务数据可以按渠道、地区等离散值使用同样的操作方式。

注意事项：原始值列表来自当前来源和配置，加载未完成或失败时先处理加载问题。不要将原始值分组理解为数值区间、日期区间分段。

3.4.2.8 保存数据集

1. 完成SQL、预览及字段配置后，点击页面右上角“保存”。
2. 如果出现校验问题，返回对应区域处理后重新保存。
3. 在“保存数据集”弹窗中填写“名称”，选择“所属文件夹”。编辑已有数据集时先核对回显名称和位置。
4. 点击弹窗内“保存”，等待成功反馈；点击“取消”只关闭此次保存弹窗。
5. 返回主页后选择该数据集，检查预览、字段结构和基础信息，确认名称、字段与来源正确。

注意事项：字段弹窗的“确认”、页面顶部“保存”、保存弹窗内“保存”分别属于不同步骤。只有最后保存成功，配置才作为数据集正式定义供后续使用。

3.4.2.9 查看字段结构与基础信息

1. 在主页选中数据集，切换“字段结构”。
2. 使用“搜索原始字段名或显示名称”查找字段，按需选择角色和来源筛选。
3. 核对原始字段名、显示名称、角色、类型、来源、备注和定义；派生字段有查看定义入口时打开核对。
4. 切换“基础信息”，查看名称、所属文件夹、来源数据源、来源表或SQL、来源类型和状态。
5. 查看创建人、创建时间、最后修改人和更新时间，判断当前对象与版本信息。

阅读说明：字段结构用于只读核对；要修改名称、类型或表达式，应进入“编辑”。基础信息中的SQL或来源路径用于识别定义，不应误当作数据预览结果。

3.4.2.10 编辑 复制 移动与重命名

编辑：选中数据集，点击右上角“编辑”，修改SQL和字段后重新运行预览，按保存流程提交。修改现有字段前先确认下游查询、API或报表是否依赖该字段。

复制：打开数据集节点右侧更多菜单，选择“复制”。成功后在树中查找副本，核对自动生成的名称、来源和字段，再按业务需要重命名或编辑。

移动：从更多菜单选择“移动到”，选择目标文件夹并确认；检查树中的新位置，确保仍为当前项目内的目标对象。

重命名：从更多菜单选择“重命名”，在“重命名数据集”中核对旧名称，输入新名称，点击“确定”；取消时不修改原名称。

注意事项：复制不等于编辑原对象；移动与重命名不用于更换数据来源。编辑保存可能影响后续使用该数据集的查询，执行前应先确认字段口径与下游需要。

3.4.2.11 启用 停用与删除

1. 选中目标数据集，核对右侧标题和状态。
2. 需要暂停使用时点击“停用”，阅读影响提示后确认；恢复时使用“启用”。
3. 状态变更后重新查看，检查预览与导出等入口的可用性。
4. 确需删除时，打开节点更多菜单选择“删除”，阅读引用校验和确认提示。
5. 存在下游引用时先处理引用；确认对象无需保留且符合删除条件后，再完成最终确认。

注意事项：停用影响后续取数。删除后前台不提供恢复入口，操作前先确认配置已留存；删除数据集不等于删除来源表及其中的业务数据。

3.4.2.12 导出数据

1. 在主页选择启用的数据集，核对名称、来源与字段。
2. 在“数据预览”确认当前定义的结果可以正常读取后，点击右上角“导出”。
3. 根据系统反馈进入“数据导出”查看任务状态。
4. 任务成功后在数据导出模块下载；失败时查看失败原因，处理后再发起。

注意事项：预览前50行用于检查样例，导出按数据集定义处理实际结果。没有导出按钮时检查数据集状态与权限；导出创建成功不代表文件已经生成。