藉助 Gemini 編寫 SQL 程式碼

本文說明如何使用Google Cloud的 AI 輔助協作工具 Gemini,在 Cloud SQL Studio 執行下列作業:

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

本文適用於熟悉 SQL、資料分析和 Cloud SQL 的資料庫管理員和資料工程師。如果您是 Cloud SQL 新手,請參閱「Cloud SQL 總覽」。

事前準備

  1. 如要完成本文件中的工作,請確認您具備必要的 Identity and Access Management (IAM) 權限。
  2. 確認 Cloud SQL Studio 的存取權。如果您無法存取 Cloud SQL Studio,請參閱「Cloud SQL Studio 必要的角色和權限」
  3. 選用:如要按照本文件中的範例操作,請使用下列結構定義建立 Singers 資料表:

    CREATE TABLE
    Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      SingerInfo VARBINARY(MAX),
      BirthDate  DATETIMEOFFSET
    );
    

    建立 Singers 資料表後,請按一下「重新整理」,更新資料庫結構定義。

必要角色和權限

如要取得完成本文件工作所需的權限,請要求管理員授予您專案的 Cloud SQL 管理員 (roles/cloudsql.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

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

您還需要下列權限:

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

您可以向 Gemini 提供自然語言註解 (或提示),根據結構定義生成查詢。舉例來說,您可以提示 Gemini 根據下列提示生成 SQL:

  • 「在 Singers 資料表新增名為 birthday 的日期資料欄。」
  • 「有多少歌手是在 90 年代出生?」

如果結構定義有變更 (例如新增資料表或資料欄),請先點選「重新整理」圖示 更新結構定義,再使用 Gemini。

如要在 Cloud SQL 中使用 Gemini 輔助功能生成 SQL,請按照下列步驟操作:

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

    前往 Cloud SQL

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

  3. 在導覽選單中,按一下「Cloud SQL Studio」。

  4. 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。「Explorer」窗格會顯示資料庫中的物件清單。

  5. 在工作列中,按一下「settings_suggestionGemini」,查看 Cloud SQL 中的 Gemini 功能。

  6. 確認已啟用「產生查詢註解」。

  7. 如要查詢資料庫,請按一下「New SQL editor tab」(新增 SQL 編輯器分頁) 。

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

    例如,輸入下列提示詞:

    -- add a row to table singers
    

    按下 Return 或 Enter 鍵。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'
    
    
  9. 查看 SQL 建議,然後執行下列任一操作:

    • 如要查看接受 Gemini 生成 SQL 的選項,請將滑鼠游標懸停在查詢上。系統會顯示下列選項:
      • 接受:如要接受建議的查詢,請按下 Tab,然後點選「執行」。
      • 接受字詞:如要接受部分建議查詢,請按下 Control+Right arrow 鍵 (macOS 則為 Command+Right arrow 鍵),然後點按「執行」。
    • 如要編輯原始 SQL,請按下 Tab,編輯 SQL,然後按一下「Run」(執行)。
    • 如要關閉建議,請按下 Esc 鍵或繼續輸入。

「幫我寫程式碼」的工具

如要使用「幫我寫程式碼」工具,請按照下列步驟操作:

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

    前往 Cloud SQL

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

  3. 在導覽選單中,按一下「Cloud SQL Studio」。

  4. 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。「Explorer」窗格會顯示資料庫中的物件清單。

  5. 如要查詢資料庫,請按一下 「New tab」(新增分頁)。

  6. 按一下查詢編輯器旁的「settings_suggestion 幫我寫程式碼」。

  7. 在「幫我寫程式碼」視窗中輸入提示。例如,add a row to table singers,然後點選「生成」。

    Gemini 會生成類似下列內容的 SQL:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
    VALUES (1, Alex, 'M.', '1977-10-16');
    
  8. 查看生成的 SQL,然後採取下列任一動作:

    • 如要接受 Gemini 生成的 SQL,請按一下「Insert」(插入),將陳述式插入查詢編輯器。然後點選「執行」,執行建議的 SQL。
    • 如要問問 Gemini 生成新查詢,請按一下「Edit」(編輯)。修改提示後,按一下「更新」。接著,您可以決定接受新生成的陳述式,或關閉建議。
    • 如要關閉建議,請關閉「幫我寫程式碼」視窗。

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

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

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

    前往 Cloud SQL

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

  3. 在導覽選單中,按一下「Cloud SQL Studio」。

  4. 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。「Explorer」窗格會顯示資料庫中的物件清單。

  5. 如要查詢資料庫,請按一下 「New tab」(新增分頁)。

  6. 在查詢編輯器貼上要 Gemini 說明的查詢。

  7. 反白選取要讓 Gemini 說明的查詢,然後按一下「astrophotography_mode Explain this selected query」(說明所選查詢)。

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

使用 Gemini 修正查詢中的錯誤

Gemini 現在提供擴充功能,可協助您修正 Cloud SQL 查詢中的錯誤,不必離開 Cloud SQL Studio。

Gemini 的 AI 輔助功能已整合至 Cloud SQL Studio,可提供下列優勢:

  • 在 Cloud SQL Studio 編輯器中,逐行比較原始查詢和套用建議變更的新查詢。
  • 醒目顯示原始查詢中可能導致問題的部分,並以自然語言提供變更摘要。
  • 參考與查詢相關的確切錯誤訊息和結構定義資訊,提供準確、相關的修正建議。
  • 不必仰賴第三方一般用途 LLM,這類模型可能無法提供精細的協助,也可能讓資料暴露於潛在的安全風險。
  • 更快速有效率地排解常見問題,例如語法、結構定義和執行階段錯誤。

所需權限

開始之前,請確認您具備下列權限:

使用 Gemini 和 Cloud SQL Studio 修正查詢

如要使用 Gemini 功能修正 Cloud SQL Studio 查詢中的特定錯誤,請完成下列步驟:

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

    前往 Cloud SQL

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

  3. 在導覽選單中,按一下「Cloud SQL Studio」。

  4. 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。「Explorer」窗格會顯示資料庫中的物件清單。

  5. 在工作列中,按一下「settings_suggestionGemini」,查看 Cloud SQL 中的 Gemini 功能。

  6. 如要查詢資料庫,請按一下 「New tab」(新增分頁)。

  7. 在查詢編輯器中,輸入可能不正確或不完整的查詢。

  8. 按一下「執行」。

    如果查詢有問題,系統會傳回錯誤。

    舉例來說,傳回的訊息可能是「Run」(執行) 分頁中的驗證錯誤,或「Results」(結果) 分頁中的錯誤訊息。

  9. 按一下「修正」。

  10. 在查詢視窗中,分頁會開啟差異編輯器,逐行比較現有查詢和建議變更。查詢編輯器也會提供建議編輯內容的摘要。查看建議的查詢變更,並視需要更新。接著,接受並執行新查詢:

    按一下「接受並執行」。

限制

後續步驟