藉助 Gemini 編寫 SQL 程式碼

本文說明如何使用 Gemini Code Assist,在 Spanner 中取得 AI 輔助,以執行下列操作:

瞭解 Gemini for Google Cloud 如何使用您的資料,以及使用時機

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

事前準備

  1. 選用:設定 Gemini Code Assist

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

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

    前往 Spanner

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

  5. 選取資料庫。

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

  7. 在工作列中,按一下「pen_spark Gemini」,即可查看 Spanner 中的 Gemini 功能。

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

  9. 選用:如要跟著本文中的範例操作,請先按照「為資料庫建立結構定義」一文的說明,建立 Singers 資料表。

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

必要的角色

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

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

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

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

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

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

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

    前往 Spanner

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

  3. 選取資料庫。

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

  5. 如要查詢資料庫,請按一下「New SQL editor tab」(新的 SQL 編輯器分頁) 。確認已啟用 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'
    
    
  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 說明的查詢,然後按一下「spark 說明這項查詢」

    SQL 說明會顯示在「Gemini」窗格中。

後續步驟