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。点击 Extended by(扩展方式)部分中的链接,直接导航到定义了 aircraft_extended 的 LookML。

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

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

在这些示例中,扩展和扩展 explore 参数在同一个文件中彼此相邻,但并不总是如此。通过查看参数是否扩展(尤其是扩展对象和扩展对象可能位于不同的 LookML 文件中)而言,这一点并不明显。无论对象是在何处定义的,元数据面板都会为您提供相关对象的上下文信息。

用于优化的元数据

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

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

已导入项目的元数据

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

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

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