在 Gemini 協助下編寫 LookML

本文件頁面說明如何在 LookML 專案中使用 Gemini 輔助功能建立維度、維度群組和指標。Gemini in Looker 功能可根據書面提示生成 LookML 程式碼建議，適用於 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。如需詳細啟用說明，請參閱「管理員設定 - Looker 中的 Gemini」說明文件頁面。
  • 如果是 Looker (Google Cloud Core)，則必須在 Google Cloud 控制台中為執行個體啟用 Gemini in Looker。如需詳細的啟用說明，請參閱「管理 Looker (Google Cloud Core) 執行個體上的 Gemini」說明文件頁面。
• 您必須獲派 Looker 角色，且該角色在 LookML 專案中至少有一個模型具備 develop 權限。
• 您必須獲派 Looker Gemini 角色。

在 Looker IDE 中使用 Gemini

如要在 Looker 專案中使用 Gemini 建立 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，並在 Explore 中測試新欄位。
• 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 建立維度，因此探索結果會包含超連結，方便您在地圖上查看座標：

建立今日總銷售額的指標

以下是使用「建立指標」選項的提示，要求 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 版 Looker