本页面介绍了创建新项目以及根据您的数据库自动生成基本模型的步骤。
还有其他选项可用于创建项目文件:您可以创建一个空白项目并手动创建其模型,也可以克隆现有的公共 Git 代码库,请参阅创建新的 LookML 项目文档页面。
从您的数据库自动生成模型
点击菜单栏中的 Develop,确认您处于开发模式。
从导航面板的 Develop 部分中选择 Projects。
在 LookML 项目页面中,选择 New LookML Project:
- 在 LookML 项目页面中,您可以查看所有项目及其各自的模型。您可以使用此页面创建、查看和配置项目。
在 New Project 对话框中,为您的项目指定选项:
- 为您的项目命名。
- 在起点中,选择从数据库架构生成模型。
- 从连接下拉菜单中,选择数据库连接的名称。
- 从 Build Views From 中,选择一个选项:
- 所有表:LookML 生成器为数据库中的每个表创建一个视图文件。
- 单个表:LookML 生成器为数据库中的一个表创建一个视图。如果您选择此选项,请输入数据库表的名称。
- 要仅为数据库中的一个架构生成文件,请在 Schemas 文本字段中输入架构的名称。您可以列出多个架构,并用英文逗号分隔。
- 如要在视图文件名中排除表前缀,请在 Ignore Prefixes 文本字段中输入数据库的前缀。此字段区分大小写。您可以列出多个前缀(用英文逗号分隔)。例如,您的表名为
dwh_orders
和DBS_users
。如果您在 Ignore Prefixes 文本字段中输入dwh, DBS
,则 Looker 会创建名为orders
和users
的视图文件。
点击创建项目。
- LookML 生成器会为项目创建一个模型文件,并为数据库中的每个表创建一个视图文件(除非另有指定)。然后,Looker 在 Looker IDE 中打开新项目。
- LookML 生成器会为视图和模型文件创建 IDE 文件夹。如果您的数据库具有多个架构,LookML 生成器会为架构创建一个文件夹。
对于 BigQuery 连接,如果您从数据库生成 LookML 项目,Looker 会使用 BigQuery 列元数据中的说明(如果有)自动填充字段说明。
该生成器还会为每个数据库表创建一个探索。如需开始查询数据,请使用探索面板选择探索的名称。
如需在创建项目后重命名项目,请参阅访问和修改项目信息文档页面的重命名项目部分。
您可以按照了解模型和查看文件文档页面中所述,手动为项目创建其他新模型,也可以按照本页面上如果需要配置模型部分所述,将模型配置为在生产环境中使用,还可以在创建新的 LookML 项目文档页面上找到进一步的说明。
生成或手动创建模型文件后,请参阅设置和测试 Git 连接文档页面,了解如何将 Looker 项目连接到 Git。您可以记录对 LookML 文件的更改并管理文件的版本。
改进了 LookML 生成
如果您的 Looker 管理员已启用经过改进的 LookML 生成实验室功能,那么当您从数据库生成项目时,Looker 会向您的项目添加其他元素:
- Looker 会向新项目添加 README 文件。README 文件包含 LookML 简介,以及可帮助新 LookML 开发者的链接和资源。
- Looker 向模型文件和每个视图文件添加了几种内嵌注释说明。
- 如果视图至少有一个
type: number
维度的名称中不含字符串id
,则 Looker 会创建type: sum
测量和type: average
测量,这两个维度均基于type: number
的第一个维度(其名称中不含字符串id
)。
如果需要配置模型
配置模型的用处如下:
- 它指定给定的模型名称引用特定项目中的特定模型。
- 它设置允许模型使用的连接。
如果管理员(或拥有 manage_models
或 manage_project_models
权限的开发者)处于开发模式,则不需要配置模型。这样,LookML 开发者便可以在开发模式下轻松工作。但是,如果模型配置存在,则任何查询都会受到该配置的限制,即使在开发模式下也是如此。
虽然 LookML 开发者会在模型文件中指定了所需的连接,但由管理员控制在 LookML 项目页面上允许哪些连接。如果模型指定使用的连接是模型配置中不允许的连接,则不允许该连接。
在以下情况下,模型必须具有配置:
- 模型首次推送到生产环境时。如果未配置该模型,一旦模型进入生产模式,对该模型的任何查询就会失败。首次将模型从开发模式推送到生产环境时,如果模型名称对于 Looker 实例而言是唯一的,则 Looker 会自动配置模型。但是,如果您在其他项目中配置了同名模型,Looker 不会自动配置该模型。
- 开发期间。如果您的开发者没有获得
manage_models
权限(包含在admin
角色中)或manage_project_models
权限,则必须先配置模型,然后这些开发者才能对该模型运行查询。您可以在模型存在或项目存在之前配置模型。然后,当 LookML 开发者创建项目和模型时,模型允许的连接已配置完毕,开发者可以成功运行查询。
借助 Looker,拥有 manage_models
或 manage_project_models
权限的开发者可在开发模式下对未配置的模型运行查询。Looker 通过在项目中搜索具有该名称的模型来实现此目的。使用该名称找到的第一个模型将用于运行查询。