工作簿

概述

工作薄为用户提供了通过可视化拖拽或编写SQL进行数据查询与分析的环境，分为可视化工作薄和SQL工作薄两种类型。可视化工作薄支持通过拖拽操作，结合自然语言生成SQL以实现数据查询与分析；SQL工作薄则支持直接编写SQL语句进行数据查询与分析。有关可视化工作薄的详细介绍，请查看 。本文重点介绍SQL工作薄的主要功能及使用方法。

功能入口

点击导航栏“数据整合”下的“工作簿”，即可进入工作薄列表页面，其中展示最近编辑的工作薄记录。点击右上角“新建工作簿-SQL工作薄”按钮，就可以创建一个新的SQL工作薄。

功能介绍

• 顶部区域*
• 收起侧边目录：点击后可收起【实体目录】模块
• 返回首页：点击后将返回至平台首页
• 编辑工作薄名称： 支持修改当前工作薄的名称
• 版本记录： 详见下文【版本记录】部分
• 另存为视图： 详见下文【另存为视图】部分
• 保存： 保存当前工作薄配置（不进行语法校验）
• 实体目录：* 详见下文【实体目录】部分
• 代码编辑器* ： 详见下文【代码编辑器】部分
• 查询区域* ： 详见下文【查询】部分

顶部区域

版本记录

点击“版本记录”可查看历史上保存的SQL脚本版本。支持对比任意版本与上一版本的差异，并可将历史版本恢复为当前版本。

另存为视图

选中SQL代码后，点击“另存为视图”，可将该段SQL保存为视图，便于后续查询使用。

实体目录

实体目录展示所有可用的视图，包括逻辑视图和基础视图。

• 数据目录：支持搜索数据源、数据空间、基础视图及逻辑视图。
• 关注列表：展示您已关注的基础视图和逻辑视图，方便快速查看和使用。 选中某一视图后，可进行关注或查看其详细信息。 同时支持将视图名称及字段插入代码编辑器。 此外，还可查看字段信息及其关联的投影信息。

代码编辑器

代码编辑器包含四个主要部分：执行、编辑框、格式化及函数。

• 执行：详见下文【执行】部分。
• 编辑框：详见下文【编辑框】部分。
• 格式化：点击后对编辑框中的SQL代码进行格式美化。
• 函数：详见下文【函数】部分。

执行

点击“执行”按钮可运行代码编辑器中的部分或全部SQL片段。默认根据光标所在位置，动态执行当前SQL语句区块（以分号分隔）。也支持通过鼠标选中多个代码片段一并执行。

• 执行（1W）：执行时将自动添加“limit 10000”限制结果数量，该数量可在“个人信息-偏好设置”中调整。
• 执行（全部）：执行全部数据，不添加数量限制。

编辑框

SQL代码编辑框支持智能补全提示与错误提示。智能补全涵盖SQL关键字、函数、数据源、数据空间、基础视图及逻辑视图等信息；错误提示则用于指出SQL编写过程中的语法问题。

函数

点击“函数”按钮可查看并搜索所需使用的函数。 支持将选中函数插入代码编辑器 。

查询

查询区域包含查询记录、查询结果及智能加速功能。

查询记录

在“查询记录”中可查看历史SQL查询信息、执行耗时及命中的投影信息。

查询结果

“查询结果”页面展示SQL执行后返回的数据结果。每次SQL查询任务的结果均会显示在此区域，包括查询数据结果及任务执行的详细信息。

智能加速

若查询中存在可加速的视图且已配置智能加速策略，系统将自动给出“智能加速提示”。 点击“选择加速方案”可查看可用加速方案。若存在多个方案，还可对比其加速效果后进行选择。