本文說明如何使用 Gemini Code Assist,在 Spanner 中取得 AI 輔助功能,協助您完成下列工作:
瞭解 Gemini for Google Cloud 如何使用您的資料。
本文適用於熟悉 Spanner、SQL 和資料分析的資料庫管理員和資料工程師。如果您是 Spanner 新手,請參閱使用 Google Cloud 控制台建立及查詢資料庫。
事前準備
選用步驟:設定 Gemini Code Assist。
如要完成本文中的工作,請確認您具備必要的 Identity and Access Management (IAM) 權限。
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體。
選取資料庫。
在導覽選單中,按一下「Spanner Studio」。
在工作列中,按一下「pen_spark Gemini」,即可查看 Spanner 中的 Gemini 功能。
選用:如要跟著本文中的範例操作,請先按照「為資料庫建立結構定義」一文的說明,建立
Singers資料表。
如要在 Spanner 中停用 Gemini 功能,請重複上述步驟,然後取消選取要停用的 Gemini 功能。
必要的角色
如要取得完成本文件工作所需的權限,請要求管理員在專案中授予您「Gemini for Google Cloud 使用者 」(roles/cloudaicompanion.user) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
使用自然語言提示詞生成 SQL 查詢
您可以提供自然語言註解 (或提示) 給 Gemini,要求根據結構定義產生查詢。舉例來說,您可以提示 Gemini 根據下列提示生成 SQL:
- 「請建立表格,追蹤顧客滿意度問卷調查結果。」
- 「Add a date column called birthday to the Singers table.」(在 Singers 資料表中新增名為「birthday」的日期欄。)
- 「有多少歌手出生於 90 年代?」
如要在 Spanner 中透過 Gemini 輔助生成 SQL,請按照下列步驟操作:
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體。
選取資料庫。
在導覽窗格中,按一下「Spanner Studio」。「Explorer」窗格會顯示資料庫中的物件清單。
如要查詢資料庫,請按一下「New SQL editor tab」(新的 SQL 編輯器分頁)。確認已啟用 SQL 生成功能。
如要生成 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'查看生成的 SQL 查詢,然後進行下列任一操作:
- 如要接受 Gemini 生成的 SQL,請按下
Tab,然後點選「執行」來執行建議的 SQL。 - 如要編輯 Gemini 生成的 SQL,請按下
Tab,編輯 SQL,然後點選「執行」。 - 如要關閉建議,請按下
Esc鍵或繼續輸入。
- 如要接受 Gemini 生成的 SQL,請按下
在查詢編輯器中說明 SQL 陳述式
您可以使用 Gemini in Spanner,以自然語言說明 SQL 查詢。對於複雜或冗長的查詢,這項說明功能可協助您瞭解語法、基礎結構定義和業務情境。
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體。
選取資料庫。
在導覽窗格中,按一下「Spanner Studio」。
如要查詢資料庫,請按一下「新分頁」。
在查詢編輯器中貼上查詢。
反白選取要讓 Gemini 說明的查詢,然後按一下「spark 說明這項查詢」。
SQL 說明會顯示在「Gemini」窗格中。