查询任务

重要

此功能目前以公共预览版提供。 请联系 Azure Databricks 代表,以申请访问权限。

创建查询

  1. 执行下列操作之一:

    • 单击侧栏中的 创建图标 图标并选择“查询”。
    • 单击侧栏中的 查询图标 图标,然后单击“+ 新建查询”按钮。

    此时会显示查询编辑器。

  2. 在“新建查询”下面的框中,单击 向下箭头图标 图标,然后选择 SQL 终结点。 若要筛选列表,请在文本框中输入文本。

    选择终结点

    第一次创建查询时,可用 SQL 终结点的列表按字母顺序显示。 下次创建查询时,将选择上次使用的 SQL 终结点。

    SQL 终结点旁的图标表示状态为:

    • 运行 运行
    • 正在启动 正在启动
    • 已停止 已停止

    备注

    如果没有 SQL 终结点,请与 SQL Analytics 管理员联系。

浏览数据对象

如果具有元数据读取权限,则架构浏览器会显示可用的数据库和表。

备注

如果没有数据对象,请与 SQL Analytics 管理员联系。

  1. 在 SQL 终结点下面的框中,单击 向下箭头图标 图标,并选择一个数据库。

    默认数据库

    备注

    • 必须选择正在运行的 SQL 终结点。
    • 为了在架构浏览器中查看数据对象,必须是数据对象所有者,或被授予了该对象的特权

    若要刷新架构,请单击 刷新架构图标 按钮。

    刷新架构

    可在搜索框中键入筛选器字符串来筛选架构:

    筛选架构

  2. 单击一个表来显示表中的列。

    表列

构造查询

可以通过从架构浏览器插入元素或在查询编辑器中键入内容来构造查询。

  • 在架构浏览器中,单击数据对象最右侧的双箭头。

    插入架构项

  • 在查询编辑器中键入内容。

    查询编辑器支持自动完成。 键入时,自动完成功能将建议有效的完成内容。 例如,如果光标位置的有效完成内容是列,则自动完成功能将建议一个列名称。 如果键入 select * from table as t where t.,则自动完成功能将识别出 ttable 的别名,并建议 table 中的列。

    自动完成别名

完成编辑后,单击“保存”。

执行查询

若要执行查询:

  1. 选择 SQL 终结点。

  2. 在查询编辑器中指定一个查询。

  3. 按 Ctrl/Cmd + Enter 或单击“执行”按钮 。

    执行查询

备注

  • 如果终结点已停止,则你执行查询时终结点将启动。 若要手动启动终结点,请按照启动终结点中的步骤操作。
  • “限制 1000”复选框已默认选中,以确保查询最多返回 1000 行。 如果知道有更多的行,可取消选中此复选框,并在查询中指定 LIMIT 子句。

查询结果将显示在“表”选项卡中。

执行查询结果

刷新查询

如果查询有计划,则它会自动刷新。 要在自动刷新间隙手动刷新查询,请单击“刷新”按钮。

刷新查询

保存查询

若要保存查询,请按 Ctrl/Cmd + S 或单击“保存”按钮 。 只有已保存的查询才会显示在查询列表中。

还原到已保存的查询

编辑查询时,“保存”按钮旁边会显示“还原”链接。

“还原”链接

单击“还原”可以返回到已保存的版本。 离开时,你的更改将保存到浏览器存储中,但是浏览器可能仍会显示有关丢失工作的警告。

将查询移至回收站

若要将查询移至回收站,请单击查询编辑器右上方的垂直省略号 垂直省略号,然后选择“移至回收站”。 单击“移至回收站”进行确认。

从回收站还原查询

  1. 在“所有查询”列表中,单击 回收站按钮.
  2. 单击查询。
  3. 单击查询编辑器右上方的垂直省略号 垂直省略号,然后选择“还原”。

永久删除查询

  1. 在“所有查询”列表中,单击 回收站按钮.
  2. 单击查询。
  3. 单击查询编辑器右上方的垂直省略号 垂直省略号,然后选择“删除”。

复制查询

若要创建查询副本(该查询由你或其他人创建),可为其创建分支。 若要为查询创建分支,请单击查询编辑器右上方的垂直省略号 垂直省略号,然后选择“创建分支”:

为查询创建分支

下载查询结果

可以将查询结果下载为 CSV、TSV 或 Excel 文件。

  1. 单击可视化效果下方的垂直省略号 垂直省略号 按钮。
  2. 选择“下载为 [CSV | TSV | Excel] 文件”。

下载查询结果

如果无法下载查询,则表示管理员已为 SQL Analytics 实例禁用了下载功能

查询编辑器工具

架构浏览器

若要切换架构浏览器,请按 Alt/Option + D,或者单击架构浏览器和查询窗格之间的窗格句柄 窗格句柄

自动完成

查询编辑器具有自动补全功能,可提高查询编写的速度。 自动补全功能可补全架构令牌、查询语法标识符(如 SELECTJOIN)和查询片段的标题。

自动补全功能默认启用,除非你的数据库架构超过 5000 个令牌(表或列)。

  • 若要禁用自动补全功能,请按“Ctrl + 空格”,或者单击查询编辑器下方的 已启用自动补全 按钮:
  • 若要启用自动补全功能,请按“Ctrl + 空格”,或者单击查询编辑器下方的 已禁用自动补全 按钮。

配置查询权限

若要配置可管理和运行查询的人员,请查看查询访问控制