本页面提供创建新项目以及从您的数据库自动生成基本模型的步骤。
您还可通过其他方式来创建项目文件:您可以创建空白项目并手动创建其模型,也可以克隆现有的公共 Git 代码库,请参阅创建新的 LookML 项目文档页面。
从您的数据库自动生成模型
点击菜单栏中的开发,并确认您处于开发模式。
从导航面板的 Develop 部分中选择 Projects。
在 LookML 项目页面中,选择新建 LookML 项目:
- 在 LookML 项目页面中,您可以查看所有项目及其各自的模型。您可以使用此页面创建、查看和配置项目。
在新建项目对话框中,为项目指定选项:
项目名称:为项目命名。请仔细选择项目名称,并将其视为项目的永久 ID,因为 Looker 通过以下方式使用项目名称:
- 为带有
project_id
参数的 API 调用标识项目。 - 在 Looker 实例的内部数据库中识别项目。
- 为了确定用于本地项目导入的项目。
- 如需在 LookML 项目页面上显示该项目。
- 在 Looker 导航面板的开发部分显示该项目。
- 作为项目文件网址的一部分。例如,在网址为
example.looker.com
的 Looker 实例上,您可以在以下网址找到名为ecommerce
的项目的项目清单文件:https://example.looker.com/projects/ecommerce/files/manifest.lkml
。
- 为带有
起点:选择从数据库架构生成模型。
Connection:从下拉菜单中选择数据库连接的名称。
Build View From:选择以下选项之一:
- 所有表:LookML 生成器会为数据库中的每个表创建一个视图文件。
- 单个表:LookML 生成器会为数据库中的一个表创建视图。如果您选择此选项,请输入数据库表的名称。
架构:要仅为数据库中的一个架构生成文件,请在架构文本字段中输入架构的名称。您可以列出多个架构(以英文逗号分隔)。
忽略前缀:如要从视图文件名中排除表前缀,请在忽略前缀字段中输入数据库的前缀。此字段区分大小写。您可以列出多个前缀,以英文逗号分隔。例如,您的表名为
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 通过在项目中搜索具有该名称的模型来实现此目的。使用该名称找到的第一个模型将用于运行查询。