在 Gemini 的协助下编写 LookML

此文档页面介绍了如何在 LookML 项目中使用 Gemini 辅助功能来创建维度、维度组和测量。根据书面提示生成 LookML 代码建议是 Gemini in Looker 的一项功能，可在 Looker（原始版本）和 Looker (Google Cloud Core) 实例中使用。

Gemini in Looker 提供依托生成式 AI 赋能的辅助功能，帮助您处理数据。

了解 Gemini for 如何以及何时使用您的数据。 Google Cloud

本页面适用于 Looker 开发者。

准备工作

如需在 Looker IDE 中使用 Gemini，请注意以下要求：

• 必须为您的 Looker 实例启用 Gemini in Looker：
  • 对于 Looker（原始版本），实例必须运行 Looker 25.2 或更高版本，并且实例必须在管理员设置中启用 Gemini in Looker 和 LookML 助理 设置。如需查看详细的启用说明，请参阅管理员设置 - Gemini in Looker文档页面。
  • 对于 Looker (Google Cloud Core)，必须在控制台中为实例启用 Gemini in Looker。 Google Cloud 还必须为您的实例启用 LookML 助理 。如需查看详细的启用说明，请参阅在 Looker (Google Cloud Core) 实例上管理 Gemini 文档页面。
• 您必须分配有相应的 Looker 角色，该角色需包含 LookML 项目中至少一个模型的 develop 权限。
• 您必须分配有相应的角色，该角色需包含 LookML 项目中至少一个模型的 gemini_in_looker 权限。

在 Looker IDE 中使用 Gemini

如需使用 Gemini 在 Looker 项目中创建 LookML，请按以下步骤操作：

1. 在 Looker 实例中，启用 开发模式。
2. 在 Looker IDE 中打开项目。
3. 使用 IDE 文件浏览器 打开您要插入 LookML 的 LookML 视图文件。

4. 从侧边栏选择器中选择帮我编码 图标。

   

5. 打开帮我编码 面板后，点击以将光标置于 LookML 视图文件中的某一行。Gemini 会根据 LookML 文件的类型以及光标在文件中的位置，提供适当的选项来引导您，例如创建维度 或创建测量 。

6. 从帮我编码 面板中选择以下选项之一：

   • 创建维度组
   • 创建维度
   • 创建测量
   • 其他代码建议：如果您想尝试不同的 LookML 元素，可以使用其他代码建议选项。请注意，Gemini 是一项尚处于发展早期的技术，因此请在部署之前验证和测试所有输出。

7. 在帮我编码 面板文本字段中，使用对话语言描述您要创建的维度、维度组或测量。如需获得指导，请参阅本页面的在 Looker IDE 中使用 Gemini 的提示和示例提示部分。

8. 按 Enter 键或点击提交 图标，将请求发送给 Gemini。Gemini 会在回答中提供建议的代码。

9. 有了建议的代码，您可以执行以下操作：

   • 将指针悬停在插入 按钮上，以在文件中预览建议的 LookML。您可以将光标移到文件中的其他行，以便在将 LookML 插入文件之前在其他位置预览它。
   • 点击修改 按钮，手动更改建议的 LookML。
   • 点击插入 按钮，将 LookML 插入到文件中光标所在的位置。
   • 通过选择“我喜欢”图标（此回答很有帮助 ）或“不喜欢”图标（此回答不是我想要的 ），提供有关建议代码的反馈。
   • 点击新代码建议 链接，重新开始并为 Gemini 输入新的提示。

   

10. 在 LookML 文件中点击保存更改 。

11. 通过执行以下操作来验证 LookML：

    • 使用 LookML 验证器 验证 LookML。
    • 在“探索”中测试 LookML。

在 Looker IDE 中使用 Gemini 的提示

以下是在 Looker IDE 中使用 Gemini 的一些提示：

• 为获得最佳结果，请使用美式英语编写提示。如需了解详情，请参阅 Gemini for Google Cloud 限制文档。
• 帮我编码 面板不会保留对话中上一个提示的上下文，也不会在登录和刷新时保留提示。
• 使用 Gemini 建议的 LookML 时，请务必使用 LookML 验证器验证 LookML，并在“探索”中测试新字段。
• 根据您的请求，Gemini 可能会建议引用其他视图文件中的字段的 LookML。将建议的 LookML 添加到文件后，请保存该文件并运行 LookML 验证器。如果您需要向模型文件添加 include 语句，LookML 验证器将显示错误。

示例提示

为了给您一些想法，下面提供了一些示例提示及其结果：

• 使用经度和纬度创建维度
• 创建今日总销售额的测量

使用经度和纬度创建维度

以下提示使用了创建维度 选项，要求 Gemini 根据视图文件中定义的 longitude 和 latitude 字段创建新维度：

show coordinates with longitude and latitude

Gemini 会返回以下建议的代码：

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

您可以在“探索”中选择新的 coordinates 字段以及它所基于的 longitude 和 latitude 字段来验证此 LookML。由于 Gemini 使用 type:location 创建了维度，因此“探索”结果包含一个超链接，用于在地图上查看坐标：

创建今日总销售额的测量

以下提示使用了创建度量 选项，要求 Gemini 创建一个新度量，用于计算今日所有订单的总和：

show the total sale price of today's orders

Gemini 会返回以下建议的代码：

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

提供反馈

您可以在帮我编码 面板中为生成的 LookML 提供反馈。如果生成的 LookML 看起来正确，请点击 thumb_up“我喜欢”图标。如果生成的 LookML 看起来不正确或不是您想要的，请点击 thumb_down “不喜欢”图标。

相关资源

• 详细了解 Gemini for Google Cloud
• 详细了解 Gemini in Looker