使用脈絡工程代理時,代理會自動從 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 控制台的「AlloyDB」頁面。
從清單中選取叢集。
在導覽選單中,點選「AlloyDB Studio」。
使用 IAM 驗證機制登入 AlloyDB Studio。
在「Explorer」窗格中,點選「情境集」旁邊的「查看動作」。
按一下「建立情境組合」。
在「Context set name」(脈絡資料集名稱) 中,提供不重複的脈絡資料集名稱。在 AlloyDB Studio 中,名稱長度必須介於 4 到 30 個字元之間,且開頭不得為空白字元。Studio 會將名稱轉換為小寫,並將非英數字元替換為連字號 (
-),藉此衍生情境集 ID。衍生的情境集 ID 在所選區域的專案default情境集群組中不得重複。舉例來說,脈絡資料集名稱querydata_e2e_test的脈絡資料集 ID 為querydata-e2e-test。直接使用情境工程代理或 Dataplex API 上傳情境集時,情境集 ID 會區分大小寫,且不得包含斜線 (/),長度不限於 4 到 30 個字元,也不限於英數字元、連字號和底線。選用。在「Context set description」(情境集說明) 中,新增情境集的說明。
選用。如要上傳情境集檔案,請按一下「上傳情境集檔案」部分的「瀏覽」,然後選取情境集檔案。
選用。如要選擇情境集的區域,請按一下「顯示進階選項」,然後在「選取位置」中選取區域 (每次建立時預設為
us-east1)。如果選擇us-east1以外的區域,請先選取區域再輸入內容集名稱,讓 AlloyDB Studio 驗證該區域中的名稱是否不重複。點選「建立」。
建立脈絡資料集
如果您在 Studio 中建立了空白情境集,或想更新現有情境集,請按照「使用情境工程代理建構及最佳化情境集」一節的步驟操作,生成及最佳化情境集檔案。脈絡工程代理可直接從 CLI 建立及上傳脈絡集,您也可以在 Studio 編輯脈絡集,手動上傳脈絡集檔案。
編輯脈絡資料集
如要編輯情境組合,請按照下列步驟操作:
前往 Google Cloud 控制台的「AlloyDB」頁面。
從清單中選取叢集。
在導覽選單中,點選「AlloyDB Studio」。
使用 IAM 驗證機制登入 AlloyDB Studio。
找到要編輯的情境組合,然後按一下旁邊的「查看動作」。
按一下「Edit context set」(編輯情境集)。
選用。編輯「Context set description」(脈絡資料集說明)。
在「Upload context set file」(上傳情境集檔案) 部分,按一下「Browse」(瀏覽),然後選取情境集檔案。
按一下「儲存」。
刪除脈絡資料集
如要刪除情境組合,請按照下列步驟操作:
前往 Google Cloud 控制台的「AlloyDB」頁面。
從清單中選取叢集。
在導覽選單中,點選「AlloyDB Studio」。
使用 IAM 驗證機制登入 AlloyDB Studio。
找到要刪除的情境組合,然後按一下旁邊的「查看動作」。
按一下「刪除脈絡資料集」。
在「刪除脈絡資料集」確認對話方塊中,輸入脈絡資料集的 ID。
按一下「確認」,刪除情境組合。
後續步驟
- 進一步瞭解情境組合。
- 瞭解如何在 AlloyDB Studio 中測試 QueryData。
- 瞭解如何使用情境工程代理建構及最佳化情境集。
- 瞭解如何將 QueryData 與應用程式整合。