SQL查询功能支持您通过编写SQL语句的方式对有查询权限的数据源进行快速的数据查询与分析。本文将为您介绍SQL查询产品功能的使用方法。

前提条件

  • 目标工作空间已绑定数据源对应的引擎,详情请参见配置工作空间
  • 目标工作空间已配置数据源,详情请参见数据源管理
  • 操作账号已被添加为工作空间的成员。详情请参见:添加工作空间成员和角色
    说明 使用SQL查询功能时,仅支持查询工作空间内数据源的数据,因此您需先联系管理员将您添加为工作空间成员。一个用户可以被添加为多个工作空间成员。

创建SQL查询

  1. 进入SQL查询页面。
    1. 进入数据分析模块,详情请参见:进入数据分析
    2. 您可以在数据分析首页的快捷入口区域单击SQL查询模块图标进入SQL查询页面。
      还支持您单击顶部菜单栏的SQL查询进入SQL查询页面。
  2. 选择SQL查询的对象。
    数据源引擎列表中选择需要查询的数据所在的引擎类型,在右侧列表框中选择数据源所在的工作空间、引擎实例名称或者数据源名称。选择数据源
  3. 新增SQL编辑窗口。
    您可以通过如下三种方式新增SQL编辑窗口。
    • 方法一:已有SQL文件被打开时,单击已打开文件名称右侧的图标图标即可创建新的SQL查询窗口。新增文件
    • 方式二:首次进入SQL查询页面或者当前窗口没有打开SQL文件时,单击右侧页面中的新建sql查询窗口。sql查询
    • 方法三:在SQL查询页面左侧区域,右键单击我的文件选择新增文件,弹出保存窗口,您可以自定义文件名称。同时支持您按需选择是否公开该文件。
      • 当前工作空间可见:当前工作空间下的其他成员可以通过他人文件目录查看到该SQL文件。复制对应的sql内容。
      • 仅自己可见:仅支持当前用户在我的文件目录查看该SQL文件。
      左侧导航
  4. 编写并执行查询语句。
    1. 通过上述三种方式创建SQL编辑窗口后,您可以在SQL编辑框进行代码编辑。
    2. 单击SQL代码框上方的运行图标。执行查询,完成之后,即可在下方结果显示框查看执行结果。表格中数据支持您根据字段类型排序、筛选、选定条数范围复制等操作。
      SQL结果查询
      序号 属性 说明
      SQL编辑框 编写SQL语句。如果代码中使用了变量,可以在图中区域⑩的参数设置中为变量赋值。
      运行 运行SQL编辑框内选中的语句或全部语句。单击运行后,开始执行SQL语句,运行结果展现在编辑框底部。
      说明 引擎任务运行将产生引擎费用。此费用由引擎侧收取,不在DataWorks账单中体现。
      停止 终止正在运行的SQL语句。
      保存 单击保存弹出保存窗口,您可以自定义文件名称(默认名称为用户名+日期时间),同时支持您按需选择是否公开该文件。
      • 当前工作空间可见:当前工作空间下的其他成员可以通过他人文件目录查看到该SQL文件。复制对应的sql内容。
      • 仅自己可见:仅支持当前用户在我的文件目录查看该SQL文件。
      格式化 可以使代码按照标准格式呈现。
      计划任务 支持您将指定的SQL文件设置为计划任务,开启状态的计划任务将按照配置的时间定期执行。
      说明 仅MaxCompute引擎支持使用计划任务功能。
      计划任务
      • 任务状态:计划任务的状态,您可以选择开启或者关闭计划任务。
        • 开启:SQL将会在您指定的时间执行。
        • 关闭:SQL将不再自动执行。
        说明 开启后的计划任务,次日生效。
      • 运行周期:SQL定时执行的频率。
        • 天:每天执行。
        • 周:固定每周的某一天执行。
        • 月:固定每月的某一天执行。
      • 运行时间:支持您自定义文件的运行时间,和运行周期搭配执行,运行时间为SQL具体的执行时间。
      • 参数:支持您设置任务周期运行时使用的参数,参数会根据任务运行的业务时间及参数的取值格式自动替换取值,实现在任务调度时间内参数的动态取值。详情请参见:调度参数概述
      • 任务预览:为您展示计划任务的预计执行时间及参数取值等详情。
        说明 任务预览为您展示最近三次计划执行任务的时间。
      更多
      • 版本:在代码修改后未保存的情况下,支持将缓存代码与服务器代码进行比对,并支持您选择需要的版本继续编辑。
      • 成本预估:为您预估SQL执行的费用,实际费用以账单为准。
        说明 sql语句将下推到引擎执行,可能会产生引擎侧费用。此费用由各引擎侧收取,不在DataWorks账单中体现。
      日志 SQL运行的日志。
      结果 查看SQL语句运行成功后的结果。
  5. 对查询结果进行数据分析。
    下载数据
    完成数据查询后,您可以对查询结果进行数据分析、分享或者下载数据至本地。还支持您对表格中数据进行复制和搜索等快捷操作。
    • 数据分析:单击数据分析跳转并将结果同步至电子表格,你可以对查询结果进行透视、探查等操作。详情请参见:分析数据
    • 分享:单击分享跳转并将结果同步至电子表格,您可通过电子表格的数据分享功能,分享该表数据。详情请参见:分享电子表格
    • 下载数据:单击下载数据,会将查询结果下载到本地。如果界面不显示下载数据功能,请您进入系统管理界面打开允许下载的开关。
      • 下载范围:支持下载电子表格展示数据(最多支持1万行)和全量数据(最多支持20万行),实际下载数以系统管理中设置的具体数量为准。
      • 文件格式:支持csv、excel、txt格式。
      说明 只有DataWorks增值版本在SQL查询有下载入口。增值版本默认支持下载1万行,最多支持下载20万行。实际下载记录上限以您在系统管理界面中设置的允许下载记录上限值为准。

