在 Cloud SQL Studio 中管理內容集

本文說明如何在 MySQL 適用的 Cloud SQL Studio 中，使用情境集檔案建立情境集。專案中的情境集名稱不得重複。

如要瞭解情境集，請參閱「情境集總覽」。

事前準備

請先完成下列前置作業，再建立代理。

啟用必要服務

為專案啟用下列服務：

準備 Cloud SQL 執行個體

必要角色和權限

  • 在執行個體層級新增 IAM 使用者或服務帳戶。詳情請參閱「為使用者、服務帳戶或群組新增 IAM 政策繫結」。
  • 在專案層級，將 cloudsql.studioUser、cloudsql.instanceUser 和 geminidataanalytics.queryDataUser 角色授予 IAM 使用者或服務帳戶。詳情請參閱「新增專案的 IAM 政策繫結」。
  • 如要建立、上傳及管理情境集，請在專案層級，將 Dataplex Catalog 編輯者 (roles/dataplex.catalogEditor) 或 Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin) 角色授予 IAM 使用者或服務帳戶。詳情請參閱「情境組合權限」。
  • 您必須請具備特殊權限的使用者，將資料庫權限授予 IAM 使用者或服務帳戶。

    GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";。

    詳情請參閱「將資料庫權限授予個別 IAM 使用者或服務帳戶」。

將 executesql 權限授予 Cloud SQL 執行個體

執行下列指令，將 executesql 權限授予 Cloud SQL 執行個體，並啟用 Cloud SQL Data API： 
gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
更改下列內容：
  • PROJECT_ID： Google Cloud 專案的 ID。
  • INSTANCE_ID：Cloud SQL 執行個體的 ID。
如要執行本教學課程中的步驟，請登入 Google Cloud，然後使用 IAM 驗證機制向資料庫進行驗證。

建立脈絡資料集

如要建立情境組合，請按照下列步驟操作：

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

    前往 Cloud SQL

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

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

  4. 使用 IAM 驗證機制登入 Studio。

  5. 在「Explorer」窗格中，點選「情境集」旁邊的「查看動作」。

  6. 按一下「建立情境組合」。

  7. 在「Context set name」(脈絡資料集名稱) 中，提供不重複的脈絡資料集名稱。情境集名稱區分大小寫，可以使用英文字母、數字、連字號和底線，名稱長度必須介於 4 至 30 個字元。

    脈絡資料集 ID 是由脈絡資料集名稱衍生而來，但不一定相同。系統會將脈絡資料集名稱轉換為小寫，並以 - 字元取代非英數字元，做為脈絡資料集 ID。舉例來說，脈絡資料集名稱 querydata_e2e_test 的脈絡資料集 ID 為 querydata-e2e-test。

  8. 選用。在「Context set description」(情境集說明) 中，新增情境集的說明。

  9. 選用。如要上傳情境集檔案，請按一下「上傳情境集檔案」部分的「瀏覽」，然後選取情境集檔案。

  10. 點選「建立」。

建立脈絡資料集

建立脈絡資料集後，請按照「使用 Gemini CLI 建構脈絡資料」一節的步驟建立脈絡資料集檔案。接著，您可以編輯情境集，上傳情境集檔案。

編輯脈絡資料集

如要編輯情境組合，請按照下列步驟操作：

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

    前往 Cloud SQL

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

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

  4. 使用 IAM 驗證機制登入 Studio。

  5. 找到要編輯的情境組合，然後按一下旁邊的「查看動作」。

  6. 按一下「Edit context set」(編輯情境集)。

  7. 選用。編輯「Context set description」(脈絡資料集說明)。

  8. 按一下「Upload context set file」(上傳情境集檔案) 專區中的「Browse」(瀏覽)，然後選取情境集檔案。

  9. 按一下「儲存」。

刪除脈絡資料集

如要刪除情境組合，請按照下列步驟操作：

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

    前往 Cloud SQL

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

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

  4. 使用 IAM 驗證機制登入 Studio。

  5. 找出要刪除的情境組合，按一下旁邊的「查看動作」。

  6. 按一下「刪除脈絡資料集」。

  7. 在「刪除脈絡資料集」確認對話方塊中，輸入脈絡資料集的 ID。

  8. 按一下「確認」，刪除情境組合。

後續步驟