本文說明如何使用 Gemini Code Assist,在 Spanner 中取得 AI 輔助,以執行下列操作:
瞭解 Gemini for Google Cloud 如何使用您的資料,以及使用時機。
本文適用於熟悉 Spanner、SQL 和資料分析的資料庫管理員和資料工程師。如果您是 Spanner 新手,請參閱使用 Google Cloud 控制台建立及查詢資料庫。
事前準備
如要完成本文中的工作,請確認您具備必要的 Identity and Access Management (IAM) 權限。
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體。
選取資料庫。
在導覽選單中,按一下「Spanner Studio」。
在工作列中,按一下「pen_spark Gemini」,即可查看 Spanner 中的 Gemini 功能。
選用:如要跟著本文中的範例操作,請先按照「為資料庫建立結構定義」一文的說明,建立
Singers
資料表。
如要在 Spanner 中停用 Gemini 功能,請重複上述步驟,然後取消選取要停用的 Gemini 功能。
必要的角色
如要取得完成本文工作所需的權限,請要求管理員授予您專案的 Gemini for Google Cloud User (roles/cloudaicompanion.user
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
使用自然語言提示生成 SQL 查詢
您可以提供自然語言註解 (或提示) 給 Gemini,根據結構定義產生查詢。舉例來說,您可以提示 Gemini 根據下列提示生成 SQL:
- 「請建立表格,追蹤顧客滿意度調查結果。」
- 「在 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」窗格中。