在 AlloyDB Studio 中管理內容集

使用脈絡工程代理時,代理會自動從 CLI 建立及上傳脈絡資料集。本文說明如何在 AlloyDB for PostgreSQL Studio 中建立、編輯及刪除情境集,以便在 Google Cloud 控制台中使用視覺化介面管理情境集檔案。在 AlloyDB Studio 建立情境集時,AlloyDB Studio 會將情境集儲存在專案的 default 情境集群組 (位於所選區域),並連結至目前的資料庫。在專案的 default 情境集群組中,特定區域內所有資料庫和執行個體的情境集名稱 (以及衍生情境集 ID) 不得重複。在 AlloyDB Studio 中,如果建立的脈絡資料集名稱衍生 ID 已存在,則無法通過驗證。如要覆寫內容並保留資料庫關聯,請改為編輯現有的脈絡資料集。如果直接透過情境工程代理或 Dataplex API 上傳,並使用現有的情境集 ID,系統會取代其內容,以及資料庫關聯 (如有指定)。

AlloyDB Studio 的「Context sets」(情境集) 清單只會顯示 default 情境集群組中,所有支援區域內連結至目前資料庫的情境集。如果情境集是為其他資料庫建立,或透過 API 建立,但未連結 databases (或自訂情境集群組) 中的資料庫資源,就不會顯示在 AlloyDB Studio 清單中。

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

事前準備

建立或上傳情境集前,請先完成下列前置作業。

您可以在 us-central1、us-east1、europe-west4 和 asia-southeast1 區域建立情境集。

啟用必要服務

為專案啟用下列服務:

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

請確認您可以存取現有的 AlloyDB 叢集和執行個體,或建立新的叢集和執行個體。
本教學課程需要 AlloyDB 執行個體中有資料庫。 詳情請參閱「建立資料庫」。

必要角色和權限

  • 將 alloydb.iam_authentication 資料庫旗標設為 on (alloydb.iam_authentication=on),在執行個體上啟用 Identity and Access Management (IAM) 資料庫驗證功能。詳情請參閱「啟用及停用 IAM 驗證」。
  • 在資料庫層級,將 IAM 使用者或服務帳戶新增至叢集。詳情請參閱「管理 IAM 驗證」。
  • 在專案層級,將 roles/alloydb.databaseUser、roles/serviceusage.serviceUsageConsumer 和 roles/geminidataanalytics.queryDataUser 角色授予 IAM 使用者。詳情請參閱「新增專案的 IAM 政策繫結」。
  • 如要建立、上傳及管理情境集,請在專案層級,將 Dataplex Catalog 編輯者 (roles/dataplex.catalogEditor) 或 Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin) 角色授予 IAM 使用者。詳情請參閱「情境組合權限」。
  • 您也必須將唯讀資料庫權限授予 IAM 使用者或服務帳戶。

    GRANT SELECT ON ALL TABLES IN SCHEMA public TO "USER_NAME";

    將 USER_NAME 替換為使用者的電子郵件地址,或不含 .gserviceaccount.com 後置字串的服務帳戶地址 (例如 my-sa@my-project.iam)。由於 ID 包含特殊字元 (@ 和 .),因此必須用引號括住。

    詳情請參閱「將適當的資料庫權限授予 IAM 使用者」。

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

如要將 executesql 權限授予 AlloyDB for PostgreSQL 執行個體,並將 dataApiAccess 執行個體欄位設為 ENABLED (QueryData 必須設定,即使預設允許某些內部 Google Cloud 服務,例如 AlloyDB Studio),請使用下列 curl 指令:
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -H "x-goog-user-project: PROJECT_ID" \
     https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED"
     }'
更改下列內容:
  • PROJECT_ID: Google Cloud 專案的 ID。
  • LOCATION:AlloyDB 叢集所在的區域。
  • CLUSTER_ID:AlloyDB 叢集的 ID。
  • INSTANCE_ID:AlloyDB 執行個體的 ID。
如要執行本教學課程中的步驟,請登入 Google Cloud,然後使用 IAM 驗證機制向資料庫進行驗證。

建立脈絡資料集

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

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

    前往 AlloyDB

  2. 從清單中選取叢集。

  3. 在導覽選單中,點選「AlloyDB Studio」。

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

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

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

  7. 在「Context set name」(脈絡資料集名稱) 中,提供不重複的脈絡資料集名稱。在 AlloyDB Studio 中,名稱長度必須介於 4 到 30 個字元之間,且開頭不得為空白字元。Studio 會將名稱轉換為小寫,並將非英數字元替換為連字號 (-),藉此衍生情境集 ID。衍生的情境集 ID 在所選區域的專案 default 情境集群組中不得重複。舉例來說,脈絡資料集名稱 querydata_e2e_test 的脈絡資料集 ID 為 querydata-e2e-test。直接使用情境工程代理或 Dataplex API 上傳情境集時,情境集 ID 會區分大小寫,且不得包含斜線 (/),長度不限於 4 到 30 個字元,也不限於英數字元、連字號和底線。

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

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

  10. 選用。如要選擇情境集的區域,請按一下「顯示進階選項」,然後在「選取位置」中選取區域 (每次建立時預設為 us-east1)。如果選擇 us-east1 以外的區域,請先選取區域再輸入內容集名稱,讓 AlloyDB Studio 驗證該區域中的名稱是否不重複。

  11. 點選「建立」。

建立脈絡資料集

如果您在 Studio 中建立了空白情境集,或想更新現有情境集,請按照「使用情境工程代理建構及最佳化情境集」一節的步驟操作,生成及最佳化情境集檔案。脈絡工程代理可直接從 CLI 建立及上傳脈絡集,您也可以在 Studio 編輯脈絡集,手動上傳脈絡集檔案。

編輯脈絡資料集

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

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

    前往 AlloyDB

  2. 從清單中選取叢集。

  3. 在導覽選單中,點選「AlloyDB Studio」。

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

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

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

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

  8. 在「Upload context set file」(上傳情境集檔案) 部分,按一下「Browse」(瀏覽),然後選取情境集檔案。

  9. 按一下「儲存」。

刪除脈絡資料集

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

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

    前往 AlloyDB

  2. 從清單中選取叢集。

  3. 在導覽選單中,點選「AlloyDB Studio」。

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

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

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

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

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

後續步驟