在 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 角色，该角色需包含 LookML 项目中至少一个模型的 develop 权限。
  • 您必须被分配 Looker Gemini 角色。

在 Looker IDE 中使用 Gemini

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

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

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

    突出显示了“帮我写代码”图标的 Looker IDE。

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

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

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

  7. 在 Help me code 面板文本字段中，使用对话式语言描述您要创建的维度、维度组或指标。如需相关指导，请参阅本页上的在 Looker IDE 中使用 Gemini 的提示和提示示例部分。

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

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

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

    当光标悬停在“插入”按钮上时，Gemini 显示代码放置位置的预览。

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

  11. 通过执行以下操作来验证 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 ;;
   }

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

显示纬度和经度字段的 Looker 探索，其中包含与纬度和经度值匹配的新坐标字段。

创建用于衡量今天总销售额的指标

以下是一个使用创建指标选项的提示，该提示要求 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。