藉助 Gemini 編寫 SQL 程式碼

預先發布版 — Gemini in Spanner

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

本文說明如何使用 Gemini Code Assist，在 Spanner 中取得 AI 輔助功能，協助您完成下列工作：

• 使用自然語言提示詞生成 SQL 查詢。
• 在查詢編輯器中說明 SQL 查詢。

瞭解 Gemini for Google Cloud 如何使用您的資料。

本文適用於熟悉 Spanner、SQL 和資料分析的資料庫管理員和資料工程師。如果您是 Spanner 新手，請參閱使用 Google Cloud 控制台建立及查詢資料庫。

注意：程式設計輔助功能是 Gemini Code Assist 的一部分，在納入 Gemini Code Assist Standard 版之前，可免費使用。 我們會在日後通知這項異動。屆時，您必須取得 Gemini Code Assist Standard 版授權，才能繼續在 Spanner Studio 中使用程式設計輔助功能。

事前準備

1. 選用步驟：設定 Gemini Code Assist。

2. 如要完成本文中的工作，請確認您具備必要的 Identity and Access Management (IAM) 權限。

3. 前往 Google Cloud 控制台的「Spanner」頁面。

   前往 Spanner

4. 從清單中選取執行個體。

5. 選取資料庫。

6. 在導覽選單中，按一下「Spanner Studio」。

7. 在 Spanner Studio 中，按一下「設定建議」settings_suggestion「Gemini Code Assist」按鈕，即可在 Spanner 中查看 Gemini 功能。

8. 選取要啟用的 Gemini 功能，例如「註解轉查詢生成」。您可以自行選取並試用功能，不會影響專案中的其他協作者。

9. 選用：如要跟著本文中的範例操作，請先建立 Singers 資料表，詳情請參閱「為資料庫建立結構定義」。

如要在 Spanner 中停用 Gemini 功能，請重複上述步驟，然後取消選取要停用的 Gemini 功能。

必要的角色

如要取得完成本文中工作所需的權限，請要求管理員授予您專案的「Gemini for Google Cloud 使用者 」(roles/cloudaicompanion.user) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

使用自然語言提示詞生成 SQL 查詢

Gemini for Google Cloud產品仍處於早期技術階段，因此可能會生成看似合理卻與事實不符的輸出內容。使用輸出內容前，請一律確認 Gemini for Google Cloud 產品輸出內容是否屬實。詳情請參閱「Gemini for Google Cloud 和負責任的 AI 技術」。

您可以提供自然語言註解 (或提示) 給 Gemini，要求根據結構定義產生查詢。舉例來說，您可以提示 Gemini 根據下列提示生成 SQL：

• 「建立追蹤顧客滿意度調查結果的表格。」
• 「在 Singers 表格中新增名為 birthday 的日期欄。」
• 「有多少歌手出生於 90 年代？」

注意： 在 Spanner 中輸入 Gemini 提示時，系統會將資料庫結構定義的相關資訊納入提示。包括資料表和資料欄名稱、資料類型和資料欄說明。資料庫結構定義和資料會保留在 Spanner 中，不會傳送至 Gemini。

如要在 Spanner 中透過 Gemini 輔助生成 SQL，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Spanner」頁面。

   前往 Spanner

2. 從清單中選取執行個體。

3. 選取資料庫。

4. 在導覽窗格中，按一下「Spanner Studio」。「Explorer」窗格會顯示資料庫中的物件清單。

5. 如要查詢資料庫，請按一下「新分頁」。確認已啟用 SQL 生成功能。

6. 如要生成 SQL，請在查詢編輯器中輸入註解，開頭為 --，後面接著單行註解，然後按下 Return。

   舉例來說，如果您輸入提示詞 -- add a row to table singers 並按下 Return，Gemini 會生成類似下列內容的 SQL 程式碼：

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   如要繼續使用 Singers 資料表的範例，請輸入提示 -- show all singers born in the 70s，然後 Gemini 會生成類似下列內容的 SQL：

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   
   

   注意： 每次輸入相同提示時，Gemini 可能會建議不同的語法。

7. 查看生成的 SQL 查詢，然後進行下列任一操作：

   • 如要接受 Gemini 生成的 SQL，請按下 Tab，然後點選「執行」來執行建議的 SQL。
   • 如要編輯 Gemini 生成的 SQL，請按下 Tab，編輯 SQL，然後點選「執行」。
   • 如要關閉建議，請按下 Esc 鍵或繼續輸入。

在查詢編輯器中說明 SQL 陳述式

您可以使用 Gemini in Spanner，以自然語言說明 SQL 查詢。對於複雜或冗長的查詢，這項說明功能可協助您瞭解語法、基礎結構定義和業務情境。

1. 前往 Google Cloud 控制台的「Spanner」頁面。

   前往 Spanner

2. 從清單中選取執行個體。

3. 選取資料庫。

4. 在導覽窗格中，按一下「Spanner Studio」。

5. 如要查詢資料庫，請按一下「新分頁」。

6. 在查詢編輯器中貼上查詢。

7. 反白選取要讓 Gemini 說明的查詢，然後按一下 astrophotography_mode「說明這項查詢」。

   SQL 說明會顯示在 Gemini Cloud Assist 窗格中。

使用 Gemini 修正查詢中的錯誤

預先發布版 — Gemini Code Assist

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。您可以按照《Cloud 資料處理附加條款》規定的方式，處理這項功能會使用的個人資料，但請遵守 Google Cloud 使用協議中的義務和限制。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

Gemini 提供擴充功能，可協助您修正 Spanner 查詢中的錯誤，不必離開查詢編輯器。

Gemini 的 AI 輔助功能已整合至 Spanner Studio，可提供下列優點：

• 使用查詢編輯器，並排比較原始查詢和建議變更的新查詢。
• 醒目顯示原始查詢中可能導致問題的區隔，並以自然語言提供變更摘要。
• 參考與查詢相關聯的確切錯誤訊息和結構定義資訊，提供準確且相關的修正建議。
• 不必再依賴第三方通用 LLM，這類模型提供的協助可能不夠細緻，也可能導致資料暴露於潛在安全風險中。
• 針對語法、結構定義和執行階段錯誤等常見問題，提供更快速有效率的疑難排解方式。

所需權限

開始前，請確認您具備下列權限：

• 「必要的角色」一節中列出的角色。
• Gemini for Google Cloud API 權限， cloudaicompanion.googleapis.com/instances.generateCode。

使用 Gemini 修正查詢

如要使用 Gemini 的功能修正查詢中的特定錯誤，請完成下列步驟：

1. 在查詢編輯器中執行查詢。

   如果查詢含有錯誤，編輯器底部的錯誤橫幅會顯示錯誤訊息。

2. 按一下「修正」。

   查詢視窗會在分頁中開啟差異編輯器 (「差異編輯器」)，逐行比較現有查詢與建議的變更。查詢編輯器也會提供建議的編輯內容摘要。

3. 查看建議的查詢變更，並視需要更新。

4. 如要接受變更並執行新查詢，請按一下「接受並執行」。

限制

• 這項功能只能在Google Cloud 控制台的 Spanner Studio 查詢編輯器中使用。
• 適用目前的 Gemini 脈絡窗口限制。

後續步驟

• 閱讀 Gemini for Google Cloud 總覽。
• 瞭解 Gemini 如何使用您的資料。