查询任务

运行自己的第一个查询

首次登录到 Databricks SQL 时,会出现一个载入面板来帮助你快速入门。 如果你不是管理员,则运行第一个查询将是第一个载入任务。

注意

如果已关闭载入面板,可以稍后按照本文中创建查询中的步骤运行此查询。

  1. 如果未看到载入面板,请在侧栏中查找“已完成的任务”,然后单击它。

    Sidebar onboarding label showing 1 of 3 tasks completed

  2. 在载入面板中,单击“运行第一个查询”。 将显示 SQL 编辑器,并加载以下查询:

    -- We've given you a sample query below to help get started.
    -- Just hit "Run" to run the query and get your results.
    SELECT
      concat(pickup_zip, '-', dropoff_zip) as route,
      AVG(fare_amount) as average_fare
    FROM
      `samples`.`nyctaxi`.`trips`
    GROUP BY
      1
    ORDER BY
      2 DESC
    LIMIT 1000
    

    此查询针对 SAMPLES 目录中的 nyctaxi 数据库运行,该目录在所有工作区中可读。

  3. 单击 “运行” 。 几秒钟后,查询结果会显示在查询下方。

    Results of your first query

查看已保存查询的列表

单击边栏中的 Queries Icon“查询”。 随即会显示“查询”列表。

默认情况下,查询按“创建者”列以时间倒序排序。 可以通过单击列标题重新对列表进行排序。

筛选已保存查询的列表

可以按创建的查询列表(“我的查询”)、收藏夹标签来筛选查询列表。

创建查询

  1. 执行下列操作之一:

    • 单击侧栏中的 SQL 编辑器。

      SQL Editor shortcut

    • 单击边栏中的Create Icon创建,然后选择查询

    • 单击边栏中的 Queries Icon“查询”,然后单击“+ 新建查询”按钮。

    此时将显示 SQL 编辑器。

  2. 如果未选择,请选择“数据源”选项卡:

    Data sources

  3. 单击 向下箭头图标 图标,然后选择一个 SQL 仓库。 若要筛选列表,请在文本框中输入文本。

    Select warehouse

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

    SQL 仓库旁的图标表示状态为:

    • 正在运行 Running
    • 正在启动 Starting
    • 已停止 Stopped

    注意

    如果没有 SQL 仓库,请与 Databricks SQL 管理员联系。

浏览数据对象

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

注意

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

还可以在数据资源管理器中浏览数据对象。

  1. 在 SQL 仓库下面的框中,单击 向下箭头图标 图标,然后选择一个数据库。

    Default database

    注意

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

    若要刷新架构,请单击 Refresh Schema Icon 按钮。

    Refresh schema

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

    Filter schema

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

    Table columns

构造查询

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

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

    Insert schema item

  • 在 SQL 编辑器中键入。

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

    Autocomplete alias

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

编辑多个查询

默认情况下,SQL 编辑器使用选项卡,因此你可以同时编辑多个查询。

SQL Editor Tabs

  • 单击 Add Tab Icon。 随即会显示带有查询名称 New Query 的选项卡。

    New Query Tab

  • 单击“打开查询”链接。 此时将显示查询对话框。

    Queries Dialog

    1. (可选)单击“我的查询”或“收藏夹”以筛选查询列表 。

    2. 在包含要查看的查询的行中,单击“打开”按钮。 查询显示在新选项卡中。

      Opened Query

若要打开新选项卡,请单击 +,然后选择“创建新查询”或“打开现有查询”。 若要运行查询,请单击“运行”。 如果右键单击某个选项卡,将看到“关闭其他”、“关闭左侧”、“关闭右侧”和“关闭所有”选项 。 如果右键单击第一个或最后一个选项卡,则“关闭左侧”或“关闭右侧”选项不可用 。

若要禁用选项卡式编辑器,请在边栏中打开“查询”,然后单击“选项卡式编辑器”旁边的切换按钮。

执行查询

若要执行查询:

  1. 选择一个 SQL 仓库。

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

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

    Execute query

注意

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

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

Execute query result

终止查询

若要在执行查询时终止查询,请单击“取消”。 管理员可以通过查看终止正在执行的查询来终止由其他用户启动的正在执行的查询。

设置查询说明

若要设置查询说明,请执行以下操作:

  1. 单击“查询信息”选项卡。

    Query info

  2. 单击“添加说明”链接或现有说明。

    Add description

  3. 编辑说明,然后按 Enter。

刷新查询

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

Refresh query

保存查询

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

还原到已保存的查询

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

Revert link

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

将查询移至回收站

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

从回收站还原查询

  1. 在“所有查询”列表中,单击 Trash Button
  2. 单击查询。
  3. 单击 SQL 编辑器右上方的垂直省略号 Vertical Ellipsis,然后选择“还原”。

永久删除查询

  1. 在“所有查询”列表中,单击 Trash Button
  2. 单击查询。
  3. 单击 SQL 编辑器右上方的垂直省略号 Vertical Ellipsis,然后选择“删除”。

复制查询

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

Fork query

查看查询信息

若要查看查询的创建或更新时间,请单击“查询信息”选项卡:

Query info

查看过去的查询执行

若要查看在 SQL 编辑器中执行的过去的执行,请单击“过去的执行”选项卡:

Past executions

此选项卡不会显示计划的执行

下载查询结果

可以将查询结果下载为 CSV、TSV 或 Excel 文件。 最多可下载 64,000 行结果。

  1. 单击结果窗格下方的垂直省略号 Vertical Ellipsis 按钮。
  2. 选择“下载为 [CSV | TSV | Excel] 文件”。

Download query result

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

转让查询的所有权

保存查询时,会成为查询的所有者。 如果从工作区中删除查询的所有者,则查询不再具有所有者,并且只有管理员用户可以管理查询的权限。 管理员用户可以将查询的所有权转让给其他用户。 使用 Databricks SQL UI 转让所有权:

  1. 打开查询。
  2. 单击“共享”。
  3. 选择一名用户,然后选择“可管理”。
  4. 阅读提示。 如果同意,请单击“确认”。

若要使用 REST API 转让所有权,请参阅转让查询的所有权

如果此查询以前具有所有者,则该用户不再具有对查询的“可管理”权限,而你授予“可管理”权限的用户现在成为所有者。

SQL 编辑器工具

架构浏览器

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

启用和禁用选项卡式编辑器

启用选项卡式编辑器后,可以轻松地在多个查询之间切换。 若要启用和禁用选项卡式编辑器,请单击“查询”页面上的“选项卡式编辑器”开关:

Tabbed editor toggle

自动完成

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

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

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

配置查询权限

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

访问管理员视图

Azure Databricks 管理员用户可以查看所有查询。 在此视图中,管理员可查看和删除任何查询。 但是,如果未与管理员共享查询,则管理员无法编辑查询。

若要查看所有查询,请执行以下操作:

  1. 单击边栏中的 Queries Icon“查询”。
  2. 在右侧面板中单击“管理员视图”。

转让查询的所有权

管理员可以转让查询的所有权。 请参阅转让查询的所有权