管理SQL查询

在SQL查询页面,您可以搜索已创建SQL查询文件的相关信息,并执行修改、删除和移动等管理操作。管理SQL查询
区域 描述
搜索文件 在区域①您可以输入文件名、文件夹名称或者表名搜索目标文件。
文件目录
在区域②,您可以查看我保存的文件及他人共享的文件。
  • 我的文件:我保存的所有文件。
  • 他人文件:其他人保存为工作空间可见的文件。
  • 公共数据:适用于用户体验SQL查询产品功能,无需申请权限,可直接查询数据。
  • 所有的表:当前工作空间及数据源下所有的物理表。双击表名可快速生成查询语句,右键支持您进行快速生成SQL语句、查看表详情、数据预览、申请表权限等操作。
您还可以右键单击我的文件选择新建文件夹文件
  • 新建文件夹:在弹出的新建文件夹窗口中输入文件夹名称,并选择保存到我的文件或我的文件下的子文件夹中。您还可以对已创建的文件夹进行如下操作:
    • 重命名:右键单击目标文件夹选择重命名,在弹出的修改窗口中修改当前文件夹的名称。
    • 移动:右键单击目标文件夹选择移动,在弹出的窗口中选择需要移动到的目标文件夹,将当期文件夹及其子文件移动到目标文件夹中。
    • 删除:右键单击目标文件夹选择删除即可删除该文件夹。删除前请确认文件夹下文件均已删除。否则不允许删除文件夹。
  • 新建文件:在弹出的保存窗口中您可以自定义文件名称,同时支持您按需选择是否公开该文件。
    还支持您对已创建的文件执行如下操作:
    • 打开:右键单击目标文件选择打开,为您在右侧编辑区域打开已保存的SQL语句文件。
    • 修改:右键单击目标文件选择修改,在弹出的修改窗口修改该文件名称和公开方式。
    • 移动:右键单击目标文件选择移动,在弹出的窗口中选择需要移动到的目标文件夹。将文件移动到目标文件夹中。
    • 删除:右键单击目标文件选择删除,即可删除该文件。