LookML 对象的元数据

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

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

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

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

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

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

模型的元数据

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

  • 信息中心：列出模型中包含的所有 LookML 信息中心，并提供指向 LookML 项目中定义的链接
  • 探索：列出模型中包含的所有探索，并提供指向 LookML 项目中定义的链接
  • 视图：列出模型中包含的所有视图，并提供指向 LookML 项目中定义的链接

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

视图的元数据

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

  1. 视图名称和详细信息：视图名称和代表视图对象类型的图标（如需查看所有可能的对象类型图标，请参阅使用对象浏览器面板浏览项目文档页面）。元数据面板还会提供文件名和行号，其中显示了视图在文件的 LookML 中的定义位置（以及指向项目中视图的链接）。
  2. 在 [number] 个模型中使用菜单：显示包含此视图的模型列表，其中 [number] 表示包含该视图的模型的数量。例如，如果某个视图在两个模型中使用，元数据面板会显示文本在 2 个模型中使用 。
  3. 主键：视图的主键。
  4. 基本视图：将此视图用作基本视图的探索。
  5. 联接至：此视图联接到的探索。

如果视图有扩展或优化，这些内容也会显示在元数据面板中。

探索的元数据

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

  1. 探索名称和详细信息：探索名称和代表其对象类型的图标（如需查看所有可能的对象类型图标，请参阅使用对象浏览器面板浏览项目文档页面）。元数据面板还会提供文件名和行号，其中显示了探索在文件的 LookML 中的定义位置（以及指向项目中探索的链接）。
  2. 基本视图：探索的基本视图（用作构建探索的出发地的视图）。
  3. 联接的视图：联接到基本视图的其他视图。

如果探索有扩展或优化，这些内容也会显示在元数据面板中。

字段的元数据

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

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

扩展的元数据

在 LookML 代码编辑器中选择 view 或 explore 参数时，元数据面板的 扩展自 部分会显示该对象的任何 扩展。

例如，假设以下示例 LookML 代码适用于一个模型文件，其中 aircraft_extended 探索扩展了 aircraft 探索：

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 文件浏览器中“导入的项目”文件夹中的对象，以查看有关导入文件的元数据。