搜索工作区对象

  • 项目

本文介绍如何在 Azure Databricks 工作区中搜索表、笔记本、查询、仪表板、警报、文件、文件夹、库、作业、存储库、合作伙伴和市场列表。

表必须在 Unity Catalog 中注册才能显示在搜索结果中。

在使用客户管理的密钥进行加密的工作区中，笔记本内容和查询内容在搜索中不可用。

若要使用 UI 顶部栏中的导航式搜索来搜索工作区，请执行以下操作：

  1. 单击 Azure Databricks 工作区顶部栏中的“搜索”字段，或使用键盘快捷键 Command-P。

    导航式搜索栏

    最近使用过的文件、笔记本、查询、警报和仪表板会列在“最近使用的内容”下，按上次打开日期排序。

  2. 输入搜索条件。

    根据搜索条件筛选列表中最近使用过的对象。 导航式搜索可能还会推荐与你的条件匹配的其他对象。 若要执行工作区的完整搜索，请使用“搜索结果”页。

  3. 从列表中选择一个项。

“搜索结果”页

整页搜索体验提供了更多空间来查看结果、更多对象的元数据，还提供了更多筛选器来用于缩小结果范围。

若要在“搜索结果”页上按对象类型、对象所有者或上次修改日期筛选搜索结果，请执行以下操作：

  1. 单击 Azure Databricks 工作区顶部栏中的“搜索”字段，或使用键盘快捷键 Command-P，然后按 Enter。

    “搜索结果”页随即打开。

  2. 输入搜索条件。

  3. 从列表中选择一个项。

可以按文本字符串和/或对象类型进行搜索。 当你键入搜索条件并按 Enter 后，系统会在你有权访问的工作区中搜索所有查询、仪表板、警报、文件、文件夹、笔记本、库、存储库、合作伙伴和市场列表的名称。 如果你的工作区启用了 Unity Catalog，则系统还会搜索表名、表注释、列名和列注释。

按文本字符串搜索

若要搜索文本字符串，请在搜索字段中键入字符串并按 Enter。 系统会在你有权访问的工作区中搜索所有对象的名称。 它还搜索笔记本命令中的文本，但不搜索非笔记本文件中的文本。

可以在搜索条目的两侧添加引号，以将搜索结果缩小为仅包含确切短语的文档。

完全匹配搜索支持以下内容：

  • 基本引号（例如 "spark.sql("）
  • 转义的引号（例如 "spark.sql(\"select"）

完全匹配搜索不支持以下内容：

  • 带引号和不带引号（例如 "spark.sql" partition）
  • 多个引号（例如 "spark.sql" "partition"）

重要

此功能目前以公共预览版提供。

你可以使用自然语言来搜索 Unity Catalog 表。 搜索将返回具有相关语义的结果。

例如，搜索查询“对于地理区域我应该用什么”会侧重于“地理区域”，并查找包含地理属性的相关术语，如城市、国家/地区、地域和地理位置。

该搜索还可以通过将可能是搜索词的内容与筛选器分离来理解搜索查询中的模式，这意味着自然语言查询功能更为强大。

例如，搜索查询“展示关于检查的表”会被分解，使得“检查”成为关键术语，而“表”成为用户要搜索的对象类型。

将搜索限制为特定对象类型

在“搜索结果”页上，可以通过从“类型”下拉列表或页面右侧的选项卡中单击对象类型来按类型（例如文件、文件夹、笔记本、库、表或存储库）搜索项目。 文本字符串不是必需的。 如果你将文本字段留空，然后按 Enter，系统会搜索该类型的所有对象。 单击列表中的某个名称可在工作区中打开该项目。 你还可以使用下拉菜单进一步缩小特定类型项目的搜索结果，例如按所有者或上次修改日期。

你还可以在 UI 顶部的搜索栏中在搜索查询中指定筛选器。 例如，你可以在搜索查询中包括以下内容来搜索你拥有的表：type:table owner:me。 若要详细了解如何通过语法指定筛选器，请在“搜索结果”页上应用筛选器，并查看搜索栏中的查询如何自动更新。

热门程度

搜索使用热度信号（基于工作区中其他用户与特定表进行交互的频率）来改进表的排名方式。

如果不使用热度提升，你将不得不查询搜索结果中返回的表，才能知道哪一个是权威表。 通过人气提升，最受欢迎的表排名更高，这样你就不必猜测哪一个是正确的。 搜索结果中表名旁边的热度指示符 “热门程度指示器”图标 反映了对象排名。 你还可以按热度对搜索结果进行排序。

知识卡片

当搜索能够以高置信度识别你要查找的内容时，排名靠前的搜索结果就变成了一张知识卡片。 知识卡片提供额外的对象元数据。 Unity Catalog 托管表支持知识卡片。

示例知识卡片

在已启用 Unity Catalog 的工作区中搜索表和模型

在启用了 Unity Catalog 的工作区中，可以搜索 Unity Catalog 中注册的表和模型。 可以搜索以下任意一项：

  • 表或模型名称。
  • 表或模型注释。
  • 表列名称。
  • 表列注释。

可以在“搜索结果”页中按父目录和数据库（架构）来筛选搜索结果。

还可以按表的流行度对结果进行排序。

搜索结果不包括：

  • 你无权查看的表和模型。

    换言之，要使某个表或模型显示在搜索结果中，你必须至少对该表拥有 SELECT 特权或对该模型拥有 EXECUTE 特权，对其父架构拥有 USE SCHEMA 特权，并对其父目录拥有 USE CATALOG 特权。 默认情况下，元存储管理员拥有这些特权。 必须向所有其他用户授予这些特权。 请参阅 Unity Catalog 特权和安全对象。

  • 旧版 Hive 元存储中（即 hive_metastore 目录中）的表。

    若要将这些表升级到 Unity Catalog 并使其可供搜索，请按照将表和视图升级到 Unity Catalog 中的说明操作。