持续集成 (CI) 内容验证器会识别存在错误的信息中心和 Look。这些错误通常是因缺少对 LookML 字段的引用而导致的。
CI 内容验证器执行的验证与 标准 Looker 内容验证器 类似,但存在一些差异:
CI 内容验证器支持以下功能:
- 您可以将 CI 内容验证器配置为在 Looker 开发者向 LookML 代码库提交拉取请求时自动运行,或者在您手动运行 CI 套件时手动运行。
- 您可以将 CI 内容验证器结果限定为特定 Looker 内容文件夹,或限定为 LookML 项目中的特定模型和探索。默认情况下,CI 内容验证器的结果会自动限定为您的 LookML 项目。CI 内容验证器限定是后处理:验证器在整个 Looker 实例上运行,然后将结果过滤为您在创建 CI 套件时指定的限定。
标准 Looker 内容验证器支持以下功能:
- 您只能手动运行 Looker 内容验证器。
- 您可以将 Looker 内容验证器限定为特定 Looker 内容文件夹,或限定为特定 LookML 项目。Looker 内容验证器限定发生在验证之前:验证器仅在您启动内容验证时指定的文件夹和项目上运行。
- 您可以使用 Looker 内容验证器替换字段、视图、探索和模型的名称,移除字段,以及删除 Look。
如需详细了解在创建或修改 CI 套件时可以配置的选项,请参阅本页面的内容验证器选项部分。如需了解如何运行内容验证器,请参阅运行持续集成套件文档页面。
在 运行结果页面上,内容验证器会为每个出错的 Look 或信息中心提供错误消息,以及指向内容的链接:

内容验证器选项
您可以在创建持续集成套件时指定多个选项,以配置内容验证器的运行方式。本页面的以下部分介绍了这些选项:
要查询的探索
默认情况下,内容验证器会对 LookML 项目中的所有模型和探索运行内容验证。
您可以使用要查询的探索 字段指定要包含在内容验证中的探索和模型。
您可以采用以下格式指定探索:model_name/explore_name
例如,如需在 thelook.model.lkml 文件中指定名为 users 和 orders 的探索,您需要输入以下内容:thelook/users, thelook/orders
如需详细了解如何在此字段中指定探索和模型,以及相关示例,请参阅 SQL 验证器 文档页面。
要排除的探索
默认情况下,内容验证器会对 LookML 项目中的所有模型和探索运行内容验证。
您可以使用要排除的探索 字段指定要从内容验证中排除的探索和模型。
您可以采用以下格式指定探索:model_name/explore_name
如需详细了解如何在此字段中指定探索和模型,以及相关示例,请参阅 SQL 验证器 文档页面。
要验证的文件夹
您可以指定文件夹 ID 或以英文逗号分隔的文件夹 ID 列表,将内容验证限定为 Looker 实例上的特定内容文件夹。
如需获取文件夹的 ID,请使用 Looker 主导航菜单打开该文件夹,然后从浏览器网址中获取文件夹 ID。文件夹 ID 是网址的最后一个元素。例如,在以下网址中,文件夹 ID 为 45:
https://myinstance.looker.com/folders/45
要排除的文件夹
您可以在要排除的文件夹 字段中指定文件夹 ID 或逗号分隔的文件夹 ID 列表,从内容验证中排除特定内容文件夹。
排除个人文件夹中的内容
如果您希望内容验证器仅验证共享文件夹中的内容,请启用排除个人文件夹中的内容 字段。启用排除个人文件夹中的内容 字段后,内容验证器将忽略 Looker 实例上个人文件夹中的内容。
增量验证
增量验证是一种用于查找特定开发分支中独有的错误(在生产环境中尚不存在)的方法。增量验证有助于开发者查找和修复自己负责的错误,而不会因项目中的现有错误而分心,并且还可以加快验证速度,尤其是对于包含大量探索的 LookML 项目。
在验证器结果中,内容验证器会指明每个被跳过的探索,因为在被验证的分支或提交中,其编译后的 SQL 没有更改。如需查看增量验证结果的示例,请参阅查看增量验证的结果。
您可以在创建或修改持续集成套件时,在内容验证器 部分中选中仅增量错误 复选框,为内容验证器启用增量验证。
请注意以下有关增量验证的信息:
- 当内容验证器验证生产分支本身时(例如在生产分支上手动运行时),增量验证设置不适用。在验证生产分支时,内容验证器会显示完整的结果验证。
内容验证的限制
如果您删除模型或更改其名称,内容验证器不会返回这些“悬空”内容错误,因为该模型无法再与正在测试的项目相关联。