在 PostgreSQL 適用的 Cloud SQL Studio 中管理內容集

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

事前準備

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

啟用必要服務

• Data Analytics API with Gemini
• Gemini for Google Cloud API
• Dataplex Universal Catalog API

準備 Cloud SQL 執行個體

必要角色和權限

• 將 IAM 使用者或服務帳戶新增至執行個體。詳情請參閱「使用 Cloud SQL 的 IAM 資料庫驗證機制管理使用者」。
• 在專案層級將 cloudsql.studioUser、cloudsql.instanceUser 和 geminidataanalytics.queryDataUser 角色授予 IAM 使用者。詳情請參閱「為專案新增 IAM 政策繫結」。
• 您也必須以具有超級使用者權限 (例如 postgres 使用者) 的身分登入，然後授予 IAM 使用者或服務帳戶資料庫唯讀權限。
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  將 USER_NAME 替換為使用者的電子郵件地址。由於電子郵件地址含有特殊字元 (「@」和「.」)，因此必須加上引號。
  
  詳情請參閱「授予個別 IAM 使用者或服務帳戶資料庫權限」。

授予 Cloud SQL 執行個體 executesql 權限

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

• PROJECT_ID： Cloud de Confiance by S3NS 專案的 ID。
• INSTANCE_ID：Cloud SQL 執行個體的 ID。

建立內容集

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

1. 前往 Cloud de Confiance by S3NS 控制台的 Cloud SQL 頁面。

   前往 Cloud SQL

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

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

4. 使用 IAM 驗證登入 Studio。

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

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

7. 在「Context set name」(內容集名稱) 欄位中，提供不重複的內容集名稱。內容集名稱會區分大小寫，且可包含字母、數字、連字號和底線。

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

9. 點選「建立」。

建構情境集

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

編輯脈絡資料集

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

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

   前往 Cloud SQL

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

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

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

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

6. 按一下「編輯情境集」。

7. 選用：編輯「Context set description」(情境集說明)。

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

9. 按一下 [儲存]。

刪除內容集

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

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

   前往 Cloud SQL

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

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

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

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

6. 按一下「刪除內容集」。

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

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

後續步驟

• 進一步瞭解情境集。
• 瞭解如何測試內容集。
• 瞭解如何使用 Gemini CLI 建構脈絡資料。