藉助 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 BYTEA,
  BirthDate  TIMESTAMPTZ
);

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

必要角色和權限

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

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

您還需要 cloudaicompanion.companions.generateChat 權限，才能在查詢編輯器中說明 SQL 陳述式，並使用 cloudaicompanion.companions.generateCode 權限協助編寫程式碼。

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

您可以向 Gemini 提供自然語言註解 (或提示)，產生根據結構定義產生的查詢。例如，您可以要求 Gemini 產生 SQL，以回應下列提示：

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

如果結構定義有變更 (例如新增資料表或欄)，請先按一下「重新整理」重新整理，更新結構定義，再使用 Gemini。

如要透過 Gemini 協助在 Cloud SQL 中產生 SQL，請按照下列步驟操作：

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

    前往 Cloud SQL

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

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

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

  5. 在工作列中，按一下 pen_spark「Gemini」Gemini，即可查看 Cloud SQL 中的 Gemini 功能。

  6. 確認已啟用產生查詢註解功能。

  7. 如要查詢資料庫，請按一下 「New SQL editor tab」。

  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)，然後點選「Run」。
    • 如要編輯原始 SQL，請按下 Tab、編輯 SQL，然後點選「Run」。
    • 如要關閉建議，請按下 Esc 鍵或繼續輸入。

「幫我寫程式碼」的工具

如要使用「Help me code」工具，請按照下列步驟操作：

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

    前往 Cloud SQL

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

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

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

  5. 如要查詢資料庫，請按一下 「New tab」。

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

  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，請按一下「插入」，將陳述式插入查詢編輯器。接著按一下「執行」，即可執行建議的 SQL。
    • 如要要求 Gemini 產生新查詢，請按一下「編輯」。編輯完提示後，請按一下「更新」。接著，您可以決定接受新產生的陳述式，或略過建議。
    • 如要關閉建議，請關閉「Help me code」視窗。

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

您可以使用 Cloud SQL 中的 Gemini，以自然語言說明 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 說明的查詢，然後按一下「spark」「說明這項查詢」。

    SQL 查詢的說明會顯示在 Gemini 對話視窗中。

後續步驟