在 SQL 编辑器中编写查询和浏览数据

项目
04/10/2024

Azure Databricks UI 包含一个 SQL 编辑器，可用于创作查询、浏览可用数据以及创建可视化效果。你还可以与工作区中的其他团队成员共享已保存的查询。

SQL 编辑器 UI

打开编辑器后，可以创作 SQL 查询或浏览可用数据。文本编辑器支持自动完成、自动格式设置和其他各种键盘快捷方式。

可以使用文本编辑器顶部的查询选项卡打开多个查询。每个查询选项卡都有用于运行查询、将查询标记为收藏项以及连接到 SQL 仓库的控件。还可以保存、计划或共享查询。

连接以计算

必须至少对正在运行的 SQL 仓库具有 CAN USE 权限才能运行查询。可以使用编辑器顶部附近的下拉列表查看可用选项。若要筛选列表，请在文本框中输入文本。

SQL 仓库选择器

首次创建查询时，可用 SQL 仓库的列表按字母顺序显示。下次创建查询时，会选择上次使用的 SQL 仓库。

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

正在运行
正在启动
已停止

注意

如果列表中没有 SQL 仓库，请与工作区管理员联系。

运行查询时，选定的 SQL 仓库将自动重启。若要了解启动 SQL 仓库的其他方法，请参阅启动 SQL 仓库。

在 SQL 编辑器中浏览数据对象

如果你拥有元数据读取权限，SQL 编辑器中的架构浏览器会显示可用的数据库和表。还可通过目录资源管理器浏览数据对象。

架构浏览器显示了示例目录、nyctaxi 数据库、行程表以及该表中的列。

可以在目录资源管理器中导航 Unity Catalog 管控的数据库对象，而无需活动计算。若要浏览 hive_metastore 中的数据和不受 Unity Catalog 管控的其他目录，必须为计算附加相应的特权。请参阅 Unity Catalog 数据治理。

注意

如果架构浏览器或目录资源管理器中没有数据对象，请与工作区管理员联系。

单击架构浏览器顶部附近的来刷新架构。可在搜索框中键入筛选器字符串来筛选架构。

单击表名可显示该表的列。

创建查询

可以在 SQL 编辑器中输入文本来创建查询。可以从架构浏览器插入元素来引用目录和表。

在 SQL 编辑器中键入查询。

SQL 编辑器支持自动补全。键入时，自动完成功能将建议完成内容。例如，如果光标位置的有效完成内容是列，则自动完成功能将建议一个列名称。如果键入 select * from table_name as t where t.，则自动完成功能将识别出 t 是 table_name 的别名，并建议 table_name 中的列。
（可选）完成编辑后，单击“保存”。

打开和关闭自动完成功能

实时自动完成功能可补全架构令牌、查询语法标识符（如 SELECT 和 JOIN）和查询片段的标题。该功能默认启用，除非你的数据库架构超过 5000 个令牌（表或列）。

使用 SQL 编辑器下方的开关关闭或打开实时自动完成功能。

若要关闭实时自动完成功能，请按 Ctrl + 空格，或者单击 SQL 编辑器下方的按钮。

保存查询

SQL 编辑器右上角附近的“保存”按钮可保存查询。

重要

修改查询但未显式单击“保存”时，该状态将保留为查询草稿。查询草稿将保留 30 天。 30 天后，将自动删除查询草稿。若要保留更改，必须显式保存更改。

编辑多个查询

默认情况下，SQL 编辑器使用选项卡，这让你能够同时编辑多个查询。若要打开新选项卡，请单击 +，然后选择“创建新查询”或“打开现有查询”。单击“打开现有查询”以查看保存的查询列表。单击“我的查询”或“收藏夹”以筛选查询列表。在包含要查看的查询的行中，单击“打开”。

“查询”对话框

运行一个或多个查询

若要运行一个查询或所有查询，请执行以下操作：

选择一个 SQL 仓库。
在 SQL 编辑器中突出显示查询（如果查询窗格中有多个查询）。
按 Ctrl/Cmd + Enter 或单击“运行(1000)”，在结果窗格中以表的形式显示结果。

注意

默认为所有查询选择“限制为 1000”，将返回的查询数限制在 1000 行。如果使用“限制为 1000”设置来保存查询，则此设置适用于所有查询运行（包括仪表板中的运行）。若要为此查询返回所有行，可单击“运行(1000)”下拉列表来取消选择“限制为 1000”。如果你想要对行数指定不同的限制，可以在查询中添加一个使用所选值的 LIMIT 子句。