在 Cloud SQL Studio 中管理內容集

本文說明如何使用內容集檔案，在 PostgreSQL 適用的 Cloud SQL Studio 中建立內容集。資料庫中的情境集名稱不得重複。

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

事前準備

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

啟用必要服務

為專案啟用下列服務：

準備 Cloud SQL 執行個體

請確認您可以存取現有的 Cloud SQL 執行個體，或建立新的執行個體。詳情請參閱「建立 Cloud SQL 執行個體」。

您必須在 Cloud SQL 執行個體中建立資料庫，才能進行本教學課程。詳情請參閱「在 Cloud SQL 執行個體上建立資料庫」

所需角色和權限

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

    GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;

    將 USER_NAME 替換為使用者的電子郵件地址。電子郵件地址含有特殊字元 (@ 和 .)，因此必須用引號括住。

    詳情請參閱「將資料庫權限授予個別 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：專案的 ID。 Google Cloud
  • 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」窗格中，按一下「Context sets」旁邊的「查看動作」。

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

  7. 在「脈絡資料集名稱」中，提供不重複的脈絡資料集名稱。內容集名稱會區分大小寫，且可包含英文字母、數字、連字號和底線。

  8. 選用。在「情境集說明」中，新增情境集的說明。

  9. 點選「建立」。

建立脈絡資料集

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

編輯脈絡資料集

如要編輯內容集，請按照下列步驟操作：

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

    前往 Cloud SQL

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

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

  4. 使用 IAM 驗證登入 Studio。

  5. 在「Explorer」窗格中，點選「Context sets」(內容集) 旁邊的「View actions」(查看動作)。

  6. 按一下「編輯內容集」。

  7. 選用。編輯脈絡資料集說明。

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

  9. 按一下 [儲存]。

刪除脈絡資料集

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

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

    前往 Cloud SQL

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

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

  4. 使用 IAM 驗證登入 Studio。

  5. 在「Explorer」窗格中，按一下「Context sets」旁邊的「查看動作」。

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

  7. 在「Delete context set」(刪除脈絡資料集) 確認對話方塊中，輸入脈絡資料集的名稱。

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

後續步驟