在 AlloyDB Studio 中管理內容集

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

如要瞭解內容集，請參閱「內容集總覽」。

事前準備

建立代理程式前，請先完成下列先決條件。

啟用必要服務

為專案啟用下列服務：

準備 AlloyDB for PostgreSQL 叢集、執行個體和資料庫

請確認您有權存取現有的 AlloyDB 叢集和執行個體，或建立新的叢集和執行個體。
如要完成本教學課程，您必須在 AlloyDB 執行個體中建立資料庫。 詳情請參閱「建立資料庫」。

必要角色和權限

  • 在資料庫層級將 Identity and Access Management (IAM) 使用者或服務帳戶新增至叢集。詳情請參閱「管理資料庫使用者」。
  • 在專案層級將 alloydb.databaseUser、serviceusage.serviceUsageConsumer 和 geminidataanalytics.queryDataUser 角色授予 IAM 使用者。詳情請參閱「為專案新增 IAM 政策繫結」。

授予 AlloyDB for PostgreSQL 執行個體 executesql 權限

如要將 executesql 權限授予 AlloyDB for PostgreSQL 執行個體，並將 data_api_access 執行個體設定設為 ALLOW_DATA_API 值，請使用下列 curl 指令： 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
取代下列項目：
  • PROJECT_ID：專案的 ID。 Google Cloud
  • LOCATION：AlloyDB 叢集所在的區域。
  • CLUSTER_ID：AlloyDB 叢集的 ID。
  • INSTANCE_ID：AlloyDB 執行個體的 ID。
如要執行本教學課程中的步驟，請登入 Google Cloud，然後使用 IAM 驗證功能驗證資料庫。

建立脈絡資料集

如要建立內容集，請執行下列步驟：

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

    前往 AlloyDB

  2. 從清單中選取叢集。

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

  4. 使用 IAM 驗證功能登入 Studio。

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

  6. 按一下「建立內容集」。

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

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

  9. 點選「建立」。

建立脈絡資料集

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

編輯脈絡資料集

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

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

    前往 AlloyDB

  2. 從清單中選取叢集。

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

  4. 使用 Identity and Access Management 驗證登入 Studio。

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

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

  7. 選用步驟：編輯「Context set description」(內容集說明)。

  8. 在「上傳內容集檔案」部分中，按一下「瀏覽」，然後選取內容集檔案。

  9. 按一下 [儲存]。

刪除脈絡資料集

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

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

    前往 AlloyDB

  2. 從清單中選取叢集。

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

  4. 使用 Identity and Access Management 驗證登入 Studio。

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

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

  7. 在「Delete context set」(刪除內容集) 確認對話方塊中，輸入內容集名稱。

  8. 按一下「確認」即可刪除內容集。

後續步驟