LookML 对象的元数据

拥有 develop 权限的用户可以在 Looker IDE 元数据面板中查看这些对象的上下文相关信息。

如需在 Looker IDE 中查看元数据面板,请执行以下操作:

  1. 前往您的项目文件
  2. 如需打开快捷帮助面板,请选择快捷帮助图标
  3. 在 LookML 代码编辑器中,将光标放在元数据面板中您想要了解更多背景信息的对象上。
  4. 在快捷帮助面板中,选择元数据标签页,以打开元数据面板。

元数据面板会使用名称和表示对象类型的图标来标识对象(如需查看所有可能的对象类型图标,请参阅使用对象浏览器面板浏览项目文档页面)。

如果多个模型中使用了一个 LookML 对象,则元数据面板会提供下拉菜单,供您选择要查看其元数据的模型。

元数据面板中显示的信息取决于您选择的 LookML 对象的类型,以及所选对象在项目中的使用方式。您可以使用元数据更好地了解项目的许多方面,如以下部分所述。

模型的元数据

如果您选择模型文件,元数据面板会显示以下部分:

  • 信息中心:列出模型中包含的所有 LookML 信息中心,以及指向 LookML 项目中相应定义的链接
  • 探索:列出模型中包含的所有探索,以及指向 LookML 项目中相应定义的链接
  • 视图:列出模型中包含的所有视图,以及指向 LookML 项目中其定义的链接

每个部分的标题还会显示每种类型的对象的数量。

视图的元数据

如果您选择视图参数,则元数据面板会显示以下有关视图在项目中使用方式的信息:

  1. 视图名称和详细信息:视图名称和表示视图对象类型的图标(如需了解所有可能的对象类型图标,请参阅使用对象浏览器面板导航项目文档页面)。元数据面板还提供了在文件的 LookML 中定义视图的文件名和行号(以及指向项目中视图的链接)。
  2. “已在 [number] 个模型中使用”菜单:显示包含此视图的模型列表,其中 [number] 表示包含此视图的模型数量。例如,如果在两个模型中使用某个视图,则元数据面板会显示文本 Used in 2 models(在 2 个模型中使用)。
  3. 主键:视图的主键
  4. 基本视图:将此视图用作基本视图的探索。
  5. 加入了:探索此视图的加入情况。

如果数据视图包含附加信息优化内容,这些内容也会显示在元数据面板中。

探索的元数据

如果您选择 explore 参数,元数据面板会显示有关“探索”在项目中的使用方式的以下信息:

  1. “探索”名称和详细信息:“探索”名称和表示其对象类型的图标(如需查看所有可能的对象类型图标,请参阅使用“对象浏览器”面板浏览项目文档页面)。元数据面板还会提供文件的 LookML 中定义探索的位置(文件名和行号)以及指向项目中探索的链接。
  2. 基本视图:探索的基本视图(此视图可用作构建探索的起点)。
  3. 合并的视图:合并到基本视图的其他视图。

如果“探索”包含扩展程序优化内容,这些内容也会显示在元数据面板中。

字段的元数据

如果您选择某个字段,元数据面板会显示有关该字段在项目中的使用方式的以下信息:

  1. 字段名称和详细信息:字段名称和表示其对象类型的图标(如需查看所有可能的对象类型图标,请参阅使用对象浏览器面板浏览项目文档页面)。元数据面板还会显示字段的类型,并提供文件名以及文件的 LookML 中定义该字段的行号(以及指向项目中该字段的链接)。
  2. 用于 [number] 个模型菜单:显示包含此字段视图的模型列表。
  3. 存在于视图中:使用此字段的视图。

扩展程序的元数据

当您在 LookML 代码编辑器中选择 viewexplore 参数时,元数据面板的“Extended by”(扩展)部分会显示该对象的所有扩展

例如,请考虑使用 aircraft_extended 探索扩展 aircraft 探索的模型文件的以下 LookML 代码示例:

explore: aircraft {
  view_name: aircraft
  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

如果您为 aircraft 探索选择 LookML 定义,则元数据面板的“扩展方式”部分会列出 aircraft_extended。点击扩展部分中的链接,即可直接前往定义了 aircraft_extended 的 LookML。

如果您点击 aircraft_extended 探索的定义,则元数据面板会提供有关 aircraft 扩展探索的以下信息:

  • 合并的视图:列出已加入 aircraft 探索的所有视图。
  • 扩展:列出所选探索所扩展的对象。在本例中,这就是 aircraft 探索。

在这些示例中,扩展和扩展 explore 参数在同一个文件中彼此相邻,但并不总是如此。从参数中看不出它是否已扩展,尤其是因为被扩展的对象和扩展对象可能位于不同的 LookML 文件中。无论相关对象是在何处定义的,元数据面板都会为您提供相关对象的上下文。

用于优化的元数据

借助元数据面板,您可以轻松查看视图或探索对象的优化。元数据面板的优化部分会显示已添加到对象的优化数量,您可以使用相应链接前往每个优化的 LookML。

与扩展程序一样,您无法仅通过查看 LookML 来确定对象是否经过了优化,尤其是因为优化后的 LookML 可能位于其他文件中。通过元数据面板,您可以查看对象是否已优化;如果对象已经过优化,则您可以直接导航到 LookML 以进行优化。

已导入项目的元数据

元数据面板包含导入的项目中的对象的相关信息,其中包括指向定义了对象的导入文件的链接。例如,为基于导入的视图文件的探索选择 LookML 后,元数据面板中会显示导入的视图文件的信息。

在元数据面板中,您可以点击链接,前往定义该对象的导入文件。

此外,您还可以在 IDE 文件浏览器中点击“导入的项目”文件夹中的对象,查看导入文件的元数据。